文档章节

基于 Jenkins + JaCoCo 实现功能测试代码覆盖率统计

Jenkins中文社区
 Jenkins中文社区
发布于 05/22 22:19
字数 1986
阅读 640
收藏 18

本文首发于:Jenkins 中文社区

hangzhou

使用 JaCoCo 统计功能测试代码覆盖率?

对于 JaCoCo,有所了解但又不是很熟悉。 "有所了解"指的是在 CI 实践中已经使用 JaCoCo 对单元测试代码覆盖率统计: 当代码 push 到代码仓库后,用 JaCoCo 进行单元测试代码覆盖率统计,并将相应数据推送到 SonarQube。 "不是很熟"指的是应用场景也仅限于此,并未进行过多研究与实践。

前不久,有测试同事提出,想要在实际测试时,用 JaCoCo 统计功能测试代码覆盖率。 其主要目的是在经过功能测试后,通过查看代码覆盖率统计的相关指标,增强对软件质量的信心。 经查阅资料,证明这是可行的。

由于对 JaCoCo 不甚了解,于是查阅官网资料对 JaCoCo 进一步了解。

进一步了解 JaCoCo

JaCoCo,即 Java Code Coverage,是一款开源的 Java 代码覆盖率统计工具。 它由 EclEmma 团队根据多年来使用和集成现有库的经验教训而创建。

JaCoCo 愿景

JaCoCo 应该为基于 Java VM 的环境中的代码覆盖率分析提供标准技术。 重点是提供一个轻量级的、灵活的、文档良好的库,以便与各种构建和开发工具集成。

JaCoCo 产品功能

  • 指令(C0)、分支(C1)、行、方法、类型和圈复杂度的覆盖率分析。
  • 基于 Java 字节码,因此也可以在没有源文件的情况下工作。
  • 通过基于 Java agent 的实时检测进行简单集成。其他集成场景(如自定义类加载器)也可以通过 API 实现。
  • 框架无关性:平稳地与基于 Java VM 的应用程序集成,比如普通 Java 程序、OSGi 框架、web 容器或 EJB 服务器。
  • 兼容所有已发布的 Java 类文件版本。
  • 支持不同的 JVM 语言。
  • 支持几种报告格式( HTML、XML、CSV )。
  • 远程协议和 JMX 控件,以便在任何时间点从覆盖率 agent 请求执行数据 dump 。
  • Ant 任务,用于收集和管理执行数据并创建结构化覆盖报告。
  • Maven 插件,用于收集覆盖信息并在Maven构建中创建报告。

非功能特性

  • 使用简单和与现有构建脚本和工具集成。
  • 良好的性能和最小的运行时开销,特别是对大型项目。
  • 轻量级实现,对外部库和系统资源的依赖性最小。
  • 全面的文档。
  • 完整文档化的 API ( JavaDoc ) 和用于与其他工具集成的示例。
  • 回归测试基于 JUnit 测试用例,具有完整的功能测试覆盖率。

对 JaCoCo 可以与现有构建脚本和工具进行集成这里做进一步说明: 官方提供了 Java API、Java Agent 、CLI、Ant 、Maven、Eclipse 这几种集成方式; 第三方提供了诸如与 Gradle、IDEA、Jenkins 等其它工具的集成方式。

抛开理论,开始实践

JaCoCo 不仅支持统计本地服务的代码覆盖率,也支持统计远程服务的代码覆盖率。 单元测试覆盖率统计就是统计本地服务的代码覆盖率,代码和运行的服务在一台机器上,笔者这里通过使用 JaCoCo Maven 插件完成的。 而功能测试代码覆盖率统计则是统计远程服务的代码覆盖率,代码和运行的服务一般不在一台机器上,这里需要借助 JaCoCo Java agent 实现。

备注:实际上,JaCoCo Maven 插件也使用了 JaCoCo Java agent,不过用户不需要直接关系 Java agent 及其选项,Maven 插件都透明地处理了。

1、下载 JaCoCo 分发包

