From 1216fa36cf1f61fd49fe984e721e8d9d2e98c2e7 Mon Sep 17 00:00:00 2001 From: Henrique Reis Neves <39978017+NevesHenry@users.noreply.github.com> Date: Fri, 25 Sep 2026 18:50:06 -0300 Subject: [PATCH] docs: fix stale README notes, document building without Qt (#812) * docs: fix stale README notes, document building without Qt - Use the current issue template name, Game Emulation Status Report (renamed in 027433f). - Raise the documented Windows CMake minimum from 3.12 to 3.22.1, which the bundled SPIRV-Tools requires. - Note that -DKYTY_BUILD_LAUNCHER=OFF builds kyty_emulator and the regression tests without Qt (#193). Co-Authored-By: Claude Opus 5.5 (1M context) * docs: add Qt-free Linux build commands --------- Co-authored-by: Claude Opus 5.5 (1M context) Co-authored-by: nmzik --- README.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index bffcf57f..195f38cd 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ or graphical glitches, so please include the version you tested when reporting a ## Contributing Testing games and submitting detailed bug reports are useful ways to contribute. Search existing -issues first, then use the **Game Emulation Bug Report** template and attach the complete log file. +issues first, then use the **Game Emulation Status Report** template and attach the complete log file. Code contributions should be focused, build successfully on the platforms they touch, and include relevant tests where practical. Windows is the primary target, so a change that alters shared code @@ -132,7 +132,7 @@ the Vulkan/SPIR-V validation rules. ### Build requirements (Windows) - Git -- CMake 3.12 or newer +- CMake 3.22.1 or newer - Ninja - Visual Studio 2022 or Build Tools 2022 with the **Desktop development with C++** workload and **C++ Clang tools for Windows** component @@ -178,7 +178,7 @@ sudo apt-get install --no-install-recommends \ libasound2-dev libpulse-dev libudev-dev libdbus-1-dev libwayland-dev wayland-protocols ``` -Qt 6 (Concurrent, Network, Widgets) is also required — either the distribution packages +Qt 6 (Concurrent, Network, Widgets) is required for the launcher — either the distribution packages (`qt6-base-dev`) or an official Qt installation. ```bash @@ -197,6 +197,18 @@ The install step copies the Qt libraries and plugins next to the binaries, so from the pinned [KytyPS5 FFmpeg core](https://github.com/KytyPS5/ext-ffmpeg-core) release, including VP9 and WebM support. System FFmpeg packages are not required. +To build `kyty_emulator` and the `kyty_tests` target without Qt, use a separate build directory: + +```bash +git submodule update --init --recursive + +cmake -S . -B _Build/linux-no-qt -G Ninja -DCMAKE_BUILD_TYPE=Release \ + -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ \ + -DKYTY_BUILD_LAUNCHER=OFF + +cmake --build _Build/linux-no-qt --target kyty_emulator kyty_tests --parallel +``` + As on Windows, the MSVC compiler is not used; Clang is required. `cl.exe` is rejected at configure time.