如何使用 Flutter 开发 HarmonyOS 应用

文章目录为什么使用 Flutter 来开发搭建 Flutter 开发环境mac 环境变量示例win 环境变量参考验证环境变量是否配置成功集成与调试 Flutter OH SDKFlutter 开发环境搭建第一个 Flutter OH 程序其它常用 Flutter OH 命令题外话Flutter OH 参考文档AuthorGoritDate2026年3月24日Developmentwin 11本教程适用于有一定鸿蒙应用开发基础的开发者或有 Flutter 开发经验的开发者希望借助 Flutter 的跨端开发能力开发出自己的 app为了方便表述后续采用 Flutter OH 表达为什么使用 Flutter 来开发答Flutter 可以编写一套代码。同时编译成 Android、IOS、HarmonyOS 应用并且基于 Flutter 的自绘引擎可以达到高还原度且性能不输原生应用的体验效果搭建 Flutter 开发环境虽然 Google 官方并没有对 Flutter 增加 OpenHarmony 的支持但是 OpenHarmony 社区却对 Flutter 增加了适配 —— 基于 OpenHarmony 的 Flutter SDK关于教程方面主要是配置Java 17 SDK、DevEco Studio、Flutter OH SDK 及相关的环境变量DevEco Studio 直接在 HarmonyOS 官网下载即可这里不再过多赘述下载好后如果没有真机设备那就用模拟器也可以mac 环境变量示例# 配置JDK 17exportJAVA_HOMEJAVA_HOME path/Contents/HomeexportPATH$JAVA_HOME/bin:$PATH# 配置OpenHarmony SDK, ohpm, hvigor, nodeexportTOOL_HOME/Applications/DevEco-Studio.app/Contents# mac环境exportDEVECO_SDK_HOME$TOOL_HOME/sdk# command-line-tools/sdkexportPATH$TOOL_HOME/tools/ohpm/bin:$PATH# command-line-tools/ohpm/binexportPATH$TOOL_HOME/tools/hvigor/bin:$PATH# command-line-tools/hvigor/binexportPATH$TOOL_HOME/tools/node/bin:$PATH# command-line-tools/tool/node/bin#配置FlutterexportPUB_CACHE~/PUBexportPATHflutter_flutter path/bin:$PATHexportPUB_HOSTED_URLhttps://pub.flutter-io.cnexportFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cnwin 环境变量参考在环境变量面板添加以下配置① 配置配置JDK 17变量值作用域JAVA_HOMEJDK path 系统变量Path%JAVA_HOME%\bin追加到现有值② 配置OpenHarmony SDK,ohpm,hvigor,node变量值作用域TOOL_HOMEDeveco-studio Path系统变量DEVECO_SDK_HOME%TOOL_HOME%\sdk系统变量Path%TOOL_HOME%\tools\ohpm\bin系统变量Path%TOOL_HOME%\tools\hvigor\bin系统变量Path%TOOL_HOME%\tools\node\bin系统变量③ 配置Flutter变量值作用域PATHflutter_flutter Path\bin系统变量PUB_CACHEPUB Path系统变量PUB_HOSTED_URLhttps://pub.flutter-io.cn系统变量FLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn系统变量验证环境变量是否配置成功验证 JDK 17java-version验证 Flutter OH SDK 是否生效以下为 Flutter 原生命令# 第一次可能会下载Dart SDKdart--versionflutter--version运行结果集成与调试 Flutter OH SDKflutter doctor-v可以看到 Flutter 和 OH 的工具链都是 ok环境搭建就完成了具体步骤可以直接官方指导文档——OpenHarmony版Flutter环境搭建指导PS官方虽然推荐是在 mac 下进行开发但是实际我在 win 环境也完整的将一个 flutter三方库flutter_background_service完成鸿蒙化的适配开发Flutter 开发环境搭建除了 DevEco 以外我们还需要用到 vscode分别安装Flutter和 Dart 的插件即可具体的步骤就不详细概述可以参考文档配置即可~需要了解 Flutter 基础有经验的可以跳过Dart 语言语法Flutter 应用 Application、package、plugin 的关系和作用Flutter 程序的基本概念Flutter 中一切皆为 widget…第一个 Flutter OH 程序创建一个 Flutter OH 工程# 创建工程 方式一 该方式只创建了ohos平台flutter create--platformsohosprojectName# 创建工程 方式二 该方式创建了android,ios,ohos三个平台flutter createprojectName# 进入工程根目录编译hap包flutter build hap--debug默认执行第一个命令即可使用 DevEco 打开demo/ohos目录等待完成编译构建手动解决报错打开模拟器完成手动签名以上步骤完成后执行flutter run即可看到 flutter app 在 HarmonyOS 模拟器上运行起来了其它常用 Flutter OH 命令F# 创建 package项目flutter create--platformsohos,android,ios multi_entry_ohos# 创建 plugin 项目flutter create--platformsohos,android,ios multi_entry_ohos--templateplugin# 添加平台支持插件flutter create-tplugin--platformsplatforms题外话没记错的话Flutter 发布了专门给 AI Agents 用的专门的 skill用 AI 开发 Flutter 应用会变得事半功倍Flutter OH 参考文档[1] Flutter OH 文档指引[2] Flutter OH 学习 Demo[3] Flutter 官方文档