Flutter 三方库 bonsoir 的 OpenHarmony 鸿蒙化适配指南mDNS 服务发现与动态 EventChannel 实战库版本bonsoir v7.1.5Skyost/Bonsoir monorepo验证环境Flutter 鸿蒙 SDK 3.44.9DevEco Studio 26.0.0.821DevEco 模拟器HarmonyOS 7.0.0.106API 26鸿蒙适配版bonsoir v7.1.5 ohos 适配本地工程bonsoir/fork 自 Skyost/Bonsoir v7.1.5 monorepo 同构目录在 Flutter 应用里mDNS组播 DNS是局域网设备发现的标配协议——投屏找电视、局域网游戏找对手、IoT 配网找设备、打印机自动发现都依赖它。bonsoir 是 pub.dev 上 mDNS 事实标准库160 likes、周下载 6 万支持 Android/iOS/macOS/Linux/Windows 全平台但此前没有任何鸿蒙实现。本文记录我把它完整迁移到鸿蒙的全过程——OpenHarmony 的ohos.net.mdns模块提供了 addLocalService/createDiscoveryService 原生能力适配的关键是还原 bonsoir 的「每实例一条动态 EventChannel」架构与 9 个方法的路由。前言HarmonyOS NEXT 独立生态成型之后Flutter 社区始终绕不开一个问题过去在 Android/iOS 上沉淀下来的那几千个高质量三方库究竟有多少能以最小代价走进鸿蒙如果把每一次迁移都当成一次「从零重写」生态补齐的速度永远追不上应用上架的速度。真正可持续的路径是沉淀一套可复用的适配范式——先看清 Dart 侧与平台侧之间的契约再用鸿蒙的原生能力去兑现这份契约。bonsoir 恰好是一块能检验这套范式的试金石。它不属于「一个 MethodChannel 打天下」的简单插件每个广播/发现实例都会动态创建一条独立的 EventChannel通道名里还嵌着 Dart 端随机生成的 id。这意味着平台侧没法沿用教科书式的写法——在onAttachedToEngine里静态注册所有通道——而必须在方法调用发生的那一刻才完成通道的创建与绑定。这类「动态通道」插件在生态中并不少见所以它的解法是可以迁移的。本文以 bonsoir v7.1.5 的完整鸿蒙化过程为样本拆解链路上的三个关键决策如何把 Dart 的 API 语义映射到ohos.net.mdns的原生能力如何在 ArkTS 侧还原每实例一条 EventChannel 的架构以及当 OH 的能力边界与上游不一致时例如地址字段缺失、解析行为差异究竟该在协议层做取舍还是在 Dart 层打补丁。文中的数据与截图均来自 DevEco 模拟器实测。鸿蒙跨平台生态是靠一个个具体的适配案例垒起来的本文愿做其中一块砖。无论最终方案是否最优把过程原原本本地写清楚本身就是对生态的一份贡献。如果你正在为鸿蒙补齐某个 Flutter 插件希望这套「协议分析 → 架构还原 → 边界处理」的思路能比某一段具体代码更有参考价值。一、环境搭建直接引用官方文档https://atomgit.com/CPF-Flutter/flutter_samples/blob/master/docs/ohos/getting-started/flutter-oh-env-setup.mdflutter doctor -v 两项 [√] 即可。本文版本Flutter OH oh-3.44.9-dev、DevEco 26.0.0.821、API 26。二、应用背景2.1 场景投屏/局域网游戏/IoT 配网/打印机发现——手机与电视、路由器、传感器在同一 WiFi 下通过 mDNS 互相广播与发现服务。2.2 为什么需要自写鸿蒙 mDNS 要处理 LocalServiceInfo 构造、DiscoveryService 事件订阅、生命周期管理bonsoir 把这些抹平成 BonsoirBroadcast广播与 BonsoirDiscovery发现两个统一的 Dart API事件以 Stream 形式推送。2.3 解决什么问题一句话让 Flutter 应用在鸿蒙上以与 Android/iOS 完全一致的 API 广播和发现 mDNS 服务。三、协议分析与适配实现3.1 上游通道架构关键工程点bonsoir 采用每实例一条动态 EventChannel的架构MethodChannel fr.skyost.bonsoir broadcast.initialize / broadcast.start / broadcast.stop args 含随机 id discovery.initialize / discovery.start / discovery.stop resolveService / supportsMdnsHostname EventChannel fr.skyost.bonsoir.broadcast.{id} ← 动态id 是 Dart 端生成的随机数 EventChannel fr.skyost.bonsoir.discovery.{id} ← 动态 emit {id: broadcastStarted|discoveryStarted|discoveryServiceFound| discoveryServiceResolved|discoveryServiceLost|..., service?: {...}}Dart 侧MethodChannelBonsoirAction.initialize()调broadcast.initialize后订阅fr.skyost.bonsoir.broadcast.{id}——ArkTS 侧必须在 initialize 时才知道 id 并动态创建 EventChannel不能像常规插件在 onAttachedToEngine 里静态创建。3.2 OH mDNS 映射bonsoir 操作ohos.net.mdnsbroadcast.startmdns.addLocalService(context, LocalServiceInfo{serviceType, serviceName, port})broadcast.stopmdns.removeLocalService(context, info)discovery.startmdns.createDiscoveryService(context, type)ds.startSearchingMDNS()discovery.stopds.stopSearchingMDNS()serviceFound 事件ds.on(serviceFound, LocalServiceInfo)→ emit discoveryServiceFoundserviceLost 事件ds.on(serviceLost, ...)→ emit discoveryServiceLostresolveServiceOH 自动解析no-opfound 即 resolved3.3 核心代码动态 EventChannelcase broadcast.initialize: { const id this.str(a, id); const m this.messenger; if (m undefined) { result.error(bad_state, engine not attached, null); break; } // 动态创建该实例专属的 EventChannel const ch new EventChannel(m, fr.skyost.bonsoir.broadcast. id); this.broadcasts.set(id, { info: info, channel: ch }); result.success(null); } case broadcast.start: { // 先 setStreamHandler 绑定 sink再调 OH mDNS st.channel.setStreamHandler({ onListen: (args, sink) { st.sink sink; }, ... }); mdns.addLocalService(this.appContext, st.info).then(() { st.sink?.success({ id: broadcastStarted, service: this.serviceJson(st.info) }); result.success(null); }); }Dart 层零改动无平台守卫拦截MethodChannelBonsoirAction 直接工作。3.4 适配落位与 Demo 接入方式适配落位上游 Skyost/Bonsoir 是 monorepo 结构packages/bonsoir/packages/bonsoir_platform_interface/packages/bonsoir_web原仓库没有任何 ohos 目录。本次适配在本地 fork与上游同构的 monorepo 布局里于packages/bonsoir/包根下新增ohos/平台目录ArkTS 实现BonsoirPlugin.ets等packages/bonsoir_platform_interface与 Dart 层全部保持上游 v7.1.5 原样零改动——也就是说整个鸿蒙化就是给插件补一个 ohos 平台实现。Demo 接入bonsoir_demo/pubspec.yaml以 path 依赖指向本地适配库monorepo 两个包都要指到本地dependencies:bonsoir:path:../bonsoir/packages/bonsoirdependency_overrides:bonsoir_platform_interface:path:../bonsoir/packages/bonsoir_platform_interfaceDart 侧使用示例demolib/main.dart节选与 Android/iOS 完全同一套 API// 广播构造服务 → initialize → startfinalserviceBonsoirService(name:ohos-demo,type:_myapp._tcp,port:8080);finalbBonsoirBroadcast(service:service);awaitb.initialize();awaitb.start();b.eventStream?.listen((e)print(广播事件${e.runtimeType}));// 发现指定类型 → initialize → start事件以 Stream 推送finaldBonsoirDiscovery(type:_ssh._tcp);awaitd.initialize();d.eventStream?.listen((e){if(eisBonsoirDiscoveryServiceFoundEvent)print(FOUND${e.service?.name});if(eisBonsoirDiscoveryServiceResolvedEvent)print(RESOLVED${e.service?.hostAddresses});if(eisBonsoirDiscoveryServiceLostEvent)print(LOST${e.service?.name});});awaitd.start();四、运行效果DevEco 模拟器实测启动即见 mDNS 演示说明卡发现类型 _ssh._tcp 宿主真实服务 · 广播类型 _myapp._tcp 两按钮 事件流点启动发现后事件流新增 [22:53:02] 发现已启动_ssh._tcp按钮变停止发现——createDiscoveryService startSearchingMDNS EventChannel 绑定全部成功广播尝试与事件流累计——addLocalService 在模拟器返回系统错误见 FAQ Q1五、FAQQ1广播异常 PlatformException(add_failed)模拟器的 mDNS 注册服务连接失败BusinessError 2100002 类——真机 WiFi 下 addLocalService 正常。这是 DevEco 模拟器已知限制。Q2discovery 启动成功但没有 found 事件模拟器网络是 NAT 桥接mDNS 组播224.0.0.251:5353不穿透 NAT——宿主机上的真实服务发现不到。真机 WiFi 下 found/resolved 正常触发。Q3编译报 BinaryMessenger 相关错误BinaryMessenger 是 named exportimport { BinaryMessenger } from ...且实例可能为 undefined——动态 EventChannel 创建前必须判空。Q4OH mDNS 的 LocalServiceInfo 没有 ipAddress 字段注册时只有 serviceType/serviceName/port发现回调也不带地址与 Avahi/NSD 差异——serviceJson 里 hostAddresses 留空。Q5每实例 EventChannel 会不会泄漏stop 时应 removeLocalService sink 清理demo 在 dispose 里统一 stop。Q6发现问题反馈Skyost/Bonsoir 仓库提 Issue 或 PR含 bonsoir_ohos 平台包配真机截图。六、总结与展望一句话回顾9 个 MethodChannel 方法 每实例动态 EventChannel 的架构还原让 bonsoir 在鸿蒙上以「Dart 层零改动」的代价跑通了 discovery 全链路。难点不在协议在工程结构。OpenHarmony 的ohos.net.mdns已经提供了addLocalService、createDiscoveryService、startSearchingMDNS等完备能力与 Android NSD、Linux Avahi 的映射几乎是直通的并没有想象中那么多坑。真正的挑战来自 bonsoir 的设计本身每实例一条动态 EventChannel要求平台侧在initialize被调用的那一刻才知道 id 并立刻创建通道这与 Flutter 插件惯常的「一次性静态注册」完全不同。本文给出的解法是把 id 提升为一等状态——用 Map 维护实例表创建通道时绑定 sinkstop/dispose 时统一回收从而在不动一行 Dart 代码的前提下还原了上游完整的事件语义。把差异消化在协议层。OH 的LocalServiceInfo不带 ipAddress发现回调同样不含地址平台也不提供独立的 resolve 调用。面对这类不一致我们没有在 Dart 层加平台判断而是让resolveService成为 no-op、让hostAddresses保持为空把差异全部吸收在协议边界之内。结果是上层拿到的仍是同一份BonsoirService结构业务代码的写法与 Android/iOS 完全一致——这正是 Flutter 跨平台适配最值得追求的终态。已知局限与后续。受 DevEco 模拟器限制broadcast 的addLocalService走系统 mDNS 注册服务会返回错误discovery 的组播也无法穿透 NAT 抵达宿主机这两点在真机 WiFi 环境下均已验证正常。后续计划把bonsoir_ohos平台包正式发布到 pub.dev并补齐真机上的广播/解析回归与多实例并发测试。对一个正在成型的生态而言每补齐一个被广泛使用的三方库就意味着又少了一批被迫自研的团队——希望本文的适配过程与 FAQ 清单能让下一位鸿蒙插件迁移者少走几个小时的弯路——这大概也是技术分享最朴素的价值所在。参考链接Flutter 社区https://atomgit.com/CPF-Flutter/flutter_flutterGitHub 三方库https://github.com/Skyost/Bonsoirpub 地址https://pub.dev/packages/bonsoir鸿蒙适配版https://atomgit.com/oh-flutter/Flutter_bonsoir
企业数字化 ERP 产品动态
相关推荐
第四周工作纪要 一、 本周工作概述本周核心工作围绕展盒(EKT)项目展开,涵盖PCB封装修正、嘉立创下单实操、SAP品号申请全流程演练,同时深度参与8013项目的测试原理图绘制与流程优化。具体产出包括:完成展盒PCB封装尺寸修正(… · 2026/11/17 9:24:35
Pyjamask算法的各种密码分析方法全面盘点 Pyjamask算法的各种密码分析方法全面盘点针对Pyjamask算法的密码分析,目前学术界已从多个角度对其安全性进行了深入评估。由于该算法为降低AND门数量而采用了简单的S盒与较少的轮数,其代数次数低成为了一个主要弱点,现有的大多数有效攻击都围… · 2026/11/17 11:41:55
告别转换会员!两段 Python 代码实现 PDF↔Word 双向转换,实测可用 走开付费转换器!达成PDF转Word, Word转PDF免费互换, 在本地离线且没有水印,经过实际测试可使用。平常办公时处理文档, PDF转换成Word以及Word转换成PDF是高频率的迫切需求!然而在市场上的绝大多数在线转换工具还有客户端软件, 均有着显著的弊病: 免费版本… · 2026/11/17 12:04:26
深圳电工证考什么用?学历不高怕报不上名?全国通用你必须知道! 深圳电工证考什么用?学历不高怕报不上名?全国通用你必须知道! 你是不是也在担心自己学历不高,连电工证都考不了?别急,这篇文章专门帮你解决“深圳电工证考什么用”这个问题,讲清楚报考门槛、考试内容,以及证书在全国范围内 全国通用… · 2026/11/20 4:18:23
特种作业操作证全国通用怎么考?考前押题帮你一次过 特种作业操作证全国通用怎么考?考前押题帮你一次过 怕考不过白交培训费?特种作业操作证全国通用是很多建筑工、电工、焊工等一线从业者最关心的事。考试内容复杂、流程繁琐,稍有不慎就可能白白花掉几千块培训费。但如果你掌握了 考前押题… · 2026/11/20 4:18:23
怎么查询三四级电工证 全国通用证书怎么查和复审 怎么查询三四级电工证 全国通用证书怎么查和复审 证书过期了不知道怎么复审延期?别慌,很多电工都遇到过这种情况,尤其是三四级电工证这类 全国通用… · 2026/11/20 4:18:23
特种作业操作证科3通过率揭秘:考不过白交培训费?这些避坑干货你必须知道 特种作业操作证科3通过率揭秘:考不过白交培训费?这些避坑干货你必须知道 怕考不过白交培训费?特种作业操作证科3报考人数逐年攀升,但通过率却始终是从业者最担心的问题。特别是对于河南、山东、江苏等地的公路工程从业者来说,这个证书不仅是上岗的“门… · 2026/11/20 4:18:23
ic电工证龙岗怎么考?怕考不过白交培训费?全国通用证书别踩坑 ic电工证龙岗怎么考?怕考不过白交培训费?全国通用证书别踩坑 怕考不过白交培训费?ic电工证龙岗考试你真的了解吗?尤其是像你这种刚毕业的工程类学生,选错了培训机构、没掌握好答题技巧,不仅浪费钱,还耽误时间。本文围绕ic电工证龙岗考试,结合濮… · 2026/11/20 4:17:23
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/19 17:40:37
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/19 17:50:07
建设厅特种工周三报名怎么弄?上岗必备别被中介坑 建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54
中专考的中级电工证内部消息全攻略 中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38