一、基本介紹

MobileIMSDK-鴻蒙端是一套基于鴻蒙Next(純血鴻蒙)系統(tǒng)的IM即時(shí)通訊客戶(hù)端庫(kù):
- 1)超輕量級(jí)(編譯后庫(kù)文件僅50KB)、無(wú)任何第3方庫(kù)依賴(lài)(開(kāi)箱即用);
- 2)純ArkTS編寫(xiě)、無(wú)Native代碼、高度提煉、簡(jiǎn)單易用;
- 3)基于鴻蒙Next標(biāo)準(zhǔn)WebSocket API,簡(jiǎn)潔優(yōu)雅;
- 4)可運(yùn)行于任何支持鴻蒙Next的平臺(tái);
- 5)能與 MobileIMSDK的各種客戶(hù)端完美互通;
- 6)可應(yīng)用于鴻蒙Next中的消息推送、客服聊天、企業(yè)OA、IM等場(chǎng)景。
二、與MobileIMSDK的關(guān)系
MobileIMSDK-鴻蒙端是基于鴻蒙Next標(biāo)準(zhǔn)WebSocketAPI的 MobileIMSDK配套客戶(hù)端庫(kù)。
以下是MobileIMSDK的最新通信架構(gòu)圖:

MobileIMSDK是一套專(zhuān)為移動(dòng)端開(kāi)發(fā)的原創(chuàng)開(kāi)源IM通信層框架:
- 1)歷經(jīng)10年、久經(jīng)考驗(yàn);
- 2)超輕量級(jí)、高度提煉,lib包50KB以?xún)?nèi);
- 3)精心封裝,一套API同時(shí)支持UDP、TCP、WebSocket三種協(xié)議(可能是全網(wǎng)唯一開(kāi)源的);
- 4)客戶(hù)端支持iOS、Android、標(biāo)準(zhǔn)Java、H5(暫未開(kāi)源)、微信小程序(暫未開(kāi)源)、Uniapp(暫未開(kāi)源)、鴻蒙Next(Demo工程源碼)new;
- 5)服務(wù)端基于Netty,性能卓越、易于擴(kuò)展;
- 6)可與姊妹工程 MobileIMSDK-Web 無(wú)縫互通實(shí)現(xiàn)網(wǎng)頁(yè)端聊天或推送等;
- 7)可應(yīng)用于跨設(shè)備、跨網(wǎng)絡(luò)的聊天APP、企業(yè)OA、消息推送等各種場(chǎng)景。
PS:MobileIMSDK一直在持續(xù)開(kāi)發(fā)和升級(jí)中,本鴻蒙客戶(hù)端是MobileIMSDK工程的最新成果。
三、設(shè)計(jì)目標(biāo)
直接使用鴻蒙Next的WebSocket API開(kāi)擼,有以下問(wèn)題和劣勢(shì):
- 1)功能有限:沒(méi)有心跳保活、斷線重連、消息送達(dá)保證(重傳和去重)等即時(shí)通訊關(guān)鍵算法和邏輯;
- 2)API 簡(jiǎn)陋:在如此有限的API接口下,能邏輯清晰且健壯地實(shí)現(xiàn)并組合心跳保活、斷線重連、消息送達(dá)保證等算法,需要相當(dāng)高的技術(shù)掌控力;
- 3)邏輯耦合:經(jīng)驗(yàn)欠缺的開(kāi)發(fā)人員,會(huì)將WebSocket通信邏輯與前端ArkUI界面代碼混在一起,使得UI界面的編寫(xiě)、維護(hù)、改版都非常困難。
針對(duì)以上問(wèn)題,而MobileIMSDK-鴻蒙端庫(kù)將讓開(kāi)發(fā)者專(zhuān)注于UI應(yīng)用層的開(kāi)發(fā),網(wǎng)絡(luò)通信層的專(zhuān)業(yè)代碼交由SDK開(kāi)發(fā)人員,從而解偶UI前端和通信層的邏輯耦合性,大大降低技術(shù)復(fù)雜度和應(yīng)用門(mén)檻。
MobileIMSDK-鴻蒙端庫(kù)的設(shè)計(jì)目標(biāo)是為您的開(kāi)發(fā)帶來(lái)以下便利:
- 1)界面與通信解偶:UI界面與網(wǎng)絡(luò)通信層代碼解耦,UI界面的重構(gòu)、維護(hù)、改版都非常容易和優(yōu)雅;
- 2)輕量級(jí)和兼容性:受益于堅(jiān)持使用鴻蒙Next的標(biāo)準(zhǔn)WebSocket API,簡(jiǎn)潔輕量,無(wú)需任何額外庫(kù)依賴(lài);
- 3)核心內(nèi)聚和收斂:得益于長(zhǎng)期的提煉和經(jīng)驗(yàn)積累,SDK核心層高度封裝,開(kāi)發(fā)者無(wú)需理解復(fù)雜算法即可簡(jiǎn)單上手。
- 4)純 ArkTS 實(shí)現(xiàn):純ArkTS編寫(xiě),無(wú)重量級(jí)框架和庫(kù)依賴(lài)(更無(wú)Native代碼),可干凈利落地對(duì)接各種既有系統(tǒng);
- 5)跨平臺(tái)運(yùn)行能力:受益于鴻蒙系統(tǒng)的跨端特性,理論上本SDK可運(yùn)行于任何支持鴻蒙Next的平臺(tái)上。
四、技術(shù)亮點(diǎn)
- 1)超級(jí)輕量純凈:超輕量級(jí)——純ArkTS編寫(xiě)且無(wú)任何第3方庫(kù)依賴(lài),編譯后庫(kù)文件僅50KB;
- 2)高內(nèi)聚易使用:高度提煉——簡(jiǎn)單易用,所有核心類(lèi)皆設(shè)計(jì)為單例——到手即用、高度容錯(cuò);
- 3)跨端支持好:基于鴻蒙Next的標(biāo)準(zhǔn)WebSocket API(無(wú)Native代碼依賴(lài)),理論上可很好地運(yùn)行于任何支持最新鴻蒙的平臺(tái)上;
- 4)斷網(wǎng)恢復(fù)能力:擁有網(wǎng)絡(luò)狀況自動(dòng)檢測(cè)、斷網(wǎng)自動(dòng)治愈的能力;
- 5)送達(dá)保證機(jī)制:完善的QoS消息送達(dá)保證機(jī)制(自動(dòng)重傳、消息去重、狀態(tài)反饋等),不漏過(guò)每一條消息;
- 6)通信協(xié)議封裝:實(shí)現(xiàn)了一個(gè)對(duì)上層透明的即時(shí)通訊通信協(xié)議模型;
- 7)身份認(rèn)證機(jī)制:實(shí)現(xiàn)了簡(jiǎn)單合理的身份認(rèn)證機(jī)制;
- 8)完善的log信息:在開(kāi)發(fā)調(diào)試階段,確保每一個(gè)算法關(guān)鍵步驟都有日志輸出,讓您的運(yùn)行調(diào)試更為便利;
- 9)界面代碼解耦:實(shí)現(xiàn)了UI界面代碼與SDK網(wǎng)絡(luò)通信代碼解偶,防止界面代碼跟IM核心代碼混在一起,不利于持續(xù)升級(jí)、重用和維護(hù);
- 10)多端協(xié)議兼容:實(shí)現(xiàn)了與MobileIMSDK各種客戶(hù)端完全兼容的協(xié)議模型。
五、文件組成
完整工程文件概覽:
SDK代碼文件用途說(shuō)明:

精編注釋級(jí)的源碼: