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

标签

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

RETURN_VALUE <result-var>

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

CAPTURE_CMAKE_ERROR <result-var>

3.7 版本中新增。

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

QUIET

3.3 版本中新增。

抑制任何本应打印到控制台的 CTest 特定的非错误输出。 此选项不会影响指示覆盖代码行数的摘要。