本目录包含用于构建、清理和管理 Bit HCI 项目的自动化脚本。
重要更新（2025-10-12）：项目已迁移到统一构建系统。 详见：统一构建系统指南
功能： 一键完成清理、配置、构建全流程
用法：
scripts\rebuild.bat执行流程：
- 清理所有构建产物
- 配置整个项目的 CMake
- 编译 native 运行时
- 编译所有组件（15个）
- 自动编译着色器
适用场景：
- 首次构建项目
- 清理构建后重新开始
- 解决构建环境问题
- CI/CD 自动构建
功能： 为整个项目运行 CMake 配置
用法：
scripts\configure.bat执行内容：
- 创建统一的
build/目录 - 运行
cmake生成 Visual Studio 解决方案 - 自动发现所有组件（15个）
- 配置 native 运行时
- 配置着色器编译
适用场景：
- CMakeLists.txt 修改后
- 首次构建前
- 添加新组件后
功能： 编译整个项目（native + 所有组件）
用法：
scripts\build.bat执行内容：
- 构建 native 运行时
- 编译 15 个组件
- 生成
.dll文件 - 自动编译着色器为
.spv - 所有产物输出到
build/bin/ - 显示构建统计信息
适用场景：
- 代码修改后快速重新编译
- 批量更新所有组件
- 日常开发构建
输出示例：
========================================
Building Bit HCI Project
========================================
Building all targets...
bitui_native.vcxproj -> D:\_Bit_OS\Bit HCI\build\bin\bitui_native.exe
triangle.vcxproj -> D:\_Bit_OS\Bit HCI\build\bin\triangle.dll
button.vcxproj -> D:\_Bit_OS\Bit HCI\build\bin\button.dll
...
========================================
Build Complete!
========================================
功能： 删除所有 build 目录和编译文件
用法：
# 交互式确认
scripts\clean.bat
# 跳过确认（用于自动化）
scripts\clean.bat /Y清理内容：
build/- 统一构建目录- 旧的分散 build 目录（兼容性清理）
examples/cpp/*/build/native/build/compiler/build/
适用场景：
- 构建环境出现问题
- 释放磁盘空间
- 重新开始干净构建
功能： 自动化 Git 提交流程
用法：
scripts\push.bat# 一键完成所有操作（推荐）
scripts\rebuild.bat
# 测试运行（选择任意组件）
cd build\bin
.\bitui_native.exe .\button.dll修改单个组件后：
# 快速重新编译（只编译修改的文件）
scripts\build.bat
# 测试
cd build\bin
.\bitui_native.exe .\button.dll修改多个组件后：
# 批量重新编译所有组件
scripts\build.bat修改 CMakeLists.txt 后：
# 重新配置 + 构建
scripts\configure.bat
scripts\build.bat
# 或一键重建
scripts\rebuild.bat所有构建产物位于：
build/
└── bin/
├── bitui_native.exe # Native 运行时
├── triangle.dll # 组件 1
├── button.dll # 组件 2
├── checkbox.dll # 组件 3
└── ... (共 15 个组件)
优势：
- ✅ 集中管理，易于查找
- ✅ 无需手动复制文件
- ✅ 清晰的目录结构
- ✅ 一个命令运行组件
运行方式：
cd build\bin
.\bitui_native.exe .\[组件名].dll注意： 旧的分散构建目录（
examples/cpp/*/build/）已废弃。 详见：迁移指南
解决方案：
- 检查错误信息
- 运行清理脚本：
scripts\clean.bat - 重新配置：
scripts\configure.bat - 重新构建：
scripts\build.bat
解决方案： 确保已安装 CMake 并添加到 PATH：
cmake --version如果未安装，下载：https://cmake.org/download/
解决方案：
修改 configure.bat 中的生成器：
# 当前使用（第 17 行）
cmake .. -G "Visual Studio 17 2022" -A x64
# 改为你的版本，例如：
cmake .. -G "Visual Studio 16 2019" -A x64症状：
CMake Error: Could not find Vulkan
解决方案：
- 安装 Vulkan SDK: https://vulkan.lunarg.com/
- 确保
VULKAN_SDK环境变量已设置 - 重启终端
验证：
echo %VULKAN_SDK%组件总数： 15 平均构建时间： ~2 秒/组件 总构建时间： ~30 秒（首次编译，并行构建） 增量构建： ~5 秒（修改单个组件）
组件列表：
- Triangle - 三角形渲染
- Rectangle - 矩形渲染
- Text - 文本渲染
- Circle - 圆形渲染
- Line - 线段渲染
- ProgressBar - 进度条
- Switch - 开关
- Button - 按钮
- Checkbox - 复选框
- Radio - 单选按钮
- Slider - 滑块
- Input - 输入框
- Label - 标签
- Tooltip - 工具提示
- Dropdown - 下拉菜单
# ✅ 推荐：使用新脚本
scripts\rebuild.bat
scripts\build.bat
# ❌ 避免：手动进入各组件构建
cd examples/cpp/triangle/build # 旧方式定期运行清理脚本释放空间：
scripts\clean.bat确保 .gitignore 正确配置，不要提交构建产物：
/build/ # 统一构建目录
**/build/ # 旧的分散目录（兼容）
*.dll
*.exe
*.lib
*.exp
*.obj新构建系统自动支持并行编译，无需额外配置：
# 自动并行构建
scripts\build.bat
# 或使用 CMake 直接控制
cmake --build build --config Release --parallel 8# 配置所有组件（需要多次）
cd examples/cpp/triangle/build && cmake ..
cd examples/cpp/button/build && cmake ..
# ... 重复 15 次
# 构建所有组件（需要多次）
cmake --build examples/cpp/triangle/build
cmake --build examples/cpp/button/build
# ... 重复 15 次
# 手动复制 DLL
copy examples\cpp\triangle\build\Release\*.dll native\build\Release\问题：
- ❌ 需要 15+ 次手动操作
- ❌ 容易遗漏
- ❌ 路径管理复杂
- ❌ 构建时间长（串行）
# 一键完成所有操作
scripts\rebuild.bat
# 或
scripts\configure.bat # 配置一次
scripts\build.bat # 构建所有优势：
- ✅ 一键操作
- ✅ 自动发现组件
- ✅ 并行构建
- ✅ 统一输出
- ✅ 4-8 倍速度提升
- 统一构建系统指南 - 完整使用文档
- 迁移指南 - 从旧系统迁移
- 构建快速指南 - 快速参考
- Push 脚本指南 - Git 提交脚本
- 项目架构 - 整体架构
- 组件开发指南 - 组件开发
- Native 运行时 - 运行时文档
如有问题，请参考：
最后更新： 2025-10-12
维护者： Bit HCI Team
系统版本： 2.0 (统一构建系统)