ZEGO 即时通讯 SDK(ZIM)Flutter 版发布 2.26.0 版本,支持使用 Flutter 框架开发 HarmonyOS 应用。该版本功能对齐标准版 ZIM SDK 2.26.0,涵盖 2.20.0 至 2.26.0 版本的全部新增功能与改进优化。这意味着,已使用 Flutter 构建跨端应用的开发者,不必再为鸿蒙单独维护一套原生通讯模块,就能把已有的即时通讯能力直接扩展到 HarmonyOS。

一个代码库,覆盖鸿蒙
对于大量采用 Flutter 的团队来说,跨端开发带来的好处在进入鸿蒙生态时往往会被打断:iOS、Android 两端共用一套 Dart 业务代码,而鸿蒙侧则需要另起一套原生实现,通讯这类涉及长连接、消息存储与离线推送的底层模块尤其难以绕开。
ZIM Flutter SDK 2.26.0 对这一现状作出了直接回应。开发者只需在 pubspec.yaml 中把 zego_zim 的依赖方式从 pub 版本切换为本地路径依赖,并在适配 OpenHarmony 的 Flutter 环境下执行 flutter pub get,即可在鸿蒙工程中复用原有的消息收发代码。登录、创建实例、发送消息、事件回调等接口调用方式,与其他平台保持一致。
集成方式与版本要求
ZEGO 官方发布日志(2026-10-16)说明,该 SDK 需依赖适配 OpenHarmony 的 Flutter,开发者需前往 ZEGO 文档中心的“下载 SDK”页面获取支持 HarmonyOS 的 SDK 压缩包,解压后以本地依赖方式集成。相关集成步骤已在 实现基本消息收发 文档中同步更新。
环境要求方面:开发侧需已参考 OpenHarmony-SIG/flutter_flutter 安装适配版 Flutter;Dart 版本需在 2.12.0 至 4.0.0 之间;测试设备需为 HarmonyOS 5.0.0 Release 或以上版本的设备真机或模拟器。HarmonyOS 平台本身无特殊权限要求,相较 Android 端可省去清单文件中的网络权限配置环节。
能力与标准版对齐
ZIM Flutter SDK 2.26.0 的鸿蒙版本从标准版 2.19.0 版本直接跃升至 2.26.0,功能上完全对齐,并非在旧版基础上做一次平台移植。因此,标准版在这一区间内积累的完整能力都已包含在鸿蒙版本中:
- 消息编辑与重发(2.20.0):支持编辑单聊与群聊消息内容,默认适用过去 24 小时内的消息;断网 30 秒内自动重发,超时可手动重发。
- 消息置顶(2.25.0):可将重要消息固定在会话顶部,并新增
pinnedTime字段,支持按置顶时间排序。 - 更细的消息控制(2.23.0):支持发送时不计入未读数、发送中取消媒体消息、通过已读回执获取对端已读时间戳。
- 会话与房间体验优化(2.21.1 / 2.26.0):会话列表同步状态回调、房间模块多端登录、群主退群 Tips 消息,以及房间在线人数超万人时的用户进出回调。
- 性能优化:超大房间消息推送逻辑优化、群组与会话列表拉取速度提升,并适配 OPPO 消息分类新规。
消息类型层面,鸿蒙端可用的能力与标准版一致:文本、图片、文件、语音、视频、自定义消息、组合消息、合并消息,以及面向房间场景的信令消息与弹幕消息,覆盖单聊、群聊、房间三类会话形态。
鸿蒙生态进入应用加速期
随着 HarmonyOS 5 及以上版本的设备量持续增长,鸿蒙已从“需要评估的第三平台”变成不少应用必须完成适配的目标。但适配的难点往往不在 UI 层:Flutter 的渲染层已能较好覆盖鸿蒙,缺口集中在音视频、即时通讯、推送等需要原生能力支撑的底层模块上。
ZEGO 方面表示,ZIM 此前已覆盖 iOS、Android、macOS、Windows、Web 等平台,HarmonyOS 的加入使 Flutter 跨端能力得以覆盖主流终端。对于社交、语聊房、在线教育、企业协作等高度依赖实时消息的场景,这意味着产品团队可以用更小的人力投入完成鸿蒙版本的上线,而不必牺牲消息可靠性与一致性。
相关链接
本文来自作者投稿,版权归原作者所有。如需转载,请注明出处:https://www.nxrte.com/jishu/im/72669.html