jacoco是一个开源的覆盖率根据
针对开发语言java 嵌入到ant maven里,可作为eclipse插件,可以
sonar jenkins提供了它的集成
覆盖率计数器:
tcpserver方式插桩,某个端口上开启一个tcp服务,监听保存,api方式连接tcp,进行覆盖率数据的dump操作
- 行覆盖率-Lines--onthefly
- 类覆盖率-Classes-度量计算class类文件是否被执行
- 分支覆盖率-Non-abstract Methods--if,switch
- 方法覆盖率-branches C1
- 指令覆盖-instrumentation C0
- 券复杂度-Cyclomatic Complexity
两种插桩模式
- onthefly插桩 -javaahent参数指定特定的jar文件,启动instrumentation的代理程序
--更方便,不用提前进行字节码插桩,无需考虑classpath的设置
--以下情况不适用:部署环境不支持javaagent,部署环境不允许设置jvm参数,动态修改字节码过程中和其它agent有冲突,无法自定义用户加载类 - offline模式 -再测试前先对文件进行插桩,然后生成查过桩的class或jar包
例如: -javaagent:[yourpath/]jacocoagent.jar=[option1]=[value1],[option2]=[value2]
mvn clean install
执行命令后的 target 目录
报告解读
首先我们需要知道报告中各种标记的含义,代码的背景颜色代表这一行的行覆盖情况:
- 红色背景:这一行没有任何指令被执行;
- 黄色背景:这一行有部分指令被执行;
- 绿色背景:这一行的所有指令都被执行了;
代码前方的菱形则代表这一行的分支覆盖情况,在if-else或者switch等逻辑分支语句前会出现:
- 红色菱形:这一行没有分支被执行;
- 黄色菱形:这一行有部分分支被执行;
- 绿色菱形:这一行的所有分支都被执行了;
(1)精确定位代码逻辑错误
(2)快速发现测试遗漏or冗余代码
在测试过程中,出现大量代码未覆盖的情况怎么办?很简单,去找开发了解这部分的代码逻辑:如果是测试遗漏的,反向补充用例,有目标的查漏补缺;如果是废弃代码,则提醒开发删除,有效去除项目中的冗余代码。
接入过程开发无感知,不需要修改代码,降低推广难度;
测试过程中如果需要,也支持多次更新报告;
多次部署,合并为一份报告,方便后续进行测试分析;
整个流程全自动收集,即使是没有测试参与的项目,覆盖率数据也尽在掌握。
maven package
打包被测项目
mvn package -Dmaven.test.skip=true
mvn clean package -Dmaven.javadoc.skip=true -Dmaven.test.skip=true
进入jacoco\target目录,解压刚打的包jacoco-0.8.5.202006300741.zip
使用压缩软件打开jacocoagent.jar,删除META-INF目录下.SF,.DSA,*.RSA文件
使用压缩软件打开jacococli.jar,删除META-INF目录下.SF,.DSA,*.RSA文件
使用压缩文件打开jacococli.jar,删除com\jcraft\jsch(只删除jsch目录)
使用压缩文件打开jsch-0.1.55.jar,将其中\com\jcraft\jsch拷贝到jacococli.jar\com\jcraft\目录下
进入jacoco\target目录,解压刚打的包,启动被测项目
java
-javaagent:D:\Java\jacoco-0.8.7\lib\jacocoagent.jar=
includes=*(项目包路径所有过滤,*所有class),
output=(启动项目的两种方案,file或者tcpserver)tcpserver,
port=9999,(监听和dump端口)
address=127.0.0.1,(对外开放的tcpserver访问地址)
append=true(原文件末尾进行追加,false是覆盖)
-jar ..\target\demo-0.1.jar
java -javaagent:D:\yule\jacoco-0.8.7\lib\jacocoagent.jar=includes=*,output=tcpserver,port=9999,address=127.0.0.1,append=true-jar ..\target\demo-0.1.jar
java -javaagent:D:\yule\jacoco-0.8.7\lib\jacocoagent.jar=includes=*,output=tcpserver,port=2020,address=localhost,append=true -jar xprice.jar
java -jar D:\yule\jacoco-0.8.7\lib\jacococli.jar dump --address localhost --port 2020 -destfile .\report\res.exec
java -jar D:\yule\jacoco-0.8.7\lib\jacococli.jar dump --address localhost --port 2020 --destfile zdh.exec
java -jar D:\yule\jacoco-0.8.7\lib\jacococli.jar report .\report\zdh.exec --classfiles \classes\com --sourcefiles ..\src\main\java --html .\html-report --xml .\report.xml
生成覆盖率exec文件
java -jar D:\Java\jacoco-0.8.7\lib\jacococli.jar dump --address 127.0.0.1 --port 9999 -destfile .\report\res.exec
全量报告-生成html以及xml报告
java -jar D:\Java\jacoco-0.8.7\lib\jacocoagent.jar report .\report\res.exec --classfiles ..\target\classses\com --sourcefiles ..\src\main\java --html .\html-report --xml .\report.xml
基于分支的增量报告
java -jar F:\jacoco-0.8.5.20200630074\lib\jacococli.jar report zdh.exec --type 2 --gitName zhangfei --gitPassword 123456 --gitDir E:\workspace\zdh --newBranchName dev1 --oldBranchName dev2 --classfiles E:\workspace\zdh\target\classes\com --sourcefiles E:\workspace\zdh\src\main\java --html report --xml report.xml
基于tag的增量报告
java -jar F:\jacoco-0.8.5.20200630074\lib\jacococli.jar report zdh.exec --gitName zhangfei --gitPassword 123456 --gitDir E:\workspace\zdh --branchName master --newTag 49117d1 --oldTag f1563cc --classfiles E:\workspace\zdh\target\classes\com --sourcefiles E:\workspace\zdh\src\main\java --html report --xml report.xml
参数意思
classfiles,编译后的class目录
sourcefiles,源文件目录,理论可以不传,不传的话 只能到文件级的展示,再细 需要具体代码和行数就需要这个了
以下是新增的参数说明
type,分析类型,1全量,2基于分支增量,3基于tag增量,不传默认等于3
gitDir,git本地目录,只有type=2或者3时需要此参数,不传默认当前目录
gitName,git用户名,只有type=2或者3时需要此参数
gitPassword,git密码,只有type=2或者3时需要此参数
branchName,分支名称,type=3时需要此参数,不传默认master
newTag,新tag(预发版本),type=3时需要此参数