《Gradle权威指南》--Android Gradle测试

No1：

Android既可以用传统的JUnit测试，也可以用Android的instrument测试。

No2：

当我们运行测试的时候，androidTest SourceSet会被构建成一个可以安装到设备上的测试apk，这个测试apk里有很多我们写好的测试用例，它们会被执行，来测试我们的app。

No3：

android{
    defaultConfig{
        testApplicationId "org.flysnow.app.example121.test"
        testInstrumenttationRunner "android.test.InstrumentationTestRunner"
        testHandleProfiling true
        testFunctionalTest true
    }
}

testApplicationId--测试apk的包名

testFunctionTest--是否启用功能测试

testHandleProfiling--是否启用性能分析

testInstrumentationRunner--运行测试使用的Instrumentation Runner

-----------------------------------

最后根据配置生成AndroidManifest.xml文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schema.android.com/apk/res/android"
    package="org.flysnow.app.example121.test">
    
    <users-sdk android:minSdkVersion="14" android:targetSdkVersion="23"/>
    <application>
        <uses-library android:name="android.test.runner"/>
    </application>
    <instrumentation android:name="android.test.InstrumentationTestRunner"
                     android:targetPackage="org.flysnow.app.example121"
                     android:handleProfiling="true"
                     android:functionalTest="true"
                     android:label="Tests for org.flysnow.app.example121"/>
</manifest>

targetPackage会使用被测试App的包名自动填充

No4：

依赖

dependencies{
    androidTestCompile 'com.android.support:support-annotation:23.0.1'
    androidTestCompile 'com.android.support:test:runner:0.4.1'
    androidTestCompile 'com.android.support.test:rules:0.4.1'
}

会被编译到测试apk中，正式的apk包里没有这些jar库

No5：

测试apk默认是debug模式，但也可以改为release模式

android{
    ...
    testBuildType "release"
}

No6：

运行测试代码：使用./gradlew connectedCheck运行。内部步骤是：

1）使用adnroidAndroidTest任务构建好测试应用和被测试应用，其中欧冠被测试应用又是被assembleDebug任务构建的

2）通过install任务安装这两个应用

3）运行我们写好的测试用例，等运行完之后，卸载两个应用

4）最后测试的结果会被保存在build/androidTest-results目录下

注：测试Application项目不会有被测试的apk生成，只有一个测试apk生成

No7：

本地单元测试--不依赖Android框架或者只有非常少的依赖，直接运行在本地开发机器上，不需要设备或模拟器

比较常用的模拟框架有Mockito和JMock

No8：

针对特定的BuildType和特定的Flavor测试。每一种BuildType，每一种Flavor都有对应的测试用例存放目录

比如：

src/main/java/对应的是src/test/java

src/debug/java/对应的是src/testDebug/java/

src/google/java/对应的是src/testGoogle/java/

No9:

JUnit3和JUnit4的区别：

JUnit的测试用例需要都集成junit.framework.TestCase，并且测试方法要以test为前缀。JUnit4就没有这些限制，测试方法也只需要使用@Test注解进行标注就好了

package org.flysnow.app.example122;

import org.junit.Test;
import static org.hamcrest.CoreMatchers.is;
import static org.junit.Assert.assertThat;

public class EmailValidatorTest{
    @Test
    public void emailValidator_CorrectEmailSimple_ReturnsTrue(){
        assertThat(EmailValitor.isValidEmail("name@email.com"),is(true));
    }
    @Test
    public void emailValidator_CorrectEmailSimple_ReturnsFalse(){
        assertThat(EmailValidator.isValidEmail("name"),is(false));
    }
}

执行

./gradlew :example122:test

测试结果在build/reports/tests目录下

No10：

使用Mockito框架

dependencies{
    testCompile 'junit:junit:4.12'
    testCompile 'org.mockito:mockito-core:1.10.19'
}

package org.flysnow.app.example122;

import android.content.Context;

public class Utils{
    private Context mContext;
    
    public Utils(Context context){
        this.mContext = context;
    }
    public String getAppName(){
        return String.valueOf(mContext.getString(R.string.app_name));
    }
}

package org.flysnow.app.example122;

import android.content.Context;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.mockito.Mock;
import org.mockito.runners.MockitoJUnitRunner;
import static org.hamcrest.CoreMatchers.*;
import static org.junit.Assert.*;
import static org.mockito.Mockito.*;

@RunWith(MockitoJUnitRunner.class)
public class UtilsTest{
    private static final String APP_NAME = "Example122";
    
    @Mock
    Context mMockContext;
    @Test
    public void readAppNameFromContext(){
        when(mMockContext.getString(R.string.app_name)).thenReturn(APP_NAME);
        
        Utils utils = new Utils(mMockContext);
        String appName = utils.getAppName();
        assertThat(appName,is(APP_NAME));
    }
}

1）告诉JUnit4要使用MockitlJUnitRunner

2）模拟Context的对象mMockContext

3）when.thenReturn逻辑，when一定要和Utils里的getAppName方法的逻辑一样，thenReturn告知模拟器期望返回的值

4）使用./gradlew :example 122:test执行查看结果

No11：

Instrument测试--运行在真实的安卓物理机或模拟器上。要生成一个测试apk。下面以AndroidJUnitRunner为例

android{
    defaultConfig{
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        testApplicationId "con.example.app.test"
    }
}

dependencies{
    compile fileTree(dir: 'libs',include:['*.jar'])
    androidTestCompile 'com.android.support.test:runner:0.4.1'
    androidTestCompile 'com.android.support.test:rules:0.4.1'
}

