# Windows client package (M9.8e) Decision: [ADR-0086](../adr/0086-windows-client-package.md). Windows development host only; requires Visual Studio 2022 C++ tools and prepared SDL, Dear ImGui, Mbed TLS and msquic sources (`cmake -P tools/prepare-sdl3.cmake`, `prepare-imgui.cmake`, `prepare-mbedtls.cmake`, `prepare-msquic.cmake`), plus Strawberry Perl and NASM for msquic's OpenSSL build (ADR-0090). ## Build a package ```powershell powershell -NoProfile -ExecutionPolicy Bypass -File tools\client\package-windows.ps1 ``` It refuses uncommitted tracked changes (`-AllowDirty` packages them with a `-dirty` identity), configures `client-package` with `EVO_BUILD_IDENTITY=g<12 hex>`, builds, runs the client/network/quic-session CTest suite, stages the allowlisted files and writes `build/packages/evo-client-windows-x64-.zip` and `.zip.sha256`. The staged folder stays next to the ZIP. `-Clean` deletes `build/client-package` first; the build log is `build/client-package.log` (+ `.err`). Package content (exact): `evo-client.exe`, `SDL3.dll`, `msquic.dll`, `README.txt`, `BUILD-INFO.txt`, `THIRD-PARTY-NOTICES.txt`, `SHA256SUMS.txt` and `LICENSES/` (SDL3, its HIDAPI, yuv2rgb, stb_image and Khronos notices, Apache-2.0, Mbed TLS, Dear ImGui with fonts and stb notices, msquic, OpenSSL). The tester README template is `tools/client/README-package.txt`; the notice index is `tools/client/THIRD-PARTY-NOTICES.txt`. No credentials, grant bundles, CA files or settings are ever packaged; dev CA and grants are issued to testers separately. ## Verify a package ```powershell powershell -NoProfile -ExecutionPolicy Bypass -File tools\client\verify-windows-package.ps1 -Zip build\packages\.zip [-Interactive] powershell -NoProfile -ExecutionPolicy Bypass -File tools\client\package-selftest.ps1 -Staged build\packages\ -DynamicRuntimeImage build\client-network\evo-client.exe ``` Verification works without Visual Studio (copy `tools/client` with the ZIP): digest, exact content and SHA256SUMS, PE imports of all three images limited to system DLLs plus `SDL3.dll` and `msquic.dll` (no C runtime DLLs), credential and profile-path scan, then the extracted client runs with only the Windows system directories on PATH. `-Interactive` opens a real window for 3 s. The self-test proves each guard refuses its defect. ## Not yet covered - Gitea Actions publication: needs a Windows runner (none registered). - A clean Windows VM run and hardware/DPI qualification: M9.8g. - Code signing: none; Windows SmartScreen may warn on first run.