使用 FVM 管理 Flutter-OH 多版本：高效切换鸿蒙 Flutter 开发环境

使用 FVM 管理 Flutter-OH 多版本：高效切换鸿蒙 Flutter 开发环境

欢迎大家加入开源鸿蒙跨平台开发者社区

目录

• FVM 简介
• 安装 FVM
• 鸿蒙 Flutter SDK 版本概览
• 使用 FVM 管理鸿蒙 Flutter SDK
• IDE 配置指南
• 常见问题与建议

详细操作步骤

FVM 简介

FVM (Flutter Version Management) 是一个功能强大的命令行工具，专门用于管理多个 Flutter SDK 版本。对于鸿蒙 Flutter (Flutter-OH) 开发者而言，FVM 能够解决以下痛点：

核心功能

• 多版本管理：安装、切换和管理多个 Flutter SDK 版本，支持官方版本和自定义版本
• 通道管理：支持 Flutter 的 stable、beta、dev 和 master 通道
• 项目级配置：为每个 Flutter 项目单独指定 SDK 版本
• 全局设置：设置系统默认的 Flutter 版本
• 缓存优化：避免重复下载相同版本，节省磁盘空间和下载时间

主要优势

• 环境隔离：不同项目使用不同 Flutter 版本，避免版本冲突
• 快速切换：一键切换开发环境，提升多项目开发效率
• 简化配置：减少环境变量依赖，降低配置复杂度
• 跨平台支持：完全支持 Windows、macOS 和 Linux 系统

安装 FVM

请根据操作系统选择对应的安装方式：

macOS / Linux

# 使用 Homebrew (macOS)brew tap leoafarias/fvm brewinstallfvm# 或使用 Dart 全局安装dart pub global activate fvm

Windows

# 使用 Chocolateychoco install fvm# 或使用 Dart 全局安装dart pub global activate fvm

安装后配置

# 验证安装fvm --version# 配置环境变量（根据实际shell配置）# 对于 bash/zsh，添加到 ~/.bashrc 或 ~/.zshrc：exportPATH="$PATH:$HOME/fvm/default/bin"exportPUB_CACHE="$HOME/.pub-cache"

提示：完整安装指南请参考 FVM 官方文档

鸿蒙 Flutter SDK 版本概览

目前鸿蒙化的 Flutter 版本托管在 AtomGit，主要包括以下版本：

完整版本管理表格

版本	分支/标签	状态	推荐用途	克隆命令示例
3.7	br_3.7.12-ohos-1.1.3	稳定	历史项目维护	git clone -b br_3.7.12-ohos-1.1.3
3.22	3.22.0-ohos	稳定	生产环境项目	git clone -b 3.22.0-ohos
3.32	oh-3.32.0-release	稳定	新功能需求	git clone -b oh-3.32.0-release
3.35	oh-3.35.7-dev	开发	新项目/尝鲜	git clone -b oh-3.35.7-dev

重要提示：鸿蒙 Flutter SDK 正处于快速迭代期，推荐使用 dev 分支以获取最新功能和修复。当前默认分支为oh-3.22.0，请定期关注仓库更新。

使用 FVM 管理鸿蒙 Flutter SDK

步骤 1：克隆 SDK 到 FVM 缓存目录

FVM 通过特殊的文件夹命名规则管理自定义版本：以custom_为前缀的文件夹会被识别为自定义 SDK。

# 1. 进入 FVM 缓存目录# 默认位置：~/fvm/versions （可通过 FVM_CACHE_PATH 环境变量修改）cd~/fvm/versions# 克隆 3.35 版本（推荐）# 注意：使用 oh-3.35.7-dev 分支gitclone -b oh-3.35.7-dev https://atomgit.com/openharmony-tpc/flutter_flutter.git custom_3.35-ohos# 克隆 3.22 版本gitclone -b3.22.0-ohos https://atomgit.com/openharmony-tpc/flutter_flutter.git custom_3.22-ohos# 克隆 3.7 版本gitclone -b br_3.7.12-ohos-1.1.3 https://atomgit.com/openharmony-tpc/flutter_flutter.git custom_3.7-ohos

步骤 2：创建新项目并使用鸿蒙 SDK

# 1. 创建项目目录mkdir-p ~/projects/flutter_oh_democd~/projects/flutter_oh_demo# 2. 为该项目指定鸿蒙 Flutter SDK# 首次使用会询问是否继续，输入 y 确认fvm use custom_3.35-ohos# 3. 创建支持鸿蒙的 Flutter 项目# --platforms=ohos：启用鸿蒙平台支持# --project-name：指定项目名称# 最后的 "."：在当前目录创建fvm flutter create --platforms=ohos --project-name flutter_oh_demo.# 4. 验证项目配置cat.fvm/fvm_config.json# 应显示：{"flutterSdkVersion":"custom_3.35-ohos"}

步骤 3：已有项目切换鸿蒙 SDK

对于现有项目，切换步骤更简单：

# 进入项目目录cd/path/to/existing/project# 切换 SDK 版本fvm use custom_3.35-ohos# 验证切换结果fvm flutter --version

