ctest_coverage

执行 CTest 覆盖率步骤 作为 Dashboard 客户端。

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>

将 0 存储到 <result-var> 变量中，如果覆盖率工具运行无错误，则为非零。

CAPTURE_CMAKE_ERROR <result-var>

3.7 版本中新增。

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

QUIET

3.3 版本中新增。

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