Android Java应用Proguard/R8混淆配置问题求助

你的配置与问题 #

基础配置 #

你使用Android Studio 2023.3.1、AGP 8.2.2、Gradle 8.2，初始仅开启minifyEnabled true，未修改proguard-rules.pro，配置如下：

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

核心问题 #

1. 手动构建APK时持续触发R8缺失类错误，添加-dontwarn规则后无效，missing_rules.txt内容未变化；
2. 模拟器构建的APK中，自定义类及方法仍以明文存在，默认混淆未生效。

问题原因及解决办法 #

1. R8报错无法解决的原因 #

AGP 8.x默认用R8替代老版ProGuard，它对缺失类的处理逻辑更严格：

• -dontwarn仅能抑制警告，但R8默认会将缺失类判定为错误而非警告，因此仅添加该规则无效；
• 两种可行解决方式：
  方案一（推荐，明确保留引用）：在proguard-rules.pro中添加完整规则

  -dontwarn org.kxml2.io.KXmlParser,org.kxml2.io.KXmlSerializer
  -keep class org.kxml2.io.** { *; }
  

  方案二（仅确认类不会被调用时使用）：在build.gradle的对应buildType块中添加

  missingClassesAllowed true
  

• 注意：missing_rules.txt中生成的通常是-keep规则而非-dontwarn，需完整复制文件内的规则到proguard-rules.pro，不能仅添加自定义的-dontwarn。

2. 自定义类未混淆的原因 #

默认的proguard-android.txt对debug模式有特殊调试友好配置：

• debug模式下，R8默认保留所有类名、方法名以方便调试。若需在debug模式下开启混淆，需替换默认规则文件：

  proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
  

• 检查proguard-rules.pro是否存在全局保留规则，比如-keep public class com.yourpackage.** { *; }会导致所有自定义类不混淆。正确做法是仅保留必要入口类，示例：

  # 保留Application类
  -keep public class com.yourpackage.MyApplication extends android.app.Application { *; }
  # 保留四大组件
  -keep public class com.yourpackage.** extends android.app.Activity { *; }
  -keep public class com.yourpackage.** extends android.app.Service { *; }
  # 保留序列化类的必要方法
  -keepclassmembers class * implements java.io.Serializable {
      static final long serialVersionUID;
      private static final java.io.ObjectStreamField[] serialPersistentFields;
      private void writeObject(java.io.ObjectOutputStream);
      private void readObject(java.io.ObjectInputStream);
  }
  

• 若release模式也未混淆，确认minifyEnabled true在release块中配置正确，无其他Gradle配置冲突。

适配当前版本的配置参考 #

无需查找网上过时资料，直接查看Android Studio内置官方文档：

• 打开Android Studio，进入File -> Settings -> Languages & Frameworks -> Android SDK -> SDK Tools，确保安装对应版本的Android SDK Build-Tools，查看其中的R8相关文档；
• 或直接在build.gradle中点击minifyEnabled、proguardFiles等关键字，跳转至适配当前AGP版本的官方说明。

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