# MobileIMSDK **Repository Path**: jackjiang/MobileIMSDK ## Basic Information - **Project Name**: MobileIMSDK - **Description**: 原创全平台IM通信层框架,轻量级、高度提炼,历经10年、久经考验。同时支持UDP+TCP+WebSocket三种协议,支持iOS、Android、Java、H5、微信小程序、Uniapp、鸿蒙Next,服务端基于Netty。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: http://www.52im.net/thread-52-1-1.html - **GVP Project**: No ## Statistics - **Stars**: 2669 - **Forks**: 883 - **Created**: 2015-11-27 - **Last Updated**: 2025-11-01 ## Categories & Tags **Categories**: im **Tags**: Netty, WebSocket, 即时通讯, IM, TCP ## README
[](https://gitee.com/jackjiang/MobileIMSDK)
[](https://github.com/JackJiang2011/MobileIMSDK)
[](https://gitcode.com/hellojackjiang2011/MobileIMSDK)
[](https://gitee.com/JackJiang2011/MobileIMSDK/blob/master/LICENSE)
[文档手册](http://www.52im.net/forum.php?mod=collection&action=view&ctid=1&fromop=all)・[技术社区](http://www.52im.net/forum-89-1.html)・[更新日志](http://www.52im.net/thread-1270-1-1.html)・[产品案例❶](http://www.52im.net/thread-20-1-1.html)・[产品案例❷](http://www.52im.net/thread-4824-1-1.html)・[产品案例❸](http://www.52im.net/thread-2470-1-1.html)
复杂的即时通讯算法交由SDK开发人员,从而解偶即时通讯应用开发的复杂性。
# 五、框架组成
整套MobileIMSDK框架由以下部分组成:
| | 平台 | 完成度 | Demo演示 | 开发指南 | 源码位置 | 参考应用案例 |
|---|----|------|--------|------ |------|--------|
| 1 | **Android** | ✅ | [安装和使用](http://www.52im.net/thread-55-1-1.html) | [查看](http://www.52im.net/thread-61-1-1.html) | [源码目录](https://gitee.com/jackjiang/MobileIMSDK/tree/master/sdk_src/TCP_Client/MobileIMSDK4a_tcp_Open/) | [查看](http://www.52im.net/thread-20-1-1.html) 🔥 |
| 2 | **iOS** | ✅ | [安装和使用](http://www.52im.net/thread-54-1-1.html) | [查看](http://www.52im.net/thread-62-1-1.html) | [源码目录](https://gitee.com/jackjiang/MobileIMSDK/tree/master/sdk_src/TCP_Client/MobileIMSDK4i_tcp_Open/) | [查看](http://www.52im.net/thread-2730-1-1.html) 🔥 |
| 3 | **Java** | ✅ | [安装和使用](http://www.52im.net/thread-56-1-1.html) | [查看](http://www.52im.net/thread-59-1-1.html) | [源码目录](https://gitee.com/jackjiang/MobileIMSDK/tree/master/sdk_src/TCP_Client/MobileIMSDK4j_tcp_Open/) | |
| 4 | **HTML5** | ✅ | [运行演示](http://www.52im.net/thread-3682-1-1.html#11) | [查看 ](http://www.52im.net/thread-4239-1-1.html)| [精编注释版](http://www.52im.net/thread-3682-1-1.html) | [查看](http://www.52im.net/thread-2470-1-1.html) 🔥 |
| 5 | **微信小程序** | ✅ | [运行演示](http://www.52im.net/thread-4169-1-1.html#10) | [查看](http://www.52im.net/thread-4168-1-1.html) | [精编注释版](http://www.52im.net/thread-4169-1-1.html) | |
| 6 | **Uniapp** | ✅ | [运行演示](http://www.52im.net/thread-4225-1-1.html#10) | [查看](http://www.52im.net/thread-4226-1-1.html) | [精编注释版](http://www.52im.net/thread-4225-1-1.html)| |
| 7 | **鸿蒙Next** ⭐️| ✅ | [HarmonyChat](https://gitee.com/jackjiang/harmonychat) 🔥 | [查看](http://www.52im.net/thread-4767-1-1.html) | [精编注释版](http://www.52im.net/thread-4766-1-1.html) | [查看](http://www.52im.net/thread-4824-1-1.html) 🔥 |
| 8 | **Flutter** | ☑️ | | | [社区版本](https://github.com/Wongxd/MobileIMSDK/tree/master/sdk_src/TCP_Client/MobileIMSDK4f_tcp_Open) | |
| 9 | **Server** ⭐️⭐️| ✅ | [安装和使用](http://www.52im.net/thread-1272-1-1.html) | [查看](http://www.52im.net/thread-63-1-1.html) | [源码目录](https://gitee.com/jackjiang/MobileIMSDK/tree/master/sdk_src/Server/MobileIMSDKServer_Open) | |
整套MobileIMSDK框架的架构原理图:

:bulb: 补充说明:MobileIMSDK一直在持续开发和升级中,[鸿蒙Next客户端](http://www.52im.net/thread-4766-1-1.html) 是MobileIMSDK工程的最新成果。另外:MobileIMSDK可与姊妹工程 [MobileIMSDK-Web](http://www.52im.net/thread-959-1-1.html) 无缝互通,从而实现Web网页端聊天或推送等。
# 六、技术特征
* 久经考验:历经10年,从Andriod 2.3、iOS 5.0 时代持续升级至今(绝不烂尾);
* 超轻量级:高度提炼,lib包50KB以内;
* 多种协议:可能是全网唯一开源可一套API同时支持UDP、TCP、WebSocket三种协议的同类框架 :new:;
* 多种网络:精心优化的TCP、UDP、WebSocket协议实现,可应用于卫星网、移动网、嵌入式物联网等场景;
* 多端覆盖:客户端支持iOS、Android、标准Java、[H5](http://www.52im.net/thread-3682-1-1.html)、[微信小程序](http://www.52im.net/thread-4169-1-1.html)、[Uniap](http://www.52im.net/thread-4225-1-1.html)、[鸿蒙Next](http://www.52im.net/thread-4766-1-1.html);
* 高效费比:独有的UDP协议实现,无连接特性,同等条件下可实现更高的网络负载和吞吐能力;
* 消息走向:支持即时通讯技术中消息的所有可能走向,共3种(即C2C、C2S、S2C);
* 粘包半包:优雅解决各端的TCP经典粘包和半包问题,底层封装,应用层完全无感知;
* QoS机制:完善的消息送达保证机制(自动重传、消息去重、状态反馈等),不漏过每一条消息;
* 健壮可靠:实践表明,非常适于在高延迟、跨洲际、不同网络制式环境中稳定、可靠地运行;
* 断网恢复:拥有网络状况自动检测、断网自动治愈的能力;
* 原创算法:核心算法和实现均为原创,保证了持续改进和提升的空间;
* 多种模式:预设多种实时灵敏度模式,可根据不同场景控制即时性、流量和客户端电量消耗;
* 数据压缩:自有协议实现,未来可自主定制数据压缩,灵活控制客户端的流量、服务端网络吞吐;
* 高度封装:高度封装的API接口,保证了调用的简易性,也使得可应用于更多的应用场景;
* Web支持:可与姊妹工程 [MobileIMSDK-Web](http://www.52im.net/thread-959-1-1.html) 无缝互通实现网页端聊天或推送等;:point_left:
* 扩展性好:服务端基于Netty,继承了Netty的优秀高可扩展性;
* 性能优异:服务端继承了Netty高性能、高吞吐特性,适用于高性能服务端场景。
> MobileIMSDK 所支持的全部3种即时通讯消息走向分别是:编译和运行:[查看鸿蒙Next端Demo完整源码](https://gitee.com/jackjiang/MobileIMSDK/tree/master/demo_src/WebSocket/MobileIMSDK4HarmonyDemo)。

### 2、MobileIMSDK Demo在Android端、iOS端运行效果:
> 安装和使用:[进入Android版Demo帮助页](http://www.52im.net/thread-55-1-1.html)、[进入iOS版Demo帮助页](http://www.52im.net/thread-54-1-1.html)。


### 3、MobileIMSDK Demo在H5端运行效果:

### 4、MobileIMSDK Demo在微信小程序端运行效果:

### 5、MobileIMSDK Demo在Uniapp端运行效果:

### 6、MobileIMSDK Demo在Windows 运行效果:
> 安装和使用:[进入Java版Demo帮助页](http://www.52im.net/thread-56-1-1.html)。

### 7、MobileIMSDK Demo在Mac OS X 运行效果:
> 安装和使用:[进入Java版Demo帮助页](http://www.52im.net/thread-56-1-1.html)。

### 8、MobileIMSDK-Web版客户端Demo运行效果:
> 1)MobileIMSDK-Web Demo在手机端浏览器运行效果:[查看MobileIMSDK-Web版详情](http://www.52im.net/thread-959-1-1.html)。

> 2)MobileIMSDK-Web Demo在PC端多种主流浏览器的运行效果:[查看MobileIMSDK-Web版详情](http://www.52im.net/thread-959-1-1.html)。

# 十四、【案例1】鸿蒙NEXT端IM产品RainbowTalk
> 更多资料请见:[详细介绍](http://www.52im.net/thread-4822-1-1.html)、[运行截图](http://www.52im.net/thread-4824-1-1.html)、[安装体验](http://www.52im.net/thread-4825-1-1.html)。


# 十五、【案例2】移动端IM产品RainbowChat
> 更多资料请见:[详细介绍](http://www.52im.net/thread-19-1-1.html)、[Android运行截图](http://www.52im.net/thread-20-1-1.html) 、[iOS运行截图](http://www.52im.net/thread-2730-1-1.html)、[安装体验](http://www.52im.net/thread-4739-1-1.html)(真机实拍视频:[Andriod端](https://www.bilibili.com/video/BV1sN411Y7a8/)、[iOS端](https://www.bilibili.com/video/BV1Rf4GzyEjh/))。



# 十六、【案例3】网页端IM产品RainbowChat-Web
> 更多截图和视频:[详细介绍](http://www.52im.net/thread-2483-1-1.html)、[更多运行截图](http://www.52im.net/thread-2470-1-1.html)、[更多演示视频](http://www.52im.net/thread-2491-1-1.html)。

