ctest_coverage

作为 仪表板客户端 执行 CTest 覆盖步骤。

ctest_coverage([BUILD <build-dir>] [APPEND]
               [LABELS <label>...]
               [RETURN_VALUE <result-var>]
               [CAPTURE_CMAKE_ERROR <result-var>]
               [QUIET]
               )

收集覆盖率工具结果并将它们存储在“Coverage.xml”中，以便使用 :command:“ctest_submit”命令提交。

选项是：

构建<构建目录>

指定顶级构建目录。如果未给出，则使用 CTEST_BINARY_DIRECTORY 变量。

追加

标记 Coverage.xml 以追加到自上次 ctest_start 调用以来提交到仪表板服务器的结果。追加语义由正在使用的仪表板服务器定义。这 不会 导致将结果附加到先前调用此命令生成的 .xml 文件中。

标签

过滤覆盖率报告以仅包括标有至少一个指定标签的源文件。

RETURN_VALUE <result-var>

如果覆盖工具运行没有错误，则存储在 <result-var> 变量 0 中，否则为非零。

CAPTURE_CMAKE_ERROR <result-var>

在 3.7 版本加入.

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

安静

在 3.3 版本加入.

抑制任何本应打印到控制台的特定于 CTest 的非错误输出。指示涵盖了多少行代码的摘要不受此选项的影响。