下面给出一份「鸿蒙版 Flutter」从零到可跑的完整配置教程，基于社区目前最活跃的
openharmony-tpc/flutter_flutter（分支 oh-3.27.4-dev）整理而成。
官方暂未原生支持，所有步骤均为社区移植方案，2025-12 验证可用。

---

一、前置条件

1. 操作系统：Windows 10+ / macOS 12+ / Ubuntu 20+
2. 磁盘剩余 ≥ 10 GB（含 OpenHarmony SDK + Flutter 引擎编译产物）
3. 已安装 Git、Python 3.8+、JDK 11（DevEco Studio 自带即可）

---

二、国内镜像加速（必做）

# Windows PowerShell
$env:PUB_HOSTED_URL="https://pub.flutter-io.cn"
$env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

# macOS/Linux/Zsh
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

建议写进系统变量或 ~/.zshrc，永久生效 。

---

三、获取鸿蒙版 Flutter SDK

# 不要下载 zip！必须用 clone，否则 git 子模块会丢
git clone -b oh-3.27.4-dev https://gitcode.com/openharmony-tpc/flutter_flutter.git

克隆完成后路径示例：

• Windows：D:\dev\flutter_flutter
• macOS/Linux：~/dev/flutter_flutter

---

四、配置环境变量
把 bin 目录追加到 PATH：

平台	操作
Windows	系统属性 → 高级 → 环境变量 → Path → 新增 D:\dev\flutter_flutter\bin
macOS/Linux	echo 'export PATH="$HOME/dev/flutter_flutter/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

验证：

flutter --version
# 输出包含 3.27.4-ohos 字样即 OK

---

五、安装 OpenHarmony 工具链

1. 安装 DevEco Studio 4.0+（华为开发者官网）
   安装向导一并勾选：

   • OpenHarmony SDK
   • Native (C/C++) 工具链
   • 模拟器（可选）

2. 配置 OHOS_SDK_HOME
   把 SDK 根目录加到系统变量：

   OHOS_SDK_HOME=C:\Users\<name>\AppData\Local\OpenHarmony\Sdk
   

   并在 Path 追加 %OHOS_SDK_HOME%\toolchains

3. 打开 DevEco → SDK Manager → 确认 API ≥ 11 已安装

---

六、创建第一个鸿蒙 Flutter 项目

# 1. 新建工程
flutter create --platforms ohos my_first_app
cd my_first_app

# 2. 拉取鸿蒙专用插件（纯 Dart 插件可直接用；含原生代码需替换为鸿蒙版）
flutter pub get

项目结构多出一个 ohos/ 目录，即为鸿蒙平台工程。

---

七、运行到模拟器/真机

1. 启动 DevEco 模拟器（或真机打开开发者模式 → USB 调试）
2. 执行

flutter run

首次编译会耗时 2~5 min，成功后模拟器内出现经典计数器界面，即验证通过 。

---

八、构建 HAP 安装包

flutter build app --release

产物路径：
my_first_app/ohos/build/outputs/default/my_first_app-default-unsigned.hap
如需真机安装，继续在 DevEco 里「自动签名」即可 。

---

九、已有 Flutter 项目迁移到鸿蒙

1. 切分支

   git checkout -b feat-ohos
   

2. 生成 ohos 目录

   flutter create --platforms ohos .
   

3. 插件兼容性处理
   • 纯 Dart 插件：无改动
   • 含原生代码：在 ohos-tpc 插件清单 里找对应鸿蒙版，然后在 pubspec.yaml 写 dependency_overrides 强制替换
4. 重新 flutter pub get → flutter run

---

十、常见报错速查

现象	解决
flutter doctor 提示缺少 Android toolchain	忽略即可，我们只构建 ohos
cmdline-tools 报错	DevEco 里打开 SDK Manager 重装 Command Line Tools
模拟器列表为空	先启动 DevEco 模拟器，再执行 flutter run
真机安装失败	DevEco → File → Project Structure → Signing 勾选自动签名

---

十一、目前限制（2025-12）

• 官方尚未合并，属于社区移植，API 覆盖度约 70%
• 摄像头、蓝牙、推送等需自己写 Platform Channel 或等社区插件
• 仅支持 OpenHarmony API 11+（HarmonyOS NEXT 及以上）

---

照此流程，Windows/macOS/Linux 均可 30 min 内让 Flutter 在鸿蒙模拟器里跑起来。
更多示例与插件持续更新，关注 openharmony-tpc 组织即可。祝开发顺利！