安装react-native-contacts后项目无法构建，Gradle 4.1.0下载失败

问题概述 #

执行npm i react-native-contacts安装依赖后，项目运行时出现Gradle 4.1.0下载失败错误，相关配置及错误信息如下：

• package.json配置：

  "react-native": "0.68.1",
  "react-native-contacts": "^7.0.5",
  

• gradle.build配置：

  buildToolsVersion = "31.0.0"
  minSdkVersion = 21
  compileSdkVersion = 31
  targetSdkVersion = 31
  

• 错误提示：

Could not resolve all files for configuration ':react-native-contacts:classpath'.

Could not find gradle-4.1.0.jar (com.android.tools.build:gradle:4.1.0).
Searched in the following locations:
https://dl.google.com/dl/android/maven2/com/android/tools/build/gradle/4.1.0/gradle-4.1.0.jar

已尝试代理无效，但浏览器可直接下载该文件，所在地区为伊朗。

可行解决方案 #

1. 手动下载并放入本地仓库 #

• 用浏览器打开错误提示中的链接，下载gradle-4.1.0.jar文件；同时找到对应版本的gradle-4.1.0.pom文件（可通过Maven仓库页面获取下载链接，浏览器同样能下载）。
• 找到本地Maven仓库路径：一般为~/.m2/repository/com/android/tools/build/gradle/4.1.0/，如果文件夹不存在，手动创建层级目录。
• 将下载好的.jar和.pom文件放入该目录，重新运行项目。

2. 修改依赖库的Gradle配置 #

• 找到项目中node_modules/react-native-contacts/android/build.gradle文件。
• 将文件里的com.android.tools.build:gradle:4.1.0替换为你项目根目录android/build.gradle中已使用的Gradle插件版本（RN 0.68.1通常搭配AGP 7.x版本，比如com.android.tools.build:gradle:7.0.4）。
• 保存修改后，重新执行项目构建命令。

3. 配置本地仓库优先查找 #

• 打开项目根目录的android/build.gradle文件，在repositories列表中添加本地仓库配置，确保Gradle优先从本地查找依赖：

  repositories {
      mavenLocal()
      // 保留原有的其他仓库配置...
  }
  

4. 清除Gradle缓存并重同步 #

• 进入项目的android目录，执行命令清除缓存：

  ./gradlew cleanBuildCache
  

• 然后重新同步项目：

  ./gradlew sync
  

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