快捷目录
▌ 网络理论
▌ 相关资料
- MobileIMSDK版本更新日志
- MobileIMSDK常见问题解答
👈 - MobileIMSDK性能测试报告
- 客户端Demo安装和使用帮助(Android)
- 客户端Demo安装和使用帮助(iOS)
- 客户端Demo安装和使用帮助(Java)
- 服务端Demo安装和使用帮助
🆕 - 应用案例RainbowChat体验版
👈 - 应用案例RainbowChat体验版截图预览
- 应用案例某Chat的部分非敏感运营数据
▌ 开发文档
- 客户端开发指南(Android)
- 客户端开发指南(iOS)
- 客户端开发指南(Java)
- 服务端开发指南
- 客户端SDK API文档(Android)
- 客户端SDK API文档(iOS)
- 客户端SDK API文档(Java)
- 服务端SDK API文档(基于Mina框架)
- 服务端SDK API文档(基于Netty框架)
▌ 资源下载
▌ 学习交流
- 讨论学习和资料区：点此进入
- 常见问题讨论学习：点此进入
👈 - 移动端即时通讯交流群：
320837163👈 - bug/建议发送至：
jb2011@163.com - 技术支持/合作/咨询请联系作者QQ：
413980957
一、简介
MobileIMSDK是一套专为移动端开发的原创即时通讯高可重用框架：
- 超轻量级、高度提炼，lib包50KB以内；
- 完全基于UDP协议实现；
- 客户端支持iOS、Android、标准Java平台；
- 服务端提供Mina版和Netty版，方便研究和学习；
👈 - 可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；
👈 - 可应用于跨设备、跨网络的聊天APP、企业OA、消息推送等各种场景。
MobileIMSDK工程始于2013年10月（2018年06月08日发布了最新版v3.3，版本更新日志点此查看 ），起初用作某产品的即时通讯底层实现，完全从零开发。
MobileIMSDK现已公开并免费供开发者使用，希望对需要的人有所启发和帮助。
二、代码托管同步更新
GitHub.com
- 代码托管： https://github.com/JackJiang2011/MobileIMSDK
- 项目资料： 点击查看更多资料
OsChina.net
- 代码托管： https://gitee.com/jackjiang/MobileIMSDK
- 项目资料： 点击查看更多资料
MobileIMSDK版本更新日志：点此查看
三、设计目标
让开发者专注于应用逻辑的开发，底层复杂的即时通讯算法交由SDK开发人员，从而解偶即时通讯应用开发的复杂性。
四、框架组成
整套MobileIMSDK框架由以下5部分组成：
- Android客户端SDK：用于Android版即时通讯客户端，支持Android 2.3及以上，查看API文档；
- iOS客户端SDK：用于开发iOS版即时通讯客户端，支持iOS 6.0及以上，查看API文档；
- Java客户端SDK：用于开发跨平台的PC端即时通讯客户端，支持Java 1.5及以上，查看API文档；
- 服务端SDK（Mina版）：基于Mina框架，用于开发即时通讯服务端，支持Java 1.6及以上版本，查看API文档。
- 服务端SDK（Netty版）：基于Netty框架，用于开发即时通讯服务端，支持Java 1.6及以上版本，查看API文档
🆕 。
五、技术特征
- 超轻量级：高度提炼，lib包50KB以内；
- UDP实现：更好的适应现今的无线网络环境；
- 高效费比：UDP的无连接特性，同等条件下可实现更高的网络负载和吞吐能力；
- 消息走向：支持即时通讯技术中消息的所有可能走向，共3种（即C2C、C2S、S2C）；
- QoS机制：完善的消息送达保证机制，不漏过每一条消息；
- 健壮可靠：实践表明，非常适于在高延迟、跨洲际、不同网络制式环境中稳定、可靠地运行；
- 断网恢复：拥有网络状况自动检测、断网自动治愈的能力；
- 原创算法：核心算法和实现均为原创，保证了持续改进和提升的空间；
- 多种模式：预设多种实时灵敏度模式，可根据不同场景控制即时性、流量和客户端电量消耗；
- 数据压缩：自有协议实现，未来可自主定制数据压缩，灵活控制客户端的流量、服务端网络吞吐；
- 高度封装：高度封装的API接口，保证了调用的简易性，也使得可应用于更多的应用场景；
- Web支持：可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；
👈 - Mina、Netty：服务端分别提供了基于Mina和Netty共2个版本，根据您的技术喜好灵活选择
🆕 。
MobileIMSDK 所支持的全部3种即时通讯消息走向分别是：
(1) Client to Client (C2C)：即由某客户端主动发起，接收者是另一客户端；
(2) Client to Server (C2S)：即由某客户端主动发起，接收者是服务端；
(3) Server to Client (S2C)：即由服务端主动发起，接收者是某客户端。
六、性能测试
压力测试表明，MobileIMSDK用于推送场景时，理论单机负载可接近千万级。用于聊天应用时，单机负载也可达数十万。
当然，每款应用都有各自的特点和差异，请视具体场景具体评估之，测试数据仅供参考。
七、演示程序
八、应用案例
① 基于MobileIMSDK的产品级聊天APP：
② MobileIMSDK在高网络延迟下的案例：
某款基于MobileIMSDK的商业商品，曾运营于跨洲际的复杂网络环境下，端到端通信延迟在洲际网络繁忙时可高达600ms以上（与服务端的单向延迟约为300ms左右，而通常大家访问国内主流门户的延迟约为20~50ms），某段时期的非敏感运营数据 点此查看。
九、资源下载
内含完整demo、api文档、编译分发包等）。
十、典型应用场景
🚩 场景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要简单的多。
十一、开发指南
十二、授权方式
你可永久免费且自由地使用MobileIMSDK，如：用于研究、学习、甚至商业用途， 但禁止在超越License约束内容的情况下用于商业用途等，请尊重知识产权。 更详细的授权说明，请见MobileIMSDK社区介绍贴中的“十二、授权方式”一节。
补充说明：如您还需获得更多技术支持或技术合作请联系作者，QQ：
413980957。
十三、联系方式
- 讨论学习和资料区：
🌎 点此进入； - 移动端即时通讯学习交流群：
320837163（更多QQ群点此进入）；
- bug和建议请发送至：
💌 jb2011@163.com； - 技术支持、技术合作或咨询请联系作者QQ：
🐧 413980957、微信：hellojackjiang。
十四、捐助作者
优秀的开源需要您的支持才能走的更远，衷心感谢您的支持与理解，也希望您能从开源中收益。
- 捐助链接： 点此进入。
十五、关注作者
- 推荐关注：BeautyEye工程
- 博客地址：点击入进
- Github主页：点击进入
附录1：官方Demo截图
🚩 Android和iOS运行效果：
安装和使用：进入Android版Demo帮助页、进入iOS版Demo帮助页。
🚩 Windows 运行效果：
安装和使用：进入Java版Demo帮助页。
🚩 Mac OS X 运行效果：
安装和使用：进入Java版Demo帮助页。
🚩 MobileIMSDK-Web版客户端Demo运行效果：
MobileIMSDK-Web在手机端浏览器运行效果：查看MobileIMSDK-Web版详情。
MobileIMSDK-Web在PC端浏览器运行效果：查看MobileIMSDK-Web版详情。
附录2：基于MobileIMSDK的全功能IM【案例】
关于RainbowChat的更多资料请见：RainbowChat前端APP功能截图网页。
