gradle 编译环境下进行android单元测试

====== android 单元测试介绍 ======
JUnit是一个开源的java单元测试框架，android的测试套件是基于JUnit 3的（不完全兼容JUnit 4），Junit4只需简单了解即可，可以使用普通的junit来进行测试，推荐使用android的Junit测试框架进行高效全面的进行测试。
====== Android 单元测试框架UML ======
{{:dolphin_news:share:androidjunituml.png?300 |}}


====== eclipse下的andriod项目单元测试 ======
使用AndroidJunit来做单元测试，大致可以分以下几个步骤： 
    - 新建Android Test Project
    - 新建Junit test case
    - 新建Junit test suite
    - 运行Junit test
===== 新建 Android Test Project =====
这部分内容是在eclipse中导入了shell_en_aglie的基础上的完成的，请首先确保你已经成功导入了shell_en_agile工程(其它工程也是一样)。新建Android Test Project方法：
    - 在eclipse中File->New->Other->Android->AndroidTestProject， 输入测试工程名， 如输入dolphin_junit_test。
    - 下一步选择被测试的工程， 如选择测试DolphinBrowerEn， 这一步就完成了。    
    此时我们打开AndroidManifest.xml看一下
<code>    
    <?xml version="1.0" encoding="utf-8"?>
    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    <!-- 此处包名被修改了，自动会根据被测项目生成为mobi.mgeek.TunnyBrower.test-->
    package="com.dolphin.browser.core.test"
    android:versionCode="1"
    android:versionName="1.0" >
    <uses-sdk android:minSdkVersion="7" />
    <instrumentation
        android:name="android.test.InstrumentationTestRunner"
        android:targetPackage="mobi.mgeek.TunnyBrower" />
    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <uses-library android:name="android.test.runner" />
    </application>
    </manifest>
</code>    
可以看到， 已经自动生成了一些内容， 如uses-library和instrumentation已经自动生成了，这里需要注意一下包名，因为前面我们选择了被测试的工程为DolphinBrowerEn，所以这里的自动为我们指定了targetPackage="mobi.mgeek.TunnyBrowser", 并且为测试工程包名package="mobi.mgeek.TunnyBrowe.test"，这里的包名因需要可以修改， 但targetPackage="com.dolphin.browser.core"为被测工程的包名，不能修改。  
===== 新建 Junit Test Case =====
新建Junit Test Case方法：
  - 在eclipse中File->New->Other->Junit->Junit Test Case
  - 在弹出的Junit Test Case 对话框中选择New Junit 3 test，Superclass 选择AndroidTestCase，并选择 Class under test 被测试类，输入Name类名，点击下一步后。
  - 选择需要被测试的方法，这里根据实际情况选择需要被测试的方法， 点击完成。
===== 新建 Junit Test Suite =====  
新建 Junit Test Suite方法：  
  - 在eclipse中File->New->Other->Junit->Junit Test Suite
  - 在弹出的Junit Test Case 对话框中选择需要测试的类。
  - 选择需要被测试的方法，这里根据实际情况选择需要被测试的方法， 输入Name后点击完成。
  - 编写TestSuite代码
  - 编写TestSuite后， 需要在AndroidManifest中添加一项instrumentation， 添加后的AndroidManifest就变成了
<code>    
    <?xml version="1.0" encoding="utf-8"?>
    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.dolphin.browser.core.test"
    android:versionCode="1"
    android:versionName="1.0" >
    <uses-sdk android:minSdkVersion="7" />
    <instrumentation
        android:name="android.test.InstrumentationTestRunner"
        android:targetPackage="com.dolphin.browser.core" />
    <!-- 添加 testsuite 项 -->    
    <instrumentation
        android:name="com.dolphin.browser.core.test.Testall"
        android:targetPackage="com.dolphin.browser.core" />    
    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <uses-library android:name="android.test.runner" />
    </application>
    </manifest>
</code>
TestSuite代码完成后如下， 代码中使用了继承InstrumentationTestRunner，主要是通过addTestSuite来添加测试类，这里我只有一个测试类，当有多个测试类时，就可以把它们都加进去。
<code java>    
public class TestAll extends InstrumentationTestRunner{


    private static final String TAG = "TestAll";


    public TestSuite getAllTests(){
        Log.i(TAG, "Junit test, testsuite");
        TestSuite suite = new InstrumentationTestSuite(this);
        suite.addTestSuite(NewsRequestWrapperTest.class);
        return suite;
    }
}
</code>
===== 运行 Junit =====
可以参考 http://blog.csdn.net/xianming01/article/details/7463066 ，由于被测试工程较大， 在eclipse中导致不能通过图形化界面运行Junit，所以我们可以采用adb shell am 的方式运行生成的junit apk 来测试。具体方法是：
  - 将被测apk安装到手机中
  - 将junit程序生成后的apk安装到手机中
  - 输入adb shell pm list instrumentation， 会显示类似以下信息，下面显示了有两个instruementation， 第一个test case, 第二个是test suite.
    
    
instrumentation:com.dolphin.browser.junittest/android.test.InstrumentationTestRunner (target=mobi.mgeek.TunnyBrowser)\\
instrumentation:com.dolphin.browser.junittest/.testall.TestAll (target=mobi.mgeek.TunnyBroer)
   
按链接中的说明， 可以输入adb shell am instrument -w com.dolphin.browser.junittest/android.test.InstrumentationTestRunner执行单条测试用例， 也可以
输入adb shell am instrument -w com.dolphin.browser.junittest/.testall.TestAll来执行test suite。


