skopcaak/Graduately
1
0
Fork 0
mirror of https://github.com/pepaskopec-blip/Graduately.git synced 2026-10-27 23:24:34 +00:00
Code Issues Projects Releases Packages Wiki Activity

Windows build 2/2?

Browse source
This commit is contained in:
Martin Dvořák 2026-09-10 09:57:12 +02:00
commit 263d6d525f
6 changed files with 261 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

3
.gitattributes vendored Normal file
View file

@ -0,0 +1,3 @@
# Keep Windows batch scripts usable when checked out on Windows.
*.bat text eol=crlf
*.cmd text eol=crlf

1
.gitignore vendored
View file

@ -14,6 +14,7 @@ error.log
CLAUDE.md CLAUDE.md
progress/ progress/
dist/ dist/
build/
# Object files # Object files
*.o *.o

62
CMakeLists.txt Normal file
View file

@ -0,0 +1,62 @@
cmake_minimum_required(VERSION 3.16)
project(maturita C)
set(CMAKE_C_STANDARD 11)
set(CMAKE_C_STANDARD_REQUIRED ON)
# GTK4 is found through pkg-config everywhere: Linux/macOS packages, MSYS2,
# vcpkg and the native MSVC (gvsbuild) package all ship .pc files.
if(MSVC)
# On MSVC the Unix-style flags pkg-config prints are not understood, so
# ask for the native "/I" and ".lib" form instead.
find_program(PKG_CONFIG_EXECUTABLE
NAMES pkg-config pkg-config.exe pkgconf pkgconf.exe)
if(NOT PKG_CONFIG_EXECUTABLE)
message(FATAL_ERROR
"pkg-config was not found. A native GTK4 install for MSVC "
"(e.g. gvsbuild) provides it; set PKG_CONFIG_PATH to "
"<GTK>/lib/pkgconfig. See README.md.")
endif()
execute_process(
COMMAND "${PKG_CONFIG_EXECUTABLE}" --cflags gtk4 --msvc-syntax
OUTPUT_VARIABLE GTK4_CFLAGS_RAW
OUTPUT_STRIP_TRAILING_WHITESPACE
RESULT_VARIABLE GTK4_CFLAGS_RESULT)
execute_process(
COMMAND "${PKG_CONFIG_EXECUTABLE}" --libs gtk4 --msvc-syntax
OUTPUT_VARIABLE GTK4_LIBS_RAW
OUTPUT_STRIP_TRAILING_WHITESPACE
RESULT_VARIABLE GTK4_LIBS_RESULT)
if(NOT GTK4_CFLAGS_RESULT EQUAL 0 OR NOT GTK4_LIBS_RESULT EQUAL 0)
message(FATAL_ERROR
"pkg-config could not find GTK4. Set PKG_CONFIG_PATH to "
"<GTK>/lib/pkgconfig (for example C:\\gtk\\lib\\pkgconfig).")
endif()
separate_arguments(GTK4_CFLAGS WINDOWS_COMMAND "${GTK4_CFLAGS_RAW}")
separate_arguments(GTK4_LIBS WINDOWS_COMMAND "${GTK4_LIBS_RAW}")
else()
find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK4 REQUIRED IMPORTED_TARGET gtk4)
endif()
# WIN32 suppresses the console window on Windows; the app still uses main(),
# so MSVC needs mainCRTStartup as the entry point.
if(WIN32)
add_executable(maturita WIN32 maturita.c)
else()
add_executable(maturita maturita.c)
endif()
if(MSVC)
target_compile_options(maturita PRIVATE ${GTK4_CFLAGS})
target_link_options(maturita PRIVATE ${GTK4_LIBS})
target_link_options(maturita PRIVATE /ENTRY:mainCRTStartup)
target_compile_definitions(maturita PRIVATE _CRT_SECURE_NO_WARNINGS)
else()
target_link_libraries(maturita PRIVATE PkgConfig::GTK4 m)
target_compile_options(maturita PRIVATE
-Wall -Wextra -Wno-deprecated-declarations)
endif()

108
README.md
View file

