cmake：命令行工具ctest

比眉伴天荒 2022-10-11 12:11 275阅读 0赞

# 概要 #

ctest [<options>]
    ctest --build-and-test <path-to-source> <path-to-build>
          --build-generator <generator> [<options>...]
          [--build-options <opts>...] [--test-command <command> [<args>...]]
    ctest {
        -D <dashboard> | -M <model> -T <action> | -S <script> | -SP <script>}
          [-- <dashboard-options>...]

# 描述 #

ctest可执行文件是CMake测试驱动程序。为使用enable\_testing()和add\_test()命令的项目创建的cmake生成构建树具有测试支持。此程序将运行测试并报告结果。

# Options #

`-C <cfg>, --build-config <cfg>`

*  选择要测试的配置。
 *  一些cmake生成的构建树在同一棵树中可以有多个构建配置。此选项可用于指定应该测试哪个。配置示例为Debug和Release。

`--progress`

*  启用测试的短进度输出。
 *  当ctest的输出被直接发送到终端时，通过更新同一行而不是在新行上打印每个测试的开始和结束消息来报告测试集的进度。这可以显著地减少测试输出的冗长。对于失败的测试，测试完成消息仍然会在其自己的行上输出，并且最终的测试摘要也将被记录。
 *  也可以通过设置环境变量CTEST\_PROGRESS\_OUTPUT 来启用此选项.

`-V,--verbose`

*  启用测试的详细输出。
 *  测试输出通常被抑制，只显示摘要信息。此选项将显示所有测试输出。

`-VV,--extra-verbose`

*  启用测试的更详细输出。
 *  测试输出通常被抑制，只显示摘要信息。此选项将显示更多的测试输出。

`--debug`

*  显示更详细的CTest内部结构。
 *  此功能将导致大量输出，这些输出对于调试仪表板问题非常有用

`--output-on-failure`

*  如果测试失败，则输出测试程序输出的任何内容。
 *  也可以通过设置CTEST\_OUTPUT\_ON\_FAILURE环境变量来启用此选项

`-F`

*  启用故障转移。
 *  此选项允许CTest恢复之前中断的测试集执行。如果没有中断发生，-F选项将不起作用。

`-j <jobs>, --parallel <jobs>`

*  使用给定的作业数量并行运行测试。
 *  此选项告诉CTest使用给定数量的作业并行运行测试。也可以通过设置CTEST\_PARALLEL\_LEVEL环境变量来设置此选项。
 *  此选项可与处理器测试属性一起使用。
 *  参见标签和子项目摘要。