ctest_submit

執行 CTest 提交步驟 作為 儀表板用戶端。

ctest_submit([PARTS <part>...] [FILES <file>...]
             [SUBMIT_URL <url>]
             [BUILD_ID <result-var>]
             [HTTPHEADER <header>]
             [RETRY_COUNT <count>]
             [RETRY_DELAY <delay>]
             [RETURN_VALUE <result-var>]
             [CAPTURE_CMAKE_ERROR <result-var>]
             [QUIET]
             )

將結果提交到儀表板伺服器。預設情況下，會提交所有可用的部分。

選項如下：

PARTS <part>...

指定要提交的部分子集。有效的部分名稱為

• Start - 無。

• Update - ctest_update() 結果，在 Update.xml 中。

• Configure - ctest_configure() 結果，在 Configure.xml 中。

• Build - ctest_build() 結果，在 Build.xml 中。

• Test - ctest_test() 結果，在 Test.xml 中。

• Coverage - ctest_coverage() 結果，在 Coverage.xml 中。

• MemCheck - ctest_memcheck() 結果，在 DynamicAnalysis.xml 和 DynamicAnalysis-Test.xml 中。

• Notes - 由 CTEST_NOTES_FILES 列出的檔案，在 Notes.xml 中。

• ExtraFiles - 由 CTEST_EXTRA_SUBMIT_FILES 列出的檔案。

• Upload - 由 ctest_upload() 準備上傳的檔案，在 Upload.xml 中。

• Submit - 無。

• Done - 建置完成，在 Done.xml 中。

FILES <file>...

指定要提交的特定檔案的明確清單。每個個別檔案在呼叫時都必須存在。

SUBMIT_URL <url>

在版本 3.14 中新增。

要將提交傳送到的儀表板伺服器的 http 或 https URL。如果未給定，則會使用 CTEST_SUBMIT_URL 變數。

BUILD_ID <result-var>

在版本 3.15 中新增。

將 CDash 指派給此建置的 ID 儲存在 <result-var> 變數中。

HTTPHEADER <HTTP-header>

在版本 3.9 中新增。

指定在提交期間要包含在 CDash 請求中的 HTTP 標頭。例如，CDash 可以設定為僅接受來自已驗證用戶端的提交。在這種情況下，您應該在標頭中提供持有者權杖

ctest_submit(HTTPHEADER "Authorization: Bearer <auth-token>")

此子選項可以重複多次以用於多個標頭。

RETRY_COUNT <count>

指定逾時提交的重試次數。

RETRY_DELAY <delay>

指定在逾時提交後，嘗試重新提交之前要等待的時間長度（以秒為單位）。

RETURN_VALUE <result-var>

將 0 (成功) 和非零值 (失敗) 儲存在 <result-var> 變數中。

CAPTURE_CMAKE_ERROR <result-var>

在版本 3.13 中新增。

如果執行命令時發生任何錯誤，則在 <result-var> 變數中儲存 -1，並防止 ctest 在發生錯誤時傳回非零值。

QUIET

在版本 3.3 中新增。

抑制所有原本會列印到主控台的非錯誤訊息。

提交到 CDash 上傳 API

在版本 3.2 中新增。

ctest_submit(CDASH_UPLOAD <file> [CDASH_UPLOAD_TYPE <type>]
             [SUBMIT_URL <url>]
             [BUILD_ID <result-var>]
             [HTTPHEADER <header>]
             [RETRY_COUNT <count>]
             [RETRY_DELAY <delay>]
             [RETURN_VALUE <result-var>]
             [QUIET])

第二個簽章用於透過 CDash 檔案上傳 API 將檔案上傳到 CDash。API 首先向 CDash 發送上傳請求以及檔案的內容雜湊。如果 CDash 尚未擁有該檔案，則會上傳該檔案。與檔案一起，指定 CDash 類型字串，以告知 CDash 要使用哪個處理常式來處理資料。

此簽章以與第一個簽章相同的方式解譯選項。

在版本 3.8 中新增：新增了 RETRY_COUNT、RETRY_DELAY、QUIET 選項。

在版本 3.9 中新增：新增了 HTTPHEADER 選項。

在版本 3.13 中新增：新增了 RETURN_VALUE 選項。

在版本 3.14 中新增：新增了 SUBMIT_URL 選項。

在版本 3.15 中新增：新增了 BUILD_ID 選項。