Kotlin JaCoCo - IllegalClassFormatException。请提供原始的非仪器类

Question

我正在尝试获取 Android 应用程序模块的测试覆盖率报告并执行testVariantBuildTypeUnitTest任务。

尽管所有测试均已通过，但TEST-classNameTest.xml文件包含以下错误消息。仅当包含从 Kotlin 调用 Java 的方法时才会出现此错误。这个问题有什么解决办法吗？

**Caused by: java.lang.IllegalStateException: Cannot process instrumented class... Please supply original non-instrumented classes.
at org.jacoco.agent.rt.internal_f3994fa.core.internal.instr.InstrSupport.assertNotInstrumented(InstrSupport.java:238)
at org.jacoco.agent.rt.internal_f3994fa.core.internal.instr.ClassInstrumenter.visitField(ClassInstrumenter.java:56)
at org.jacoco.agent.rt.internal_f3994fa.asm.ClassVisitor.visitField(ClassVisitor.java:339)
at org.jacoco.agent.rt.internal_f3994fa.asm.ClassReader.readField(ClassReader.java:1111)
at org.jacoco.agent.rt.internal_f3994fa.asm.ClassReader.accept(ClassReader.java:713)
at org.jacoco.agent.rt.internal_f3994fa.asm.ClassReader.accept(ClassReader.java:401)
at org.jacoco.agent.rt.internal_f3994fa.core.instr.Instrumenter.instrument(Instrumenter.java:90)
at org.jacoco.agent.rt.internal_f3994fa.core.instr.Instrumenter.instrument(Instrumenter.java:108)

我们有多模块 android 项目，因此我们使用这个自定义 Jacoco 任务来获取覆盖率报告：

project.afterEvaluate {

    (android.hasProperty('applicationVariants')
            ? android.'applicationVariants'
            : android.'libraryVariants')
            .all { variant ->
                def variantName = variant.name
                def unitTestTask = "test${variantName.capitalize()}UnitTest"

                def jacocoReportName = unitTestTask + project.name

                tasks.create(name: jacocoReportName, type: JacocoReport, dependsOn: [
                        "$unitTestTask"
                ]) {
                    group = "Reporting"
                    description = "Generate Jacoco coverage reports for the ${variantName.capitalize()} build"

                    reports {
                        html.enabled = true
                        xml.enabled = true
                    }

                    def fileFilter = [
                            // data binding
                            'android/databinding/**/*.class',
                            '**/android/databinding/*Binding.class',
                            '**/android/databinding/*',
                            '**/androidx/databinding/*',
                            '**/databinding',
                            '**/BR.*',
                            // android
                            '**/R.class',
                            '**/R$*.class',
                            '**/BuildConfig.*',
                            '**/Manifest*.*',
                            '**/*Test*.*'
                    ]

                    def javaClasses = fileTree(dir: variant.javaCompileProvider.get().destinationDir,
                            excludes: fileFilter)
                    def kotlinClasses = fileTree(dir: "${buildDir}/tmp/kotlin-classes/${variantName}",
                            excludes: fileFilter)

                    classDirectories.setFrom(files([
                            javaClasses,
                            kotlinClasses
                    ]))

                    def variantSourceSets = variant.sourceSets.java.srcDirs.collect { it.path }.flatten()
                    sourceDirectories.setFrom(project.files(variantSourceSets))

                    if (isAndroidLibrary(project)) {
                        executionData(files([
                                "${projectDir}/jacoco.exec"
                        ]))
                    }else{
                        executionData(files([
                                "$project.buildDir/jacoco/${project.name}.exec"
                        ]))
                    }

                }

            }
}

问候，

Answer 1

解决方案

问题很可能出在您的模块级 build.gradle文件中。您需要删除 testCoverageEnabled或将其设置为 false。

android {
 ...
  buildTypes {
     release {
        minifyEnabled true
     }
     debug {
        // testCoverageEnabled true 
        minifyEnabled false
     }
  }

解释和参考

• 首先，我多年来一直在使用 JaCoCo 解决 Android 上的单元测试覆盖率问题，并且随着 AGP（Android Gradle 插件）团队增强了 AGP（例如类似问题） ，多次遇到这些问题，因此该解决方案在未来版本中可能会发生变化AGP 的。

• 随着AGP 4.1的发布，AGP 团队改变了插件处理单元测试的方式。我向 AGP 团队提出了一个输入链接描述问题，他们解释说该插件（AGP 4.1+）使用自己的检测形式来获取覆盖范围，这无疑与 JaCoCo 不兼容。正是在这个问题上，我向我强调了解决方案。

注 1： DSL 文档中没有记录此问题！

注 2：还应该指出的是，截至我撰写本文时，AGP 7 正在开发中，也出现了相同的问题。

注意事项

此解决方案将导致生成仪器测试覆盖率的问题，因为 AGP 生成仪器测试覆盖率（以 .ec 文件的形式），这意味着要获得仪器测试覆盖率，您必须拥有 testCoverageEnabled true。作为解决方法，您可以：

• 将您的单元测试放入发布版本变体中
• 将您的仪器测试放入调试构建变体中。仍然可以将覆盖范围合并到一份报告中：例如：

task jacocoCombinedUnitTestAndroidTestReport(type: JacocoReport) {
        group = "Reporting"

        reports {
            xml.enabled = true
            html.enabled = true
        }

        def mainSrc = "$project.projectDir/src/main/java"
        def releaseKotlinClasses = fileTree(dir: "${buildDir}/tmp/kotlin-classes/release", excludes:["com/example/ui**"])
        def debugKotlinClasses = fileTree(dir: "${buildDir}/tmp/kotlin-classes/debug/com/example/ui/")
        def releaseJavaClasses = fileTree(dir: "${buildDir}/intermediates/javac/release", excludes: ["com/example/ui**"])
        def debugJavaClasses = fileTree(dir: "${buildDir}/intermediates/javac/debug/com/example/ui/" )

        def mainClasses = releaseKotlinClasses + debugKotlinClasses
        def javaClasses = releaseJavaClasses + debugJavaClasses

        sourceDirectories.from = files([mainSrc])
        classDirectories.from = files([mainClasses, javaClasses])
        executionData.from = fileTree(dir: buildDir, include: ["jacoco/testReleaseUnitTest.exec",
                                                                    "outputs/code_coverage/debugAndroidTest/connected/**.ec"])
}

• 这假设您在 ui 目录中有任何 UI 代码。
• 您包括除 ui 目录之外的所有发布类
• 您只包含您的 ui 调试类。

请注意，这仅在编写此答案时有效，希望 Google 将来能够解决该问题。