Java+Appium自动化测试下Android应用Jacoco代码覆盖率实现咨询

我之前刚好做过类似的配置，踩过不少坑，总结了一套可行的流程，应该能帮你解决问题：

1. 给Android项目配置Jacoco插桩 #

首先得让你的Android项目支持Jacoco的代码插桩，这一步是基础。在app模块的build.gradle里做如下修改：

plugins {
    id 'com.android.application'
    id 'jacoco' // 引入Jacoco插件
}

android {
    buildTypes {
        debug {
            testCoverageEnabled true // 开启debug版本的覆盖率收集
            jacoco {
                includeNoLocationClasses = true // 处理Lambda等无位置类的插桩问题
            }
        }
    }
}

// 自定义生成覆盖率报告的Gradle任务
task jacocoTestReport(type: JacocoReport, dependsOn: ['connectedDebugAndroidTest']) {
    reports {
        xml.required = true // 生成XML格式报告（方便CI工具解析）
        html.required = true // 生成可视化HTML报告
    }

    // 排除不需要统计覆盖率的文件
    def fileFilter = ['**/R.class', '**/R$*.class', '**/BuildConfig.*', '**/Manifest*.*', '**/*Test*.*', 'android/**/*.*']
    def debugClassDir = fileTree(dir: "${buildDir}/intermediates/javac/debug", excludes: fileFilter)
    def mainSrcDir = "${project.projectDir}/src/main/java"

    sourceDirectories.setFrom(files([mainSrcDir])) // 源码目录
    classDirectories.setFrom(files([debugClassDir])) // 插桩后的类文件目录
    executionData.setFrom(fileTree(dir: buildDir, includes: [
            'jacoco/connectedDebugAndroidTest.exec',
            'outputs/code_coverage/debugAndroidTest/connected/*coverage.ec'
    ])) // 覆盖率数据文件路径
}

2. 配置Appium会话，开启覆盖率收集 #

在你的Appium测试代码中，启动会话时需要添加Jacoco相关的capability，让测试过程中能收集覆盖率数据：

DesiredCapabilities caps = new DesiredCapabilities();
caps.setCapability("platformName", "Android");
caps.setCapability("deviceName", "你的设备名/模拟器名");
caps.setCapability("app", "/本地路径/到你的/app-debug.apk"); // 必须用debug包
// 关键：指定Jacoco覆盖率监听器，替换成你的应用包名
caps.setCapability("androidCoverage", "com.your.app.package/com.android.tools.tracer.jacoco.JacocoCoverageListener");

3. 运行测试并导出覆盖率数据 #

测试运行完成后，需要把设备上生成的覆盖率文件拉取到本地，再生成报告：

1. 用adb命令拉取设备上的coverage.ec文件（路径中的包名替换成你的应用包名）：

adb pull /data/data/com.your.app.package/files/coverage.ec ./app/build/outputs/code_coverage/debugAndroidTest/connected/

2. 执行Gradle任务生成可视化报告：

./gradlew jacocoTestReport

报告生成后，你可以在app/build/reports/jacoco/jacocoTestReport/html目录下打开index.html查看详细的覆盖率统计。

4. 常见问题排查 #

如果还是没成功，可以检查这几个点：

• 覆盖率文件为空：确认是debug包、testCoverageEnabled已开启，且androidCoverage中的包名完全正确。
• 报告无数据：检查jacocoTestReport任务中executionData的路径是否和实际拉取的文件路径匹配，有没有遗漏覆盖率文件。
• 插桩失败：确保Jacoco版本和Android Gradle插件版本兼容（比如AGP 7.x对应Jacoco 0.8.7及以上）。
• 真机无法拉取文件：真机需要root权限，或者在应用的debug manifest中添加android:debuggable="true"，并确保有读写内部存储的权限。

额外小技巧 #

如果测试结束后覆盖率数据没自动dump，可以在应用的Application类中添加主动dump的逻辑（仅debug模式下执行）：

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        if (BuildConfig.DEBUG) {
            try {
                Class<?> jacocoAgent = Class.forName("org.jacoco.agent.rt.RT");
                Method getAgent = jacocoAgent.getMethod("getAgent");
                Object agent = getAgent.invoke(null);
                Method dump = agent.getClass().getMethod("dump", boolean.class);
                dump.invoke(agent, false); // false表示不终止应用
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者AMITESH SRIVASTAVA