如何为React Native项目查找适配的gradle与google-services版本对

标签是Android 11引入的包可见性特性，要求Android Gradle Plugin（AGP，即com.android.tools.build:gradle）版本必须 ≥ 3.6.0，因此不能降级到3.4.x版本。你之前遇到的兼容性问题本质是所选AGP与google-services版本没有匹配对应关系。

可行版本组合推荐 #

以下是两个经过验证的适配组合，任选其一即可：

组合1（适配性更广，适合RN 0.63及以上版本） #

• gradle-wrapper.properties 不用修改，保持现有配置即可：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

• android/build.gradle 依赖修改为：

dependencies {
    classpath("com.android.tools.build:gradle:4.1.3")
    classpath 'com.google.gms:google-services:4.3.10'
}

该组合同时解决两个报错：AGP 4.1.3原生支持标签，且和google-services 4.3.10完全兼容，不会触发Firebase Messaging组件缺失问题。

组合2（适合RN版本更低，无法升级AGP到4.x的场景） #

• gradle-wrapper.properties 仅修改distributionUrl配置，其余项保持不变：

distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip

• android/build.gradle 依赖修改为：

dependencies {
    classpath("com.android.tools.build:gradle:3.6.4")
    classpath 'com.google.gms:google-services:4.3.8'
}

该组合AGP 3.6.4支持标签，和google-services 4.3.8不存在兼容性冲突。

构建前清理操作 #

修改完配置后，先执行以下操作避免缓存影响：

• 删除android目录下的.gradle缓存文件夹
• 进入android目录执行./gradlew clean（Windows系统执行gradlew.bat clean）
• 重新启动RN项目构建即可

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