Files

3.7 KiB

M9.1 native client dependency probe

Decision: ADR-0077. This is an isolated dependency evaluation, not evo-client, gameplay or the M9.2 renderer. SDL 3.4.16 provides window/events and a thin 2D renderer. Direct Vulkan and SDL_GPU remain alternatives if measured workloads outgrow it. Audio and player UI are deferred.

Reproduce

In a C++23 developer shell with CMake 3.28+ and Ninja:

cmake -P tools/prepare-sdl3.cmake
cmake --preset client-probe
cmake --build --preset client-probe --parallel 4
ctest --preset client-probe --no-tests=error
./build/client-probe/evo-client-probe
./build/client-probe/evo-client-probe --renderer vulkan

Windows executables have .exe. CTest uses SDL's dummy window driver and software renderer for deterministic rectangle/background pixel checks. The standalone run uses the native video driver and reports the actual renderer. The window is hidden and the process exits after one checked frame; no persistent desktop window is left. An explicitly requested missing renderer must fail, not silently fall back. Synthetic keyboard injection proves event plumbing, not physical input/focus behavior.

Linux desktop builds require SDL's documented X11/Wayland development packages. The ci-client Docker stage installs the X11 subset and runs a window probe under Xvfb, in addition to dummy-driver CTests. It does not require a GPU or cluster. For a CI host without these, explicitly add -DSDL_UNIX_CONSOLE_BUILD=ON -DSDL_X11=OFF -DSDL_WAYLAND=OFF. That configuration proves software/offscreen behavior only. Do not use it to claim Linux desktop-window qualification.

Offline preparation from a previously downloaded archive:

cmake -DSDL_ARCHIVE=/absolute/path/SDL3-3.4.16.tar.gz -P tools/prepare-sdl3.cmake

The script checks the archive before extraction. Sources go under ignored build/external/sdl3/; configuration consumes only prepared sources and refuses a missing/mismatched preparation marker. Treat that directory as an immutable local dependency checkout; edits there invalidate qualification. Delete/reprepare it explicitly for a clean rebuild. No network access occurs during configuration.

Ownership, licensing and updates

  • Machine-readable release URL/version/hash: tools/sdl3-pin.cmake.
  • Owner: client/platform engineering. Upgrade by reviewing upstream release and security changes, updating version/hash, preparing fresh sources and rerunning Windows/Linux probes, analysis and package measurements.
  • SDL's zlib notice is retained in third_party/SDL3/LICENSE.txt; the complete upstream archive retains bundled component notices. No claim is made that SDL license review licenses the game itself. Binary release packaging must retain applicable third-party notices and audit enabled backend/system dependencies.
  • Shared SDL is linked only by the opt-in probe/client platform and native tests; no SDL includes enter public headers or simulation, world, biology or server targets. It is disabled by default. Windows copies SDL3.dll beside the probe; Linux uses the build RPATH.
  • Size reports are build artifacts, not performance rankings. No representative creature/terrain workload exists yet, so no renderer throughput claim is made.

Follow-up boundary

M9.2 implements the real application lifecycle, immutable-view renderer interface, resize/DPI/focus/device failures and resource limits. See client operation and validation. M9.3 owns camera/intentions. M9.8 owns distributable packaging. Xvfb verifies the Linux X11 window path; real desktop input, focus, DPI, Wayland and GPU qualification remain later gate work. See VALIDATION.md for executed measurements and limitations.