用途:面向 Jetpack Compose 应用配置 R8 压缩与优化,在发布版本中获得更小的 APK 与更好的运行性能。R8 是唯一受支持的 shrinker,ProGuard 已弃用;Compose 自带 consumer ProGuard 规则,多数应用无需添加 Compose 专用 keep。
主要能力:讲解 R8 full mode(AGP 8.0 起默认)的收益,包括 lambda grouping、sourceInformation() 剥离、composable 参数常量折叠、ComposerImpl 去虚拟化,以及配合 isShrinkResources = true 的资源压缩;资料引用约 75% 启动提升与 60% 帧渲染提升(debug 到 release)。
必要用法:release 构建配置 isMinifyEnabled = true、isShrinkResources = true,proguardFiles 使用 getDefaultProguardFile("proguard-android-optimize.txt") 与 "proguard-rules.pro",不要误用 proguard-android.txt。不要添加 -keep class androidx.compose.** { *; } 等大范围规则,也不要为便于调试而加 -dontobfuscate 或 -dontoptimize。依靠 AGP 8.x 的 missing_rules.txt 报告定位缺失的窄 keep;反射消费者(kotlinx.serialization、Hilt、Moshi 等)优先通过官方 Gradle 插件自动生成规则,否则只添加针对具体类的窄规则。可用 retrace 还原崩溃栈:$ANDROID_HOME/cmdline-tools/latest/bin/retrace app/build/outputs/mapping/release/mapping.txt < crash.txt,或 ./gradlew :app:retraceR8DebuggingArtifact。用 assembleRelease 与 APK 分析对比方法数,并用 Macrobenchmark 验证收益。
适用场景:新 Compose 应用首次配置 release;PR 引入 Compose 级 keep 时纠正;启用压缩后 release 崩溃(通常是反射消费者缺少 keep,而非 Compose);APK 体积审查;首次开启 isMinifyEnabled 前。不适用于尚未准备发布、调试普通逻辑 bug、已测量且正常、或性能问题是重组/布局/稳定性时。
限制:要求 AGP 8.0+(更早版本需在 gradle.properties 设 android.enableR8.fullMode=true)、可构建的 release 变体、Kotlin 2.0+ 与 org.jetbrains.kotlin.plugin.compose 插件。其他具体收费、平台支持等资料暂未提供。