Flutter 鸿蒙适配版发布 3.50.0+ohos 批次,开发者第一次能在一台 HarmonyOS PC 上完成开发、运行、调试到 release 打包,不再依赖 macOS 或 Windows 构建机。宿主即设备,这条链路怎么跑通,逐条拆给你看。

2026 年 11 月,Flutter 鸿蒙适配版(Flutter OH)发布了 3.50.0+ohos 批次。这是 Flutter 三方生态里一个有标志性意义的版本:开发者第一次可以在一台 HarmonyOS PC(2in1)上,不依赖任何其他构建机,用 Flutter 完成鸿蒙应用的开发、运行、调试乃至 release 打包。鸿蒙 PC 既是开发工作站,也是运行目标——”宿主即设备”。
仓库:oh-flutter/flutter_flutter[1](分支 oh-3.50-dev) 版本线:3.50.0+ohos-1.0.0 → 1.1.0 → 1.2.0 → 1.3.1 / 1.3.2
一、这个版本的意义:补齐”在鸿蒙上开发鸿蒙”的最后一环
在 3.50 之前,Flutter OH 已经能让开发者为鸿蒙设备开发应用,但开发环境本身仍要架设在 macOS / Windows / Linux 上。3.50 批次把这条链路反过来走通了:
| 能力 | 状态 |
|---|---|
| flutter 命令行直接运行在 HarmonyOS PC(musl / aarch64 宿主) | 1.1.0 起正式支持 |
| 本机设备识别 HarmonyOS local (desktop) • ohos-local | 1.1.0 |
| flutter run -d ohos-local :构建 → 安装 → 启动 → 热重载全链路 | 1.1.0(debug) |
| flutter build hap –profile / –release | 1.2.0 起支持 |
| flutter create 模板默认声明 phone / tablet / 2in1 三类设备 | 1.3.2 |
| DevEco Studio | 可选 ,不再强依赖 |
这意味着鸿蒙生态有了完整的 Flutter 开发闭环:一台鸿蒙 PC,装上 Command Line Tools 26,就能从零写一个 Flutter 应用并跑在自己的电脑上——和 macOS 上用 Flutter 开发 macOS 应用是同一种体验。
二、3.50 批次四个版本的演进脉络
1.0.0:上游大版本同步(3.47.9 → 3.50.0)
3.50 批次的地基。上游同步规模不小:2591 个提交、5591 个文件、+28 万 / -16 万行,且 OHOS 侧 Dart 从 3.13.4 切到 3.14.0(kernel 格式 138 → 141),因此 11 个引擎附件全部按本分支源码重建。引擎构建侧修掉了 3.50 源码与 3.47 时代 OHOS 补丁之间的 API 代差:abseil 升级、Impeller 接口恢复、Vulkan 类型头兼容、Dart 3.14 的 NativeAssetsApi 布局回切、FFI ABI 由 22/23/24 顺延为 24/25/26 等约十项适配。
1.1.0:HarmonyOS PC 本机开发(本次发布的核心亮点)
这是整个 3.50 批次最具突破性的一版,首次正式声明支持在 HarmonyOS PC 上直接开发:
- 宿主即设备:新增 ohos-local 设备类型,flutter devices 直接把本机识别为 HarmonyOS local (desktop);
- 无需 DevEco Studio:flutter run -d ohos-local 完成 HAP 构建、安装、启动、热重载全链路;安装走本机”无线调试”的 hdc 通道(以 uid 2000 执行 bm install),自动读取 persist.hdc.mode / persist.hdc.port,不用手工 hdc tconn;
- 宿主工件自动引导:检测到 HarmonyOS 宿主时,自动下载 musl aarch64 Dart SDK 与签名 AOT 快照(flutter_tools_aot.signed,实测首次下载约 4 秒);离线或 stamp 不匹配时回退本地重建(约 1 分钟);
- 工程模板对齐多设备:flutter create –platforms=ohos 生成的工程默认声明 phone / tablet / 2in1,同一套 Flutter 代码开箱覆盖鸿蒙手机、平板、PC 三类设备。
1.2.0:打通 profile / release 构建
1.1.0 验证的是 debug 模式,1.2.0 把正式发布所需的两档构建补齐了:
- 根因:引擎发布的是 glibc 工件,HarmonyOS PC(musl 内核)上 flutter_tools 找不到可执行的 gen_snapshot;用 Dart SDK 自带 linux 版生成的快照 target OS 是 linux,引擎加载后白屏。
- 解法:从 fluttertpc_dart_sdk 交叉编译出 ohos_arm64 版两档 AOT 编译器——gen_snapshot(release)与 gen_snapshot_profile(profile),随宿主工件自动下载,与其它平台一样零手工。
- 结果:flutter build hap –release 产出的 HAP 可启动、正常渲染(此前白屏);profile 引擎能正确加载对应快照。
1.3.1 / 1.3.2:发布线收口
修复合入与清单收口:ArtifactUpdater 白名单加入 AtomGit Release 直链(消除误导性告警)、18 个工件统一挂单 tag 并附 SHA256SUMS、flutter create 模板 deviceTypes 对齐三项设备类型。1.3.2 的实测记录里,flutter test 在 HarmonyOS PC 上已全部通过。
三、上手:在鸿蒙 PC 上跑起第一个 Flutter 应用
# 1. 获取 SDK(在 HarmonyOS PC 终端执行)
git clone https://atomgit.com/oh-flutter/flutter_flutter.git
cd flutter_flutter
git checkout 3.50.0+ohos-1.3.2
./bin/flutter –version # 首次运行自动下载宿主工件
# 2. 确认环境:本机应显示 HarmonyOS local (desktop) • ohos-local
flutter doctor -v
flutter devices
# 3. 创建并运行(模板默认声明 phone/tablet/2in1)
flutter create –platforms=ohos hello_pc
cd hello_pc
flutter run -d ohos-local # 构建→安装→启动→热重载
# 4. 正式构建
flutter build hap –release # 首次会下载 gen_snapshot.signed
环境要求:DevEco Studio 26.0.0 / Command Line Tools 26.0.0(HarmonyOS PC 开发时 DevEco 可选),引擎与应用目标 API 为 OpenHarmony API 26.0.0,Dart SDK 3.14.0(OHOS fork)。详细排障见 docs/ohos-pc-development.md[2]。
四、已知限制(截至 1.3.2)
- 本机不能交叉编译其它桌面目标(宿主 frontend_server 的 ABI 固定为 ohos);
- release 渲染后端在构建期固定;本机默认 Skia 渲染(Impeller 的 Vulkan 表面在 2in1 上取不到可用 VkImage,–enable-impeller 可复现黑屏);
- 部分宿主工具(如 shader 预编译器)能力仍在补齐过程中。
五、写在最后
Flutter 的核心承诺是“一套代码,多端运行”。3.50 批次把这个承诺在鸿蒙生态里推进了一大步:开发端(HarmonyOS PC 本机开发闭环)和运行端(手机 / 平板 / 2in1 多设备类型)同时补齐。对鸿蒙开发者来说,Flutter 不再只是“把安卓应用带来鸿蒙”的桥,而是一个可以常驻在鸿蒙 PC 上的原生开发工具链。
对正在做 Flutter 鸿蒙化的团队,建议:
- 新项目直接从 3.50.0+ohos-1.3.2 起步,模板已默认多设备声明;
- 从 3.47.x 升级的工程记得 flutter clean 并清掉 bin/cache 里的 OHOS 工件缓存(3.50 引擎二进制与旧缓存不兼容);
- 已有 Flutter 多端项目,把 ohos 加入目标平台矩阵的成本从未这么低——一台鸿蒙 PC 就够。
参考:Flutter 3.50.0+ohos 各版本 Release Notes[3](1.0.0 / 1.1.0 / 1.2.0 / 1.3.1 / 1.3.2)

参考资料
[1]oh-flutter/flutter_flutter: https://atomgit.com/oh-flutter/flutter_flutter
[2]docs/ohos-pc-development.md: https://atomgit.com/oh-flutter/flutter_flutter/blob/oh-3.50-dev/docs/ohos-pc-development.md
[3]Flutter 3.50.0+ohos 各版本 Release Notes: https://atomgit.com/oh-flutter/flutter_flutter/tree/oh-3.50-dev/release-notes
本文由人人都是产品经理作者【nutpi】,微信公众号:【nutpi】,原创/授权 发布于人人都是产品经理,未经许可,禁止转载
题图来自Unsplash,基于 CC0 协议。


