CTestUseLaunchers

当 CTEST_USE_LAUNCHERS 处于启用状态时,设置 RULE_LAUNCH_* 全局属性。

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

若要使用启动器,请在一个 ctest -S 仪表板脚本中设置 CTEST_USE_LAUNCHERS 为 ON,然后在已配置的项目的缓存中也设置 CTEST_USE_LAUNCHERS。为了使启动器正常工作,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 命令将向用于配置项目的 cmake 命令添加 -DCTEST_USE_LAUNCHERS:BOOL=TRUE。