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

  因为Andriod程序实际上是Java程序,这里先不谈Andriod native C程序的代码覆盖率收集(后面的文章会讲到,其实是用gcov做的),Java程序的代码覆盖率统计可以使用一个开源软件Emma,Emma并不需要源码可以统计代码覆盖率 。这是因为统计代码覆盖率的做法有两种(参看以前的文章:):

 

  1、修改程序源代码,添加统计代码覆盖率的代码,例如gcov采用的是这种做法。


  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编译一个覆盖率统计版:


  1、从eclipse的andriod工程里生成一个ant的build文件,andriod-app是工程名:

  android update project -p android-app


  2、将eclipse的andriod测试工程也转换成ant工程,-m选项指定了测试工程对应的主andriod工程的位置,而android-test是测试工程名:

 

  android update test-project -m ../android-app -p android-test


  3、执行下面的命令,编译、执行单元测试、收集覆盖率:

  ant clean emma debug install test

  4、在设备上,/data/data//目录里,有一个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 ~//src/

  这里我们把ant命令分解(假设已经将andriod eclipse工程转换成ant工程了),实际上执行下面几个命令可以了,下例中~/research/multiplatformdemoproject是andriod的主工程路径:


  cd ~/research/multiplatformdemoproject/

 

  # 编译成调试版

 

  ant debug

  # 在打包成dex文件之前,修改class字节码

  cd bin

  java -cp ~/android-sdk/tools/lib/emma.jar emma instr -ip classes -d instrumented

 

  # 将修改成覆盖率统计版的class字节码打包成andriod虚拟机文件


  ~/android-sdk/platform-tools/dx --dex --debug --no-optimize --output=classes.dex instrumented


  ~/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/


  # 签名

  jarsigner -keystore ~/.android/debug.keystore -storepass android -keypass android -signedjar multiplatformdemoproject.signed.apk multiplatformdemoproject.unsigned.apk androiddebugkey

 

  ~/android-sdk/tools/zipalign 4 multiplatformdemoproject.signed.apk multiplatformdemoproject.apk

 

  # 部署主程序到设备上


  ~/android-sdk/platform-tools/adb install multiplatformdemoproject.apk


  # 编译测试用例

 

  cd tests

  ant debug

 

  # 部署并且执行测试用例

  ~/android-sdk/platform-tools/adb install multiplatformdemoproject.test-debug.apk

 

  ~/android-sdk/platform-tools/adb shell am instrument -w -e coverage true cc.iqa.studio.demo.test/android.test.InstrumentationTestRunner

 

  # 查看代码覆盖率结果报告

  cd http://www.cnblogs.com/bin/

  ~/android-sdk/platform-tools/adb pull /data/data/cc.iqa.studio.demo/files/coverage.ec .


  java -cp ~/android-sdk/tools/lib/emma.jar emma report -r html -in coverage.em -in coverage.ec -sp ~/research/multiplatformdemoproject/src/

  下面是几个截图