跳转至

windows_fast_deploy_build.ps1

文档编写日期: 2026-03-20

使用办法 (Usage)

基本语法

.\scripts\build_helpers\windows_fast_deploy_build.ps1

使用示例

# 执行快速部署构建 (配置 + 编译)
.\scripts\build_helpers\windows_fast_deploy_build.ps1

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: 加载配置并编译

从配置文件读取构建目录和并行任务数,然后执行编译:

cmake --build <build_dir> [--parallel <jobs>]

构建计时

脚本使用Start-BuildTimerStop-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] 节可设置:

[options]
jobs = 8  # 并行编译任务数,留空则使用CMake默认值

注意事项

  • 本脚本不运行测试,如需测试请使用 windows_run_tests.ps1 -Config deploy
  • 如果遇到奇怪的编译问题,建议使用 windows_deploy_build.ps1 进行完整清理重建
  • 部署构建通常使用Release配置,会产生优化后的二进制文件