Jenkins構建Android項目持續集成之單元測試及代碼覆蓋率

單元測試

　　在軟件開發中一直在推崇TDD（測試驅動開發），但是一直不能被有效的執行或者並不是真正的測試驅動開發（先開發後寫單元測試），因爲我們懶！而Android開發又是大多應用層面的開發，很多都是和視圖層緊密相連的，業務邏輯和view相綁定，這導致編寫單元測試有相當大的困難，因此就我項目而言，只針對工具類、服務端API編寫單元測試。關於Android Studio如何編寫單元測試並運行，可以看之前寫的一篇文章Android Studio 單元測試

代碼覆蓋率

　　編寫好單元測試後，我們需要知道，測試用例是否覆蓋了代碼的所有分支情況，這樣才能保證代碼的可靠性、正確性。

編寫測試用例

如果使用Android Studio創建項目的話，那麼默認的會在androidTest包下生成一個ApplicationTest類，在這裏面可以寫測試用例。

上圖寫的是一個SharedPreferences Util工具類的測試用例。
如果你的測試用例不想寫在這個包下，想自定義，也可以在項目的build.gradle寫如下的配置

android {
    sourceSets {
        androidTest{
            java.srcDirs = ['src/com/helen/andbase/tests']
        }
    }

Gradle配置jacoco

　　Jacoco是一個開源的覆蓋率工具。這裏講下gradle如何配置。
　　首先要在項目的build.gradle引入插件，語句如下：

　apply plugin: 'jacoco'

　　然後註明使用的版本號

jacoco{
        version "0.7.4.201502262128"
    }

　　接着，申明一個gradle task

task jacocoTestReport(type:JacocoReport,dependsOn:"connectedAndroidTest"){
    group = "Reporting"
    description = "Generate Jacoco coverage reports after running tests."
    reports{
        xml.enabled = false
        html.enabled = true
        csv.enabled = false
    }
    classDirectories = fileTree(
            dir : "$buildDir/intermediates/classes/debug",
            excludes : [
                    '**/*Test.class',
                    '**/R.class',
                    '**/R$*.class',
                    '**/BuildConfig.*',
                    '**/Manifest*.*'
            ]
    )
    def coverageSourceDirs = ['src/main/java']
    additionalSourceDirs = files(coverageSourceDirs)
    sourceDirectories = files(coverageSourceDirs)
    additionalClassDirs = files(coverageSourceDirs)
    executionData = files("$buildDir/outputs/code-coverage/connected/coverage.ec")
}

　　最後，打開testCoverageEnabled，需要注意的是，打開該屬性的話，在斷點調試的時候會導致方法參數值丟失（看不到），所以在調試的時候要記得把它關掉。

buildTypes {
        debug{
            testCoverageEnabled true
        }
    }

　　完整的gradle配置如下

apply plugin: 'com.android.library'
//代碼覆蓋率插件
apply plugin: 'jacoco'

android {
    compileSdkVersion 22
    buildToolsVersion '22.0.1'
    defaultConfig {
        minSdkVersion 8
        targetSdkVersion 22
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug{
            testCoverageEnabled true
        }
    }
    lintOptions {
        abortOnError false
    }
    packagingOptions {
        exclude 'META-INF/NOTICE'
        exclude 'META-INF/LICENSE'
    }
    jacoco{
        version "0.7.4.201502262128"
    }
}
//jacocoTestReport依賴於connectedAndroidTest task，所以在執行jacoco之前需要先執行connectedAndroidTest，也就是說需要連接測試機（模擬器or真機）
task jacocoTestReport(type:JacocoReport,dependsOn:"connectedAndroidTest"){
    group = "Reporting"
    description = "Generate Jacoco coverage reports after running tests."
    reports{
        xml.enabled = false
        html.enabled = true
        csv.enabled = false
    }
    classDirectories = fileTree(
            dir : "$buildDir/intermediates/classes/debug",
            excludes : [
                    '**/*Test.class',
                    '**/R.class',
                    '**/R$*.class',
                    '**/BuildConfig.*',
                    '**/Manifest*.*'
            ]
    )
    def coverageSourceDirs = ['src/main/java']
    additionalSourceDirs = files(coverageSourceDirs)
    sourceDirectories = files(coverageSourceDirs)
    additionalClassDirs = files(coverageSourceDirs)
    executionData = files("$buildDir/outputs/code-coverage/connected/coverage.ec")
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.2.1'
}