Flutter × OpenHarmony 开发日记 Day1：从克隆仓库到环境就绪

日期2026年6月2日目标搭建 Flutter-OH 开发环境完成第一个鸿蒙应用版本Flutter 3.35.8-ohos-1.0.1 / Dart 3.9.2 / OpenHarmony SDK 6.0.1一、开篇为什么选择 Flutter OpenHarmony2026年OpenHarmony 生态已进入成熟期Flutter 作为 Google 推出的跨平台 UI 框架凭借自绘引擎的极致性能已成为追求高流畅度、高定制 UI 应用的首选。其鸿蒙适配版Flutter-OH正致力于将这一体验无缝延伸至鸿蒙设备实现一次开发多平台部署的愿景。今天我正式踏上了Flutter-OH的开发之旅目标是搭建完整的开发环境并跑通第一个应用。二、克隆 Flutter-OH SDKFlutter 的鸿蒙定制版本需要从 OpenHarmony-TPC 官方仓库获取而非 Google 官方仓库。我使用以下命令克隆指定版本gitclone--depth1--branch3.35.8-ohos-1.0.1 https://gitcode.com/openharmony-tpc/flutter_flutter.git参数说明--depth 1浅克隆只拉取最新提交大幅节省时间和磁盘空间--branch 3.35.8-ohos-1.0.1锁定到特定稳定版本避免后续版本升级带来的兼容性问题仓库地址https://gitcode.com/openharmony-tpc/flutter_flutter.gitOpenHarmony 官方 TPC 仓库版本选择建议当前社区推荐版本为 Flutter 3.35.7/3.35.8 系列这是目前最稳定的适配版本。三、环境配置3.1 前置依赖在配置 Flutter-OH 之前需要确保以下环境已就绪依赖项版本要求说明JDK17鸿蒙开发必须使用 Java 17DevEco Studio6.0.1鸿蒙官方 IDENode.js18hvigor 构建工具依赖Git任意代码管理3.2 环境变量配置将克隆好的 Flutter 目录添加到系统环境变量macOS / LinuxexportPATH$HOME/flutter_flutter/bin:$PATHexportPUB_HOSTED_URLhttps://pub.flutter-io.cnexportFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cnexportFLUTTER_GIT_URLgitgitcode.com:openharmony-tpc/flutter_flutter.gitWindows在系统环境变量Path中添加flutter_flutter\bin路径。3.3 配置鸿蒙 SDK 路径flutter config --ohos-sdk/path/to/your/OpenHarmony/Sdk四、验证环境4.1 检查 Flutter 版本flutter--version预期输出Flutter 3.35.8-ohos-1.0.1 • channel [user-branch] • https://gitcode.com/openharmony-tpc/flutter_flutter.git Framework • revision xxxxxxxxxx Engine • hash 6b24e1b529bc46df7ff397667502719a2a8b6b72 Tools • Dart 3.9.2 • DevTools 2.48.04.2 运行 Flutter Doctorflutter doctor-v关键检查项✅Flutter- SDK 版本和路径正确✅HarmonyOS toolchain- OpenHarmony SDK 和工具链就绪⚠️ Android toolchain / Xcode 显示[!]可忽略仅鸿蒙开发无需处理五、创建第一个鸿蒙应用5.1 初始化项目# 创建仅支持鸿蒙的项目flutter create--platformsohos my_ohos_appcdmy_ohos_app5.2 项目结构my_ohos_app/ ├── lib/ # Dart 业务代码 ├── ohos/ # 鸿蒙原生代码ArkTS │ ├── entry/ # 入口模块 │ └── ... ├── android/ # Android 平台代码 ├── ios/ # iOS 平台代码 ├── pubspec.yaml # 依赖配置 └── ...5.3 编译并运行# 查看已连接设备flutter devices# 一键运行自动编译安装启动flutter run--debug-ddevice-id或者先编译 HAP 包flutter build hap--debug产物路径my_ohos_app/ohos/entry/build/default/outputs/default/entry-default-signed.hap六、今日踩坑记录⚠️ 坑1网络超时flutter doctor检查 GitHub 时可能出现 “信号灯超时时间已到”。解决方案配置国内镜像源PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL或设置代理⚠️ 坑2JDK 版本不匹配如果flutter doctor提示 JDK 错误确认java-version# 必须输出 Java 17⚠️ 坑3ohpm/hvigor 未找到确保 DevEco Studio 的tools/ohpm/bin和tools/hvigor/bin已添加到系统Path中。七、多版本管理进阶如果你同时维护官方 Flutter 和 Flutter-OH推荐使用FVM管理多版本 SDK# 安装 FVMbrew tap leoafarias/fvm brewinstallfvm# 安装 Flutter-OH 到 FVM 管理目录cd~/fvm/versionsgitclone-b3.35.8-ohos-1.0.1 https://gitcode.com/openharmony-tpc/flutter_flutter.gitmvflutter_flutter custom_3.35.8_ohos# 切换使用fvm global custom_3.35.8_ohos fvm flutter doctor八、Day1 总结任务状态克隆 Flutter-OH SDK✅ 完成配置环境变量✅ 完成运行 flutter doctor✅ 通过创建第一个鸿蒙应用✅ 完成成功运行到设备⏳ 待验证参考资源 官方仓库openharmony-tpc/flutter_flutter 开源鸿蒙跨平台开发者社区openharmonycrossplatform.csdn.net写在最后Flutter-OH 的生态正在快速发展FOHWGFlutter-OpenHarmony 工作组正主导标准化推进计划2026年完成轻量级 Embedder 接口规范制定。作为开发者现在正是入场的最佳时机。本博客持续更新中欢迎关注 Day2 的进阶实践