引言

Flutter 是 Google 推出的跨平台开发框架，一套代码可以同时运行在 Android、iOS、Web、Windows 等平台。现在，通过华为和开源社区的努力，Flutter 也能开发鸿蒙 HarmonyOS 应用了！

这意味着：你只需写一次 Dart 代码，就能打包成 .hap 文件，在鸿蒙手机、平板上运行！

一、安装 DevEco Studio（鸿蒙官方 IDE）

DevEco Studio 是华为为鸿蒙开发打造的集成开发环境，就像 Android Studio 之于安卓。

下载与安装

1. 打开官网：最新版本 - 下载中心 - 华为开发者联盟

2. 下载 HarmonyOS 6 稳定版

即最上面的Release版本不建议下载Beta版本

3. 进行安装

安装过程一直点“下一步”即可，但要注意安装路径建议不要选 C 盘，安装选项全选 → 点击“安装”

---

二、配置开发环境

1. 创建必要文件夹

在任意盘（如 D 盘）新建以下目录结构：

D:\HarmonyOS\
├── ArkUI-X\
│   └── Sdk\
├── Emulator\
│   ├── deployed\
│   └── Sdk\         
└── OpenHarmony\
    └── Sdk\

其中的ArkUI-X 文件夹下还有一个 Sdk 文件夹，用于保存ArkUI-X的Sdk

Emulator 文件夹下还有 deployed 文件夹和Sdk文件夹，用于保存鸿蒙本地模拟器和其Sdk

OpenHarmony 文件夹下还有一个 Sdk 文件夹，用于保存鸿蒙项目Sdk

2. 启动 DevEco Studio 并配置 SDK

        ①双击桌面图标打开 DevEco Studio

        ②首次启动会提示创建项目 → 随便起个名字（如 test_harmony），点 Finish。

        ③进入主界面后，点击顶部菜单：File → Settings

        ④左侧找到 OpenHarmony SDK → 设置 SDK 路径为：

D:\HarmonyOS\OpenHarmony\Sdk

        勾选所有 API 版本 → 点击 OK → 等待下载完成（需联网）

💡 同样方法配置 ArkUI-X SDK，路径设为 D:\HarmonyOS\ArkUI-X\Sdk

3. 安装模拟器（没有真机也能调试！）

        ① 点击上方 NO Dervices --> 设备管理器

        ② 点击 + New Emulator

        ③ 选择一个手机型号（如 Mate 70）→ 下载镜像 → 创建

        ④ 创建成功后，点击 ▶ 启动模拟器

---

四、安装 Flutter

1. 下载 Flutter SDK

        ① 在 D 盘新建文件夹用来存放Flutter的文件夹：D:\Flutter

打开命令控制窗口后输入指令：

git clone -b oh-3.27.4-dev https://gitcode.com/openharmony-tpc/flutter_flutter.git

2. 配置环境变量

1. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量

2. 在 系统变量 的 Path 中点击“编辑” → “新建”，添加：

   D:\Flutter\flutter_flutter\bin
   

3. 再新建两个系统变量：

   • 变量名：PUB_HOSTED_URL
     变量值：https://pub.flutter-io.cn
   • 变量名：FLUTTER_STORAGE_BASE_URL
     变量值：https://storage.flutter-io.cn

4. 点击“确定”保存所有设置

3. 验证 Flutter 是否安装成功

1. 打开 新的 cmd 窗口（重要！必须新开）
2. 输入：

   flutter --version
   

   如果显示版本信息，说明成功！

---

五、创建并运行你的第一个鸿蒙 App

1. 创建项目

1. 在 D 盘新建文件夹：D:\MyHarmonyApp
2. 打开 cmd，进入该目录：

   cd /d D:\MyHarmonyApp
   

3. 执行创建命令：

   flutter create --platforms ohos my_first_app
   

✅ 成功后会生成 my_first_app 文件夹

2. 构建应用

cd my_first_app
flutter build app --release

构建成功后，你会在 ohos\build\outputs\default 目录下看到 .hap 文件（这就是鸿蒙安装包！）

3. 在模拟器中运行

1. 确保 DevEco Studio 的模拟器已启动
2. 回到 DevEco Studio，点击顶部绿色 ▶ 按钮
3. 选择你的模拟器设备 → 点击 OK

几秒钟后，你会在模拟器上看到经典的 “Hello World” 页面！

六、配置自动签名（发布必备）

没有签名的应用无法安装到真机！

1. 在 DevEco Studio 中，点击 File → Project Structure

2. 左侧选择 Signing Configs，点击 Sign In，用华为账号登录

3. 登录成功后，勾选 Automatically generate signature

4. 点击 OK

结语

恭喜你！你已经成功用 Flutter 开发出第一个鸿蒙 HarmonyOS 应用

虽然步骤看起来多，但只要按顺序一步步操作，新手也能轻松搞定。

更多学习资源：

• Flutter 鸿蒙 SDK：https://gitcode.com/openharmony-tpc/flutter_flutter
• 华为开发者联盟：https://developer.harmonyos.com