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 版中添加。

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

QUIET

在 3.3 版中添加。

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