windows_fast_deploy_build.ps1¶
文档编写日期: 2026-03-20
使用办法 (Usage)¶
基本语法¶
使用示例¶
Scripts详解¶
脚本用途¶
本脚本执行快速部署构建,包含: 1. 调用CMake配置脚本 (使用deploy配置) 2. 执行项目编译
不执行清理操作,适用于增量编译发布版本的场景,如: - 发布版本的小幅更新 - 需要快速生成Release版本 - 调试发布相关的问题
依赖模块¶
- LibCommon.psm1 - 提供日志输出、分隔线等通用功能
- LibConfig.psm1 - 提供INI配置文件读取功能
- LibPaths.psm1 - 提供路径解析和项目根目录定位功能
- LibBuild.psm1 - 提供构建计时器功能
配置文件¶
使用 build_deploy_config.ini 配置文件。
执行流程¶
Step 1: 调用配置脚本¶
执行 windows_configure.ps1 -Config deploy 进行CMake配置。
Step 2: 加载配置并编译¶
从配置文件读取构建目录和并行任务数,然后执行编译:
构建计时¶
脚本使用Start-BuildTimer和Stop-BuildTimer记录编译耗时。
安全检查¶
- 配置文件存在性检查
build_dir非空检查
退出代码¶
0- 编译成功- 非
0- 配置或编译失败
与完整部署构建的区别¶
| 特性 | windows_deploy_build.ps1 | windows_fast_deploy_build.ps1 |
|---|---|---|
| 清理构建目录 | 是 | 否 |
| 运行测试 | 是 | 否 |
| 执行速度 | 较慢 | 较快 |
| 适用场景 | 完全重新构建 | 增量编译 |
与快速开发构建的区别¶
| 特性 | windows_fast_develop_build.ps1 | windows_fast_deploy_build.ps1 |
|---|---|---|
| 配置文件 | build_develop_config.ini | build_deploy_config.ini |
| 构建类型 | 通常为 Debug | 通常为 Release |
| 适用场景 | 日常开发 | 发布部署 |
配置文件选项¶
在 build_deploy_config.ini 的 [options] 节可设置:
注意事项¶
- 本脚本不运行测试,如需测试请使用
windows_run_tests.ps1 -Config deploy - 如果遇到奇怪的编译问题,建议使用
windows_deploy_build.ps1进行完整清理重建 - 部署构建通常使用Release配置,会产生优化后的二进制文件