CTestUseLaunchers

当 CTEST_USE_LAUNCHERS 变量设置为类真值（例如 ON）时，此模块设置 RULE_LAUNCH_* 全局属性。

• RULE_LAUNCH_COMPILE

• RULE_LAUNCH_CUSTOM

• RULE_LAUNCH_LINK

CTestUseLaunchers 模块在调用 include(CTest) 时会自动包含在 CTest 模块中。但是，它作为一个单独的模块提供，以便项目可以独立使用 CTEST_USE_LAUNCHERS 功能。

要使用启动器，请在 ctest -S 仪表板脚本中将 CTEST_USE_LAUNCHERS 变量设置为类真值，然后在已配置的项目中也设置 CTEST_USE_LAUNCHERS 缓存变量。 cmake 和 ctest 都必须知道其值，启动器才能正常运行

• cmake 需要它来生成适当的构建规则

• ctest 需要它来进行准确的错误和警告分析

为方便起见，可以在 ctest -S 脚本中设置环境变量 CTEST_USE_LAUNCHERS_DEFAULT。然后，只要 CMakeLists.txt 包含 CTest 或 CTestUseLaunchers 模块，它就会使用环境变量的值来初始化 CTEST_USE_LAUNCHERS 缓存变量。此缓存变量初始化仅在 CTEST_USE_LAUNCHERS 尚未定义时发生。

3.8 版本新增： 如果在 ctest -S 脚本中将 CTEST_USE_LAUNCHERS 设置为类真值，则 ctest_configure() 命令将在配置项目时向 cmake 命令添加 -DCTEST_USE_LAUNCHERS:BOOL=TRUE。

示例

set(CTEST_USE_LAUNCHERS ON)
include(CTestUseLaunchers)