删除Gradle wrapper和缓存旧文件后Android项目Gradle sync失败如何解决

1. 修复Gradle 7.0兼容性问题 #

你收到的第一个报错本质是项目原有配置与Gradle 7.0不匹配，按以下步骤修改：

• 打开项目根目录下gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl参数值为：

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

• 打开项目根目录下的项目级build.gradle文件，将Android Gradle插件版本调整为与Gradle 7.0.2适配的7.0.x版本，示例配置：

  buildscript {
      dependencies {
          classpath "com.android.tools.build:gradle:7.0.4"
          // 其余原有插件配置保留即可
      }
  }
  

• 遍历项目所有build配置文件，替换废弃语法：将compile替换为implementation、testCompile替换为testImplementation，删除android.useDeprecatedNdk等已废弃的配置项。

2. 修复未知同步失败、找不到构建任务问题 #

• 完全关闭Android Studio，进入当前项目根目录，删除以下文件和文件夹：
  • 项目根目录下的.gradle文件夹
  • 项目根目录下的.idea文件夹
  • 所有模块目录下的build文件夹
  • 项目根目录下的local.properties文件
• 重新启动Android Studio，选择打开该项目，等待IDE自动重新生成所有本地配置文件。
• 进入Android Studio设置页，依次打开Build, Execution, Deployment > Build Tools > Gradle，检查配置：
  • Gradle user home路径为默认的Users/你的用户名/.gradle，无拼写错误
  • Use Gradle from选项选择gradle-wrapper.properties，不要手动指定本地Gradle路径
  • 勾选Download external annotations for dependencies

3. 兜底修复方案 #

如果以上操作均无效，执行以下操作：

• 完全关闭Android Studio，手动删除全局Users/你的用户名/.gradle文件夹，不需要手动保留任何版本的Gradle文件或缓存
• 重新打开Android Studio和对应项目，IDE会自动拉取匹配版本的Gradle安装包、所有项目依赖并重建缓存，等待同步完成即可。
• 如果Gradle拉取速度过慢，可在全局.gradle目录下新建gradle.properties文件，添加国内镜像源配置加速下载。

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