@ -104,14 +104,17 @@ Linux (Arch):
sudo pacman -S gtk4 sudo pacman -S gtk4
``` ```
Windows – GTK 4 has **no native Windows installer**. On Windows it is Windows – GTK 4 has no official installer for Windows. There are two
distributed through [MSYS2](https://www.msys2.org/), a Unix-like build supported ways to get it:
environment that comes with its own package manager called **`pacman`**.
`pacman` is **not** a Windows command. It only exists inside an MSYS2 - **Native (MSVC / Visual Studio) – recommended.** Download the prebuilt
terminal, so it will not work in `cmd.exe` or PowerShell. Install MSYS2 [gvsbuild](https://github.com/wingtk/gvsbuild/releases/latest) GTK4
first, then follow the [Windows step-by-step](#windows-step-by-step) package and unzip it. See
instructions below. [Native Windows](#native-windows-visual-studio--msvc) below.
- **MSYS2 / MinGW.** Install [MSYS2](https://www.msys2.org/) and use its
`pacman` package manager. `pacman` is **not** a Windows command and only
works inside an MSYS2 terminal. See
[Windows with MSYS2](#windows-with-msys2) below.
#### 2. Build tools (compiler, Make, pkg-config) #### 2. Build tools (compiler, Make, pkg-config)
@ -143,10 +146,11 @@ sudo dnf install pkgconf-pkg-config
sudo pacman -S base-devel pkgconf sudo pacman -S base-devel pkgconf
``` ```
Windows – the MSYS2 packages installed in the step above already include Windows – with the native MSVC path you only need Visual Studio with the
GCC, Make and pkgconf; there is nothing extra to install. Always build and **Desktop development with C++** workload (this includes the compiler and
run from the **MSYS2 UCRT64** terminal so the MinGW `PATH` (and the GTK `pkg-config` comes from the GTK package). With the MSYS2 path, the packages
DLLs) are available. installed above already include GCC, Make and pkgconf; there is nothing
extra to install.
### Building the Application ### Building the Application
@ -168,6 +172,30 @@ gcc -o maturita maturita.c `pkg-config --cflags --libs gtk4` -lm
gcc -o maturita.exe maturita.c `pkg-config --cflags --libs gtk4` -lm -mwindows gcc -o maturita.exe maturita.c `pkg-config --cflags --libs gtk4` -lm -mwindows
``` ```
On Windows with Visual Studio, use the native build script or CMake
instead – see [Native Windows](#native-windows-visual-studio--msvc).
#### Building with CMake (optional, all platforms)
A `CMakeLists.txt` is provided for CMake/IDE users. On Linux and macOS:
```bash
cmake -S . -B build
cmake --build build
```
On Windows, first add GTK to the environment (adjust `C:\gtk` if needed),
then configure from an **x64 Native Tools Command Prompt**:
```bat
set "PATH=C:\gtk\bin;%PATH%"
set "PKG_CONFIG_PATH=C:\gtk\lib\pkgconfig"
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release
```
CMake finds GTK 4 through pkg-config on every platform.
### Running the Application ### Running the Application
```bash ```bash
@ -184,10 +212,55 @@ or
./maturita.exe ./maturita.exe
``` ```
### Windows step-by-step ### Native Windows (Visual Studio / MSVC)
There is no native Windows build of GTK, so the whole toolchain lives This is the recommended Windows path: it builds a real native `.exe` with
inside MSYS2. From start to finish: MSVC and needs no MSYS2 or MinGW shell. GTK 4 for MSVC comes from
[gvsbuild](https://github.com/wingtk/gvsbuild).
1. **Install Visual Studio** (2019 or 2022) with the **Desktop
development with C++** workload. The free Community edition is enough.
2. **Download the gvsbuild GTK4 package** from the
[latest release](https://github.com/wingtk/gvsbuild/releases/latest) –
the asset is named `GTK4_Gvsbuild_<version>_x64.zip` – and unzip it to
`C:\gtk` so that `C:\gtk\bin`, `C:\gtk\lib`, `C:\gtk\include` and
`C:\gtk\share` exist. (If you unzip it elsewhere, set the `GTK_ROOT`
environment variable to that folder before building.)
3. **Build.** From this repository, run `build-windows.bat` from a normal
Command Prompt (or double-click it). It locates Visual Studio, sets up
the MSVC environment and the GTK paths, and produces `maturita.exe`:
```bat
build-windows.bat
```
Internally it gathers the GTK flags with
`pkg-config --cflags gtk4 --msvc-syntax` /
`pkg-config --libs gtk4 --msvc-syntax` and compiles with:
```bat
cl /O2 /MD maturita.c /Fe:maturita.exe ^
/link /SUBSYSTEM:WINDOWS /ENTRY:mainCRTStartup ^
%GTK_CFLAGS% %GTK_LIBS%
```
4. **Run.** `maturita.exe` needs the GTK DLLs on `PATH`, so either run it
from the same terminal or double-click `run-windows.bat`, which adds
`C:\gtk\bin` to `PATH` first.
To build from Visual Studio itself, open the folder with CMake support (the
included `CMakeLists.txt` handles GTK), or create an empty C project and
paste the output of `pkg-config --cflags gtk4 --msvc-syntax` into
**C/C++ → Command Line → Additional Options** and the output of
`pkg-config --libs gtk4 --msvc-syntax` into
**Linker → Command Line → Additional Options**.
### Windows with MSYS2
If you prefer GCC over MSVC, you can still build a native `.exe` with
MSYS2. The resulting binary is a normal Windows executable.
1. **Install MSYS2** from <https://www.msys2.org/> and complete the 1. **Install MSYS2** from <https://www.msys2.org/> and complete the
installer (accept the default install location). installer (accept the default install location).
@ -220,7 +293,7 @@ inside MSYS2. From start to finish:
make run # or: ./maturita.exe make run # or: ./maturita.exe
``` ```
#### Running the `.exe` without the MSYS2 shell #### Bundling the MSYS2 build
`maturita.exe` needs the GTK/MinGW DLLs next to it (or on `PATH`) to `maturita.exe` needs the GTK/MinGW DLLs next to it (or on `PATH`) to
start, so double-clicking it from Explorer normally fails with a start, so double-clicking it from Explorer normally fails with a
@ -276,7 +349,10 @@ saved per unit to `progress/unit1.conf` / `progress/unit2.conf` /
``` ```
maturita.c entire application (UI, navigation, themes, exercises) maturita.c entire application (UI, navigation, themes, exercises)
Makefile build & run targets Makefile build & run targets (Linux, macOS, MSYS2)
CMakeLists.txt optional CMake build (all platforms, incl. MSVC)
build-windows.bat native MSVC build script (no MSYS2 needed)
run-windows.bat launches maturita.exe with the GTK4 DLLs on PATH
README.md this file README.md this file
LICENSE GPL-3.0 license LICENSE GPL-3.0 license
progress/ created at runtime progress/ created at runtime

85
build-windows.bat Normal file
View file

@ -0,0 +1,85 @@
@echo off
setlocal
REM ---------------------------------------------------------------------------
REM Native Windows build with MSVC. No MSYS2 or MinGW shell required.
REM
REM Requirements:
REM * Visual Studio 2019/2022 with the "Desktop development with C++"
REM workload installed.
REM * A GTK4 build for MSVC, for example the gvsbuild prebuilt package
REM unzipped to C:\gtk (see README.md).
REM
REM If GTK lives somewhere other than C:\gtk, set GTK_ROOT first, e.g.
REM set GTK_ROOT=D:\gtk
REM ---------------------------------------------------------------------------
if not defined GTK_ROOT set "GTK_ROOT=C:\gtk"
REM --- 1. Locate Visual Studio and enter the 64-bit MSVC environment --------
set "VSWHERE=%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe"
if not exist "%VSWHERE%" (
echo [error] vswhere.exe not found.
echo Install Visual Studio with the "Desktop development with C++"
echo workload, then run this script again.
exit /b 1
)
set "VSPATH="
for /f "usebackq tokens=*" %%i in (`"%VSWHERE%" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath`) do set "VSPATH=%%i"
if not defined VSPATH (
echo [error] No Visual Studio C++ installation found.
exit /b 1
)
call "%VSPATH%\VC\Auxiliary\Build\vcvars64.bat" >nul
if errorlevel 1 (
echo [error] Failed to initialise the MSVC environment.
exit /b 1
)
REM --- 2. Point the build at the GTK4 installation --------------------------
set "PATH=%GTK_ROOT%\bin;%PATH%"
set "PKG_CONFIG_PATH=%GTK_ROOT%\lib\pkgconfig;%PKG_CONFIG_PATH%"
set "PKG_CONFIG=pkg-config"
where pkg-config >nul 2>nul
if errorlevel 1 (
where pkgconf >nul 2>nul
if errorlevel 1 (
echo [error] pkg-config/pkgconf was not found.
echo Make sure GTK_ROOT points at a GTK4 install that contains
echo bin\pkg-config.exe. Current GTK_ROOT: %GTK_ROOT%
exit /b 1
)
set "PKG_CONFIG=pkgconf"
)
REM --- 3. Collect the GTK4 flags in MSVC syntax -----------------------------
set "GTK_CFLAGS="
set "GTK_LIBS="
for /f "usebackq delims=" %%c in (`%PKG_CONFIG% --cflags gtk4 --msvc-syntax`) do set "GTK_CFLAGS=%%c"
for /f "usebackq delims=" %%l in (`%PKG_CONFIG% --libs gtk4 --msvc-syntax`) do set "GTK_LIBS=%%l"
if not defined GTK_CFLAGS (
echo [error] pkg-config could not find gtk4.
echo Check that "%PKG_CONFIG_PATH%" contains gtk4.pc.
exit /b 1
)
REM --- 4. Compile -----------------------------------------------------------
echo Building maturita.exe with MSVC...
cl /nologo /O2 /MD /W3 /std:c11 /D_CRT_SECURE_NO_WARNINGS ^
%GTK_CFLAGS% maturita.c ^
/Fe:maturita.exe ^
/link /SUBSYSTEM:WINDOWS /ENTRY:mainCRTStartup %GTK_LIBS%
if errorlevel 1 (
echo [error] Build failed.
exit /b 1
)
echo.
echo Built maturita.exe
echo Run it from this terminal with: maturita.exe
echo Or use run-windows.bat / double-click maturita.exe.

17
run-windows.bat Normal file
View file

@ -0,0 +1,17 @@
@echo off
setlocal
REM Launch a locally built maturita.exe with the GTK4 runtime on PATH, so the
REM app can be started by double-clicking even when GTK is not installed
REM system-wide.
if not defined GTK_ROOT set "GTK_ROOT=C:\gtk"
set "PATH=%GTK_ROOT%\bin;%PATH%"
if not exist "%~dp0maturita.exe" (
echo [error] maturita.exe not found next to this script.
echo Build it first with build-windows.bat.
exit /b 1
)
start "" /D "%~dp0" "%~dp0maturita.exe"