flutter项目环境升级二：从Flutter2.10.5升级到3.29.3

原创

已于 2025-07-15 11:50:35 修改 · 1.8k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#flutter

于 2025-06-23 15:50:09 首次发布

系统：windows
Android Studio：Android Studio Meerkat Feature Drop | 2024.3.2 Patch 1
Flutter SDK: Flutter3.29.3
JDK: java 17
详细的AGP / Gradle / Kotlin / JDK版本兼容关系可以百度或者到官方文档查询，其他博主给的很详细。确认好想要的版本兼容

这位大哥有对照表

升级步骤

Flutter3.29.3环境更换

Flutter3.29.3环境更换

1.下载flutter sdk https://docs.flutter.dev/install/archive#windows
2.配置环境替换为flutter3.29.3
在这里插入图片描述
3.更改第三方库缓存路径(若C盘内存不够用可设置)
D盘新建文件flutter_pub_cache，
‘用户变量’或’系统变量‘中点击“新建”
环境变量：PUB_CACHE; 变量值：D:\flutter_pub_cache

打开终端窗口或在Android Studio Terminal窗口，运行：

flutter pub cache repair

或重新

flutter pub 
flutter get

切换成功后pub get后的插件会缓存到flutter_pub_cache目录下
在这里插入图片描述

4.更改.gradle文件目录(.gradle文件默认目录在c盘的Users目录下若C盘内存不够用可设置)
在D盘中新建文件夹.gradle
‘用户变量’或’系统变量‘中点击“新建”
环境变量：GRADLE_USER_HOME; 变量值：D:\android_config.gradle
在这里插入图片描述
重复flutter pub cache repair或flutter pub 、flutter get

更改成功后编译相关文件会缓存在D:\android_config.gradle目录下

在这里插入图片描述

pubspec.yaml中插件升级

sdk版本切换
运行命令 flutter pub outdated查看插件的当前版本、可升级版本、可解决版本及最新版本，对版本大概有个数
运行命令：flutter pub upgrade,不要运行：flutter pub upgrade --major-versions它会升级到最新版本，可能破坏版本约束。
解决升级插件后的报错，替换新版本插件的调用方法，这里的报错需要一个个去解决。完成到这一步项目文件不报错了。

Gradle编译配置

flutter3.16以上，Flutter Gradle 插件的命令式应用已弃用

这位老哥给出了干净的gradle文件

android/settings.gradle替换：

pluginManagement {
    def flutterSdkPath = {
        def properties = new Properties()
        file("local.properties").withInputStream { properties.load(it) }
        def flutterSdkPath = properties.getProperty("flutter.sdk")
        assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
        return flutterSdkPath
    }()

    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

    repositories {
        maven { url 'https://maven.aliyun.com/repository/releases' }
        //    maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.ali