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 的非错误输出。指示覆盖了多少行代码的摘要不受此选项的影响。