ctest_coverage

執行 CTest 覆蓋率步驟 作為 儀表板用戶端。

ctest_coverage([BUILD <build-dir>] [APPEND]
               [LABELS <label>...]
               [RETURN_VALUE <result-var>]
               [CAPTURE_CMAKE_ERROR <result-var>]
               [QUIET]
               )

收集覆蓋率工具結果並將其儲存在 Coverage.xml 中，以便與 ctest_submit() 命令一起提交。

選項如下

BUILD <build-dir>

指定頂層建置目錄。如果未給定，則使用 CTEST_BINARY_DIRECTORY 變數。

APPEND

將 Coverage.xml 標記為附加到自上次 ctest_start() 呼叫以來，先前提交到儀表板伺服器的結果。附加語意由使用中的儀表板伺服器定義。這不會導致結果附加到先前呼叫此命令產生的 .xml 檔案。

LABELS

篩選覆蓋率報告，僅包含標記有至少一個指定標籤的原始碼檔案。

RETURN_VALUE <result-var>

如果覆蓋率工具執行時沒有錯誤，則在 <result-var> 變數中儲存 0，否則儲存非零值。

CAPTURE_CMAKE_ERROR <result-var>

在版本 3.7 中新增。

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

QUIET

在版本 3.3 中新增。

抑制任何原本會列印到主控台的 CTest 特定非錯誤輸出。指示覆蓋了多少行程式碼的摘要不受此選項影響。