首次使用Flutter运行main.dart遇Gradle构建报错求助

问题核心 #

该错误源于Android Gradle Plugin（AGP）与Gradle版本不兼容，或Flutter SDK与AGP版本不匹配，导致无法正常创建AppPlugin组件。

具体解决步骤 #

• 对齐AGP与Gradle版本

  1. 打开项目根目录下的android/build.gradle，找到dependencies块中的AGP版本：

     classpath "com.android.tools.build:gradle:x.x.x"
     

  2. 打开android/gradle/wrapper/gradle-wrapper.properties，找到Gradle版本：

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

  3. 确保两者版本匹配，例如：
     • AGP 7.4.x → Gradle 7.5
     • AGP 8.0.x → Gradle 8.0
     • AGP 8.1.x → Gradle 8.2

• 匹配Flutter SDK与AGP版本

  1. 运行flutter --version查看当前Flutter版本
  2. 根据Flutter版本调整AGP：
     • Flutter 3.10+ 建议AGP 7.4+
     • Flutter 3.16+ 建议AGP 8.0+
     • 若Flutter版本较旧，可执行flutter upgrade升级SDK，或降低AGP版本到兼容范围

• 清理缓存重新构建

  1. 执行flutter clean清理Flutter项目缓存
  2. 进入项目的android目录，执行gradlew clean（Windows）或./gradlew clean（Mac/Linux）清理Gradle缓存
  3. 重新运行flutter run

• 检查插件声明正确性
  打开android/app/build.gradle第24行附近，确认插件声明为：

  id 'com.android.application'
  

  避免使用内部插件com.android.internal.application

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