bukovinafilip/maturita.c
1
0
Fork 0
Code Pull requests Activity

Simplify Windows build docs to a Czech MSYS2 UCRT64 guide.

Browse source 
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
pepaskopec-blip 2026-09-10 16:15:29 +02:00
commit f360e00883
1 changed files with 58 additions and 107 deletions
Download patch file Download diff file Expand all files Collapse all files

167
README.md
View file

@ -104,17 +104,10 @@ Linux (Arch):
sudo pacman -S gtk4 sudo pacman -S gtk4
``` ```
Windows – GTK 4 has no official installer for Windows. There are two Windows – oficiální GTK 4 instalátor neexistuje. Doporučený a vyzkoušený
supported ways to get it: postup je **MSYS2 + MinGW UCRT64** (bez Visual Studia). Kompletní návod
v češtině je níže v
- **Native (MSVC / Visual Studio) – recommended.** Download the prebuilt [Instalační návod pro Windows (GTK4)](#instalační-návod-pro-windows-gtk4).
[gvsbuild](https://github.com/wingtk/gvsbuild/releases/latest) GTK4
package and unzip it. See
[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)
@ -146,11 +139,8 @@ sudo dnf install pkgconf-pkg-config
sudo pacman -S base-devel pkgconf sudo pacman -S base-devel pkgconf
``` ```
Windows – with the native MSVC path you only need Visual Studio with the Windows – kompilátor (`gcc`), GTK 4 i `pkg-config` se nainstalují v kroku 1
**Desktop development with C++** workload (this includes the compiler and návodu níže. Visual Studio není potřeba.
`pkg-config` comes from the GTK package). With the MSYS2 path, the packages
installed above already include GCC, Make and pkgconf; there is nothing
extra to install.
### Building the Application ### Building the Application
@ -168,33 +158,21 @@ Or manually:
# Linux / macOS # Linux / macOS
gcc -o maturita maturita.c `pkg-config --cflags --libs gtk4` -lm gcc -o maturita maturita.c `pkg-config --cflags --libs gtk4` -lm
# Windows (MSYS2 UCRT64 / MINGW64) # Windows (MSYS2 UCRT64) – viz také český návod níže
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 #### Building with CMake (optional, Linux / macOS)
instead – see [Native Windows](#native-windows-visual-studio--msvc).
#### Building with CMake (optional, all platforms) A `CMakeLists.txt` is provided for CMake/IDE users:
A `CMakeLists.txt` is provided for CMake/IDE users. On Linux and macOS:
```bash ```bash
cmake -S . -B build cmake -S . -B build
cmake --build build cmake --build build
``` ```
On Windows, first add GTK to the environment (adjust `C:\gtk` if needed), CMake finds GTK 4 through pkg-config. On Windows prefer the MSYS2
then configure from an **x64 Native Tools Command Prompt**: `gcc` / `make` flow below.
```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
@ -212,101 +190,74 @@ or
./maturita.exe ./maturita.exe
``` ```
### Native Windows (Visual Studio / MSVC) ### Instalační návod pro Windows (GTK4)
This is the recommended Windows path: it builds a real native `.exe` with Následujte tyto kroky pro rychlé zkompilování a spuštění na Windows.
MSVC and needs no MSYS2 or MinGW shell. GTK 4 for MSVC comes from **Visual Studio není potřeba** – stačí MSYS2 a MinGW UCRT64.
[gvsbuild](https://github.com/wingtk/gvsbuild).
1. **Install Visual Studio** (2019 or 2022) with the **Desktop 1. **Nainstalujte MSYS2 a GTK4**
development with C++** workload. The free Community edition is enough.
2. **Download the gvsbuild GTK4 package** from the Otevřete Příkazový řádek (CMD) nebo PowerShell jako Správce a spusťte:
[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 ```cmd
Command Prompt (or double-click it). It locates Visual Studio, sets up winget install --id MSYS2.MSYS2 -e --source winget
the MSVC environment and the GTK paths, and produces `maturita.exe`: C:\msys64\ucrt64.exe pacman -S --noconfirm mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gtk4 mingw-w64-ucrt-x86_64-pkg-config
```bat
build-windows.bat
``` ```
Internally it gathers the GTK flags with Počkejte, až se obě instalace dokončí. Pokud `winget` hlásí, že MSYS2 už
`pkg-config --cflags gtk4 --msvc-syntax` / je nainstalované, klidně pokračujte druhým příkazem.
`pkg-config --libs gtk4 --msvc-syntax` and compiles with: (Druhý příkaz otevře okno MSYS2, stáhne balíčky a zase se ukončí – to je
v pořádku.)
```bat 2. **Stáhněte projekt**
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 Naklonujte nebo stáhněte tento repozitář a zapamatujte si cestu, např.
from the same terminal or double-click `run-windows.bat`, which adds `C:\Users\Josef\maturita.c`.
`C:\gtk\bin` to `PATH` first.
To build from Visual Studio itself, open the folder with CMake support (the 3. **Otevřete terminál MSYS2 UCRT64**
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 Ve Start menu vyhledejte **MSYS2 UCRT64** a spusťte ho.
Nepoužívejte běžný CMD ani PowerShell – `gcc` a `pkg-config` fungují
právě v tomto okně.
If you prefer GCC over MSVC, you can still build a native `.exe` with 4. **Přejděte do složky projektu a zkompilujte**
MSYS2. The resulting binary is a normal Windows executable.
1. **Install MSYS2** from <https://www.msys2.org/> and complete the V MSYS2 se cesty píší jako `/c/...` místo `C:\...`. Upravte cestu podle
installer (accept the default install location). sebe a spusťte:
2. Open the **“MSYS2 UCRT64”** entry from the Start menu. This is a
special terminal, **not** Command Prompt or PowerShell – `pacman` only
exists here. (If you run `pacman` in `cmd.exe`/PowerShell you will see
“`'pacman' is not recognized`”, which is expected.)
3. In that MSYS2 UCRT64 terminal, install the compiler and GTK 4:
```bash ```bash
pacman -S --needed mingw-w64-ucrt-x86_64-gtk4 \ cd /c/Users/Josef/maturita.c
mingw-w64-ucrt-x86_64-toolchain \ gcc -o maturita.exe maturita.c $(pkg-config --cflags --libs gtk4) -lm -mwindows
mingw-w64-ucrt-x86_64-pkgconf make
``` ```
4. `cd` into this repository (MSYS2 uses `/c/...` for `C:\...`) and build: Příklady převodu cesty:
- `C:\Users\Josef\maturita.c` → `/c/Users/Josef/maturita.c`
- `C:\Users\Josef\Desktop\maturita.c` → `/c/Users/Josef/Desktop/maturita.c`
Pokud kompilace projde bez chyb, ve složce projektu vznikne `maturita.exe`.
5. **Spusťte aplikaci**
Ze stejného terminálu UCRT64:
```bash ```bash
cd /c/path/to/maturita.c ./maturita.exe
make
``` ```
The Makefile detects Windows automatically and produces `maturita.exe`. 6. **(Volitelně) Spuštění dvojklikem z Průzkumníka**
5. Run it from the same terminal: Samotný `maturita.exe` bez MSYS2 terminálu obvykle spadne na chybějící
DLL. Z UCRT64 terminálu (po instalaci `make` přes
`pacman -S --noconfirm make`) můžete vytvořit složku `dist/` se vším
potřebným:
```bash ```bash
make run # or: ./maturita.exe pacman -S --noconfirm make
make bundle
``` ```
#### Bundling the MSYS2 build Pak spusťte `dist/maturita.exe` dvojklikem.
`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
missing-DLL error. The Makefile can collect the required DLLs into a
`dist/` folder:
```bash
make bundle
```
Then launch `dist/maturita.exe` by double-clicking it or from Explorer.
Running the app from the MSYS2 UCRT64 terminal (step 5) always works and
needs no bundling.
## Usage ## Usage
@ -349,10 +300,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 (Linux, macOS, MSYS2) Makefile build & run targets (Linux, macOS, MSYS2); `make bundle` na Windows
CMakeLists.txt optional CMake build (all platforms, incl. MSVC) CMakeLists.txt optional CMake build (Linux / macOS)
build-windows.bat native MSVC build script (no MSYS2 needed) build-windows.bat legacy MSVC build (vyžaduje Visual Studio + gvsbuild GTK)
run-windows.bat launches maturita.exe with the GTK4 DLLs on PATH run-windows.bat legacy spouštění MSVC buildu s GTK DLL na 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