CTest

設定專案以使用 CTest/CDash 進行測試

在專案的頂層 CMakeLists.txt 檔案中包含此模組，以啟用 CTest 測試和向 CDash 提交儀表板資料。

project(MyProject)
...
include(CTest)

此模組會自動建立一個 BUILD_TESTING 選項，該選項選擇是否啟用測試支援（預設為 ON）。包含此模組後，使用類似下面的程式碼：

if(BUILD_TESTING)
  # ... CMake code to create tests ...
endif()

當啟用測試時，建立測試。

要啟用向 CDash 伺服器提交資料，請在專案頂層建立一個 CTestConfig.cmake 檔案，內容如下：

set(CTEST_NIGHTLY_START_TIME "01:00:00 UTC")
set(CTEST_SUBMIT_URL "http://my.cdash.org/submit.php?project=MyProject")

（CDash 伺服器可以將此檔案提供給設定 MyProject 的專案管理員）。此設定檔中的設定將由這個 CTest 模組和 ctest(1) 命令列 儀表板客戶端 模式 (ctest -S) 共用。

在建置要提交到 CDash 的專案時，CTest 會掃描建置輸出中的錯誤和警告，並從建置日誌中報告它們以及周圍的上下文。這種通用方法適用於所有建置工具，但不會提供產生特定問題的命令呼叫詳細資訊。您可以透過設定 CTEST_USE_LAUNCHERS 變數來取得更詳細的報告：

set(CTEST_USE_LAUNCHERS 1)

在 CTestConfig.cmake 檔案中。