跳转至

平台矩阵

CCB 支持多种构建环境,但验证结论只对明确的工具链与功能组合成立。Linux 构建成功 不能替代 Windows、MSVC 或 Android 的证据。

平台 维护中的入口 关键边界 最小有效证据
Linux Make 或 linux-x64 CMake preset 桌面默认使用 SDL2 配置/构建与聚焦测试
WSL WSL 内的 Linux 工具链 文件系统与图形集成不同于原生 Linux 注明 WSL 版本和源码所在文件系统
Windows MSYS2 Windows MSYS2 CMake presets 包名、shell 引号和 DLL 打包不同 在 MSYS2 中完成 preset 配置/构建
Windows MSVC vcpkg/MSVC 流程和 MSVC CI 编译器诊断与依赖模型不同 MSVC workflow 或等价本地构建
Android Gradle wrapper 与 native CMake Android 使用 SDL3,产物按 ABI 区分 Gradle 测试;APK/AAB 注明 variant 和 ABI

不要照抄旧的 preset 名称,应先查看当前仓库:

# validation: cmake-configure
cmake --list-presets

功能组合

Tiles、sound、本地化、tests、Lua UI、编译器和构建类型都是平台身份的一部分,PR 中必须记录。CCB 的 desktop SDL3 job 是实验性的,并受 CCB_DESKTOP_SDL3_ENABLED 门控;Android 使用 SDL3 不代表桌面默认值改变。

本页没有声称什么

本页记录 verified commit 中 Make、CMake presets、Gradle 与 CI 提供的入口,不声称 文档构建期间真实跑过每个矩阵单元。发布维护者必须以发布 commit 的默认分支检查和 产物为准。

具体命令见构建 CCB,风险扩展规则见 测试策略。