AGP 8.4库混淆变更的动机及相关构建问题咨询

一、AGP 8.4引入库混淆纳入消费者构建的核心原因 #

AGP团队推出这一变更主要是为了解决过往构建流程中的几个关键问题：

• 提升构建效率：旧版本中，库模块的代码缩减仅在自身构建阶段完成，但应用模块构建时会对依赖的库代码重复执行缩减操作，造成资源浪费。将混淆后的库产物直接提供给消费者，避免了重复处理，缩短了整体构建周期。
• 强化库代码安全性：部分库开发者希望内部实现逻辑在被应用依赖时仍保持混淆状态，防止逆向工程。旧机制下，应用模块的配置可能导致库代码被意外反混淆暴露，新变更确保库的混淆效果贯穿整个构建链路，从库构建到最终APK打包都能维持代码的混淆状态。
• 精简最终产物：库模块混淆时会移除未使用的内部类与冗余代码，消费者直接使用精简后的产物，能有效减少最终APK的体积，同时降低因未混淆的库内部类引发的类冲突风险。

二、Hilt生成类被R8移除的构建失败修复方案 #

针对你遇到的升级后发布构建失败问题，可通过以下方式解决：

• 补充Hilt专属混淆规则：在库模块的proguard-rules.pro文件中添加规则，防止R8误删Hilt生成的类：

  # 保留Hilt核心类与生成组件
  -keep class dagger.hilt.** { *; }
  -keep class * implements dagger.hilt.internal.GeneratedComponent { *; }
  -keepnames class @dagger.hilt.android.AndroidEntryPoint *
  -keepclassmembers class @dagger.hilt.android.AndroidEntryPoint * {
      <init>(...);
  }
  # 保留Hilt生成的视图组件管理器类
  -keep class * extends dagger.hilt.android.internal.managers.ViewComponentManager { *; }
  

• 优化库模块的代码缩减配置：无需直接禁用库模块的代码缩减，建议保留缩减并配置正确的混淆规则。在库模块的构建脚本中确保代码缩减启用：

  // Groovy 构建脚本
  android {
      buildTypes {
          release {
              minifyEnabled true
              proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
          }
      }
  }
  

  // Kotlin DSL 构建脚本
  android {
      buildTypes {
          release {
              isMinifyEnabled = true
              proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
          }
      }
  }
  

• 标记需保留的生成类：对Hilt生成的关键类，可直接添加@Keep注解，强制R8保留该类及其成员，避免被误删。

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