Story: Build platform follow-up
Table of Contents
This page documents a story in Sprint 07. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
Follow up on the build-platform work from sprint 04: get a Windows laptop fully functional, switch to a prebuilt Qt, and resolve the latest Windows clang build breaks.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 07 |
| Now | Completed 2025-12-18. |
| Waiting on | None. |
| Next | None. |
| Last touched | 2025-12-18 |
Continued from: Build and packaging.
Acceptance
- Windows laptop builds and tests cleanly via WSL.
- Prebuilt Qt detected and used; vcpkg Qt build skipped when present.
- Windows clang build green.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Setup windows laptop with WSL | DONE | 2026-05-19 | 2025-12-16 | Get a Windows dev laptop ready: WSL, vcpkg, project clone, full build + tests green. |
| Use prebuilt Qt | DONE | 2026-05-19 | 2025-12-17 | Switch CI and dev installs to a prebuilt Qt rather than building from vcpkg; saves significant time + disk. |
| Windows clang build failures | DONE | 2026-05-19 | 2025-12-18 | Resolve the latest Windows clang build breaks: deprecated APIs, missing DLLs, signed/unsigned warnings. |
Decisions
- Prebuilt Qt as default
- building Qt from source dominated CI runtime; the prebuilt switch was the single biggest available win.
- Windows-via-WSL is the supported Windows path
- avoids maintaining a separate native-Windows build story.
Out of scope
- macOS support — tracked separately when there's a demand.
See also
- Build and packaging (sprint 04) — predecessor.