HarmonyOS鸿蒙Next中flutter开发app，SDK版本、开发环境配置

小伙伴你好，可以通过 OpenHarmony Flutter SIG 仓库 获取支持鸿蒙的 Flutter SDK 并配置开发环境。

详细说明

1. Flutter SDK 版本选择

目前支持鸿蒙的 Flutter SDK 主要由 OpenHarmony SIG 社区维护。

• 稳定版本（Stable）：基于 Flutter 3.7.12。这是较早期的稳定版本，兼容性较好，但不支持最新的 Flutter 特性。
• 最新版本（Latest / 推荐）：基于 Flutter 3.22.0（如分支 br_3.22.0-ohos-1.0.4）。
  • 推荐理由：支持 HarmonyOS NEXT (API 11/12) 及以上版本，包含 Flutter 3.22 的性能优化（如 Impeller 渲染引擎的改进）和新特性。如果你的目标是 HarmonyOS NEXT，建议使用此版本。

2. 使用 FVM 安装鸿蒙版 Flutter SDK

由于鸿蒙版 Flutter 是社区维护的分支，FVM 无法直接通过版本号安装。我们需要将仓库克隆到 FVM 的版本目录中，使其被 FVM 识别为"自定义版本"。

实现步骤：

1. 进入 FVM 版本目录

   cd ~/fvm/versions
   

2. 克隆鸿蒙版 Flutter 仓库

   根据你选择的版本，执行对应的克隆命令：

   • 安装 3.22.0 版本（推荐）：

     # 克隆指定分支到 fvm/versions/ohos-3.22.0 目录
     git clone -b br_3.22.0-ohos-1.0.4 https://gitcode.com/openharmony-tpc/flutter_flutter.git ohos-3.22.0
     

   • 安装 3.7.12 版本：

     git clone -b master https://gitcode.com/openharmony-tpc/flutter_flutter.git ohos-3.7.12
     

3. 下载依赖与预编译

   进入对应目录并运行 flutter doctor 以初始化 SDK（这一步会下载 Dart SDK 等引擎工件）：

   cd ohos-3.22.0
   ./bin/flutter doctor -v
   

   注意：第一次运行可能需要较长时间下载依赖。

4. 在项目中应用

   现在你可以像使用普通 Flutter 版本一样使用这个自定义版本：

   # 在项目根目录下
   fvm use ohos-3.22.0
   

3. 创建支持鸿蒙、安卓、iOS 的项目

使用配置好的鸿蒙版 Flutter SDK 创建项目时，通过 --platforms 参数指定目标平台。

代码示例（命令行）：

# 确保当前环境使用的是鸿蒙版 Flutter
fvm use ohos-3.22.0

# 创建项目，显式指定包含 ohos 平台
fvm flutter create --platforms=ohos,android,ios --org com.example my_harmony_app

关键点：

• –platforms=ohos：这是关键参数，它会生成 ohos 目录（类似 android 和 ios 目录），其中包含鸿蒙工程的结构。
• 打开鸿蒙工程：使用 DevEco Studio 打开项目下的 ohos 目录进行编译和调试。

注意事项

• 环境依赖：确保电脑上已安装 DevEco Studio (推荐 5.0 以上版本用于 HarmonyOS NEXT 开发) 以及对应的鸿蒙 SDK。

• 环境变量：配置 HDC_HOME 和 OHPM_HOME 环境变量，以便 Flutter 工具链能找到鸿蒙的命令行工具。

  export HDC_HOME=/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains
  export PATH=$PATH:$HDC_HOME
  

• 签名配置：真机调试必须在 ohos 目录下的工程中配置有效的签名文件（p12/p7b）。

参考文档

• OpenHarmony Flutter 仓库 (GitCode)
• Flutter 3.22.0 OHOS 分支说明