You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter安卓构建报错Unsupported Android Plugin version:3.5.4求解决方案

错误出现原因
  • 项目依赖的Flutter第三方插件发布了新版本,部分插件将内部依赖的Android Gradle Plugin(AGP)最低兼容版本上调,执行flutter pub get时自动拉取了浮动版本范围内的最新插件,与项目原有3.5.4版本AGP不兼容,是无配置改动情况下突然报错的最常见原因。
  • Flutter SDK静默升级到新版本,新版Flutter官方上调了安卓端构建要求的最低AGP版本,不再支持3.5.4版本。
  • 本地Android构建工具链自动更新,旧版3.5.4 AGP与新版构建组件不兼容。
可行解决方案

方案1:固定依赖插件版本(无需改动构建配置,优先尝试)

  1. 打开项目根目录的pubspec.yaml文件,移除所有依赖项版本号前的^浮动标识符,将所有安卓相关插件(尤其是url_launcher这类系统能力插件)的版本固定为上一次正常构建时使用的历史版本。
  2. 删除项目根目录的pubspec.lock文件,执行flutter clean清理构建缓存。
  3. 重新执行flutter pub get拉取固定版本的依赖,再执行flutter build apk测试构建。

方案2:正确匹配升级AGP与Gradle版本

之前升级AGP4.1.0后出现异常是因为AGP与Gradle版本不匹配、插件版本未同步适配导致,按以下步骤操作即可解决:

  1. 打开android/build.gradle文件,将dependencies节点下的com.android.tools.build:gradle版本号修改为4.1.3(比4.1.0稳定性更高)。
  2. 打开android/gradle/wrapper/gradle-wrapper.properties文件,将distributionUrl属性值修改为gradle 6.7版本的官方二进制分发地址,该版本与AGP4.1.x完全匹配。
  3. 打开android/app/build.gradle文件,将minSdkVersion调整为至少19,满足当前多数插件的最低兼容要求。
  4. 进入android目录,执行./gradlew clean(Windows系统执行gradlew.bat clean)清理安卓端构建缓存,回到项目根目录执行flutter pub upgrade升级所有插件到支持AGP4.1.x的版本。
  5. 重新执行flutter build apk构建,即可解决MissingPluginException异常与构建失败问题。

方案3:回退Flutter SDK版本

如果是Flutter SDK自动升级导致的不兼容,将Flutter SDK回退到上一次正常构建时使用的历史版本,关闭SDK自动更新后重新构建即可。

内容的提问来源于stack exchange,提问作者NebulaFox

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 06:18:03