CTestUseLaunchers

当 CTEST_USE_LAUNCHERS 打开时设置 RULE_LAUNCH_* 全局属性。

当您包含 (CTest) 时,会自动包含 CTestUseLaunchers。但是,它被拆分到自己的模块文件中,因此项目可以独立使用 CTEST_USE_LAUNCHERS 功能。

要使用启动器,请在 ctest -S 仪表板脚本中将 CTEST_USE_LAUNCHERS 设置为 ON,然后将其设置在已配置项目的缓存中。 cmake 和 ctest 都需要知道它的值才能使启动器正常工作。 CMake 需要知道才能生成正确的构建规则,需要知道 ctest 才能生成正确的错误和警告分析。

为方便起见,您也可以在 ctest -S 脚本中设置 ENV 变量 CTEST_USE_LAUNCHERS_DEFAULT。然后,只要您的 CMakeLists 使用 include(CTest) 或 include(CTestUseLaunchers),它就会使用 ENV 变量的值来初始化一个 CTEST_USE_LAUNCHERS 缓存变量。此缓存变量初始化仅在尚未定义 CTEST_USE_LAUNCHERS 时发生。

在 3.8 版本加入: 如果 CTEST_USE_LAUNCHERS 在 ctest -S 脚本中打开,ctest_configure 命令会将 -DCTEST_USE_LAUNCHERS:BOOL=TRUE 添加到用于配置项目的 cmake 命令中。