一、基本介绍
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的WebSocket API开撸，有以下问题和劣势：
- 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官方开发资料](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-websocket-V5 "鸿蒙Next官方开发资料") \[2\] [MobileIMSDK开源框架的API文档](http://www.52im.net/topic-docs.html#mobileimsdk "MobileIMSDK开源框架的API文档") \[3\] [MobileIMSDK开源IM框架源码](https://gitee.com/jackjiang/MobileIMSDK "MobileIMSDK开源IM框架源码")（[Github地址点此](https://github.com/JackJiang2011/MobileIMSDK "Github地址点此")） \[4\] [MobileIMSDK-鸿蒙Next端发布公告](https://www.oschina.net/news/325767 "MobileIMSDK-鸿蒙Next端发布公告") \[5\] [MobileIMSDK-鸿蒙Next端开发手册](http://www.52im.net/thread-4767-1-1.html "MobileIMSDK-鸿蒙Next端开发手册")（**\* 推荐**）