可以从 JaCoCo 官网下载分发包,也可以从 Maven 仓库(中央仓库或私服)下载。 分发包的 lib 目录下,包括以下库:

2、Java 应用启动脚本添加 jacocoagent 相关 JVM 参数

需要将 jacocoagent.jar 推送到部署应用的服务器上,笔者这里用 Ansible 进行了批量推送。 Java 应用启动脚本需要加入类似下面的 JVM 参数:

JAVA_OPTS="$JAVA_OPTS -javaagent:/path/jacocoagent.jar=includes=*,output=tcpserver,append=false,address=$IP,port=$JACOCO_PORT"

这样在应用成功启动后,会暴露一个 TCP 服务,客户端可以连接到这个服务并获取执行数据文件。

相关属性说明如下:

  • append:其中 append=false 表示 dump 每次会生成一个新的执行数据文件,如果 append=true,dump 时则会将数据追加到已存在的执行数据文件。 其中 output=tcpserver 表示 agent 监听来自被 adrress 和 port 属性指定的TCP 端口的连接,执行数据被写到这个连接;
  • output:如果 output=tcpclient 则表示在启动时,agent 连接到被 adrress 和 port 属性指定的TCP 端口,执行数据被写到这个连接; 如果 output=file 则表示在 JVM 终止时,执行数据被写到被 destfile 属性指定的文件。output 默认值为 file 。
  • address:当 output 为 tcpserver 时绑定到的 IP 地址或主机名,或者当 output 为 tcpclient 时连接到的 IP 地址或主机名。 在 tcpserver 模式下,值为“*”导致代理只接受本机地址上的连接。address 默认值为 127.0.0.1 。
  • port:当 output 方式为 tcpserver 时绑定到该端口,或者当 output 方式为 tcpclient 时连接到该端口。 在 tcpserver 模式下,端口必须可用,这意味着如果多个 JaCoCo agent 在同一台机器上运行,则必须指定不同的端口。port 默认值为 6300 。

3、创建及配置 Jenkins Pipeline 任务

Jenkins 任务大致有几个步骤:拉取代码,构建,dump 应用执行数据( jacoco.exec ),解析 JaCoCo 产生的 jacoco.exec 文件,然后生成覆盖率报告(HTML 格式)。 拉取代码这里无需多说,配置下从代码仓库(SVN/Git)和分支地址就可以了,比较简单。 构建这里用了 Jenkins Pipeline Maven Integration Plugin ,笔者这里所用的 Maven 命令是 mvn clean package -Dmaven.test.skip=true 。 dump 应用执行数据这里有多种方式:Ant、CLI、Maven,因为Java 应用是用 Maven 构建的,这里选择了 Maven Jacoco Plugin。 解析 JaCoCo 产生的 jacoco.exec 文件,然后生成覆盖率报告(HTML 格式)笔者这里使用了 Jenkins Jacoco Plugin。

Jenkins Pipeline 案例如下:

pipeline {
    agent any
    tools {
        jdk 'JDK1.8'
    }
    stages {
        stage('Checkout'){
            steps{
                git branch: '${GIT_BRANCH}', credentialsId: 'xxx-xxx-xx-xx-xxx', url: '${GIT_URL}'
            }
        }
        stage('Build') {
            steps{
                withMaven(maven: 'maven'){
                      sh "mvn clean package -Dmaven.test.skip=true"
                }
            }
        }
        stage('DumpFromServer'){
            steps {
                withMaven(maven: 'maven'){
                      sh 'mvn org.jacoco:jacoco-maven-plugin:0.8.4:dump -Djacoco.address=${SERVER_IP} -Djacoco.port=${JACOCO_PORT}'
                }
            }
        }
        stage('JacocoPublisher') {
            steps {
                 jacoco()
            }
        }
    }
}

JaCoCo 覆盖率报告,部分截图如下:

coverage-summary

总结

