我最早接到“鸿蒙 + Flutter 混合开发”这个任务时,第一反应不是兴奋,而是头疼。团队里 Flutter 代码库已经积累了二十多个业务模块,完全用 ArkUI 重写不现实,但鸿蒙生态又绕不开。那段时间几乎每天都在翻 OpenHarmony 仓库、试各种适配分支,踩过的坑比写的代码还多。现在回过头看,整个链路——工程化构建、自动化测试、热更新——已经沉淀出一套比较成熟的打法。这篇就把我的实际经验和排查过程完整写出来,给正要上手或者已经在硬抗的团队一个参考。
1. 选型不是跟风:混合架构方案怎么定
1.1 先问自己:业务页面要跨几个端
很多团队拿到鸿蒙适配需求,第一反应是“要不全部用 ArkUI 重写”。我建议先冷静下来,盘一下业务页面到底要跨几个端。如果你的页面只在鸿蒙上跑,那直接用 ArkUI 重写,性能和体验都是最优解;但如果你的核心页面已经在 Android、iOS 上跑了好几年,而且后续还要持续多端同步迭代,那 Flutter 层的复用价值就非常明显了。
在这个判断上,我和团队有一个比较粗但实用的分法:纯展示型页面和中等交互型页面,Flutter 覆盖起来基本无压力;涉及系统级能力、复杂手势、底层硬件调用的场景,必须让鸿蒙原生来兜底。 比如我们的扫码模块最初用 Flutter 写,扫描引擎和相机流对接在 Android 上没问题,移植到鸿蒙模拟器上测试时,发现相机帧率明显掉,后来改成 PlatformView 加载鸿蒙原生的扫码视图,问题才解决。
另一个容易被忽略的点是动态化诉求。如果业务上经常需要不发版就能调整页面(比如运营活动页、首页 banner 位),Flutter 的资产更新和布局动态化要比 ArkUI 灵活一些。当然,这个话题后面会专门说,热更新在鸿蒙上有很多边界要遵守,不能简单照搬 Android 时代那套做法。
1.2 两种宿主模式怎么选
混合开发最核心的决策是“谁主谁次”。实际工程里无非两种形态:
- Flutter 为主(Flutter-first):应用入口是 FlutterActivity/FlutterViewController 的鸿蒙对应物,绝大多数页面在 Flutter 引擎里渲染,鸿蒙原生只提供 Flutter 覆盖不到的系统能力。
- 鸿蒙为主(Native-first):应用入口是鸿蒙的 Ability,鸿蒙原生负责壳工程和主要框架页,通过 Flutter 引擎动态创建多个 Flutter 页面,嵌入到鸿蒙的页面栈中。
我见过不少团队卡在这里出不来。如果你现有的代码库绝大部分是 Flutter 写的,而且未来鸿蒙上不会出现大量生态独占能力,直接选 Flutter-first。这个模式在工程上最简单,Flutter 引擎启动一次,全局一个实例,状态管理、路由栈都是现成的。
反过来,如果你在鸿蒙上有大量原生的模块在跑,比如系统设置、账号、推送、支付等,选 Native-first 更合适。但要注意,Native-first 意味着你要维护两套页面栈,Flutter 侧的路由和鸿蒙侧的 Ability 路由需要建立映射关系,页面切换的衔接、参数传递、生命周期同步都要自己处理,这部分的工程量不亚于重新写一套路由框架。
1.3 团队技术栈与交付节奏的权衡
选型这事不能只从纯技术角度算账,还得看团队里到底谁在干活。
一个只有两三个 Android 转鸿蒙的开发者,却要去维护一个大型 Flutter 跨端业务,这本身就很难持续。反过来,如果团队对 Flutter 已经很熟,只是缺鸿蒙原生知识,那补课的成本是可控的——鸿蒙的 ArkTS 语法和 TypeScript 高度相似,声明式 UI 的写法和 Flutter 的 Widget 树也有异曲同工之处,上手的坡度比从零学一套新语言平缓得多。
从交付节奏看,如果产品经理反复强调“三个端保持一致体验、同步发版”,Flutter 的统一渲染能力能帮你省掉大量 UI 适配的琐碎事。这个优势在长列表、复杂动画、自定义绘制这些场景尤为明显。曾经有一个首页改版,Android 侧用 Flutter 写完直接跑通,鸿蒙侧只是处理了两个安全区适配的边角,整体 UI 还原度几乎是像素级的。如果这个页面用 ArkUI 单独写一遍,UI 走查+微调的时间至少多花两三天。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工程落地:从 flutter create 到能跑起来
2.1 环境准备:版本对齐是第一道坎
说句实话,鸿蒙 + Flutter 混编最磨人的环节不是写业务代码,而是环境搭建。官方 Flutter SDK 默认不带 ohos 平台支持,你必须去 OpenHarmony 官方仓库找带 ohos
