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 尚未定義時發生。

Added in version 3.8: 如果 CTEST_USE_LAUNCHERS 在 ctest -S 腳本中為開啟狀態,ctest_configure 命令將會把 -DCTEST_USE_LAUNCHERS:BOOL=TRUE 加入到用於配置專案的 cmake 命令中。