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 特有非錯誤輸出。指示涵蓋了多少程式碼行的摘要不受此選項影響。