开源项目地址
https://gitee.com/didiopensource/super-jacoco
项目流程
项目架构
部署步骤
注意:一定要用Linux服务器部署,不要用Windows
准备Linux服务器环境
- 安装好JDK1.8
- 安装好git
- 安装和配置好Maven3.6,或3.6以下
- 安装MySQL数据库(尽量不用8版本,就用5.7、5.8版本)
拉取super-jacoco开源项目
git clone https://gitee.com/didiopensource/super-jacoco.git
初始化MySQL
- 建立数据库:super-jacoco
- 建立数据表:执行 sql/db.sql 文件
- 修改 application.properties 文件中的数据库配置
# 以下信息需要手动配置 spring.datasource.url=jdbc:mysql://IP:端口/super-jacoco?useUnicode=true&characterEncoding=utf8&verifyServerCertificate=false&useSSL=false spring.datasource.username=super-jacoco的数据库账号 spring.datasource.password=super-jacoco的数据库密码 #spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver #git username & password gitlab.username=被测项目的的git账号 gitlab.password=被测项目的的git密码
编译super-jacoco开源项目
生成super-jacoco.jar
mvn package -Dmaven.test.skip=true
部署super-jacoco
- 进入super-jacoco项目,把 cli.jar 复制到用户主页
cd super-jacoco/jacoco cp org.jacoco.cli-1.0.2-SNAPSHOT-nodeps.jar ~
- 把 runtime.jar 传送到被测项目服务器的 jar 包位置
scp org.jacoco.agent-0.8.5-runtime.jar root@被测项目服务器IP:/root/www/xxx/back/
- 启动super-jacoco
nohup java -jar super-jacoco.jar &
启动后的默认端口号为:8899
- super-jacoco服务器的防火墙规则自己设置
被测项目用 super-jacoco-runtime.jar 来启动
java -javaagent:/root/www/xxx/back/org.jacoco.agent-0.8.5-runtime.jar=includes=*,output=tcpserver,port=18513,address=*,append=true,destfile=/jacoco.exec -jar /root/www/xxx/back/springboot-0.0.1-SNAPSHOT.jar
附上 jacoco 启动参数
-executioindataonly: 仅生成执行数据,不生成报告。 -agentlib: 指定JaCoCo代理库,用于Java程序。 -agentpath: 指定JaCoCo代理库,用于C / C ++程序。 =destfile: 指定覆盖已有的执行数据文件的路径。 =append: 指定追加到现有执行数据文件的路径。 =includes: 指定哪些类的方法应包含在覆盖率分析中,使用逗号分隔。 =excludes: 指定哪些类的方法应排除在覆盖率分析之外,使用逗号分隔。 =classpath: 指定JaCoCo用于查找类文件的类路径。 =classpathfile: 指定包含类路径条目的文件。 =jmxfile: 指定JMX文件的路径,用于远程应用程序。 =output: 指定报告生成的目录。 =report-aggregate: 指定聚合报告的路径。 =dump-on-exit: 在JVM退出时转储执行数据。
使用覆盖率检测
启动覆盖率检测
- 准备一个不会重复的,没有使用过的 UUID
- 被测项目地址
- 被测项目上一次代码的版本ID
- 被测项目目前代码的版本ID
- 被测项目的地址
- 被测项目的 super-jacoco-runtime.jar 的端口(按照上面的启动参数就是:18513)
去被测项目进行测试,测试一段时间后,造成足够的代码覆盖
获取覆盖率收集
把启动覆盖率时的 UUID 拿来获取覆盖率
失败的场景
- 失败了也有日志文件
- 失败了的日志文件内容可能是空的,这种情况一般就是:下载项目代码后,编译失败了
成功的场景
查看覆盖率报告
整个Java项目
Java实现类列表
Java实现类