4、ProGuard实战：混淆Android项目、处理第三方库、解决混淆后崩溃

好，咱们进入真正的实战环节了。

前面讲了那么多理论，什么压缩、混淆、优化、预校验，说实话，光看概念容易晕。我当年刚接触ProGuard的时候，也是看了半天文档，一上手项目就崩。嗯，这很正常。

这一章，咱们就手把手走一遍。从配置一个Android项目开始，到处理那些烦人的第三方库，最后再聊聊混淆后崩溃怎么排查。你跟着我走一遍，心里就有底了。

4.1 在Android项目中启用ProGuard

其实启用ProGuard非常简单。Android Studio早就帮你把架子搭好了。你只需要在模块级的build.gradle文件里，把minifyEnabled设为true就行。

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

这里有两个关键点：

• minifyEnabled true：开启混淆和压缩。注意，它俩是绑定的。
• proguardFiles：指定规则文件。系统默认的规则在SDK目录里，你自定义的规则写在proguard-rules.pro里。

你可能会问，为什么默认只给release开启？因为混淆会拖慢编译速度。你想想看，每次改一行代码都要等ProGuard跑一遍，那得多烦人。所以平时开发用debug，发布前用release跑一遍混淆就够了。

4.2 编写你的第一条混淆规则

打开proguard-rules.pro，你会发现里面空空如也。别慌，咱们从最简单的开始。

混淆的核心，说白了就是告诉ProGuard：哪些东西不能动。

最常见的规则就是保留某个类或方法。比如你的Activity，如果被混淆了，Android系统就找不到它了，一启动就崩。

-keep public class * extends android.app.Activity
-keep public class * extends android.app.Service
-keep public class * extends android.content.BroadcastReceiver

上面这几行，意思就是：所有继承自Activity、Service、BroadcastReceiver的类，都给我留着，别动它们的类名和方法名。

还有一种情况，你的代码里用了反射。比如这样：

Class.forName("com.example.MySecretClass");

如果MySecretClass被混淆成了a.b.c，那Class.forName就找不到了。这时候你需要显式保留它：

-keep class com.example.MySecretClass

4.3 处理第三方库——最头疼的部分

说实话，处理第三方库是混淆里最让人头大的事。每个库的作者对混淆的态度都不一样。有的库已经内置了混淆规则，你什么都不用管。有的库则要求你手动加一堆keep规则。

我一般按这个顺序来处理：

1. 先看官方文档：大多数知名库（比如OkHttp、Retrofit、Glide）都有专门的混淆配置说明。直接复制粘贴就行。
2. 使用-keep保留整个库：如果找不到文档，或者库比较冷门，我倾向于直接保留整个库的包名。虽然会让APK变大一点，但安全第一。
3. 观察编译警告：ProGuard在编译时会输出警告。如果它说“找不到某个类”，那多半是你漏了规则。

举个例子，Retrofit的典型配置是这样的：

-keepattributes Signature, InnerClasses, EnclosingMethod
-keepattributes RuntimeVisibleAnnotations, RuntimeVisibleParameterAnnotations
-keepclassmembers,allowshrinking,allowobfuscation interface * {
    @retrofit2.http.* <methods>;
}
-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement
-dontwarn javax.annotation.**
-dontwarn kotlin.Unit
-dontwarn retrofit2.KotlinExtensions
-dontwarn retrofit2.KotlinExtensions$*

你看，这里面有-keepattributes、-keepclassmembers、还有一堆-dontwarn。为什么这么复杂？因为Retrofit大量使用了注解和动态代理，这些东西在混淆时特别容易出问题。

4.4 混淆后崩溃——怎么排查？

好了，你配置好了规则，打了一个release包。一运行，啪，崩了。这时候怎么办？

别急，我有三板斧：

4.4.1 第一板斧：看堆栈，但要看懂

混淆后的堆栈是这样的：

java.lang.NullPointerException
    at com.example.a.b(Unknown Source:12)
    at com.example.c.d(Unknown Source:45)
    at com.example.e.f(Unknown Source:78)

这谁看得懂啊？别慌，Android SDK里有个工具叫retrace（或者proguardgui.sh）。你需要用到混淆时生成的mapping.txt文件。这个文件在build/outputs/mapping/release/目录下。

用法很简单：

retrace.bat -verbose mapping.txt stacktrace.txt

运行之后，那些a.b、c.d就会变回你熟悉的类名和方法名。嗯，看到真实堆栈，问题就好解决了。

4.4.2 第二板斧：检查keep规则

最常见的崩溃原因，就是某个类或方法被错误地混淆了。我总结了几种典型场景：

崩溃现象	可能原因	解决方案
ClassNotFoundException	类被混淆或移除了	添加-keep class规则
NoSuchMethodException	方法被混淆了	添加-keepclassmembers规则
NullPointerException	Gson/Jackson反序列化失败	保留数据类的无参构造和字段
IllegalArgumentException	枚举被混淆了	保留枚举的values()和valueOf()

4.4.3 第三板斧：二分法排查

如果崩溃原因实在找不到，我会用最笨但最有效的方法——二分法。

具体做法是：先把所有keep规则都注释掉，只保留最基础的（比如Activity、Service）。然后看能不能跑。如果能跑，说明是某个第三方库的规则有问题。然后一半一半地恢复规则，直到找到罪魁祸首。

4.5 实战：一个完整的混淆配置示例

说了这么多，咱们看一个实际项目的配置。假设你的项目用了Retrofit、Glide、Gson，还有自定义的WebView接口：

# ---------- 基础保留 ----------
-keep public class * extends android.app.Activity
-keep public class * extends android.app.Service
-keep public class * extends android.content.BroadcastReceiver
-keep public class * extends android.app.Application

# ---------- Retrofit ----------
-keepattributes Signature, InnerClasses, EnclosingMethod
-keepattributes RuntimeVisibleAnnotations, RuntimeVisibleParameterAnnotations
-keepclassmembers,allowshrinking,allowobfuscation interface * {
    @retrofit2.http.* <methods>;
}
-dontwarn retrofit2.**
-keep class retrofit2.** { *; }

# ---------- Glide ----------
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public class * extends com.bumptech.glide.module.AppGlideModule
-keep public enum com.bumptech.glide.load.ImageHeaderParser$** {
  **[] $VALUES;
  public *;
}

# ---------- Gson ----------
-keepattributes Signature
-keepattributes *Annotation*
-dontwarn sun.misc.**
-keep class com.google.gson.** { *; }
-keep class * extends com.google.gson.TypeAdapter
-keep class * implements com.google.gson.TypeAdapterFactory
-keep class * implements com.google.gson.JsonSerializer
-keep class * implements com.google.gson.JsonDeserializer

# 保留你的数据类（假设在 com.example.data 包下）
-keep class com.example.data.** { *; }

# ---------- WebView JavaScript 接口 ----------
-keepclassmembers class com.example.webview.JsInterface {
    @android.webkit.JavascriptInterface <methods>;
}

# ---------- 枚举 ----------
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

你看，这个配置里，我把每个模块都分开了，注释也写得很清楚。以后维护起来，或者别人接手，一看就明白。

好了，这一章的内容就到这儿。你跟着我把配置跑一遍，再遇到混淆后崩溃，心里就有数了。记住，混淆不是玄学，它是有规律可循的。多踩几次坑，你也能成为专家。