Flutter 3.7.11中ProGuard/R8规则无法正确使用的问题

核心问题定位 #

你遇到的是Release模式下R8混淆工具将插件中需要通过类名反射加载的原生类混淆/移除，导致反射找不到类的问题。由于Flutter插件作为独立模块，其混淆规则的生效逻辑和单项目不同，需分别配置插件端和主应用端的混淆规则。

分步解决方案 #

1. 插件端Android模块配置

在插件的android目录下完成以下操作：

• 修改build.gradle，确保Release构建开启混淆并指定规则文件：

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

• 创建/编辑proguard-rules.pro，添加核心私有库的保留规则（替换为你的实际包名）：

# 保留指定包下所有类的类名（反射需要类名不混淆）
-keepnames class com.your.plugin.private.lib.**
# 保留类的所有成员（如果反射需要调用成员方法/字段）
-keep class com.your.plugin.private.lib.** { *; }
# 若存在内部类，需额外保留
-keepnames class com.your.plugin.private.lib.**$*
-keep class com.your.plugin.private.lib.**$* { *; }
# 保留Flutter Channel调用的方法（替换为你实际的方法签名）
-keepclassmembers class com.your.plugin.private.lib.** {
    public void onMethodCall(io.flutter.plugin.common.MethodCall, io.flutter.plugin.common.MethodChannel.Result);
}

2. 主应用端配置

在主应用的android/app目录下：

• 确保build.gradle的Release构建开启混淆：

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

• 在主应用的proguard-rules.pro中添加相同的插件类保留规则（若插件端规则未自动合并时补充），避免主应用的混淆规则覆盖插件配置。

3. R8优化适配

R8默认会移除未被直接引用的类，需确保反射用到的类不被误删：

• 在规则中添加-keep而非仅-keepnames，-keep会同时保留类和成员，防止被R8移除：

-keep class com.your.plugin.private.lib.** { *; }

• 若无需保留成员仅需类名，可结合allowshrinking（但不推荐反射场景）：

-keep,allowshrinking,allowobfuscation class com.your.plugin.private.lib.**
-keepnames class com.your.plugin.private.lib.**

4. 验证混淆效果

• 执行flutter build apk --release生成安装包
• 使用dex2jar将APK中的classes.dex转换为Jar文件，通过JD-GUI工具查看目标类是否仍保持原名且未被移除。

常见排查点 #

• 检查包名拼写：混淆规则中的包名必须和原生类的实际包名完全一致，大小写敏感
• 插件依赖方式：若插件是本地path依赖，确保主应用pubspec.yaml中依赖配置正确；若为远程AAR，需确保AAR包含混淆规则
• 避免全局混淆规则冲突：主应用的proguard-rules.pro中不要存在覆盖插件规则的全局配置（如-dontobfuscate会禁用所有混淆）

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