Flutter使用FVM切换版本时AGP/KGP及依赖包管理问题

阿华AIGC实验室

2026-6-13

FVM切换Flutter版本相关问题解答

问题1：切换版本后依赖包版本是否自动适配新Flutter版本？

不会自动适配。FVM仅负责切换本地使用的Flutter SDK版本，不会修改pubspec.yaml中的依赖版本号。依赖包的兼容性由其自身的pubspec约束决定，部分依赖可能仅支持特定范围的Flutter版本。

解决建议：

切换版本后执行fvm flutter pub upgrade，让pub自动更新依赖到适配当前Flutter版本的最新兼容版本；
若部分依赖无法兼容，需手动修改pubspec.yaml中的依赖版本号，或查看依赖的官方文档确认兼容的Flutter版本范围。

问题2：如何轻松管理/自动切换AGP和KGP？

FVM本身没有自动切换AGP（Android Gradle Plugin）和KGP（Kotlin Gradle Plugin）的功能，但可以通过以下方式简化管理：

统一版本配置：将AGP和KGP版本定义在gradle.properties文件中，比如添加agpVersion=7.3.1、kgpVersion=1.8.10，然后在build.gradle或settings.gradle中引用这些变量，修改时只需改一处；
编写脚本自动替换：根据当前FVM激活的Flutter版本，编写Shell（Linux/Mac）或Batch（Windows）脚本，自动检测并替换Android项目中AGP和KGP的版本号；
使用Flutter升级工具：执行fvm flutter upgrade，工具会尝试自动将AGP和KGP更新到当前Flutter版本推荐的兼容值，旧项目可能需要手动确认修改；
维护版本对应表：整理不同Flutter版本对应的AGP/KGP兼容版本，切换版本时参考表格手动修改（适合版本切换频率不高的场景）。

调试报错信息（中文翻译）

正在调试模式下启动 lib\main.dart 到 M2101K7AG...
警告：Flutter 即将停止支持您项目的 Android Gradle 插件版本 (7.3.0)。请尽快将 Android Gradle 插件版本升级到至少 7.3.1。
或者，使用 "--android-skip-build-dependency-validation" 标志绕过此检查。

修复建议：您项目的 AGP 版本通常在 `settings.gradle` 文件（E:\work\montaro\android/settings.gradle）的 plugins 块中定义，对应插件 id 为 com.android.application。
如果未找到 plugins 块，您的项目可能是用旧模板创建的。这种情况下，它最可能在顶层 build.gradle 文件（E:\work\montaro\android/build.gradle）的 buildscript 依赖块中由以下行定义："classpath 'com.android.tools.build:gradle:<version>'"。

警告：Flutter 即将停止支持您项目的 Kotlin 版本 (1.7.10)。请尽快将 Kotlin 版本升级到至少 1.8.10。
或者，使用 "--android-skip-build-dependency-validation" 标志绕过此检查。

修复建议：您项目的 KGP 版本通常在 `settings.gradle` 文件（E:\work\montaro\android/settings.gradle）的 plugins 块中定义，对应插件 id 为 org.jetbrains.kotlin.android。
如果未找到 plugins 块，您的项目可能是用旧模板创建的，这种情况下，它最可能在顶层 build.gradle 文件（E:\work\montaro\android/build.gradle）中由 ext.kotlin_version 属性定义。

无效的依赖文件：E:\work\montaro\.dart_tool\flutter_build\51791ab5dca6560646b551396cc7deb9\kernel_snapshot_program.d
无效的依赖文件：E:\work\montaro\.dart_tool\flutter_build\51791ab5dca6560646b551396cc7deb9\kernel_snapshot_program.d
无效的依赖文件：E:\work\montaro\.dart_tool\flutter_build\51791ab5dca6560646b551396cc7deb9\kernel_snapshot_program.d
无效的依赖文件：E:\work\montaro\.dart_tool\flutter_build\51791ab5dca6560646b551396cc7deb9\kernel_snapshot_program.d
lib/screen/login.dart:112:61: 错误：方法 'HomeScreen' 未在类 '_LoginScreenState' 中定义。
 - '_LoginScreenState' 来自 'package:montaro/screen/login.dart' ('lib/screen/login.dart')。
尝试将名称更正为现有方法的名称，或者定义一个名为 'HomeScreen' 的方法。
                                      builder: (context) => HomeScreen()));
                                                            ^^^^^^^^^^
Target kernel_snapshot_program 失败：Exception

FAILURE：构建因异常失败。

* 出错原因：
任务 ':app:compileFlutterBuildDebug' 执行失败。
> 进程 'command 'C:\Users\dat\fvm\versions\stable\bin\flutter.bat'' 以非零退出值 1 结束。

* 尝试：
> 使用 --stacktrace 选项获取堆栈跟踪。
> 使用 --info 或 --debug 选项获取更多日志输出。
> 使用 --scan 获取完整分析信息。
> 访问 https://help.gradle.org 获取更多帮助。

构建在 20 秒内失败
错误：Gradle 任务 assembleDebug 以退出代码 1 失败

已退出 (1)。