Android 使用 JaCoco 分析单元代码测试覆盖率

Android UI 单元测试

首先看一下Android UI单元测试的Demo

布局文件 activity_main.xml

待测试代码 MainActivity.java

说明

页面中有两个按钮,点击第一个按钮会显示一个Toast,点击第二个按钮则会抛出一个 Error

现在 我们需要判断通过 测试代码 判断出点击那个按钮将会出现 Error

单元测试编写 MainActivityTest.java

找到AndroidTest 文件夹,在里面新建 MainActivityTest 测试类.

编写代码如下:

运行测试用例

找到Android Studio 右侧 Gradle 工具栏

点击 connectedDebugAndroidTest 按钮

查询测试结果

找到module 里面的build/reports/androidTest/connected/index.html 文件通过浏览器打开

里面的内容是这样的:

数据告诉我们通过率是 80%,一共有5 个测试用例,ApplicationTest 有2个用例,MainActivityTest 有3个用例,并且失败了一个.

点击MainActivityTest,里面的页面会告诉我们 测试没通过的原因.

Android UI 单元测试的 不足之处

Android UI的测试用例不仅能帮助开发者找到 代码中会出现的Error,而且整个过程 不用像传统需要 测试人员亲自用手触发功能 .

局限性: 项目中可能有很多页面的功能都需要进行测试,但 普通的测试用例只能检测是开发者编写的测试用例是否正确,并不能知道 项目中总归有多少功能需要测试,以及 我们编写的测试用例到底完成了多少.

覆盖率

代码覆盖率=单元测试用例数量/总共待测功能数量

JaCoCo 检查代码覆盖率

介绍

随着敏捷开发的流行，编写单元测试已经成为业界共识。
但如何来衡量单元测试的质量呢？有些管理者片面追求单元测试的数量，导致底下的开发人员投机取巧，编写出大量的重复测试，数量上去了，质量却依然原地踏步。
相比单纯追求单元测试的数量，分析单元测试的代码覆盖率是一种更为可行的方式。
JaCoCo（Java Code Coverage）就是一种分析单元测试覆盖率的工具，使用它运行单元测试后，可以给出代码中哪些部分被单元测试测到，哪些部分没有没测到，并且给出整个项目的单元测试覆盖情况百分比，看上去一目了然。

gradle 集成

在 module 的 gradle中 项目如下配置

apply plugin: 'com.android.application'
apply plugin: 'jacoco'


android {
    compileSdkVersion 24
    buildToolsVersion "24.0.1"

    defaultConfig {
        applicationId "com.example.plu_rn.myapplication"
        minSdkVersion 15
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        debug {
            testCoverageEnabled = true

        }
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:24.1.1'
    androidTestCompile 'com.jayway.android.robotium:robotium-solo:5.1'
}
jacoco {
    toolVersion = "0.7.1.201405082137"
}

配置后gradle的工具栏就多了一个功能: createDebugCoverageReport

运行Jacoco

现在把MainActivityTest.java 改成如下:

public class MainActivityTest extends ActivityInstrumentationTestCase2 {

    private Solo solo;
    public MainActivityTest() {
        super(MainActivity.class);
    }

    @Override
    public void setUp() throws Exception {
        super.setUp();
        solo = new Solo(getInstrumentation(), getActivity());
    }

    public void testcase001() throws Exception{
        solo.clickOnButton("tips");
        solo.sleep(3000);
    }

    public void testStartClose() throws Exception {
        Thread.sleep(1000);
    }
    @Override
    public void tearDown() throws Exception {
        super.tearDown();
    }
}

删掉了第二个测试用例

运行 createDebugCoverageReport 功能

查看分析结果

找到 build/reports/coverage/debug/index.html 文件并用浏览器打开

这里的信息告诉我们 覆盖率为 62%

进入里面的详情 ,里面的数据详细的告诉 我们哪些功能点 已经测试,以及 还没有测试的功能点;

因为刚刚把MainActivityTest.java 里面testcase002这个方法去掉了,所以 这里显示 showError 这个方法没有被测试到.