类与成员保留策略：保持Activity、Fragment、Service等四大组件不被混淆

4.1 原理：组件名称为何必须保留

Android 系统通过 包名 + 类名 的完整限定名在 AndroidManifest.xml 中注册并启动四大组件（Activity、Service、BroadcastReceiver、ContentProvider）。Fragment 虽未在清单中直接注册，但常被 Activity 通过布局或事务动态引用，其类名同样需要保留。

• 系统反射调用：AMS（ActivityManagerService）通过反射实例化清单中声明的组件类，混淆后类名变更会导致 ClassNotFoundException。
• 布局文件绑定：Fragment 通过 android:name 属性在布局中引用，混淆后名称不匹配将引发加载失败。
• Intent 显式启动：显式 Intent 使用 Context.startActivity(Intent) 并传入目标类对象，混淆后类名改变会导致 Intent 无法路由。

4.2 核心保留规则配置

在 proguard-rules.pro 文件中为每个组件类型添加精确的 keep 规则。R8 在 AGP 3.4+ 中默认对清单注册的组件自动保留，但显式配置仍是防御性最佳实践。

-keep public class com.example.app.MainActivity { *; }
-keep public class com.example.app.DetailActivity { *; }
-keep public class com.example.app.MyFragment { *; }
-keep public class com.example.app.SyncService { *; }
-keep public class com.example.app.ConnectivityReceiver { *; }
-keep public class com.example.app.AppContentProvider { *; }

4.3 实现流程与步骤

1. 定位所有组件类：扫描 AndroidManifest.xml 中 <activity>、<service>、<receiver>、<provider> 节点的 android:name 属性；检查布局文件中 android:name 引用的 Fragment 类。
2. 编写保留规则：在 proguard-rules.pro 中为每个组件添加 -keep 规则，优先使用精确类名。
3. 配置混淆开关：在模块级 build.gradle 中启用混淆，指定规则文件路径。

// build.gradle (app 模块)
android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                          'proguard-rules.pro'
        }
    }
}

4. 执行构建：运行 ./gradlew assembleRelease，生成混淆后的 APK。
5. 验证保留结果：使用 aapt 或 dexdump 检查 APK 中组件类的名称是否保持原样。

4.4 调试与验证方法

构建完成后，通过以下两种方式确认组件未被混淆：

• 查看映射文件：build/outputs/mapping/release/mapping.txt 中记录了原始类名与混淆后类名的对应关系。搜索组件类名，若右侧名称与左侧相同，说明保留成功。
• 直接反编译 APK：使用 d2j-dex2jar 将 DEX 转为 JAR，再用 JD-GUI 打开，检查组件类的包名和类名是否完整。

4.5 常见错误与解决方案

4.6 性能与稳定性优化建议

• 避免过度保留：不要使用 -keep class com.example.app.** { *; } 这种全通配规则，它会保留包下所有类及其全部成员，显著增加 APK 体积并降低混淆效果。改为按组件类型或精确类名保留。
• 利用 R8 自动保留：AGP 3.4+ 集成的 R8 会自动分析 AndroidManifest.xml 并保留所有注册组件，此时仅需在规则文件中补充 Fragment 和非清单引用的内部类。
• 保留构造方法：组件类必须保留 无参构造方法，因为系统通过 Class.newInstance() 实例化。在 keep 规则中添加 { public <init>(...); } 或在类级别保留全部成员。

// 推荐：保留特定 Activity 及其所有构造方法
-keep public class com.example.app.MainActivity {
    public <init>(...);
}

// 或保留整个类及其全部成员（更安全但体积略大）
-keep public class com.example.app.MainActivity { *; }

• 多模块项目统一规则：在多模块工程中，将公共组件保留规则抽取到 base-rules.pro，并通过 apply from 引入，避免各模块重复配置导致遗漏。
• CI 流水线自动化验证：在持续集成脚本中添加检查步骤，解析 mapping.txt 并断言关键组件类未被混淆，防止规则变更引发生产事故。