来源:
Makefile
CMakePresets.json
android/app/build.gradle
.github/workflows/matrix.yml
.github/workflows/msvc-full-features.yml
.github/workflows/sdl3-matrix.yml
commit d32b9cc880a8
build-config
平台矩阵¶
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 名称,应先查看当前仓库:
功能组合¶
Tiles、sound、本地化、tests、Lua UI、编译器和构建类型都是平台身份的一部分,PR
中必须记录。CCB 的 desktop SDL3 job 是实验性的,并受
CCB_DESKTOP_SDL3_ENABLED 门控;Android 使用 SDL3 不代表桌面默认值改变。
本页没有声称什么¶
本页记录 verified commit 中 Make、CMake presets、Gradle 与 CI 提供的入口,不声称 文档构建期间真实跑过每个矩阵单元。发布维护者必须以发布 commit 的默认分支检查和 产物为准。