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

一、环境准备

1. 系统要求

• Windows 10/11（64位）
• 至少 8GB 内存，推荐 16GB
• 至少 50GB 可用磁盘空间
• 网络连接（用于下载 SDK 和依赖）

2. 预装软件

• Git（版本 2.20+）
• Node.js（版本 14+）
• DevEco Studio（最新版本，用于 HarmonyOS SDK 管理）

二、安装 HarmonyOS SDK

1. 下载 DevEco Studio

• 下载地址：​​​​​ 最新版本 - 下载中心 - 华为开发者联盟
  

• 从 HarmonyOS 开发者官网下载最新版本

• 安装并启动 DevEco Studio

2. 配置 HarmonyOS SDK

• 在 DevEco Studio 中，进入 File → Settings → HarmonyOS SDK
• 下载并安装 OpenHarmony SDK（推荐版本 6.0.0+）
• 记录 SDK 安装路径（如 D:\DevEco Studio\SDK ）

三、安装 OpenHarmony 版 Flutter SDK

1. 克隆 Flutter 仓库

• 打开命令提示符，进入 D:\Data\Flutter 目录
• 执行命令：

git clone -b oh-3.35.7-dev https://atomgit.com/openharmony-tpc/flutter_flutter.git

2. 配置环境变量

• 复制 D:\Data\Flutter\flutter_flutter\bin 路径

• 打开“环境变量”设置，在系统变量 Path 中添加该路径
  

• 添加 DEVECO_SDK_HOME 变量，值为 HarmonyOS SDK 安装路径

• 在 Path 中添加

D:\openharmony\DevEco Studio\sdk\default\openharmony\toolchains
D:\openharmony\DevEco Studio\tools\ohpm\bin
D:\openharmony\DevEco Studio\tools\hvigor\bin
D:\openharmony\DevEco Studio\tools\node

四、验证环境配置

1. 检查 Flutter 版本

• 打开新的命令提示符，执行

• flutter --version

• 确认显示 OpenHarmony 分支版本

2. 运行 flutter doctor

• 执行

​

flutter doctor -v

• 检查 HarmonyOS 工具链是否配置成功，检查环境变量配置是否正确，Futter与OpenHarmony应都为ok标识，若两处提示缺少环境，按提示补上相应环境即可。

• 解决可能的依赖问题（如缺少 ohpm、hvigor 等）

五、调试与运行

1. 运行模拟器

• 在 DevEco Studio 中，打开设备管理器
  
  

• 启动 HarmonyOS 模拟器

2.创建Flutter工程

创建工程与编译命令，编译产物在

${projectName}/ohos/entry/build/default/outputs/default/entry-default-signed.hap

# 创建工程 方式一 该方式只创建了ohos平台
flutter create --platforms ohos <projectName> 

# 创建工程 方式二 该方式创建了android,ios,ohos三个平台
flutter create  <projectName> 

# 进入工程根目录编译hap包
flutter build hap --debug

3.项目签名

六、OpenHarmony真机运行Flutter项目

1.运行 flutter devices 命令 ：

• 在终端中执行

flutter devices

会列出所有连接的设备。

• 输出中， 如127.0.0.1:5555 就是 HarmonyOS 模拟器的设备 ID。

使用设备 ID

当你需要指定设备运行应用时，可以使用这个 ID：

flutter run --debug -d <deviceId>

2.运行 Flutter 项目

进入 Flutter 项目根目录如（ C:\Users\fate\DevEcoStudioProjects\MyApplication4\my_ohos_app）

执行运行命令

flutter run --debug -d <devicedID>

3.验证成功

模拟器中会显示 Flutter 应用的默认界面（如计数器应用）

七、常见问题与解决方案

1. 网络问题

• 克隆速度慢：使用 Gitee 镜像源

2. 构建错误

• 签名配置失败：确保 DevEco Studio 已生成调试签名
• SDK 版本不匹配：确保 targetSdkVersion 与 compileSdkVersion 一致

3. 工具链问题

• ohpm/hvigor 未找到：检查环境变量配置
• HarmonyOS SDK 未识别：确认DEVECO_SDK_HOME 变量设置正确

八、参考资源

1. 官方文档

• HarmonyOS 开发者文档：华为开发者联盟-HarmonyOS开发者官网，共建鸿蒙生态

• Flutter 官方文档： ​Flutter documentation

• 2. 社区资源

• OpenHarmony Flutter 仓库

• HarmonyOS 开发者论坛

​