先说结论:能跑,但不是复制粘贴就能跑。
最近我把一个口腔护理类的轻量级 App 迁移到了 OpenHarmony 生态上,核心功能是“刷牙记录”——配合智能牙刷记录每次刷牙的时长、覆盖区域、力度档位,再生成历史时间线和一周热力图。项目技术栈选了 Flutter,具体用的是 flutter_for_openharmony(下面简称 FFOH)这个社区维护的分支。整条链路走下来,从工程初始化、原生通道补桥、本地存储选型,到蓝牙设备的特征值读取、锁屏场景下计时状态保活,每个环节都有和安卓端完全不一样的“脾气”。
这篇文章适合三类读者:一是想把手头 Flutter 应用平移到 OpenHarmony 上跑起来的开发者,二是正在做健康 / 护理类应用、需要接入蓝牙外设的产品,三是对跨端适配边界感兴趣、想弄明白“一套代码到底能复用多少”的人。我会把项目里能直接照抄的方案和踩过的坑都写下来,包括数据模型设计、原生插件桥接、时间戳校准这几个最容易出问题的地方。
1. 为什么在 OpenHarmony 上搞 Flutter,还要选个“刷牙计数”这种细分工
1.1 一套 Flutter 代码,到底能不能在 OpenHarmony 上原样跑
很多人的第一反应是:Flutter 不是跨端吗?写一遍到处跑,换个系统怎么会这么麻烦。
这句话对了一半。Flutter 的跨端能力体现在 Dart 层和渲染层:你的 Widget 树、布局逻辑、状态管理、纯 Dart 写的业务代码,这些在 FFOH 分支下确实能复用绝大部分。问题出在 Platform Channel 和 原生插件 上。OpenHarmony 不是 Android,没有 Android 那套 PluginRegistry,也没有现成的 shared_preferences、path_provider 这类插件的 OpenHarmony 实现。任何需要调用系统能力的地方——本地存储、蓝牙、震动、通知、传感器——都要在原生侧(OpenHarmony 的 ArkTS/C++ 层)自己写实现,再通过 MethodChannel 暴露给 Dart 调用。
我梳理了一下这个项目里的复用情况:
| 模块 | 能否直接复用 | 说明 |
|---|---|---|
| Widget 与页面路由 | 基本能复用 | 布局、动效、路由逻辑在 Flutter 层,OpenHarmony 侧不需要动 |
| 状态管理(状态机等) | 完全复用 | 纯 Dart 代码,和平台无关 |
| 数据模型与业务计算(评分、聚合) | 完全复用 | 纯 Dart,测试也好写 |
| 本地存储 | 不能直接用 | 需要换方案或用原生 Preferences 桥接 |
| 蓝牙扫码与连接 | 必须自己写桥 | OpenHarmony 侧实现扫描、连接、Notify 订阅 |
| 系统日志 | 部分可用 | 调试期可以在原生侧打日志,线上要统一收集链路 |
所以我的结论是:业务层复用得很爽,系统能力层要重新补课。 而这个“刷牙记录”功能恰好把这两种情况都覆盖了,非常适合作为 FFOH 适配的试金石。
1.2 为什么先用口腔护理这个场景试水
选“刷牙记录”不是随手拍脑袋,是冲着三个硬需求去的:
- 必须对接蓝牙外设。智能牙刷通过 BLE(低功耗蓝牙)把刷牙数据传过来,这逼着我把 FFOH 的原生插件通道完整走一遍,属于“绕不开的深水区”。
- 数据完全本地化。刷牙记录不需要账号体系,不需要服务端同步,用本地数据库就够。这能把后端复杂度全部砍掉,专注验证“设备接入 + 本地数据管理 + UI 自定义”这条主链路。
- UI 有强交互。刷牙计时页需要一个圆环倒计时动画、口腔分区引导图、实时时长数字,这些正好能检验 Flutter 渲染层在 OpenHarmony 上的表现是否流畅。
在这个项目里,我全程用一个测试用的智能牙刷模组“模拟设备 X”做验证(一个自制 BLE 设备,广播刷牙事件和力度传感器值)。不用真机牙刷的原因很简单:开发阶段可控制性太差,调试日志也不好加。如果你手头也只有成品牙刷,建议先加一个“模拟模式”,用定时器代替真实设备事件,否则后面排查问题会非常痛苦。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 项目骨架搭建:Flutter 工程跑通 OpenHarmony 的关键链路
2.1 环境准备与工程初始化
FFOH 不是 Flutter 官方主分支,而是 OpenHarmony 社区维护的分支,它把 Flutter 引擎编译产物接入到 OpenHarmony 的 hvigor 构建体系里。所以整个流程比普通 Flutter 工程多好几步,每一步错一点都可能导致 hvigor build 直接失败。
我当时的环境如下,你可以作为参考基准:
- 操作系统:64 位桌面 Linux,内存至少 16GB(编译 OpenHarmony 的 Flutter 引擎很吃内存,8GB 机器分分钟 OOM)
- 开发工具:DevEco Studio(用来打开 FFOH 工程并构建 HAP 包)
- Flutter SDK:
flutter_for_openharmony分支的 SDK,不是官方主分支 - 目标系统:OpenHarmony API 版本较新的模拟器或真机
工程初始化分两条路:一是直接 clone FFOH 分支源码,用它的示例工程跑起来;二是用 flutter create 生成标准工程,再把工程结构改成 FFOH 能识别的格式。我建议从第一条路开始,先把示例跑通,再往里面加自己的业务代码。
bash复制# 获取 FFOH 分支(以社区仓库为例)
git clone -b ohos https://example.com/flutter_for_openharmony.git flutter_ohos
# 用 FFOH 分支的 flutter 命令创建工程
./flutter_ohos/bin/flutter create brush_app
创建完工程后,你会看到一个 ohos 目录,里面是 OpenHarmony 侧的工程骨架。这个目录就是你的“原生侧”,和安卓工程里的 android 目录一个作用。后续写蓝牙插件、配置权限、加原生依赖都在这里。
2.2 原生通道设计:需要自己补的几块“桥”
跑通默认 Demo 之后,第一件必须做的事就是把工程里所有的“桥”列清楚。FFOH 是把 Flutter 的 dart:ui 和引擎层移植到了 OpenHarmony,但 MethodChannel 对应的原生侧实现需要你自己在 ohos 模块里写。
我这边需要的系统能力有三块:蓝牙、本地偏好存储、系统日志。其中蓝牙是最复杂的,单独开一个原生 Plugin 模块维护,另外两块直接在页面侧用通道调用就行。
以蓝牙扫描为例,Dart 侧是这样的:
dart复制import 'package:flutter/services.dart';
const MethodChannel _bleChannel = MethodChannel('ohos.devices.ble');
Future<void> startScan({Duration timeout = const Duration(seconds: 30)}) async {
try {
await _bl
