EMMA 覆盖率工具

1. EMMA 介绍

EMMA 是一个开源、面向 Java 程序测试覆盖率收集和报告工具。它通过对编译后的 Java 字节码文件进行插装，在测试执行过程中收集覆盖率信息，并通过支持多种报表格式对覆盖率结果进行展示。EMMA可以统计几种覆盖率：class，method，block, line。支持版本迭代的覆盖率统计

2. EMMA 使用

EMMA基本是四步曲：插桩（instr），运行，收集（ctl），报告（report）。下面分别详细的介绍下

2.1 安装

下载地址：http://sourceforge.net/projects/emma/files/emma-testing/

目前流行使用的是v2.1.*,因为支持ctl命令

将emm.jar cp /usr/local/jdk/jre/lib/ext 下面，安装完成

2.2 插桩

command：java emma instr -cp /usr/local//anrs/lib/anrs.jar -m overwrite -ix +com.* -Dmetadata.out.file=test.em

参数介绍：

-cp，指定插桩的路径，多个jar包可以用，分割

-m：输出模式

overwrite:重新jar包，anrs.jar

default:copy, 需要加上-d参数，指定输出路径。有插桩，才cp一份class到指定路径

fullcopy:需要加上-d参数，指定输出路径。不管有没有插桩，都cp一份class到指定路径

-merge:合并。

default：yes。如果metadata指定输出的文件一样，将两次插桩信息进行合并

no。不合并两次插桩信息

-ix:指定需要插桩的class

+com.*: + 指包含

-com.*：-指排除

支持多个+和-，用逗号分隔

这个功能对我们关注被改动的代码很有作用

-Dmetadata.out.file: 指定元数据（metadata）输出路径。默认是当前路径

我们在测试过程中，一般都会去更新几次jar包，并且我们希望统计出这个版本测试的覆盖率，我们就需要把几次的元数据进行合并

2.3 运行

一般情况下，直接运行应用程序即可。EMMA会启动一个监听端口，用来后面收集信息（ctl）。这个端口是固定的，47653。

如果我们的应用是多进程的，就会出现启动失败。

其实EMMA也提供了一个命令，进行端口设置：-Demma.rt.control.port=39123

还有host指定，-Demma.rt.control.host=192.168.22.22. default is localhost

这个参数需要加在程序启动命令里

EMMA还有简单的配置文件：java -Demma.properties=my.properties

my.properties format: tag=value

可以配置的参数参考：http://emma.sourceforge.net/reference/ch03s02.html#prop-ref.tables

2.4 收集

一般有两种收集信息方法：

1. 程序退出，自动收集，在当前运行目录下生成coverage.ec

2. 命令行：

java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.get,coverage.ec

合并.ec文件

由于 EMMA 中测试覆盖率是通过与 “*.em” 文件关联获得代码信息的，因此当代码发生变化时，已经运行过的测试不必完全重复，只需将得到的 “*.ec” 文件合并（新得到的 “*.ec” 文件放在后面），然后关联最新的 “*.em” 文件即可得到代码变化后的覆盖率信息，这方便了 EMMA 支持版本变化的测试。在生成新的测试报告的时候，需要注意 “*.ec” 的时间一定要晚于 “*.em” 文件。

1. 自动合并。如果生成的.ec文件名字相同，自动合并。

2. 命令行合并：java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma merge -input SM1.ec, SM2.ec -outfile SM.ec

.ec 文件需要按照时间从前到后排列，才能保证合并信息正确(参考网上说法。但我测试的结果发现，自动合并与merge合并的结果不一致，自动合并的结果更准确。所以最好使用自动合并)

默认合并为coverage.es。

貌似现在的版本outfile参数不起作用，都会合并为coverage.es

清除执行统计信息

如果我们想要每个测试用例的独立覆盖率报告，需要将内存中的执行信息清除掉。

目前有两种清除方法：

1. 重启应用

2. 命令行：reset

java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.reset

reset只能清除内存中记录的方法、块、行的执行信息，但是无法清除类覆盖信息。

2.5 report

command：

java -cp /usr/jdk/jdk1.6.0_29/jre/lib/ext/emma.jar emma report -r html -in anrs.em coverage.ec –sp src/-Dreport.html.out.file=coverage.html

参数介绍

-r: report type:html,txt,xml

-sp: sourcecode path

3. 会碰到的问题（来源于网上介绍，refer to

<http://www.51testing.com/?uid-170805-action-viewspace-itemid-87390>

）

3.1 issue1

"emma ctl:

coverage.get: RPC failure while executing [coverage.get]

Exception in thread "main" com.vladium.emma.EMMARuntimeException: coverage.get:

RPC failure while executing [coverage.get]

at com.vladium.emma.ctl.CtlProcessor._run(CtlProcessor.java:242)"

需要在应用执行目录下进行插桩，就可以解决这个issue

3.2 issue2

Exception in thread "main" java.lang.NoClassDefFoundError: com/vladium/emma/rt/R

at org.apache.jmeter.NewDriver.$VRi(NewDriver.java)

at org.apache.jmeter.NewDriver.<clinit>(NewDriver.java)

errorlevel=1

由于java加载ApacheJMeter.jar包时ClassLoader顺序非预期，通过-

Xbootclasspath/p:E:\alibaba\tools\emma-stable-2.1-lib\emma.jar 强制优先加载emma.jar。

故修改应用启动脚本为（以jemeter为例）

%JM_START% %JM_LAUNCH% -Xbootclasspath/p:E:\alibaba\tools\emma-stable-2.1-lib\emma.jar %

JVM_ARGS% %ARGS% -jar "%JMETER_BIN%ApacheJMeter.jar" %JMETER_CMD_LINE_ARGS%

4. 项目应用

4.1 项目特点

应用程序会启动多个进程，启动脚本也会执行jar包。---需要解决emma端口冲突

测试过程中，由于bug会修改代码，版本迭代。希望统计这些版本的整个覆盖率信息---emma支持多个版本的覆盖率统计

希望每个case都有自己独立的覆盖率统计信息，同时也要有整个的覆盖统计信息。

4.2 应用

每个case执行的步骤:

1. 判断是否更新了jar包

1.1 更新：插桩，指定同个文件名合并到一起

1.1.1 stop app

1.1.2 设置 EMMAPORT 环境变量

1.1.3 启动一个应用进程，指定EMMAPORT：-Demma.rt.control.port=$EMMAPORT

1.1.4 循环1.1.2 & 1.1.3,启动完所有的进程

1.2 未更新：

1.2.1 清除执行信息：

java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.reset

2. 执行case

3. 收集执行信息

3.1 把所有进程的执行信息收集到一个文件里

java -cp /usr/jdk/jdk1.6.0_23/jre/lib/ext/emma.jar emma ctl -connect localhost:47653 -command coverage.get,coverage.ec

3.2 每个case需要有独立的执行信息

cp coverage.ec coverage_caseNo.ec

4. 生成报告

测试完这个版本后，生成报告