CentOS 中 Flutter 更新操作指南
一 快速升级到最新稳定版
- 查看当前版本与渠道:运行命令查看 Flutter 与 Dart 版本、当前 channel(如:stable、beta、dev、master)。
- 命令:
flutter --version、flutter channel
- 切换到目标渠道(可选):如需从 dev 切到 stable,先切换再升级更稳定。
- 命令:
flutter channel stable
- 执行升级:升级 SDK 到当前渠道的最新版本。
- 验证升级结果:确认版本号与工具链是否正常。
- 命令:
flutter --version、flutter doctor
- 如命令未找到,检查 PATH 是否包含 Flutter 的 bin 目录(例如:
/opt/flutter/bin)。
二 升级到指定版本或回退版本
- 指定版本升级:直接升级到某个版本号(示例为 3.10.5)。
- 命令:
flutter upgrade 3.10.5
- 回退到历史版本(手动方式):进入 Flutter SDK 安装目录(该目录是一个 Git 仓库),重置到目标 commit。
- 步骤:
- 进入目录:
cd /opt/flutter
- 查看提交历史并复制目标 commit id:
git log --oneline -10
- 回退:
git reset --hard <commit_id>
- 校验:
flutter --version
- 说明:回退会同步切换对应的 Dart SDK,网络不稳可能导致下载中断。
三 使用 FVM 进行多版本管理与升级(推荐用于多项目)
- 安装 FVM(Dart 全局工具):
- 命令:
dart pub global activate fvm
- 安装与切换版本:
- 安装指定版本或渠道:
fvm install stable、fvm install 3.16.9
- 为当前项目使用版本:
fvm use 3.16.9(会在项目根目录生成 .fvm/flutter_sdk 软链)
- 全局默认版本:
fvm use 3.16.9 --global
- 升级策略:
- 全局升级:
flutter upgrade(影响 FVM 的全局版本)
- 项目级升级:在项目目录执行
fvm flutter upgrade(只升级该项目所使用的 SDK 副本)
- 常用辅助命令:
- 列出已安装版本:
fvm list
- 删除版本:
fvm remove 3.16.9
- IDE 集成:将 Android Studio/VS Code 的 Flutter SDK 路径指向项目下的 .fvm/flutter_sdk
- 建议将 .fvm/ 加入 .gitignore,避免误提交。
四 升级后的项目依赖与验证
- 获取/升级依赖:
- 安装依赖:
flutter pub get
- 升级依赖:
flutter pub upgrade(或指定包:flutter pub upgrade <package_name>)
- 清理与重建(遇到依赖冲突或异常时):
- 清理:
flutter clean
- 重新获取:
flutter pub get
- 兼容性检查与修复:
- 运行
flutter doctor 检查环境与健康度
- 若出现 “依赖包要求 Flutter 版本较低/较高” 的冲突,需升级/降级相关依赖或锁定兼容版本
- 回归测试:在升级 SDK 与依赖后,执行运行与关键业务测试,确保功能与性能正常。