package org.flysnow.app.example123;

import android.support.test.rule.ActivityTestRule;
import android.support.test.runner.AndroidJUnit4;
import android.test.suitebuilder.annotation.LargeTest;
import org.junit.Before;
import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

@RunWith(AndroidJUnit4.class)
@LargeTest
public class MainActivityTest{
    @Rule
    public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule<>(MainActivity.class);
    @Before
    public void initSomethind(){}
    @Test
    public void validSomething(){
        mActivityRule.getActivity().findViewById(android.R.id.test1).performClick();
    }
}

@LargeTest说明它有更高的权限

@Rule指定规则：要测试的是MainActivity

另外还有其他的库可以使用

dependencies{
    androidTestCompile 'org.hamcrest:hamcrest-library:1.3'
    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.1'
    androidTestCompile 'com.android.support.test.uiautomator:uiautomator-v18:2.1.1'
}

No12：

测试选项配置testOptions闭包

android{
    ...
    testOptions{
        reportDir = "$project.buildDir/example123/report"
        resultsDir = "$project.buildDir/example123/result"
        unitTests.all{
            jvmArgs '-XX:MaxPermSize=256m'
        }
    }
}

1）reportDir：用于配置生成测试报告的目录

2）resultsDir：用于配置生成测试结果的目录

3）unitTests：用于控制单元测试的执行--上面是指定启动的JVM的最大非堆内存是256M

---------------------------------------------

把每个库项目的测试报告统一合并查看：android-reporting

只需要在总的build.gradle中配置

apply plugin: 'android-reporting'

然后执行./gradlew deviceCheck mergeAndroidReports -continue

-continue是在测试失败的时候，也可以继续执行其他测试用例

No13：

代码覆盖率--testCoverageEnabled控制菜吗覆盖率统计是否开启

android{
    buildTypes{
        release{
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'
            zipAlignEnabled true
        }
        debug{
            testCoverageEnabled = true
        }
    }
}

另外，要注意配置jacoco时的Android Gradle的版本号

1）如果是1.5.0之前的版本

android{
    jacoco{
        version = '0.6.2.201302030002'
    }
}

2）如果是1.5.0版本，在根项目的build.gradle里配置

buildscript{
    repositories{
        jcenter()
    }
    dependencies{
        classpath 'org.jacoco:org.jacoco.core:0.7.4.201502262128'
    }
}

3）从2.0.0版本开始，不管在根项目，还是子项目都可以使用了

运行

./gradlew createDebugCoverageReport，报告在build/reports/coverage下

No14：

Lint支持--代码、资源的优化工具--lintOptions{}闭包

android{
    lintOptions{
        abortOnErroe true
        warningsAsErrors true
        check 'NewApi'
    }
}

abortOnError--boolean类型，用于配置Lint发现错误时是否退出Gradle构建

absolutPaths--boolean类型，用于配置错误的输出里是否应该显示绝对路径，默认显示的是相对路径

check--set集合

android{
    lintOptions{
        check 'NewApi'
    }
}

注：NewApi就是一个issue id，终端输入lint --list查看所有可用id，另外，lint --show可以查看详细信息

android{
    lintOptions{
        def checkSet = new HashSet<String>()
        checkSet.add("NewApi");
        checkSet.add("InlinedApi")
        check = checkSet
    }
}

缩写

android{
    lintOptions{
        check 'InlinedApi','NewApi'
    }
}

checkAllWarnings--boolean类型，True表示需要检查所有警告的issue，包括那些默认被关闭的issue，false不检查

checkReleaseBuilds--boolean类型，用于配置在release构建的过程中，Lint是否应该检查致命的错误的问题，默认true，一旦发现有‘fatal’级别的问题，release构建会被终止

disable--用来关闭给定issue id的Lint检查，和check用法一样

enable--用来配置哪些issue id启动lint check，和disable用法相反

explainIssues--boolean类型，用来配置Lint检查出的错误报告是否应该包含解释说明

htmlOutput--File类型，用于配置HTML报告输出的文件路径

android{
    lintOptions{
        htmlOutput new File("${buildDir}/lintReports/lint-results.html")
    }
}

htmlReport--boolean类型，用于配置是否生成HTML报告，默认是true

ignoreWarings--boolean类型，用于配置Lint是否忽略警告级别的检查，只检查错误级别

lintConfig--File类型，用于指定Lint的配置文件，

noLines--boolean类型，如果为true，error输出将不会包含源代码的行号

quiet--boolean类型，表示是否开启安静模式，这样Lint分析的进度或者其他信息将不会显示

severityOverrides--返回一个Map类型结果，用来获取issue的优先级。Map的key是issue id，value是优先级，包括fatal、error、warning、informational、ignore

showAll--boolean类型，用于标记是否应该显示所有的输出

textOutput--File类型，用于指定生成的test格式的报告的路径

textReport--boolean类型，用于配置是否生成text报告

warningsAdErrors--boolean类型，用于配置是否把所有的警告也当成错误处理，默认false

xmlOutput--File类型，用于设置生成xml报告的路径

xmlReport--boolean类型，用于控制是否生成xml格式的报告，默认true

error、fatal、ignore、warning、informational--用来配置issue的优先级，接受的都是issue id作为其参数。error是把给定的issue强制指定为erroe这个优先级

-------------------------

运行./gradlew lint，默认生成报告在output/lint-results.html下