- R8 删除了无人使用的代码和资源,重写了其余部分,并缩短了名称,从而创建更小、启动速度更快、响应速度更慢的应用程序。
- 建议在发布版本中启用优化,并调整资源保留规则,这是阻止 R8 发挥全部性能的主要障碍。
- R8 的配置分析器会衡量有多少代码可以进行缩减、优化和混淆,并标记出范围过广、重复或无用的规则。
- 使用 App Bundles、轻量级图像、语言和密度调整以及持续的大小测量来完成任务,可以显著提高下载速度。
压缩 Android 应用并非只是删除单个文件;它需要在应用大小、启动速度和内存占用之间找到微妙的平衡。Android内置的优化器 R8 可以处理大部分工作,无需您编写任何代码:它会分析哪些代码和资源正在被使用,移除未使用的部分,并重写剩余部分以降低运行开销。您的应用用户会感受到更快的启动速度、更低的内存占用、更流畅的界面以及更少的崩溃信息。
关键在于给它足够的工作空间。R8 可以访问的代码库范围越大,效果就越好。过于宽泛的保护规则是最常见的障碍,因为它们会锁定那些可能不会被动态调用的类和方法,以及它们的依赖项。不断完善这些规则、进行测量和重新测试,是区分简单发布应用和真正精细调优应用的关键所在。
R8究竟有什么功能?为什么你应该信任它?
R8 的工作流程分为一系列相互关联的阶段。首先,它会分析实际的入口点,例如清单文件中声明的活动或服务,构建一个所有引用的映射表,并丢弃映射表之外的任何内容。然后,它会进行逻辑优化:将调用替换为被调用方法的主体,合并类和接口,简化结构,并降低执行开销。最后,它会缩短类、字段和方法的名称,例如,将类似 `com.example.MyActivity` 的类名缩短为 `aba`,从而节省元数据。
- 减少死代码使用频率较低的依赖项将不再发挥其全部作用。
- 更高效的执行插入方法和合并类可以减少调用次数和内存压力。
- 较轻的DEX文件混淆可以保存元数据并加快类加载速度。
- 调整后的资源自 Gradle 插件 8.12 版本起,R8 也参与了资源优化。
从用户角度来看,这意味着更快的启动速度、更低的内存消耗、更佳的渲染效果以及更少的应用无响应问题。官方建议很明确:在发布版本中启用优化。但对于日常测试或库开发而言,通常没有必要这样做,因为名称更改会增加编译时间并增加调试难度。
启用基于 Gradle 插件版本的优化
如果您使用的是最新版本的 Android Gradle 插件,操作已大大简化。只需在发布构建类型的优化代码块中启用一个标志,并将您的 keep 规则放置在特定的源代码集中(例如,将以 .keep 结尾的文件放置在 src/main/keepRules 目录下)。这种新方法涵盖了代码和资源,并包含与旧版 ProGuard 优化规则等效的默认平台规则,因此无需声明额外的文件。
对于基于插件早期版本的项目,标准做法是在发布构建类型中包含两个参数:一个用于启用代码压缩,另一个用于启用资源精简。明智的做法是同时启用这两个参数,并添加系统自动生成的优化规则文件,以及必要的自定义规则文件。在发布构建中不启用这些参数,是悄悄地将大量资源浪费给用户的一种方式。
全模式和优化资源缩减
R8 的完整模式默认启用多年,它对反射和动态调用的使用提出了更严格的要求。如果有人曾经编写过禁用完整模式的属性,最好将其删除:禁用完整模式会降低优化器的潜力。但是,在包含大量动态代码的项目中,完整模式可能需要额外的规则,因此务必使用实际发布版本进行测试,而不仅仅是单元测试。
优化的资源缩减功能在插件 8.12 版本中引入,自 9.0 版本起,启用资源缩减功能后会自动应用。其理念是将资源视为代码图的一部分:以前,打包工具会生成保留规则,使无法访问的资源和相互引用的代码保持有效;现在,如果一组代码和资源不再使用,则不再受保护并会被删除。在具有多种设备规格的应用程序中,已测得文件大小缩减超过 50%。
R8 配置分析器及其三个评分
此分析器工具可告知您配置是起到促进作用还是阻碍作用。它会生成统计数据,显示您的代码库中实际可进行代码精简、优化和混淆的百分比。如果精简得分为 66%,则意味着 R8 可以从三分之二的代码库中移除代码;如果优化得分相同,则只能对三分之二的代码应用方法插入、类合并和其他技术。混淆得分衡量的是可以缩短多少代码以节省元数据。
除了总体指标外,该报告还详细说明了每条规则的影响以及它们阻碍的优化属性。报告还会识别源自第三方库的规则,这非常有用,因为这些库的作者并不熟悉您的具体实现,有时编写的规则过于通用,以至于会阻碍应用程序中与功能完全无关的部分的优化。
如何快速生成报告
为了快速迭代规则,Gradle 提供了一个专门的任务,它可以在不打包 APK 或 bundle 的情况下分析发布配置。这样可以大大缩短反馈周期,并且生成的 HTML 报告会位于模块的 reports 文件夹中,该文件夹下有一个专门用于 R8 的目录。如果您正在微调规则并希望立即看到每次更改的效果,那么这是推荐的选择。
如果您偏好自动分析,任何发布版本都会在映射结果中生成一个 HTML 文件。如果您觉得自动生成很麻烦,可以使用相应的实验性属性禁用此功能。在插件的旧版本中,解决方法是将最新的 R8 版本添加到项目的类路径中,并在运行构建时使用系统属性指定报告的保存目录。
在不破坏应用程序的前提下完善保护规则
目标是只保留真正可以通过反射访问的内容,不多也不少。首先,检查那些阻碍大量类进行优化的规则,审查它们保护了哪些元素,并验证它们是否真的被动态调用。然后缩小范围:与其保留包含所有成员的整个包,不如将规则限制在特定的类和成员上。在实施更改之前,运行测试来覆盖受影响的类、字段和方法。
此外,要谨慎处理被包含的规则。如果一条规则保护整个包,而另一条规则保护该包中的一个类,那么后一条规则就没有任何作用,而第一条规则会阻碍你可能并不需要的优化。判断哪条规则更准确:如果范围更窄的规则编写得当,则移除范围更广的规则并解锁包的其余部分;如果范围更广的规则正确,则仍然移除它,但要重写它,使其只影响必要的部分。然后再次运行分析器并编译完整版本,以验证一切是否仍然正常工作。
重复、未使用和库规则
分析器识别出两个明显的冗余来源:一是与当前构建中的任何类、方法或字段都不匹配的规则,二是同一文件或不同文件中重复出现的相同规则。前者通常在重构或移除依赖项后被遗留,成为无用代码;后者则会增加维护难度,却没有任何实际好处。清理这些冗余代码可以使配置更易于阅读和调试。
使用第三方库时,操作空间很小,因为它们的规则是打包好的,无法选择性地编辑。比较实际的做法是,将影响记录在报告中并通知维护者,或者暂时将这些规则复制到你的项目中,排除那些影响范围更广的规则,并在决定是否值得承担风险之前评估潜在收益。
ProGuard 和 R8:相似但不完全相同
多年来,ProGuard 做了四件事:移除未使用的元素、优化字节码、混淆名称以及添加预检查信息。R8 在此基础上更进一步:它更积极地插入方法、合并类、尽可能将枚举转换为整数,并且对 Kotlin 的特性有了更深入的理解。此外,它的编译速度更快,并且由于核心库的去甜化,允许在旧版本的 Android 上使用现代 Java API。
关于规则,R8 接受 ProGuard 的规则,并添加了一些自身的修改器,例如强制或阻止插入特定方法的规则。名称转换不会改变行为,但会使读取堆栈跟踪变得复杂:它始终为每个版本保留映射文件,以便在生产环境发生故障时恢复原始跟踪。
压缩过程中常见的错误以及如何摆脱困境
同样的问题反复出现:由于类被删除导致的“找不到类”,由于方法被重命名导致的“没有此方法”,由于模型名称丢失而无法序列化,或者库假设一切都不会改变。诊断几乎总是需要检查通过反射访问的内容,并添加最小必要规则。为了进行调查,可以启用使用情况、种子和映射打印到临时文件,或者暂时禁用某些优化来找出问题所在。
值得注意的是,重新生成或修补 DEX 文件的外部工具可能会破坏 R8 精心实现的优化。如果您的构建链包含此类步骤,请在指责优化器之前先检查该步骤。如果构建性能是您关注的问题,您可以进行一些调整,使 R8 适应您的环境,同时又不牺牲其优势。
减少资源:图像、密度和语言
资源通常占据文件包的很大一部分。将位图转换为 WebP 格式可以在保持质量的同时减小文件大小,而矢量图则可以避免为每种密度重复使用相同的图标。仅配置实际使用的密度范围并限制包含的语言可以显著减小文件大小,尤其是在翻译较多的应用程序中。对于无法转换的 PNG 文件,可以使用一些压缩工具,以最小的损失进行压缩。
它还有助于以编程方式将单个资源着色为灰度图,而不是捆绑多个彩色版本;在启动时按需加载大型、不必要的图像;并使用 IDE 的代码检查功能移除孤立资源。如果某个资源仅被无效代码引用,优化后的资源缩减机制会检测并移除它,而这在以前是不会发生的,因为这两个进程是独立运行的。
布局、样式和视图层级
扁平化层级结构并不会减小 APK 的大小,但可以提升性能,这正是我们目标的另一半。用精心设计的 ConstraintLayout 替换不必要的容器嵌套,使用 include 提取常用组件,并定义样式以避免重复属性。布局检查器可以帮助您检测到过深的视图树,这些视图树会拖慢 APK 的加载速度。
应用包、动态模块和原生库
以捆绑包形式发布是一项颠覆性的变革:应用商店会生成针对每台设备量身定制的软件包,因此每个用户只需下载所需的代码和资源。由于它过滤掉了不适用的语言、设备密度和架构,下载量远低于通用 APK。此外,功能可以根据条件或即时标准按需分配到不同的功能模块中。
关于原生库,仅包含您支持的架构并启用压缩功能,可以避免包含无人运行的二进制文件。如果您使用 Bazel 而不是 Gradle 进行编译,也可以将 R8 集成到流水线中,但需要注意的是,Android 应用开发官方并不支持此功能。
测量大小并监测演变
没有测量,就没有优化。IDE的 APK 分析器会显示软件包的真实大小,而自定义的 Gradle 任务可以在每次构建后报告大小。将此检查添加到持续集成中,可以自动控制大小,并防止几个新的依赖项在无人察觉的情况下使二进制文件体积膨胀。
不同版本之间行为发生了哪些变化?
回顾一下最近的发展历程很有意义,因为它解释了许多不再适用的旧配置。8.0版本默认启用完整模式;8.6 版本改进了回溯功能,包括对任何最低 SDK 版本进行文件和行回溯;8.12 版本在 Logcat 中引入了优化的资源缩减和自动回溯;9.0 版本默认启用该功能,过滤了消费者规则中的全局选项,并优化了 Kotlin 空值检查;9.1 版本默认重新打包类;9.3 版本引入了简化的优化块和 .keep 规则集。
考虑到以上所有因素,真正起作用的是一套简单的流程:在发布时启用优化,定期查看分析器报告,精简不必要的规则,清理资源和镜像,使用打包文件进行分发,并在每次发布时测量文件大小。这些看似不起眼的小步骤,结合起来就能将一个臃肿缓慢的应用变成一个瞬间下载、即刻启动的应用。而且,由于代码和依赖项不断增长,审查必须持续进行:今天优化得当的部分,一旦添加了新的库或集成了具有自身资源的功能,就会变得不再适用。
常见问题
R8 对我的应用程序代码具体做了什么?
它会分析已声明的入口点,构建引用映射,并移除所有无法从这些入口点访问的内容。然后,它会重写剩余代码,以降低运行开销,并缩短类名、字段名和方法名以节省空间。
如何在最新版本的 Gradle 插件中启用 R8 优化?
它通过发布版本构建类型的优化块中的一个标志激活,该标志涵盖代码和资源。您自己的规则放在一个特定的源代码集中,这些文件扩展名为 .keep。
减少代码和减少资源有什么区别?
代码精简会移除不可达的类、字段和方法,而资源精简则会移除未使用的图片、布局和其他文件。在现代版本中,这两项任务都集成到一个单一的引用图中,从而避免了仅仅因为代码过时而保留链接资源。
R8 配置分析器是用来做什么的?
衡量代码库中仍可用于缩减、优化和混淆的百分比,并分析每条保留规则的影响。利用这些数据,您可以识别出过于宽泛的规则、重复的规则以及不再匹配任何内容的规则。
为什么宽泛的资源保护规则会损害我的应用程序的性能?
因为它不仅阻止 R8 触及该规则保护的内容,还阻止其触及所有依赖于该规则的内容。结果是包中的代码更多,元数据更多,而用于方法插入或类合并的空间却更少。
发布应用时,使用 App Bundle 版本是否比发布通用 APK 版本更好?
是的,因为应用商店会生成针对每种设备定制的软件包,每个用户只需下载所需的语言、密度和架构资源。这种调整显著减小了下载大小,而且无需您维护单独的文件。
如何从混淆后的构建文件中读取堆栈跟踪信息?
您需要每次版本构建时生成的映射文件,并应用 R8 重跟踪工具。最新版本甚至可以在 IDE 的 Logcat 窗口中自动重跟踪日志。
值得对即将发布的库进行优化吗?
当 R8 能够看到完整的应用程序架构时,全面优化效果最佳,因此大部分工作都在编译最终应用程序时完成。即便如此,库也可以精心配置其使用者规则,以避免在集成它的项目中造成优化阻塞。