笔者所实现的方式并未覆盖任何场景,但是大同小异,相关工具的使用详情可以查看官网文档,因为它是最全面的。 笔者希望这个实践能给有类似诉求的同行一些参考,当然笔者也希望能够和大家互相交流。 同时笔者的 JaCoCo 实践之路并未结束,可能在使用的过程中会有一些问题需要解决, 后续也将考虑使用 Jenkins API 为需要统计功能测试代码覆盖率的 Java 应用实例自动生成一个对应的 Jenkins 任务, 并在 Java 应用实例销毁后,对相应的 Jenkins 任务进行清理等其它功能。

参考

作者:王冬辉

© 著作权归作者所有

Jenkins中文社区

Jenkins中文社区

粉丝 24
博文 33
码字总数 54218
作品 0
杭州
私信 提问
Jacoco 统计E2E的代码覆盖率

原本一直以为代码覆盖率只能单测能搞,后来听了MTSC大会的一个分享,发现这东西E2E测试也是可以搞,而且这东西搞好来想想对精准测试帮助非常大。 于是花了点时间搞了个demo,并写了这个简单的...

米阳MeYoung
2018/08/16
0
0
如何使用Jacoco远程统计tomcat服务的代码覆盖率

如何使用Jacoco远程统计tomcat服务的覆盖率 在做软件开发的时候经常会遇到做各种测试,这里介绍一种本人遇到的:代码覆盖率测试, 这个测试非常实用,能发现许多无效的模块和代码。强烈推荐!...

明舞
2015/08/12
0
7
Android自动化单元测试(下)

承接上文 上一篇单元测试讲了如何在Android Studio中写测试用例,自动化测试并生成测试报告,这一篇主要讲一下扩展工具的使用。 jacoco代码覆盖率   jacoco是一个检测代码覆盖率的插件工具...

jara0705
2018/01/10
0
0
jacoco-maven-plugin 父子工程 远程获取覆盖率

1 修改父子工程web项目内pom 在build->plugins下增加 执行mvn install -Dmaven.test.skip=true 2 修改启动文件,并重启应用 下载jacoco的zip文件,解压安装在/home/tools/bin/下 3 IDEA目录中执...

刘泓
2017/11/02
0
0
Maven结合SonarQube的使用笔记

前提:1,SonarQube已经安装好且已经安装了sonar-php-plugin,并且在测试服务器上也安装并配置好了sonar-scanner2,安装了Maven这个非常简单,直接从官网上下载Maven的zip包,解开然后配置下...

Kevin6188
2016/08/02
750
0

没有更多内容

加载失败,请刷新页面

加载更多

技术分享 | delete大表slave回放巨慢的问题分析

原创作者: 洪斌 问题 在master上执行了一个无where条件delete操作,该表50多万记录。binlog_format是mixed模式,但transaction_isolation是RC模式,所以dml语句会以row模式记录。此表没有主键...

爱可生
19分钟前
1
0
Tableau BI工具对接 AnalyticDB for PostgreSQL数据源

AnalyticDB for PostgreSQL(原HybridDB for PostgreSQL)作为高性能分析型数据库,可以支持用户对其业务数据进行实时分析,能够让企业敏锐感知市场动态,做出必要决策。 Tableau是一款数据分...

阿里云云栖社区
19分钟前
2
0
《后端架构师技术图谱》

推荐: 《Java技术书籍大全》 - awesome-java-books 从初级开发者到资深架构师,看这些书就够了 数据结构 队列 集合 链表、数组 字典、关联数组 栈 树 二叉树 完全二叉树 平衡二叉树 二叉查找...

哥本哈根的小哥
25分钟前
2
0
iTOP-4418开发板-QtE5.7系统-10.1寸屏触摸

本文档介绍 iTOP-4418开发板的 QtE 系统(QtE5.7 的需要修改,QtE4.7 默认支持)的 10.1 寸屏触摸的配置方法。 目前迅为的触摸屏从驱动芯片的方案区分,主要为:TSC2007 系列、ft5x0x_ts 系列...

书白
30分钟前
0
0
linux 脚本文件,后台运行jar包并输出日志

#!/bin/bash#chkconfig: 345 90 10#description: Starts and stops the shaungluJava daemon.######################################################################### Purpose:......

west_coast
37分钟前
1
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部