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:固定依赖插件版本(无需改动构建配置,优先尝试)
- 打开项目根目录的
pubspec.yaml文件,移除所有依赖项版本号前的^浮动标识符,将所有安卓相关插件(尤其是url_launcher这类系统能力插件)的版本固定为上一次正常构建时使用的历史版本。 - 删除项目根目录的
pubspec.lock文件,执行flutter clean清理构建缓存。 - 重新执行
flutter pub get拉取固定版本的依赖,再执行flutter build apk测试构建。
方案2:正确匹配升级AGP与Gradle版本
之前升级AGP4.1.0后出现异常是因为AGP与Gradle版本不匹配、插件版本未同步适配导致,按以下步骤操作即可解决:
- 打开
android/build.gradle文件,将dependencies节点下的com.android.tools.build:gradle版本号修改为4.1.3(比4.1.0稳定性更高)。 - 打开
android/gradle/wrapper/gradle-wrapper.properties文件,将distributionUrl属性值修改为gradle 6.7版本的官方二进制分发地址,该版本与AGP4.1.x完全匹配。 - 打开
android/app/build.gradle文件,将minSdkVersion调整为至少19,满足当前多数插件的最低兼容要求。 - 进入
android目录,执行./gradlew clean(Windows系统执行gradlew.bat clean)清理安卓端构建缓存,回到项目根目录执行flutter pub upgrade升级所有插件到支持AGP4.1.x的版本。 - 重新执行
flutter build apk构建,即可解决MissingPluginException异常与构建失败问题。
方案3:回退Flutter SDK版本
如果是Flutter SDK自动升级导致的不兼容,将Flutter SDK回退到上一次正常构建时使用的历史版本,关闭SDK自动更新后重新构建即可。
内容的提问来源于stack exchange,提问作者NebulaFox
相关产品推荐
相关产品推荐

