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 -S
腳本中 CTEST_USE_LAUNCHERS 為開啟,ctest_configure 命令會將 -DCTEST_USE_LAUNCHERS:BOOL=TRUE 添加到用於設定專案的 cmake 命令中。