Gradle构建中Preverifying步骤是什么？为何耗时久及如何提速？

一、Preverifying步骤到底是什么？ #

Preverifying是Android构建流程里，R8/ProGuard（当前Android默认用R8替代ProGuard）执行代码混淆、资源压缩前的核心前置校验环节。简单说就是给项目所有字节码做一次全面的「合规体检」：

• 检查所有类、方法、字段的引用是否合法，排查未定义类/方法、签名不匹配或访问权限冲突等问题；
• 验证字节码是否符合Java字节码规范，避免后续混淆、优化步骤因非法字节码直接崩溃；
• 提前标记需要保留的类、成员（基于你的混淆规则），为后续混淆和资源压缩做准备。

这个步骤的存在是为了提前拦截问题，避免在更耗时的混淆阶段才发现错误，反而浪费更多时间。

二、为什么Preverifying会耗时较长？ #

尤其是你开启minifyEnabled true和shrinkResources true后耗时暴增，核心原因有这几个：

1. 处理范围大幅扩大：开启混淆和资源压缩后，R8需要处理主项目代码+所有依赖库的字节码，而非仅编译后的主项目代码。如果项目依赖了大量第三方库，字节码总量会呈几何级增长，Preverifying的校验工作量自然飙升。
2. 联动资源压缩的额外校验：shrinkResources true会让Gradle同步检查资源与代码的引用关系，Preverifying阶段需要额外校验哪些资源被代码引用、哪些可被删除，进一步增加了工作量。
3. 旧版本工具的性能瓶颈：如果你的Gradle或Android Gradle Plugin（AGP）版本较老，R8的Preverifying阶段缺少并行处理、字节码批量校验等优化，效率会非常低。

三、如何加快Preverifying的执行速度？ #

针对你遇到的Release构建耗时从1分钟涨到1小时的情况，这些方法亲测有效：

1. 优先升级Gradle和AGP版本 #

新版本AGP（比如7.0+）对R8做了大量性能优化，包括Preverifying阶段的并行处理、字节码校验算法升级，能大幅降低该步骤耗时。建议升级到当前稳定版（比如AGP 8.x系列），同时搭配对应版本的Gradle（AGP 8.x对应Gradle 8.x）。

2. 精简混淆规则与依赖范围 #

• 清理无用依赖：用./gradlew dependencies命令分析项目依赖，移除实际未使用的第三方库，减少需处理的字节码总量。
• 精准配置-keep规则：对于已混淆的第三方库（比如多数SDK本身就是混淆后的），或明确无需混淆的类/包，用-keep规则明确保留，让R8无需在这些类上做额外校验与处理。示例：

  -keep class com.thirdparty.sdk.** { *; }
  

• 谨慎使用-dontpreverify：如果项目经过充分测试，确定字节码无问题，可在混淆规则中添加-dontpreverify跳过整个Preverifying步骤，这会大幅提速，但注意：这可能导致后续R8处理时出现字节码错误，仅建议在稳定项目中尝试。

3. 开启并行与增量构建 #

在项目根目录的gradle.properties中添加以下配置，利用多核CPU提升构建效率：

# 开启并行构建
org.gradle.parallel=true
# 根据CPU核心数设置工作线程数，比如4核设为4
org.gradle.workers.max=4
# 开启按需配置优化
org.gradle.configureondemand=true
# 禁用R8全模式（非必需时开启，全模式优化更彻底但耗时久）
android.enableR8.fullMode=false

4. 启用构建缓存 #

确保Gradle构建缓存开启，默认已开启，可在gradle.properties中确认：

org.gradle.caching=true

重复构建时，Preverifying阶段的结果会被缓存，无需重新执行。

内容的提问来源于stack exchange，提问作者c0dehunter