项目结构说明

执行上述操作后，项目目录会生成以下 FVM 相关文件：

项目目录/ ├── .fvm/ │ ├── flutter_sdk -> /Users/username/fvm/versions/custom_3.35-ohos # 软链接 │ ├── fvm_config.json # 版本配置文件 │ ├── release # 发布配置 │ ├── version # 版本信息 │ └── versions/ │ └── custom_3.35-ohos -> /Users/username/fvm/versions/custom_3.35-ohos ├── .fvmrc # FVM 运行时配置 └── (其他项目文件)

关键点：所有软链接都指向 FVM 缓存目录，实现 SDK 的复用，避免重复存储。

IDE 配置指南

Visual Studio Code 配置

在项目根目录的.vscode/settings.json中添加以下配置：

{"dart.flutterSdkPath":".fvm/flutter_sdk",// 或使用完整路径：// "dart.flutterSdkPath": ".fvm/versions/custom_3.35-ohos","dart.addSdkToTerminalPath":true,"dart.env":{"PUB_HOSTED_URL":"https://pub.flutter-io.cn"},// 可选：同步运行和调试配置"dart.synchronizeFlutterSdk":true,// 可选：自动获取包"dart.runPubGetOnPubspecChanges":true}

配置后操作：

1. 重启 VSCode
2. 按Cmd+Shift+P(macOS) 或Ctrl+Shift+P(Windows/Linux)
3. 输入 “Flutter: Change SDK”，选择.fvm/flutter_sdk
4. 右下角确认 Flutter SDK 版本已切换

Android Studio / IntelliJ IDEA 配置

1. 打开项目设置：

   • macOS:IntelliJ IDEA → Preferences
   • Windows/Linux:File → Settings

2. 配置 Flutter SDK：

   • 进入Languages & Frameworks → Flutter
   • 点击 “Flutter SDK path” 右侧的 “…” 按钮
   • 选择项目中的.fvm/flutter_sdk目录
   • 点击 “Apply” 保存配置

3. 验证配置：

   • 查看状态栏的 Flutter 版本信息
   • 运行flutter doctor确认环境正常

命令行环境集成

为了在终端中也能正确使用项目指定的 Flutter 版本，建议配置 shell：

# 在 ~/.bashrc、~/.zshrc 或对应配置文件中添加fvm_use(){if[-f"./.fvm/fvm_config.json"];thenfvm use$(cat./.fvm/fvm_config.json|grep-o'"flutterSdkVersion":"[^"]*"'|cut-d'"'-f4)--silentfi}# 进入目录时自动切换版本（可选）# cd() {# builtin cd "$@"# fvm_use# }

常见问题与建议

Q1: FVM 安装后命令未找到？

A: 确保已将 FVM 添加到 PATH 环境变量：

# 对于 bash/zshecho'export PATH="$PATH:$HOME/.pub-cache/bin"'>>~/.zshrcsource~/.zshrc

Q2: 克隆 SDK 速度慢或失败？

A: 尝试以下解决方案：

1. 使用 HTTPS 而非 SSH（如示例所示）
2. 配置 Git 代理（如有需要）
3. 使用国内镜像（如果提供）
4. 分步克隆：先浅克隆，再获取完整历史

Q3: 项目创建时提示平台不支持？

A: 确保：

1. 使用--platforms=ohos参数
2. SDK 版本支持鸿蒙平台
3. 已正确安装鸿蒙开发环境

Q4: 如何更新已安装的鸿蒙 SDK？

# 进入 SDK 缓存目录cd~/fvm/versions/custom_3.35-ohos# 拉取最新代码gitpull origin dev# 清理并重建flutter clean flutter precache

Q5: 多个项目需要不同版本怎么办？

A: FVM 的核心优势就在于此。只需在每个项目中执行：

# 在项目 A 中fvm use custom_3.22-ohos# 在项目 B 中fvm use custom_3.35-ohos

FVM 会自动管理版本切换，互不干扰。

最佳实践建议

1. 版本命名规范：使用一致的命名规则，如custom_<版本>-ohos-<日期>
2. 定期更新：尤其是 dev 分支，建议每周更新一次
3. 备份配置：将.vscode/settings.json和.fvmrc纳入版本控制
4. 文档维护：在团队中统一 FVM 使用流程，确保环境一致性
5. 性能监控：定期清理不再使用的 SDK 版本：fvm remove <版本>

总结

FVM 为鸿蒙 Flutter 开发提供了强大的版本管理能力，特别适合：

• 同时维护多个不同 Flutter 版本的项目
• 团队协作中统一开发环境
• 尝鲜最新鸿蒙 Flutter 特性
• 降级测试和版本兼容性验证

通过本文介绍的配置流程，您可以轻松搭建和管理多版本鸿蒙 Flutter 开发环境，享受高效、灵活的跨平台开发体验。

---

相关资源：

• FVM 官方文档
• 鸿蒙 Flutter SDK 仓库
• Flutter 中文网
• OpenHarmony 官方