===== 注意事项 =====
  - 创建工程时， 注意package 和 targetPackage 的关系。
  - 由于我测试的是DolphinBrowserEn，在eclipse中无法编译，所以使用了生成测试apk，然后安装到手机中，使用adb shell am 方式进行测试。
  - 如何写测试方法， 这里不做说明， 需要注意被测试方法为异步方法时，如http，需要用到线程同步去等待异步任务的完成。
  - 我们也可以写一个activity，画一个简单的界面，通过点击button触发单元测试， 也可以对界面进行单元测试。




====== gradle环境下进行android单元测试方法一 ======
这部分内容以AOSP 里的development/samples/NotePad为例，NotePad工程下的单元测试代码在它的tests文件夹里。
步聚：
  * 先新建一个文件夹testJunit(名字任意)，将development/samples/NotePad项目复制到里面。
  * 现在文件结构是 testJunit 里面是NotePad工程，工程下就是src, res, tests, AndroidManifest等。
  * 在testJunit里新建三个文件，build.gradle, common.gradle, settings.gradle.
build.gradle 内容如下：
<code> 
def gradle = project.getGradle()
gradle.beforeProject { project ->


    if (project.file(‘build.gradle‘).exists()) {
        project.buildscript {
            repositories {
                maven {
                    name = "Baina Maven Proxy"
                    url = "http://mirrors.baina.com:8080/archiva/repository/internal"
                }
            }


            dependencies {
                classpath ‘com.android.tools.build:gradle:0.6.+‘
            }
        }
    }
}
</code>
common.gradle内容如下：
<code>
tasks.withType(JavaCompile) {
    options.fork = true
    options.forkOptions.setMemoryMaximumSize("4096m")
    options.forkOptions.setMemoryInitialSize("1024m")
    options.encoding = "UTF-8"
}


android {
    compileSdkVersion 17
    buildToolsVersion "18.0.1"


    sourceSets {
        main {
            manifest.srcFile ‘AndroidManifest.xml‘
            java.srcDirs = [‘src‘]
            resources.srcDirs = [‘src‘]
            aidl.srcDirs = [‘src‘]
            renderscript.srcDirs = [‘src‘]
            res.srcDirs = [‘res‘]
            assets.srcDirs = [‘assets‘]
        }
    instrumentTest {
            java.srcDirs = [‘tests/src‘]
            resources.srcDirs = [‘tests/src‘]
            aidl.srcDirs = [‘tests/src‘]
            renderscript.srcDirs = [‘tests/src‘]
            res.srcDirs = [‘tests/res‘]
            assets.srcDirs = [‘tests/assets‘]
    }


        //instrumentTest.setRoot(‘tests‘)
    }
}
</code>
此处instrumentTest也可以另一种方式写成
instrumentTest.setRoots(‘tests‘), 这样的话，需把NotePad里的src改为java， 为了在eclipse中能运行，建议采用分别指明目录的方式。


settings.gradle内容如下：
<code>
include ‘:NotePad‘
</code>


  * 在NotePad 文件夹里新建build.gradle, 内容如下：
<code>
apply plugin: ‘android‘
apply from: "$project.rootDir/common.gradle"


android {
    compileSdkVersion 16


    buildTypes {
        release {
            runProguard true
            proguardFile ‘proguard.cfg‘
        }


        debug {
            runProguard true
            proguardFile ‘proguard-debug.cfg‘
        }
    }
    
    defaultConfig {
        testPackageName "com.example.android.notepad.tests"
        testInstrumentationRunner "android.test.InstrumentationTestRunner"
    }
}
    
}
</code>
说明：以上四个gradle文件我是从shell_en_agile里的复制过来的， 参考它的结构并修改而来的。
  * 编译
在 testJunit 运行 gradle --daemon assembleDebug 会生成NotePad工程的apk, 运行 gradle --daemon assembleTest 会生成单元测试工程的apk。
  * 运行
安装test apk, 运行 adb shell am instrument -w com.dolphin.browser.junittest/android.test.InstrumentationTestRunner。    


====== gradle 环境下做android单元测试的配置方法二  ======
实现工作中，为了使tests工程与被测工程的git commit message相关不干扰，可以将单元测试独立出来管理，这样与被测工程相对独立，tests工程不会影响NotePad工程。在方法一的基础上继续下面的操作。
步聚：
  * 将NotePad 里的 tests剪切出来放到NotePad 平行的位置， 现在文件结构是 testJunit 里有两个文件夹，NotePad 及tests, NotePad里面只剩下了src, res等。
  * cd NotePad , 将测试工程通过软链接的方式链接进来: ln -s ../tests tests。
  * 编译：
在testJunit下编译 gradle --deamon installTest, 编译完成后， 可以查看build下是否生成了对应的单测测试文件的class文件，确认编译没有问题。
  * 运行：
参照测试工程tests， 具体命令可参考AOSP/development/samples/ApiDemos/tests 里的 AllTests.java。


To run all suites found in this apk: adb shell am instrument -w com.dolphin.browser.junittest/android.test.InstrumentationTestRunner \\
To run just this suite from the command line: adb shell am instrument -w -e class com.dolphin.browser.junittest.TestAll com.dolphin.browser.junittest/android.test.InstrumentationTestRunner \\
To run an individual test case: adb shell am instrument -w -e com.dolphin.browser.junittest.xxxtest com.dolphin.browser.junittest/android.test.InstrumentationTestRunner \\
To run an individual testcase: adb shell am instrument -w -e class com.dolphin.browser.junittest.news.test.NewsRequestWrapperTest com.dolphin.browser.junittest/android.test.InstrumentationTestRunner \\