收集Android程序测试代码覆盖率

上一篇 / 下一篇 2012-08-07 09:50:30 / 个人分类：杂谈

　　代码覆盖率的作用主要是用来查看测试用例执行完毕后，有哪些代码尚未覆盖到，未覆盖到的代码通常意味着未覆盖到的功能或场景，对于Andriod程序来说，好像国内聊到这个领域的文章不多，这里记录下来供大家参考。

+\ k/U dZ6m9h ]1?2`0　　因为Andriod程序实际上就是Java程序，这里先不谈Andriod native C程序的代码覆盖率收集（后面的文章会讲到，其实就是用gcov做的），Java程序的代码覆盖率统计可以使用一个开源软件Emma，Emma并不需要源码就可以统计代码覆盖率。这是因为统计代码覆盖率的做法有两种（参看以前的文章：）：

C:@H*[)R2L~?(O7i0　　1、修改程序源代码，添加统计代码覆盖率的代码，例如gcov采用的就是这种做法。

!C*`Iyn0　　2、修改最终程序，比如Emma就是修改Java class的字节码Oolong代码。为了能够将统计到的代码覆盖率结果追溯到源代码，一般是将Java编译成调试（Debug）版，做法是：Emma在每个Oolong跳转代码前加入统计覆盖率的代码，而调试版的class，里面会有.source, .line. .var这些指令，告诉调试器字节码与Java源代码、Java变量与Oolong变量的数字引用的映射关系，这种做法的好处是，只要你的程序最终会生成 Java字节码，例如Scala之类的程序，生成的调试版都可以用Emma修改，达到统计代码覆盖率的目的。Java虚拟机对调试的支持，请参考书籍《Programming for the Java? Virtual Machine》第7章里的描述。

　　因为Andriod程序在部署到设备之前，会有个程序（dx）将Java字节码翻译成Andriod虚拟机里的字节码，所以可以在翻译之前使用Emma修改class文件，再打包。

　　实际上Andriod提供了一个ant的 build文件，里面就封装了这个功能，我这里将这个脚本做的事情挖了出来，解释一下各步骤。在解释之前，先看看如何用ant编译一个覆盖率统计版：51Testing软件测试网_)S5hi&n:w

0i+spb"y x0　　1、从eclipse的andriod工程里生成一个ant的build文件，andriod-app就是工程名：51Testing软件测试网Q,X@ V,`M

T*wX?V,q]}+gt0　　androidupdate project -p android-app2、将eclipse的andriod测试工程也转换成ant工程，-m选项指定了测试工程对应的主andriod工程的位置，而android-test就是测试工程名：51Testing软件测试网qyd7i `

　　android update test-project -m ../android-app -p android-test3、执行下面的命令，编译、执行单元测试、收集覆盖率：

6]tG:qc5I|0s0　　ant clean emma debug install test4、在设备上，/data/data/<package name>/目录里，有一个files文件夹里有coverage.ec文件，即记录了代码覆盖率信息，但这个信息还需要跟源码做一次映射才能看到哪些代码行已覆盖。

　　5、将上面coverage.ec文件拷贝到andriod主工程的bin文件夹里，这个文件夹里有一个文件名coverage.em，里面记录了修改过的字节码与源代码的映射关系。

　　6、要查看代码覆盖率时，执行下面的命令（andriod SDK里以及自带了emma.jar），下面命令里的sp参数即指定了源代码的位置：

　　java -cp ~/android-sdk/tools/lib/emma.jar emma report -r html -in coverage.em -in coverage.ec -sp ~/<andriod-app>/src/

　　这里我们把ant命令分解（假设已经将andriod eclipse工程转换成ant工程了），实际上执行下面几个命令就可以了，下例中~/research/multiplatformdemoproject就是andriod的主工程路径：51Testing软件测试网(S n2MP)V0~q`

　　cd ~/research/multiplatformdemoproject/
ty"a G5r2f0　　# 编译成调试版
`OF\#AL(A0　　ant debug

3C FNqmS0　　# 在打包成dex文件之前，修改class字节码

　　cd bin
:p)K*l%q8_%c;Gn1{)_0　　java -cp ~/android-sdk/tools/lib/emma.jar emma instr -ip classes -d instrumented
rqcd#AG0　　# 将修改成覆盖率统计版的class字节码打包成andriod虚拟机文件
B&^'cfFO1p0　　~/android-sdk/platform-tools/dx --dex --debug --no-optimize --output=classes.dex instrumented51Testing软件测试网#qkT$lQ S Q
　　~/android-sdk/platform-tools/aapt package -v -f -M /home/shiyimin/research/multiplatformdemoproject/AndroidManifest.xml -S /home/shiyimin/research/multiplatformdemoproject/res -I /home/shiyimin/android-sdk/platforms/android-8/android.jar -F multiplatformdemoproject.unsigned.apk /home/shiyimin/research/multiplatformdemoproject/bin/51Testing软件测试网?_bcj$d

　　# 签名
　　jarsigner -keystore ~/.android/debug.keystore -storepass android -keypass android -signedjar multiplatformdemoproject.signed.apk multiplatformdemoproject.unsigned.apk androiddebugkey51Testing软件测试网l~:^|4Df
　　~/android-sdk/tools/zipalign 4 multiplatformdemoproject.signed.apk multiplatformdemoproject.apk

!z#P9a,{&@ YZ0　　# 部署主程序到设备上
U:V_;_7k0　　~/android-sdk/platform-tools/adb install multiplatformdemoproject.apk

　　# 编译测试用例51Testing软件测试网m3GRy%[2`!Q
　　cd tests
　　ant debug

　　# 部署并且执行测试用例
A[5g ^ST Q*qB{0　　~/android-sdk/platform-tools/adb install multiplatformdemoproject.test-debug.apk
]7V!z8MtED4Qi0　　~/android-sdk/platform-tools/adb shell am instrument -w -e coverage true cc.iqa.studio.demo.test/android.test.InstrumentationTestRunner

　　# 查看代码覆盖率结果报告
Q(f,AQ/WE:c-_0　　cd http://www.cnblogs.com/bin/51Testing软件测试网rv.Dp5o+Y
　　~/android-sdk/platform-tools/adb pull /data/data/cc.iqa.studio.demo/files/coverage.ec .51Testing软件测试网u},HH8^R!e
　　java -cp ~/android-sdk/tools/lib/emma.jar emma report -r html -in coverage.em -in coverage.ec -sp ~/research/multiplatformdemoproject/src/

g qrW2q,d0　　下面是几个截图：

51Testing软件测试网u)lKy|
51Testing软件测试网*j4Wg!T@