# 重要-即时通讯IM开源项目OpenIM关于版本管理及v2.3
越来越多的客户把OpenIM用到了生产环境，由于新特性持续迭代和bug修复，会涉及到后续的升级方案，为了让大家后续从容应对，本文重点总结OpenIM对未来版本管理的思路和方案。同时，官网对于文档进行了全面更新，有部分端的文档需要在下周完成。
## 版本管理
OpenIM版本管理较为复杂，涉及到服务端版本，以及多端SDK版本。由于OpenIM的SDK底层使用golang实现，所以aar/framework和go core SDK(Open-IM-SDK-Core https://github.com/OpenIMSDK/Open-IM-SDK-Core) 版本保持一致。而插件层会修复自身bug从而带来版本号的变化，所以插件也有自身的版本号。服务端和客户端SDK只需要大版本（版本号第一位数字）保持一致即可。
用例子说明版本号管理
（1）比如go core SDK是2.0.1 （稳定版）
（2）aar包2.0.1 aar和go core SDK版本保持一致；
（3）flutter2.0.1+a 前面三位数保存一致， a b c 是修复自身bug后的版本号
（4）app 自身版本独立，如2.11.2， 但需要在app里面增加一项，表示使用了SDK版本号为2.0.1+a
| go sdk版本（github Open-IM-SDK-Core tag） | aar/framework版本 | Flutter sdk版本 | iOS sdk 版本 | Android sdk 版本 | js sdk 版本 | uniapp 版本 | app/pc版本 |
| ------------------------------------------ | ----------------- | -------------------------- | ------------------------- | ------------------------- | ------------------------------ | ------------------- | --------------------------------------------------- |
| 2.0.1 | 2.0.1 | 2.0.1+1 前面和core保持不变 | 2.0.1.1 前面2.0.1保持不变 | 2.0.1.1 前面2.0.1保持不变 | 2.1.0-beta.1前面和core保持一致 | 2.0.1和core保持一致 | 应用版本可以完全独立，但需要展使用sdk详细版本信息。 |
版本发布过程2.0.1-rc0 =》2.0.1-rc1 =》 2.0.1（稳定版）
## 项目成果
从服务端到客户端SDK开源即时通讯（IM）整体解决方案，可以轻松替代第三方IM云服务，并能根据业务需求高度自定义和二次开发，打造具备聊天、社交、办公功能的app。
OpenIM继续领跑开源IM领域，在广大开发者的大力支持下，目前github star持续突破。越来越多的开发者把OpenIM应用在社交，协同办公领域。在运营过程中也暴露并修复了代码的一些bug，由于使用场景广泛，OpenIM越来越健壮，开源价值也凸显出来了。
github地址： https://github.com/OpenIMSDK/Open-IM-Server
开发者中心：https://doc.rentsoft.cn/#/
## V2.2.0稳定版
V2.2.0稳定版发布时间：2022年7月1日
### 平台支持
以下平台都支持消息互通，SDK和服务端代码100%开源，采用Apache-2.0 License协议，任何团队和个人都可以免费商用。demo主要展示SDK如何使用。商业版是OpenIM团队在开源的服务端和SDK基础上，开发带有UI功能完整的IM产品
| 平台 | SDK 及兼容性 | 源码 | Demo | 商业版 |
| -------- | ------------------------ | -------- | -------- | -------------------- |
| Android | 兼容android5.0及以上版本 | 100%开源 | 100%开源 | 有，针对付费客户开放 |
| iOS | 兼容iOS 11.0及以上版本 | 100%开源 | 100%开源 | 有，针对付费客户开放 |
| Flutter | 兼容flutter2.0及以上版本 | 100%开源 | 100%开源 | 有，针对付费客户开放 |
| Uniapp | | 100%开源 | 100%开源 | 有，针对付费客户开放 |
| Electron | | 100%开源 | 100%开源 | 有，针对付费客户开放 |
| 小程序 | | 100%开源 | 100%开源 | 无 |
| Web | | 100%开源 | 100%开源 | 有，针对付费客户开放 |
| Linux | | 100%开源 | 100%开源 | 无 |
### 帐号功能
| 功能 | 说明 |
| ------------ | ------------------------------------ |
| 帐号禁用 | 设置Token踢出状态，强制用户踢出 |
| 帐号导入 | 把用户导入OpenIM |
| 用户在线状态 | 查询用户是否在线，以及具体哪些端在线 |
| 查询帐号 | 查询帐号是否导入 |
### 多端登录
| 功能 | 说明 |
| ---------- | ------------------------------------------------------------ |
| 单平台登录 | Android、iPhone、iPad、Windows、Mac 只能1端在线；Web 可10端同时在线 |
### 消息类型
| 功能 | 说明 |
| ------------ | ------------------------------------------------------------ |
| 文本消息 | 消息内容是普通文本 |
| 图片消息 | 消息内容为图片 URL 地址、尺寸、图片大小等信息 |
| 表情消息 | 表情消息为开发者自定义 |
| 语音消息 | 语音数据需要提供时长信息，以秒为单位 |
| 地理位置消息 | 消息内容为地理位置标题、经度、纬度信息 |
| 文件消息 | 消息内容为文件的 URL 地址、大小、格式等信息，格式不限，不限制大小。 |
| 短视频消息 | 消息内容为视频文件的 URL 地址、时长、大小、格式等信息，不限制大小。 |
| 自定义消息 | 开发者自定义的消息类型，例如红包等形式的消息 |
| 系统通知消息 | 包含内置的系统通知消息和开发者自定义系统通知消息 |
| Tips 消息 | 包括群、好友、用户信息修改等Tips |
| 合并消息 | 最大支持10条消息合并 |
| 清空所有消息 | 清除个人的本地和服务端消息 |
| 图片视频文件 | 支持MinIO，cos，oss上传 |
### 会话功能
| 功能 | 说明 |
| -------------- | ------------------------------------------ |
| 删除会话 | 支持删除本地；支持删除本地，同时删除服务端 |
| 设置会话免打扰 | 设置会话免打扰，单聊 群聊 |
| 置顶会话 | 置顶/取消置顶 |
### 设置功能
| 功能 | 说明 |
| -------------- | -------------------------- |
| 设置全局免打扰 | 设置后能收到消息，但不提醒 |
### 消息功能
| 功能 | 说明 |
| :----------- | :----------------------------------------------------------- |
| 离线消息 | 用户登录后退到后台，当有用户给其发消息时，即时通信 IM 支持离线推送 |
| 漫游消息 | 在新设备登录时，将服务器记录(云端)的历史消息存储进行同步，默认为全量同步。 |
| 多端同步 | 多终端消息同步，可同时收到消息 |
| 历史消息 | 支持本地历史消息和云端历史消息 |
| 消息撤回 | 撤回投递成功的消息，撤回时间由UI自己控制 |
| 已读回执 | 查看单聊/群聊会话中对方的已读未读状态，对于群聊可以查看哪些人已读/未读 |
| 消息转发 | 将消息转发给其他用户或群组 |
| @功能 | 群内 @ 消息与普通消息没有本质区别，仅是在被 @ 的人在收到消息时，需要在 UI 上做特殊处理 |
| 正在输入 | 支持 |
| 离线推送 | 目前整合了个推、极光推送 |
| 消息删除 | 支持仅删除本地，或者同时删除本地和服务端 |
| 消息回复 | 支持对消息进行回复 |
| 本地消息搜索 | 支持搜索好友，搜索群组、群成员；搜索消息，按照会话分组 |
### 阅后即焚
| 功能 | 说明 |
| ------------ | ------------------------------------------------------------ |
| 私聊阅后即焚 | 在私聊时，双方都可以开启或者关闭阅后即焚状态，在阅后即焚开启后，对方已读后，可以开启30秒倒计时，双方删除 |
### 用户功能
| 功能 | 说明 |
| :----------------------- | :--------------------------------------------------- |
| 设置用户资料 | 用户设置自己的昵称、头像、性别、年龄等资料 |
| 获取用户资料 | 用户查看自己、好友及陌生人资料 |
| 当前登录用户资料变更回调 | 通过监听回调，及时刷新UI界面 |
| 自定义用户资料 | 设置ex字段 |
| 用户通知监听回调 | 登录用户信息修改，连接成功/失败，token过期，被踢下线 |
### 关系链功能
| 功能 | 说明 |
| :--------------------------- | :----------------------------------------------- |
| 查找好友 | 可通过用户帐号 ID 查找好友 |
| 申请添加好友 | 申请添加好友，需对方同意 |
| 导入好友 | 支持导入双向好友关系 |
| 删除好友 | 成为好友后可以删除好友 |
| 获取所有好友 | 获取所有好友 |
| 同意/拒绝好友 | 收到请求加好友请求的系统通知后，可以通过或者拒绝 |
| 添加用户到黑名单 | 把任意用户拉黑，如果此前是好友关系，仍然保留 |
| 移除黑名单 | 把用户从黑名单中移除 |
| 获取黑名单列表 | 拉取用户黑名单列表 |
| 好友备注 | 成为好友后可以给好友备注 |
| 校验好友 | 支持校验单向好友关系 |
| 校验黑名单 | 支持校验单向黑名单 |
| 获取收到的的好友申请列表 | 被添加的好友申请列表 |
| 获取主动发出去的好友申请列表 | 主动申请添加其他人为好友的申请列表 |
| 好友通知监听回调 | 包括好友申请，好友列表变更，好友资料变更； |
| 黑名单通知监听回调 | 用户黑名单列表变更 |
### 群组功能
目前群组采用写扩散模型，会导致消息复制多份，同时不支持新成员查看进群前的历史消息。
| 功能 | 说明 |
| -------------------- | ------------------------------------------------------------ |
| 群容量 | 人数无上限，建议控制在一万人以内 |
| 创建群 | 任何人可以创建群 |
| 群资料属性 | 群名，群头像，群简介，群公告，群扩展字段 |
| 进群模式 | 群成员邀请直接入群；所有人直接进群；所有人都需要验证；群主和管理员验证通过 |
| 获取收到的群申请列表 | 群主管理员可以查看其他用户的入群申请 |
| 获取发出的群申请列表 | 查看本用户入群申请列表 |
| 获取群成员列表 | 拉取群成员信息，支持分页拉取 |
| 群主转让 | 现有群主转让群主身份给群成员 |
| 群成员类型 | 群主、管理员、普通成员 |
| 管理员设置 | 群主可以增减管理员 |
| 群组资料修改权限 | 群主、管理员可修改：群名，群头像，群简介，群公告，群扩展字段 |
| 修改群成员昵称 | 群主可以修改所有人的群昵称。 管理员只能修改普通群成员的群昵称。 |
| 修改自己的群昵称 | 群成员修改群内昵称，群昵称默认为用户昵称 |
| 消息类型支持 | 同消息类型 |
| 消息提醒 | 接收消息但不提示；屏蔽群消息 |
| 历史消息 | 支持 |
| 离线消息 | 支持 |
| 消息漫游 | 支持 |
| 指定成员强制推送@ | 群内 @ 消息与普通消息没有本质区别，仅是在被 @ 的人在收到消息时，需要在 UI 上做特殊处理 |
| 群消息已读回执 | 支持，后台可以配置是否启用，群消息哪些人已读未读 |
| 踢人 | 群主和管理员可以踢人，且管理员不能踢群主和其他管理员 |
| 主动退群 | 除群主外，其他用户均可以主动退群。 群主需先将群转让给其他群成员才可以进行退群操作 |
| 禁言 | 群主管理员对普通成员禁言、解除禁言 |
| 转让群 | 群主可以将群的拥有者权限转给群内的其他成员，转移后， 被转让者变为新的群主，原群主变为普通成员。 |
| 解散群 | 群主管理员可以解散群 |
| 群通知监听回调 | 包括群信息修改，群成员变更，个人进群列表变更，以及群申请通知。 |
## v2.3.0重要特性
预计v2.3.0-rc0发布时间为2022年7月20日
| 版本特性 | 预计发布时间 |
| ---------------------------------------------- | ------------ |
| 群聊写扩散增加读扩散机制，解决消息存储冗余问题 | 2022-7-20 |
| 优先同步群聊最新消息，按需拉取历史消息 | 2022-7-20 |
| 服务端加入一致性缓存，优化db读写性能 | 2022-7-20 |
| 支持单群百万级超级大群 | 2022-7-20 |
| 支持新入群用户查看历史消息 | 2022-7-20 |
## 我们的团队
有部分读者总在质疑现在乐此不疲做聊天 app还有什么价值？这里统一回答一下，OpenIM不是一个独立的聊天工具，是IM统一解决方案，OpenIM用开源技术创造服务价值，打造轻量级、高可用的IM架构，开发者只需简单调用 SDK，即可在应用内构建多种即时通讯及实时音视频互动场景，打造社交，还是电商客服，或者游戏互动等场景。相比于其他云服务商，OpenIM有其优势：开源，安全，可靠，低成本。对于信息安全重视的电子政务，企业协同办公，OpenIM都是非常好的选择。从公司成立之初就将“开源”作为核心战略来推进，以公司化运营打造开源IM，充分体现了自由、平等、分享的互联网精神。OpenIM邀请全球技术极客来参与OpenIM建设，使每位开发者都能免费使用最优秀的IM组件，让每个app都具备即时通讯能力。
