React Native中gradle-wrapper与build.gradle的Gradle配置区别

两类配置的核心差异 #

这两个配置指向完全不同的构建组件，不存在版本号直接对齐的关系，很多开发者会因为插件命名带gradle产生混淆：

• gradle-wrapper.properties中配置的distributionUrl=https\://services.gradle.org/distributions/gradle-5.5-all.zip，指定的是Gradle 构建工具本体的版本，5.5就是本体的版本号。
• 项目根目录build.gradle中引入的classpath("com.android.tools.build:gradle:3.4.2")，指定的是*Android Gradle 插件（AGP）*的版本，3.4.2是插件自身的版本号，和Gradle本体没有版本序列上的关联。

两个版本在构建流程中的具体作用 #

Gradle 5.5（本体版本） #

作为整个构建体系的底层执行引擎，承担所有通用构建能力：

• 负责解析构建脚本的语法，调度所有构建任务的执行顺序、资源分配
• 实现全项目的依赖解析、缓存管理、增量构建等核心规则
• 依赖Wrapper机制，项目会强制使用这个配置指定的5.5版本运行，不受开发者本地安装的Gradle版本影响，保证团队构建环境统一
• 你遇到的Gradle 6不兼容报错，本质是当前项目锁定的Gradle 5.5运行规则，和其他依赖/插件要求的Gradle 6运行逻辑存在语法差异，最终触发报错

AGP 3.4.2（Android插件版本） #

它是运行在Gradle本体之上的扩展能力包，不参与底层构建调度，只负责Android场景的专属构建逻辑：

• 提供Android项目特有的构建任务，比如资源文件处理、Android SDK编译规则对齐、签名APK生成、AAR库打包、BuildConfig文件生成等
• 将通用的Gradle构建能力，适配为Android开发流程需要的执行逻辑

版本匹配的基本规则 #

AGP和Gradle本体存在官方要求的兼容范围，比如AGP 3.4.2适配的Gradle版本范围为5.1.1到5.5，因此你当前项目的两个配置是可以正常协同工作的。如果强行将Gradle本体升级到6.x版本，老旧的AGP 3.4.2没有适配新版Gradle的语法规则，就会触发各类不兼容报错。

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