Jacoco覆盖率工具使用

Jacoco介绍

Jacoco是一个开源的覆盖率工具。Jacoco可以嵌入到Ant 、Maven中，并提供了EclEmma Eclipse插件,也可以使用JavaAgent技术监控Java程序。很多第三方的工具提供了对Jacoco的集成，如sonar、Jenkins等。

官网地址：http://www.eclemma.org/jacoco/

Java Counters

Jacoco包含了多种尺度的覆盖率计数器,包含指令级(Instructions,C0coverage)，分支（Branches,C1coverage）、圈复杂度(CyclomaticComplexity)、行(Lines)、方法(non-abstract methods)、类(classes)。

 

如上图所示，标示绿色的为分支覆盖充分，标黄色的为部分分支覆盖，标红色的为未执行该分支。

支持的集成工具

Jacoco团队提供了如下的一些集成工具的支持：

Java API

http://www.eclemma.org/jacoco/trunk/doc/api/index.html

Command Line

       http://www.eclemma.org/jacoco/trunk/doc/agent.html

Apache Ant

       http://www.eclemma.org/jacoco/trunk/doc/ant.html

Apache Maven

       http://www.eclemma.org/jacoco/trunk/doc/maven.html

Eclipse EclDmma Plugin

       http://www.eclemma.org/

下面介绍使用ant工具的方法，将使用一个web工程做完示例讲解。

Apache Ant的使用

web工程图

 

执行ant  file task：all-report

执行ant file后生成报告report目录如图所示：

 

测试报告

可以单独运行命令：anttest-report生成测试报告；

执行之后会在build/report/html生成测试报告，其中打开index.html如下所示。下

单击： 进入：

展示测试类名称、测试方法名称 、测试状态 success or fail 、类型及执行时间：

 

测试用例覆盖率

可以单独执行命令：antcoverreport；

执行之后会在build/report/coverage下生成覆盖报告，其中打开index.html如下所示：

 

单击包名称一层一层单击进入：

具体颜色定义查看上面的介绍。

Jacoco与jenkins，sonar集成

Jenkins中构建简单配置

 

图仅供参考。

Jacoco与jenkins集成

首先jenkins安装jacoco插件，如图所示：

建议使用jenkins插件管理进行安装；

对应的Jenkins插件见https://wiki.jenkins-ci.org/display/JENKINS/JaCoCo+Plugin

配置jacoco插件

在“Addpost-build action”中选择“”，如图所示：

 

配置如下部分：

 

第一个部分：代码覆盖率统计文件位置；

第二个部分：classes文件位置；

第三个部分：源码文件位置；

 

根据需要填写百分比；

 

Jacoco 与sonar集成

在项目跟目录下面新建一个sonar-project.properties，如web图所示。

编辑此文件：

 

执行sonar，配置jenkins部分

 

只需要执行sonar-runner即可，前提是将jenkins与sonar-runner集成在一起；

运行jenkins，执行构建任务

 

看到类似结果，表示构建结束。

至此，可以通过jenkins查看代码覆盖率等信息。

单击进入测试项目：

 

 

单击“CodeCoverage Trend“部分，进入详细页面：

单击进入详细的覆盖率文件：

SonarQube展示

进入sonarqube项目：http://172.16.XXX.XXX9000/

单击工程jacoco_test_project：

进入详细页面：

其中圈中左边为单元测试覆盖率，右边为单元测试统计；

 

单击进入

 

通过下拉框选择查看行覆盖情况，未覆盖行情况，分支覆盖情况，未覆盖分支情况；

 

 

单击 进入测试情况信息页面：

 

如果存在错误，此部分会展示错误情况。