一、基本介绍

MobileIMSDK-鸿蒙端是一套基于鸿蒙 Next（纯血鸿蒙）系统的 IM 即时通讯客户端库：

• 1）超轻量级（编译后库文件仅 50KB）、无任何第 3 方库依赖（开箱即用）；

• 2）纯 ArkTS 编写、无 Native 代码、高度提炼、简单易用；

• 3）基于鸿蒙 Next 标准 WebSocket  API，简洁优雅；

• 4）可运行于任何支持鸿蒙 Next 的平台；

• 5）能与 MobileIMSDK 的各种客户端完美互通；

• 6）可应用于鸿蒙 Next 中的消息推送、客服聊天、企业 OA、IM 等场景。

二、与 MobileIMSDK 的关系

MobileIMSDK-鸿蒙端是基于鸿蒙 Next 标准 WebSocketAPI 的 MobileIMSDK 配套客户端库。

以下是 MobileIMSDK 的最新通信架构图：

MobileIMSDK 是一套专为移动端开发的原创开源 IM 通信层框架：

• 1）历经 10 年、久经考验；

• 2）超轻量级、高度提炼，lib 包 50KB 以内；

• 3）精心封装，一套 API 同时支持 UDP、TCP、WebSocket 三种协议（可能是全网唯一开源的）；

• 4）客户端支持 iOS、Android、标准 Java、H5(暂未开源)、微信小程序(暂未开源)、Uniapp(暂未开源)、鸿蒙 Next(Demo 工程源码)new；

• 5）服务端基于 Netty，性能卓越、易于扩展；

• 6）可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；

• 7）可应用于跨设备、跨网络的聊天 APP、企业 OA、消息推送等各种场景。

PS：MobileIMSDK 一直在持续开发和升级中，本鸿蒙客户端是 MobileIMSDK 工程的最新成果。

三、设计目标

直接使用鸿蒙 Next 的 WebSocketAPI 开撸，有以下问题和劣势：

• 1）功能有限：没有心跳保活、断线重连、消息送达保证（重传和去重）等即时通讯关键算法和逻辑；

• 2）API 简陋：在如此有限的 API 接口下，能逻辑清晰且健壮地实现并组合心跳保活、断线重连、消息送达保证等算法，需要相当高的技术掌控力；

• 3）逻辑耦合：经验欠缺的开发人员，会将 WebSocket 通信逻辑与前端 ArkUI 界面代码混在一起，使得 UI 界面的编写、维护、改版都非常困难。

针对以上问题，而 MobileIMSDK-鸿蒙端库将让开发者专注于 UI 应用层的开发，网络通信层的专业代码交由 SDK 开发人员，从而解偶 UI 前端和通信层的逻辑耦合性，大大降低技术复杂度和应用门槛。

MobileIMSDK-鸿蒙端库的设计目标是为您的开发带来以下便利：

• 1）界面与通信解偶：UI 界面与网络通信层代码解耦，UI 界面的重构、维护、改版都非常容易和优雅；

• 2）轻量级和兼容性：受益于坚持使用鸿蒙 Next 的标准 WebSocket API，简洁轻量，无需任何额外库依赖；

• 3）核心内聚和收敛：得益于长期的提炼和经验积累，SDK 核心层高度封装，开发者无需理解复杂算法即可简单上手。

• 4）纯 ArkTS 实现：纯 ArkTS 编写，无重量级框架和库依赖（更无 Native 代码），可干净利落地对接各种既有系统；

• 5）跨平台运行能力：受益于鸿蒙系统的跨端特性，理论上本 SDK 可运行于任何支持鸿蒙 Next 的平台上。

四、技术亮点

• 1）超级轻量纯净：超轻量级——纯 ArkTS 编写且无任何第 3 方库依赖，编译后库文件仅 50KB；

• 2）高内聚易使用：高度提炼——简单易用，所有核心类皆设计为单例——到手即用、高度容错；

• 3）跨端支持好：基于鸿蒙 Next 的标准 WebSocket API（无 Native 代码依赖），理论上可很好地运行于任何支持最新鸿蒙的平台上；

• 4）断网恢复能力：拥有网络状况自动检测、断网自动治愈的能力；

• 5）送达保证机制：完善的 QoS 消息送达保证机制（自动重传、消息去重、状态反馈等），不漏过每一条消息；

• 6）通信协议封装：实现了一个对上层透明的即时通讯通信协议模型；

• 7）身份认证机制：实现了简单合理的身份认证机制；

• 8）完善的 log 信息：在开发调试阶段，确保每一个算法关键步骤都有日志输出，让您的运行调试更为便利；

• 9）界面代码解耦：实现了 UI 界面代码与 SDK 网络通信代码解偶，防止界面代码跟 IM 核心代码混在一起，不利于持续升级、重用和维护；

• 10）多端协议兼容：实现了与 MobileIMSDK 各种客户端完全兼容的协议模型。

五、文件组成

完整工程文件概览：

SDK 代码文件用途说明：

精编注释级的源码：

六、Demo 功能说明

（点击可看大图 ▲）

七、实际运行效果

1）Demo 的登陆界面运行截图（点击可看大图 ▼）：

2）Demo 的主界面运行截图（点击可看大图 ▼）：

3）Demo 运行的同时，可以查看详细的 log 输出（方便调试）：

八、详尽开发者手册

① 开发者手册（网页版）：点此进入 ◀

② 开发者手册（PDF 精编版）：点此进入 ◀（* 推荐）

九、相关资料

[1] 鸿蒙 Next 官方开发资料

[2] MobileIMSDK 开源框架的 API 文档

[3] MobileIMSDK 开源 IM 框架源码（Github 地址点此）

[4] MobileIMSDK-鸿蒙 Next 端发布公告

[5] MobileIMSDK-鸿蒙 Next 端开发手册（* 推荐）