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 鸿蒙化的团队,建议:

  1. 新项目直接从 3.50.0+ohos-1.3.2 起步,模板已默认多设备声明;
  2. 从 3.47.x 升级的工程记得 flutter clean 并清掉 bin/cache 里的 OHOS 工件缓存(3.50 引擎二进制与旧缓存不兼容);
  3. 已有 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 协议。