Gradle技术问询：如何针对混淆后的Jar运行测试而非主输出类？

这问题我之前帮同事处理过，默认情况下Gradle测试任务确实直接用主源码编译后的类文件跑测试，但要换成混淆后的Jar，核心就是调整测试任务的类路径，同时确保混淆任务在测试前执行。下面分两种常见场景给你具体配置：

一、Java项目（以ProGuard/ShadowJar为例） #

1. 先配置混淆任务 #

首先你得确保有生成混淆Jar的任务，这里以ProGuard插件和ShadowJar插件为例：

方式1：使用ProGuard官方插件

先引入插件并配置混淆规则：

plugins {
    id 'java'
    id 'com.guardsquare.proguard' version '7.4.2'
}

proguard {
    configurations {
        main {
            // 指定你的混淆规则文件
            configuration files('proguard-rules.pro')
            // 输入主源码编译后的产物
            injars sourceSets.main.output
            // 指定混淆后Jar的输出路径
            outjar "${buildDir}/libs/your-app-obfuscated.jar"
            // 引入项目依赖（避免混淆时丢失必要的依赖类）
            libraryjars configurations.runtimeClasspath
        }
    }
}

方式2：使用ShadowJar插件（带混淆）

如果用ShadowJar打包并混淆，配置如下：

plugins {
    id 'java'
    id 'com.github.johnrengelman.shadow' version '8.1.1'
}

shadowJar {
    // 启用混淆
    mergeServiceFiles()
    transform(com.github.jengelman.gradle.plugins.shadow.transformers.ProGuardTransformer) {
        configuration files('proguard-rules.pro')
    }
    // 指定输出Jar名称
    archiveFileName = "your-app-obfuscated.jar"
}

2. 修改测试任务的类路径 #

接下来要让测试任务放弃默认的主源码输出，改用混淆后的Jar，同时让测试依赖混淆任务：

test {
    // 移除默认的主源码类文件和资源路径
    sourceSets.main.output.classesDirs.each { dir ->
        classpath -= files(dir)
    }
    sourceSets.main.output.resourcesDir?.let { dir ->
        classpath -= files(dir)
    }

    // 添加混淆后的Jar到测试类路径（根据你用的混淆任务调整路径）
    // 如果是ProGuard，用这个路径
    classpath += files("${buildDir}/libs/your-app-obfuscated.jar")
    // 如果是ShadowJar，直接引用shadowJar任务的输出
    // classpath += shadowJar.outputs.files

    // 确保混淆任务先于测试执行
    // ProGuard的话依赖proguard.main
    dependsOn proguard.main
    // ShadowJar的话依赖shadowJar
    // dependsOn shadowJar
}

二、Android项目（针对R8混淆） #

Android项目默认用R8做混淆，你可以创建一个专门的测试任务来针对release混淆后的产物：

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

// 创建自定义测试任务，针对混淆后的release产物
task testObfuscatedRelease(type: Test) {
    // 依赖R8混淆任务
    dependsOn 'minifyReleaseWithR8'
    // 替换类路径为混淆后的Jar + 测试依赖
    classpath = files("${buildDir}/intermediates/runtime_library_classes/release/classes.jar") + configurations.testRuntimeClasspath
    // 指定测试类的路径（用默认的test源码集）
    testClassesDirs = sourceSets.test.output.classesDirs
    // 可以指定测试运行的JVM参数等
    jvmArgs '-ea'
}

关键注意事项 #

• 混淆规则要适配测试：混淆时要保留测试需要调用的主类、方法或字段，不然测试会因为找不到类/方法失败。比如在proguard-rules.pro里添加：

  // 保留测试需要用到的public类和方法
  -keep public class com.example.yourpackage.YourService {
      public <methods>;
  }
  

• 依赖顺序要正确：一定要让测试任务依赖混淆任务，否则可能出现测试跑的时候混淆Jar还没生成的情况。
• 验证类路径：可以通过运行./gradlew test --info查看测试任务的类路径，确认混淆后的Jar已经被包含进去，原来的主类路径已经被移除。

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