其實基于jacoco來做Android端代碼覆蓋率的難點(diǎn)主要是各個項目的gradle插件依賴跟jacoco版本直接的兼容性問題，特別是在以及開發(fā)很多年的多模塊項目下，這個問題尤為明顯，另外網(wǎng)上雖然有很多相關(guān)的文章資料，但是要么是gradle插件依賴版本太低，要么就是jacoco版本、配置文件以及項目的開發(fā)環(huán)境沒有說清楚或者寫的有問題，導(dǎo)致最終很難按照說明完成接入。
我用的是gradle8.0.1版本比較新，應(yīng)該是目前gradle最新的版本。

gradle插件版本：classpath 'com.android.tools.build:gradle:8.0.1'
gradle依賴版本：distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip

我這里直接以多模塊項目為例，單模塊項目修改jacoco.gradle配置文件中的源碼路徑和class文件路徑即可。

第一步

在app模塊下新建一個jacoco.gradle文件，具體代碼如下所示：

apply plugin: 'jacoco'

android {
    buildTypes {
        debug {
            /**打開覆蓋率統(tǒng)計開關(guān)**/
            testCoverageEnabled = true
        }
    }
}

//源代碼路徑，有多少個module，就在這里寫多少個路徑，如果你只有app一個module，那么就寫一個就可以
def coverageSourceDirs = [
        '../app/src/main/java',
//        '../common/src/main/java',
]

//class文件路徑，如果你只有app一個module，那么就寫一個就可以
def coverageClassDirs = [
        '/app/build/intermediates/javac/debug/classes',
//       '/common/build/intermediates/javac/debug/classes',
]

//Jacoco 版本，建議用這個版本兼容性比較好
jacoco {
    toolVersion = "0.8.2"
}

//生成報告task
task jacocoTestReport(type: JacocoReport) {
    group = "JacocoReport"
    description = "Generate Jacoco coverage reports after running tests."
    reports {
        //xml.enabled = true
        //html.enabled = true
        xml.required = true
        html.required = true
    }
    classDirectories.from = files(files(coverageClassDirs).files.collect {
        println("$rootDir" + it)
        fileTree(dir: "$rootDir" + it,
                // 過濾不需要統(tǒng)計的class文件
                excludes: ['**/R*.class',
                           '**/*$InjectAdapter.class',
                           '**/*$ModuleAdapter.class',
                           '**/*$ViewInjector*.class'
                ])
    })
    sourceDirectories.from = files(coverageSourceDirs)
    executionData.from = files("$buildDir/outputs/code-coverage/coverage.ec")

    doFirst {
        coverageClassDirs.each { path ->
            println("$rootDir" + path)
            new File("$rootDir" + path).eachFileRecurse { file ->
                if (file.name.contains('$$')) {
                    file.renameTo(file.path.replace('$$', '$'))
                }
            }
        }
    }
}

//初始化Jacoco Task
task jacocoInit() {
    group = "JacocoReport"
    doFirst {
        File file = new File("$buildDir/outputs/code-coverage/")
        if (!file.exists()) {
            file.mkdir();
        }
    }
}

其中class的文件路徑，具體跟gradle的版本有關(guān)，需要查看你自己實際的路徑，如下圖：

然后在你的app模塊下的build.gradle文件中依賴這個jacoco.gradle，如下所示：

apply plugin: "com.android.application"

apply from: "$rootDir/gradle/base.gradle"
apply from: "../gradle/exported.gradle"

apply from: 'jacoco.gradle'

android {
  ...
}

我們再整理一個jacoco.gradle放在項目的根目錄作為通用配置，內(nèi)容如下：

apply plugin: 'jacoco'
android {
    buildTypes {
        debug {
            /**打開覆蓋率統(tǒng)計開關(guān)**/
            testCoverageEnabled = true
        }
    }
}

如果需要統(tǒng)計子module中的代碼覆蓋率，那么需要在子module的build.gradle文件中添加如下依賴：

apply from: rootProject.file('jacoco.gradle')

第二步

定義一個JacocoHelper類，主要是用來生成ec文件，根據(jù)使用場景可以放在你需要的地方，比如在APP內(nèi)提供一個按鈕，點(diǎn)擊觸發(fā)生成ec文件，也可以通過命令行的方式觸發(fā)，具體代碼如下：

package com.example.helper;

import android.os.Environment;
import android.util.Log;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;


public class JacocoHelper {

    private static final String TAG = "JacocoHelper";

    //ec文件的路徑
    private static final String DEFAULT_COVERAGE_FILE_PATH = Environment.getExternalStorageDirectory()
        .getPath() + "/coverage.ec";

    /**
     * 生成ec文件
     *
     * @param isNew 是否重新創(chuàng)建ec文件
     */
    public static void generateEcFile(boolean isNew) {
        OutputStream out = null;
        File mCoverageFilePath = new File(DEFAULT_COVERAGE_FILE_PATH);
        try {
            if (isNew && mCoverageFilePath.exists()) {
                Log.d(TAG, "清除舊的ec文件");
                mCoverageFilePath.delete();
            }
            if (!mCoverageFilePath.exists()) {
                mCoverageFilePath.createNewFile();
            }
            out = new FileOutputStream(mCoverageFilePath.getPath(), true);
            Object agent = Class.forName("org.jacoco.agent.rt.RT")
                .getMethod("getAgent")
                .invoke(null);
            if (agent != null) {
                out.write((byte[]) agent.getClass().getMethod("getExecutionData", boolean.class)
                    .invoke(agent, false));
            }
        } catch (Exception e) {
            Log.d(TAG, e.toString());
        } finally {
            try {
                if (out != null) {
                    out.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }

}

在需要生成ec文件的地方調(diào)用下面的方法：

JacocoHelper.generateEcFile(true);

第三步 生成測試報告

通過上面的兩個步驟，我們就完成了Android項目的Jacoco配置，下面是如何使用它來獲取我們手工或者自動化測試的代碼覆蓋率。

首先我們可以通過Android Studio直接編譯安裝集成了Jacoco的Debug包，然后再在項目的根目錄執(zhí)行下面的命令完成初始化：

./gradlew jacocoInit

接著我們就可以通過執(zhí)行自動化測試腳本或者手工來開始我們的用例測試了，測試完成后執(zhí)行下面的命令：

adb pull /storage/emulated/0/coverage.ec .

最后我們在項目根目錄執(zhí)行下面的命令來生成報告：

./gradlew jacocoTestReport

第四步 報告分析

第五步 落地場景

我們既然可以根據(jù)執(zhí)行的用例拿到代碼的覆蓋情況，那么我們就可以基于這個數(shù)據(jù)來做度量和精準(zhǔn)測試了，比如：

1. 可以讓業(yè)務(wù)QA或者外包使用覆蓋率包來完成功能模塊的測試工作，這樣就可以根據(jù)生成的覆蓋率數(shù)據(jù)來度量測試效果了；

2. 另外在做精準(zhǔn)測試的時候，我們都需要維護(hù)用例和代碼的關(guān)系庫，那么如何得到這個關(guān)系呢，這時候我們就可以通過在手工或者UI自動化的方式執(zhí)行用例的過程中把每個用例跟對應(yīng)覆蓋的代碼類文件建立映射關(guān)系來完成初期的關(guān)系庫；