windows_run_tests.ps1

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

使用办法 (Usage)

基本语法

.\scripts\build_helpers\windows_run_tests.ps1 [-Config <develop|deploy>]

参数说明

参数	类型	默认值	说明
-Config	String	develop	配置类型，可选值: develop 或 deploy

使用示例

# 使用默认开发配置运行测试
.\scripts\build_helpers\windows_run_tests.ps1

# 使用部署配置运行测试
.\scripts\build_helpers\windows_run_tests.ps1 -Config deploy

Scripts详解

脚本用途

本脚本使用CTest运行项目的测试套件。它会：

1. 根据指定配置读取构建目录
2. 定位测试子目录
3. 执行CTest并显示测试结果

适用于：

• 验证代码正确性
• 回归测试
• CI/CD流程中的测试阶段

依赖模块

• LibCommon.psm1 - 提供日志输出、分隔线等通用功能
• LibConfig.psm1 - 提供INI配置文件读取功能
• LibPaths.psm1 - 提供路径解析和项目根目录定位功能

配置文件

根据-Config参数选择配置文件：

• develop模式: build_develop_config.ini
• deploy模式: build_deploy_config.ini

执行流程

1. 加载配置

从配置文件读取build_dir设置。

2. 构建测试目录

测试目录路径为：<项目根目录>/<build_dir>/test

3. 验证测试目录存在

如果测试目录不存在，脚本会报错并提示先运行构建脚本。

4. 执行测试

ctest --test-dir <test_dir> --output-on-failure

CTest参数说明

• --test-dir: 指定测试目录
• --output-on-failure: 测试失败时显示详细输出

安全检查

• 配置文件存在性检查
• build_dir非空检查
• 测试目录存在性检查

退出代码

• 0 - 所有测试通过
• 非0 - 有测试失败

测试失败处理

脚本会：

• 显示警告信息
• 返回失败的退出代码
• 不会中断执行流程

使用建议

1. 构建后立即测试: 在构建脚本中自动调用本脚本
2. 独立运行测试: 修改代码后可单独运行测试验证
3. CI集成: 在CI流程中使用 -Config deploy 确保发布版本质量

常见问题

Q: 测试目录不存在怎么办？ A: 请先运行相应的构建脚本，如 windows_develop_build.ps1 或 windows_deploy_build.ps1

Q: 如何查看详细测试输出？ A: 脚本使用 --output-on-failure 参数，失败的测试会自动显示详细输出

Q: 如何只运行特定测试？ A: 本脚本运行全部测试，如需运行特定测试，请直接使用 CTest 命令并添加筛选参数