R8在AGP 3.4+中默认启用,需正确开启优化开关并处理规则冲突:minifyEnabled true仅为起点;AGP 8.1+默认Full Mode,9.3+推荐optimization { enable = true },低版本须指定proguard-android-optimize.txt;宽泛keep规则会抑制优化,应改用细粒度规则;shrinkResources依赖代码缩减结果,需结合resConfigs和resourceOptimizations补全清理;入口点识别不准易致误删,应显式声明或加@Keep。

R8 在 AGP 3.4+ 中默认启用,你不需要手动“安装”它;真正要做的,是正确开启优化开关并处理规则冲突。
minifyEnabled true 是起点,不是终点
仅设置 minifyEnabled true 会让 R8 执行基础混淆和缩减,但不会启用激进优化(如方法内联、类合并)。AGP 8.1+ 默认启用 Full Mode,但低版本或自定义配置下容易退化为兼容模式。
- AGP 9.3+ 推荐改用新 DSL:
optimization { enable = true },它同时触发代码与资源优化,并自动加载 Android 平台默认 keep 规则(等效于proguard-android-optimize.txt) - AGP 8.0–9.2 仍需沿用旧写法,但必须确保
proguardFiles指向proguard-android-optimize.txt而非proguard-android.txt,否则优化力度大幅下降 - AGP < 8.0 且未显式指定
-optimize指令时,R8 实际运行在“兼容模式”,几乎不执行逻辑优化
keep 规则写错会导致 R8 “不敢动”关键代码
常见错误是把 -keep class com.example.** { *; } 这类宽泛规则直接塞进 proguard-rules.pro。R8 会严格遵守这些约束,哪怕某个类只被 Gson 反序列化一次,整包都被锁死无法 shrink/obfuscate/inline。
远程控制 Android 设备,支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架,通过 ADB 连接设备,用户无需 Root(1)查看手机屏幕;(2)自动化操作手机 App;(3)远程安装/卸载应用……
- 优先用细粒度规则:对 Gson 映射类,写
-keep class com.example.model.UserResponse { <fields>; },而非{ *; } - 第三方库自带的 consumer-proguard-rules.pro 会被自动合并,可用
./gradlew app:dependencies --configuration releaseRuntimeClasspath查看哪些 AAR 贡献了规则 - 启用
r8-analyzer技能后运行./gradlew r8AnalyzeRelease,能输出具体有多少 class/method 因某条规则失去优化能力
shrinkResources true 不等于资源真被删了
shrinkResources true 依赖代码缩减结果——只有当 R8 确认某个资源 ID 在字节码中完全未被引用,才会删除对应文件。如果资源通过字符串拼接、反射或自定义 View 构造器引用,它大概率被漏掉。
- 检查是否生效:解压 APK 后执行
grep -r "R.drawable.xxx" ./classes.dex,若无结果但资源仍在,说明引用方式逃逸了静态分析 - 配合
resConfigs "zh", "en"和android.enableResourceOptimizations=true(AGP 8.8+)可补全语言与密度资源清理 - 资源缩减失败时,
build/outputs/mapping/release/resources.txt会列出所有“疑似未使用但被保留”的资源及原因
最易被忽略的是:R8 的优化效果高度依赖入口点识别准确性。Activity、Service 等四大组件由 manifest 自动注册为入口,但自定义 ContentProvider、Instrumentation 或 Jetpack Compose 预加载类,若未显式声明为入口,相关链路可能被误删——这时候不是关掉 R8,而是补 -keep 或用 @Keep 注解标定。

















