1. 安装必要工具
在Debian系统上,首先需要安装Java开发环境、构建工具(如Maven)和代码覆盖率工具(以JaCoCo为例)。通过以下命令完成安装:
sudo apt update
sudo apt install openjdk-11-jdk maven
JaCoCo通常通过构建工具(如Maven)的插件形式集成,无需单独安装。
2. 配置JaCoCo插件(Maven项目)
若使用Maven构建项目,需在项目的pom.xml文件中添加JaCoCo插件的配置。配置内容包括:准备测试代理(prepare-agent)、生成覆盖率报告(report)。示例如下:
<build>
<plugins>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.7</version> <!-- 使用最新稳定版本 -->
<executions>
<execution>
<goals>
<goal>prepare-agent</goal> <!-- 测试前准备代理,注入覆盖率检测代码 -->
</goals>
</execution>
<execution>
<id>report</id>
<phase>test</phase> <!-- 在测试阶段执行 -->
<goals>
<goal>report</goal> <!-- 生成HTML格式覆盖率报告 -->
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
此配置会自动在测试过程中收集覆盖率数据,并生成报告。
3. 运行测试并生成报告
在项目根目录下执行以下Maven命令,运行单元测试并生成覆盖率报告:
mvn clean test
命令执行完成后,报告会自动生成在target/site/jacoco/目录下,其中index.html是主报告文件。
4. 查看与分析报告
使用浏览器打开target/site/jacoco/index.html文件,即可查看详细的代码覆盖率信息。报告包含以下核心指标:
5. 可选:集成到持续集成(CI)系统
若项目使用Jenkins、GitLab CI等CI工具,可将JaCoCo集成到CI流程中,实现每次构建自动生成覆盖率报告。以Jenkins为例,步骤如下:
mvn clean test;target/site/jacoco/index.html。