VSCode运行Flutter代码遇Gradle依赖错误，无法在Android模拟器启动

问题原因 #

项目构建Android版本时，Gradle无法从默认配置的仓库拉取到指定版本（7.1.2）的Android Gradle插件，导致构建失败。Web和Windows平台不受影响是因为它们不需要依赖Android Gradle插件。

解决方案 #

1. 确保Google Maven仓库已配置

打开项目根目录下的android/build.gradle文件，检查buildscript块中的repositories是否包含google()仓库——Android Gradle插件仅在Google Maven仓库发布，缺失这个仓库会导致无法找到插件：

buildscript {
    ext.kotlin_version = '1.6.10' // 保持与项目一致的Kotlin版本
    repositories {
        google() // 必须添加此仓库
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.1.2'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

2. 匹配Gradle与Android Gradle插件版本

Android Gradle插件7.1.2要求搭配Gradle 7.2及以上版本。检查android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

如果当前Gradle版本低于7.2，修改后保存文件。

3. 清除缓存并重新构建

• 执行命令清除Flutter项目缓存：flutter clean
• 删除项目android目录下的.gradle文件夹（本地Gradle缓存，删除后会重新下载）
• 重新运行项目：flutter run

4. 手动导入插件（备选方案）

如果上述方法仍无法解决，可以手动下载插件文件：

• 找到com.android.tools.build:gradle:7.1.2的pom和jar文件
• 将文件放到本地Maven仓库的对应路径：~/.m2/repository/com/android/tools/build/gradle/7.1.2/
• 再次执行构建命令

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