ctest_coverage

作为 Dashboard Client 执行 CTest Coverage Step。

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 文件中。

标签

过滤覆盖率报告，仅包含被标记了指定标签中至少一个标签的源文件。

RETURN_VALUE <result-var>

如果覆盖率工具运行正常，则将 <result-var> 变量设置为 0，否则设置为非零值。

CAPTURE_CMAKE_ERROR <result-var>

3.7 版本中新增。

如果运行命令时有任何错误，则在 <result-var> 变量中存储 -1，并防止 ctest 在发生错误时返回非零值。

QUIET

3.3 版本中新增。

抑制任何 CTest 特定的非错误输出，否则这些输出将被打印到控制台。指示覆盖了多少行代码的摘要不受此选项的影响。