升级两年前Flutter项目时无法创建AppPlugin插件报错求助

错误核心原因 #

该报错本质是Android Gradle插件(AGP)版本与当前Flutter SDK版本不兼容。你使用的AGP 4.0.2版本过旧，无法适配Flutter SDK中对com.android.build.api.dsl.extension.AppExtension类的API调用要求，导致插件初始化失败。

修复步骤 #

1. 升级Android Gradle插件版本
   打开项目根目录下的android/build.gradle文件，修改buildscript中的AGP依赖版本为与Flutter兼容的版本（Flutter 3.x系列建议使用AGP 7.0+版本，比如7.4.2）：

   buildscript {
       repositories {
           google()
           mavenCentral()
       }
       dependencies {
           classpath 'com.android.tools.build:gradle:7.4.2'
       }
   }
   

2. 同步Gradle Wrapper版本
   AGP版本需要对应匹配的Gradle版本，打开gradle/wrapper/gradle-wrapper.properties，更新distributionUrl：

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

   注：AGP与Gradle版本存在严格对应关系，比如AGP 7.4.2对应Gradle 7.5

3. 验证依赖兼容性
   你的项目中Kotlin版本为1.8.20，与AGP 7.4.x版本兼容，无需调整；若后续出现Kotlin相关报错，可将Kotlin版本调整为AGP兼容的范围（如1.7.x-1.8.x）。

4. 清理缓存并重新构建
   执行以下命令清理项目缓存并重新获取依赖：

   flutter clean
   flutter pub get
   

   之后重新运行项目即可。

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