升级至Android Studio Chipmunk | 2021.2.1后遭遇Gradle插件缺失问题求助

Hey，我之前升级到Android Studio Chipmunk | 2021.2.1的时候也碰到过一模一样的问题，折腾了好一会儿才搞定，分享几个亲测有效的解决办法给你：

1. 检查仓库配置顺序和完整性 #

Android Gradle插件（AGP）主要托管在Google仓库，所以得确保你的项目配置里正确引入了Google仓库，而且顺序要靠前。打开项目根目录的settings.gradle（或settings.gradle.kts），确认内容如下：

pluginManagement {
    repositories {
        google() // 把Google仓库放在最前面
        gradlePluginPortal()
        mavenCentral()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

如果之前把gradlePluginPortal()放在Google前面，很可能会导致无法解析AGP插件。

2. 确认AGP与Gradle版本的匹配性 #

Chipmunk版本对应的AGP版本是7.2.x，而AGP 7.2.0需要搭配Gradle 7.3.3使用。检查以下两个文件：

• 根目录build.gradle里的AGP版本是否为7.2.0：

  plugins {
      id 'com.android.library' version '7.2.0' apply false
  }
  

• gradle/wrapper/gradle-wrapper.properties里的Gradle版本是否正确：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-bin.zip
  

版本不匹配会直接导致插件无法正常解析。

3. 清理Gradle缓存 #

有时候本地Gradle缓存损坏也会引发这个问题，按以下步骤操作：

• 关闭Android Studio
• 删除用户目录下的.gradle/caches文件夹：
  • Windows：C:\Users\[你的用户名]\.gradle\caches
  • Mac：~/.gradle/caches
• 重新打开Android Studio，点击工具栏的「Sync Project with Gradle Files」按钮

4. 尝试Invalidate Caches并重启 #

如果上面的方法都没效果，试试Android Studio自带的缓存重置功能：

• 点击顶部菜单栏的File -> Invalidate Caches...
• 勾选「Invalidate and Restart」，点击确认等待重启完成

一般来说，按照上面的步骤操作后，这个插件找不到的问题就能解决了。

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