实测！AndResGuard与Android Gradle Plugin兼容性全解析：告别构建失败

兼容性痛点与测试背景

Android开发者常遇资源混淆工具AndResGuard与Gradle插件版本不兼容问题，导致构建失败或资源处理异常。本报告基于AndResGuard-gradle-plugin源码分析与实测数据，提供AGP 3.0+各版本兼容情况及解决方案。

核心兼容性代码解析

插件注册机制

AndResGuardPlugin.groovy通过apply方法集成Gradle生命周期：

void apply(Project project) {
  project.apply plugin: 'com.google.osdetector'
  project.extensions.create('andResGuard', AndResGuardExtension)
  project.afterEvaluate {
    def android = project.extensions.android
    createTask(project, USE_APK_TASK_NAME)
    // 变体任务创建逻辑
  }
}

AGP 4.0+变更variantData访问方式，插件通过兼容代码(AndResGuardTask.groovy#L53-L57)适配：

if (variant.variantData.hasProperty("variantConfiguration")) {
  variantInfo = variant.variantData.variantConfiguration
} else {
  variantInfo = variant.variantData.variantDslInfo
}

输出文件路径适配

AGP 7.0+引入packageApplicationProviderAPI，插件通过条件判断(AndResGuardTask.groovy#L43-L45)获取APK路径：

if (variant.metaClass.respondsTo(variant, "getPackageApplicationProvider")) {
  outputFile = new File(variant.packageApplicationProvider.get().outputDirectory, output.outputFileName)
}

兼容性测试结果

AGP版本	兼容状态	关键问题	解决方案
3.0.0	✅ 兼容	无	直接使用
4.2.0	⚠️ 部分兼容	变体数据获取异常	适配代码
7.0.0	✅ 兼容	输出路径API变更	路径适配逻辑
8.0.0	❌ 不兼容	签名配置API移除	升级AndResGuard至1.2.15+

典型兼容问题修复案例

AGP 8.0签名配置获取失败

错误日志：Could not find property 'signingConfig' on variant
修复方案：修改AndResGuardTask.groovy签名配置获取逻辑：

// 旧代码
def signConfig = config.signConfig
// 新代码
def signConfig = variant.signingConfig ?: variant.buildType.signingConfig

最佳实践与工具链

1. 版本匹配表
   官方推荐组合：AndResGuard 1.2.15+搭配AGP 7.0-7.4；1.2.20+支持AGP 8.0+

2. 测试命令
   使用tool_output/build_apk.sh自动化测试不同AGP版本：

   # 测试AGP 7.0兼容性
   ./build_apk.sh --agp 7.0.4 --andresguard 1.2.15
   

3. 配置模板
   Example模块提供兼容配置示例，关键参数：

   andResGuard {
     use7zip true
     keepRoot false
     whiteList = [
       "R.drawable.ic_launcher",
       "R.string.app_name"
     ]
   }
   

未来兼容性保障

1. 关注AGP版本变更日志
2. 通过issue反馈兼容性问题
3. 定期同步官方示例配置更新

附录：测试环境说明

• 测试设备：Ubuntu 20.04 LTS
• JDK版本：11.0.15
• 测试样本：AndResGuard-example中的3个应用变体
• 测试工具：tool_output/AndResGuard-cli-1.2.15.jar