CTestUseLaunchers

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

当您 include(CTest) 时,CTestUseLaunchers 会被自动包含。然而,它被拆分到其自身的模块文件中,以便项目可以独立使用 CTEST_USE_LAUNCHERS 功能。

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

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

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