开源即时通讯IM框架 MobileIMSDK：快速入门

1、项目简介

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

• 1）历经8年、久经考验；
• 2）超轻量级、高度提炼，lib包50KB以内；
• 3）精心封装，一套API同时支持UDP、TCP、WebSocket三种协议（可能是全网唯一开源的）；
• 4）客户端支持iOS、Android、标准Java、H5(暂未开源)、小程序(开发中..)、Uniap(开发中..)；
• 5）服务端基于Netty，性能卓越、易于扩展 new；
• 6）可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；
• 7）可应用于跨设备、跨网络的聊天APP、企业OA、消息推送等各种场景。

2、代码托管同步更新

GitHub.com：

• 代码托管：https://github.com/JackJiang2011/MobileIMSDK
• 技术社区： 点击查看更多资料

码云gitee：

• 代码托管： http://git.oschina.net/jackjiang/MobileIMSDK
• 技术社区： 点击查看更多资料

3、设计目标

让开发者专注于应用逻辑的开发，底层复杂的即时通讯算法交由SDK开发人员，从而解偶即时通讯应用开发的复杂性。

4、框架组成

整套MobileIMSDK框架由以下6部分组成：

• 1）Android客户端SDK：用于开发Android版即时通讯客户端，支持Android 2.3及以上版本，查看API文档；
• 2）iOS客户端SDK：用于开发iOS版即时通讯客户端，支持iOS 8.0及以上版本，查看API文档；
• 3）Java客户端SDK：用于开发跨平台的PC端即时通讯客户端，支持标准Java 1.6及以上版本，查看API文档；
• 4）H5客户端SDK：暂无开源版，查看精编注释版；
• 5）小程序端SDK：持续开发中，敬请关注；
• 6）服务端SDK：用于开发即时通讯服务端，支持Java 1.7及以上版本，查看API文档；

整套MobileIMSDK框架的架构组成：

5、技术特征

• 久经考验：历经8年，从Andriod 2.3、iOS 5.0 时代持续升级至今（绝不烂尾）；
• 超轻量级：高度提炼，lib包50KB以内；
• 多种协议：可能是全网唯一开源可同时支持UDP、TCP、WebSocket三种协议的同类框架；
• 多种网络：精心优化的TCP、UDP、WebSocket协议实现，可应用于卫星网、移动网、嵌入式物联网等场景；
• 高效费比：独有的UDP协议实现，无连接特性，同等条件下可实现更高的网络负载和吞吐能力；
• 消息走向：支持即时通讯技术中消息的所有可能走向，共3种（即C2C、C2S、S2C）；
• 粘包半包：优雅解决各端的TCP经典粘包和半包问题，底层封装，应用层完全无感知；
• QoS机制：完善的消息送达保证机制（多重保障），不漏过每一条消息；
• 健壮可靠：实践表明，非常适于在高延迟、跨洲际、不同网络制式环境中稳定、可靠地运行；
• 断网恢复：拥有网络状况自动检测、断网自动治愈的能力；
• 原创算法：核心算法和实现均为原创，保证了持续改进和提升的空间；
• 多种模式：预设多种实时灵敏度模式，可根据不同场景控制即时性、流量和客户端电量消耗；
• 数据压缩：自有协议实现，未来可自主定制数据压缩，灵活控制客户端的流量、服务端网络吞吐；
• 高度封装：高度封装的API接口，保证了调用的简易性，也使得可应用于更多的应用场景；
• Web支持：可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；
• 扩展性好：服务端基于Netty，继承了Netty的优秀高可扩展性；
• 性能优异：服务端继承了Netty高性能、高吞吐特性，适用于高性能服务端场景。

MobileIMSDK 所支持的全部3种即时通讯消息走向分别是：

(1) Client to Client (C2C)：即由某客户端主动发起，接收者是另一客端；

(2) Client to Server (C2S)：即由某客户端主动发起，接收者是服务端；

(3) Server to Client (S2C)：即由服务端主动发起，接收者是某客户端。

6、性能测试

压力测试表明，MobileIMSDK用于推送场景时，理论单机负载可接近千万级。用于聊天应用时，单机负载也可达数十万。

当然，每款应用都有各自的特点和差异，请视具体场景具体评估之，测试数据仅供参考。

性能测试报告：点此查看。

7、演示程序

• 1）Android客户端 Demo：点此安装和使用；
• 2）iOS客户端 Demo：点此安装和使用；
• 3）Java客户端 Demo：点此安装和使用；
• 4）H5客户端 Demo：点此查看介绍；
• 5）服务端 Demo：点此安装和使用 new。

8、应用案例

RainbowChat是一款基于MobileIMSDK的产品级聊天APP，更多详情：点击下载体验 或 查看运行截图。

① 基于MobileIMSDK的产品级聊天APP：

详细介绍、下载体验 或 查看运行截图。

② MobileIMSDK在高网络延迟下的案例：

某款基于MobileIMSDK的商业商品，曾运营于跨洲际的复杂网络环境下，端到端通信延迟在洲际网络繁忙时可高达600ms以上（与服务端的单向延迟约为300ms左右，而通常大家访问国内主流门户的延迟约为20~50ms），某段时期的非敏感运营数据 点此查看。

9、打包下载（all in one）

• ① 最新发布版（国外地址）：Github打包下载
• ② 最新发布版（国内地址）：码云gitee打包下载（访问速度快！）

说明：最新发布版打包内容中，已包含完整的demo源码、sdk源码、api文档、编译后的分发包等。

10、典型应用场景

场景1：聊天APP

• 应用说明：可用于开发类似于微信、QQ等聊天工具。
• 消息走向：需使用C2C、C2S、S2C全部类型。

特别说明：MobileIMSDK并未定义聊天应用的应用层逻辑和协议，开发者可自行定义并实现之。

场景2：消息推送

• 应用说明：可用于需要向客户端实时推送信息的各种类型APP。
• 消息走向：仅需使用S2C 1种消息走向，属MobileIMSDK的最简单应用场景。

场景3：企业OA

• 应用说明：可用于实现企业OA的指令、公文、申请等各种消息实时推送，极大提升用户体验，并可延伸至移动设备。
• 消息走向：仅需使用S2C 1种消息走向，属MobileIMSDK的最简单应用场景。

场景4：企业OA的增强型

• 应用说明：可用于实现企业OA中各种系统级、用户级消息的实时互动，充分利用即时通讯技术提升传统OA的价值。
• 消息走向：可使用C2C、C2S、S2C全部类型，这与聊天APP在很多方面已无差别，但企业OA有自已的用户关系管理模型和逻辑，较之全功能聊天APP要简单的多。

11、开发指南

• 1）Android客户端开发指南：点此查看；
• 2）iOS客户端开发指南：点此查看；
• 3）Java客户端开发指南：点此查看；
• 4）H5客户端开发指南：点此查看；
• 5）Server端开发指南：点此查看。

12、关注作者

博客地址：点击入进、Github主页：点击进入

附录1：Demo截图

1）Android和iOS运行效果

>> 安装和使用：进入Android版Demo帮助页、进入iOS版Demo帮助页。

2）Windows 运行效果

>> 安装和使用：进入Java版Demo帮助页。

3）Mac OS X 运行效果

>> 安装和使用：进入Java版Demo帮助页。

附录2：基于MobileIMSDK的全功能IM【案例】

>> 关于RainbowChat的更多资料请见：RainbowChat前端APP功能截图网页 。

附录3：基于MobileIMSDK-Web的网页端IM系统【案例】

下图为RainbowChat-Web的主界面（更多截图点此进入、更多演示视频点此进入）：