第四章 混淆与资源压缩优化

4.1 原理与对比

Android 构建工具链中提供两类代码混淆/缩减工具：传统 ProGuard 与新一代 R8。

资源压缩（shrinkResources）会移除未被代码引用的资源文件（drawable、layout、string 等）。它依赖于代码混淆产出的“使用清单”，因此必须与 minifyEnabled 同时启用。

4.2 实现流程

1. 开启混淆与资源压缩：在 build.gradle.kts 的 release 构建类型中配置。
2. 编写 / 维护规则文件：保留反射调用、JNI 接口、第三方库入口、序列化类等。
3. 添加白名单：适应业务特殊需求（如 Gson 序列化、Retrofit 接口、EventBus 事件类）。
4. 验证与调试：构建 Release 包后通过 Mapping 文件解析崩溃栈，检查资源是否被误删。
5. 集成到 CI：确保每次 Release 发布前都执行完整的混淆+资源压缩检查。

4.3 关键配置与规则示例

以下为标准的 Release 构建配置（Kotlin DSL）：

android {
    buildTypes {
        release {
            isMinifyEnabled = true
            isShrinkResources = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
}

proguard-rules.pro 常见规则片段：

# 保留 Application 类
-keep class com.example.MyApplication { *; }

# 保留 Gson 序列化需要的类
-keepclassmembers class * {
    @com.google.gson.annotations.SerializedName <fields>;
}

# 保留 Retrofit 接口
-keep,allowobfuscation interface * {
    @retrofit2.http.* <methods>;
}

# 保留 EventBus 事件类（如果使用）
-keepclassmembers class * {
    @org.greenrobot.eventbus.Subscribe <methods>;
}

# 保留 JNI 方法
-keepclasseswithmembernames class * {
    native <methods>;
}

# 保留枚举（防止混淆导致枚举序列化异常）
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

# 保留资源引用（R 类）
-keep class **.R$* { *; }

4.4 白名单维护策略

白名单本质上就是 -keep 规则的集合。建议采用分层维护：

• 框架层：Android SDK、Jetpack、主流三方库（Retrofit、OkHttp、Glide、Room 等）的官方规则通常已包含在 proguard-android-optimize.txt 中，但需验证。
• 业务层：序列化（Gson / Moshi / Kotlinx Serialization）、反射调用（ARouter、ButterKnife 等）需手动添加。
• 测试与工具：保留 debug 构建类型中的日志类（Timber 等）。

高效白名单维护工具：

# 使用 Android Studio 的“ProGuard Playground”插件（搜索 “ProGuard” plugin）
# 或通过 Gradle 任务生成规则建议
./gradlew :app:minifyReleaseWithR8 -Dprintseeds

4.5 调试与反混淆

Release 包崩溃后，需用 Mapping 文件还原堆栈：

# Mapping 文件位置
app/build/outputs/mapping/release/mapping.txt

# 使用 retrace 工具（位于 $ANDROID_HOME/tools/proguard/bin/retrace.sh）
retrace.bat -verbose mapping.txt crash_stack.txt

若发现 ClassNotFoundException 或 NoSuchMethodError，通常是因为未在规则中保留反射或动态加载的类。解决方案：

1. 将缺失类加入 -keep 规则。
2. 检查三方库是否需要补充规则（查看库文档或 Github 示例）。

4.6 常见错误与避坑

4.7 性能与稳定性优化

• 优化级别选择：R8 默认使用 R8.fullMode=true，可尝试 android.r8.fullMode=false 提升构建速度（但可能损失部分优化效果）。
• 规则精简：避免通配符 ** 过多，尤其 -keep class ** { *; } 会扫描所有类，极大拖慢编译。
• 资源压缩白名单：使用 res/raw/keep.xml 精确列举。
• Mapping 文件归档：每次 Release 打包后自动保存 mapping.txt 到指定目录，方便后期追溯。

4.8 完整工作流（SVG）