CTEST_COVERAGE_COMMAND

版本 3.1 中新增。

在 ctest(1) dashboard 客户端脚本中指定 CTest 的 CoverageCommand 设置。

Cobertura

在您的多模块 Java 项目中使用 Cobertura 作为代码覆盖率生成工具，可以生成一系列 XML 文件。

Cobertura Coverage 解析器期望从单个 XML 文件中读取代码覆盖率数据，该文件包含所有模块的代码覆盖率数据。Cobertura 提供了一个程序，能够合并给定的 cobertura.ser 文件，然后另一个程序可以从之前合并的文件生成一个合并的 XML 文件。对于命令行测试，可以在 CTest 查找代码覆盖率文件之前手动完成此操作。对于脚本构建，请将 CTEST_COVERAGE_COMMAND 变量设置为指向执行这些相同步骤的文件，例如 .sh 或 .bat 文件。

set(CTEST_COVERAGE_COMMAND .../run-coverage-and-consolidate.sh)

其中 run-coverage-and-consolidate.sh 脚本可能由 configure_file() 命令创建，并且可能包含以下代码

#!/usr/bin/env bash
CoberturaFiles="$(find "/path/to/source" -name "cobertura.ser")"
SourceDirs="$(find "/path/to/source" -name "java" -type d)"
cobertura-merge --datafile coberturamerge.ser $CoberturaFiles
cobertura-report --datafile coberturamerge.ser --destination . \
                 --format xml $SourceDirs

该脚本使用 find 命令捕获项目源目录下的所有 cobertura.ser 文件的路径。它会保留文件列表，并将其作为参数传递给 cobertura-merge 程序。`--datafile` 参数指定合并结果将保存在何处。

然后使用合并的 coberturamerge.ser 文件通过 cobertura-report 程序生成 XML 报告。调用 cobertura-report 程序需要一些命名参数。

--datafila

合并的 .ser 文件的路径

--destination

放置输出文件(s)的路径

--format

写入输出的文件格式：xml 或 html

其余提供的参数是源树中每个模块的 /src/main/java 目录的完整路径。需要这些目录，不应忘记。