我终于可以在 Android Studio 里跑 Harmony Flutter 了

已经熟悉 Flutter，但第一次接触 Harmony Flutter 工作流的开发者。

开篇

前端时间因为项目需要，希望可以把flutter项目运行到Harmony纯血鸿蒙上，搜索得知原来支持鸿蒙的flutter并不在主链上，
是个单独的项目地址为：https://gitcode.com/CPF-Flutter/flutter_flutter.git
下载SDK后,又修改各种配置，各种升级，折腾了很久也没有搞定，对于刚刚从flutter移植项目的人来说门槛真的挺高，经过搜索偶然发现这个Harmony Runner神奇插件 Joyous Harmony Runner for Flutter真是解决了很多实际问题。

目前如果只是安装了flutter sdk及插件, dart环境，android studio开发环境下遇到大概问题：

• 1.Android Studio 安装了flutter新版本插件后，可以识别设备，但是没有任何帮助，仅仅是可以看到；
• 2.不能直接运行真机安装，不能指定设备，只能是命令行；
• 3.不能在Android studio上鸿蒙真机 debug；
• 4.在Android studio没有高亮显示ets源代码;
• 5.不支持同时多个flutter版本，因为鸿蒙版本的flutter sdk周边三个方库太少，很多不支持，不能把原项目直接升级，直接升级全是错误，不升级不支持鸿蒙。
• 6.默认手机文件管理不支持鸿蒙
• 7.由于只能命令行没法方便看手机日志，在DevEco中又不支持flutter代码（两个平台互相不认识）。
• 8.很多库都不支持鸿蒙，导致没法迁移
  我想这些问题也都是影响flutter在鸿蒙设备上运行的原因，感谢有这个插件让我省了很多事，但是第8点，第三方库都不支持鸿蒙版本flutter还是问题。

Joyous Harmony Runner for Flutter 就是解决这些割裂感。它不是替代官方 Flutter 插件，也不是替代 DevEco Studio，而是把已经配置好的 Harmony Flutter 命令行能力接回 Android Studio，让日常开发动作变成可点击、可诊断、可重复的流程。

为什么需要一个 Runner

Harmony Flutter 当前通常需要几类工具一起工作：

• Android Studio：Flutter / Dart 代码编辑、断点、项目开发主环境。
• DevEco Studio：HarmonyOS SDK、签名、证书、Profile、设备授权。
• Harmony Flutter fork：真正支持 Harmony target 的 Flutter 工具链。
• hdc / ohpm / hvigor：设备、包管理和构建相关命令。

这些工具都重要，但它们分散在不同地方。开发者最想要的其实很简单：打开项目、选择设备、点运行、看日志、必要时打断点。

Joyous Harmony Runner 把这个日常路径集中到 Android Studio 右侧 Tool Window 中。

安装后看到什么

安装插件后，Android Studio 右侧会出现 Joyous Harmony Runner 工具窗口。顶部是一排运行相关入口：

• 设备下拉列表
• Run
• Debug
• Stop
• Rerun
• Logs
• Files
• Build
• Doctor
• Enable Harmony

主区域顶部固定显示 Harmony Doctor，用于快速查看 Flutter、hdc、ohpm、Harmony SDK、签名和设备状态。

配置路径

第一次使用时，建议先打开：

Settings | Languages & Frameworks | Joyous Harmony Runner

这里可以配置：

• Flutter Harmony SDK 或 flutter 可执行文件
• DevEco Studio 安装路径
• Harmony SDK root
• hdc 可执行文件或目录
• hvigor 可执行文件或目录
• ohpm 可执行文件或目录

字段为空时，Runner 会尝试从项目、环境变量、DevEco Studio 和 PATH 自动发现。用户手动指定后，插件会检查路径是否合法，合法才保存。

插件是支持flutter双版本，原有功能可以还是flutter主链，harmony单独配置路径，这就非常方便了。

用 Harmony Doctor 找问题

在真正运行前，可以先点 Doctor。Doctor 会输出几类状态：

• Project：是否存在 pubspec.yaml、ohos/、entry、bundle、ability。
• Toolchain：Flutter Harmony、hdc、ohpm、hvigor、Harmony SDK。
• Device：是否有在线 HarmonyOS / OpenHarmony 设备。
• Signing：是否发现签名相关配置。

它的价值不是替你绕过配置，而是把问题说清楚。比如 SDK 没配、设备没连、签名缺失，Runner 会明确告诉你下一步该去哪里处理。

选择真机并运行

设备连接后，顶部设备下拉会列出可用设备。选择目标设备后，点击 Run，Runner 会执行 Harmony Flutter 的构建、安装和启动流程。

这些输出不会放在插件里自建一个孤立面板，而是进入 Android Studio 系统的 Run / Build 输出区域，这样整体体验更接近 IDE 原生工具。

首次体验结论

Joyous Harmony Runner 的第一价值，是让 Harmony Flutter 的日常运行流程回到 Android Studio。你仍然需要 DevEco Studio 完成 SDK、签名和设备授权，但真正写代码、跑真机、看日志和调试时，不必一直在多个工具之间来回切换。

对于 Flutter 开发者来说，这一步不是炫技，而是把每天都要做的动作变顺。
但是关于第8点很多库都不支持鸿蒙，只能希望越来越多的开发者参与支持完善这些库。