跳到主要内容

更新日志（稳定版）

注意

仅 Android/iOS 平台的 IM SDK 存在开发版、稳定版区分。

设计原则​

iOS 平台提供稳定版 IMLib SDK 和 IMKit。

  • SDK 的稳定版本在线上运行时长、稳定性、使用量等方面满足一定的指标要求。
  • 更强调稳定性，而非引入新功能。

发布周期与版本号规则​

IM SDK 在 5.4.X 版本前后版本号规则不同。5.4.X 后更方便区分开发版、稳定版。

  • 从 5.4.X 版本及以后，Stable 版本占用第二位版本号。第二位为偶数均为开发版，第二位为奇数均为稳定版。例如，5.5.X 为稳定版 SDK 使用的版本号。
  • 在 5.4.X 之前，稳定版版本号规则不固定。
  • 融云会监控 Stable 版本客户的使用状况，定期更新稳定版，最长更新周期为两个月。

维护说明​

  1. 如果融云正在积极开发的大版本号（当前为 5.X）下发布了新的 Stable 版本，我们建议使用 Stable 版本的客户升级到新的 Stable 版本。新的 Stable 版本发布后，历史稳定版维护力度相应降低。
  2. 针对已不再积极开发的历史大版本（2.X、4.X）SDK，融云仅维护一个 Stable 版本。请仍使用 2.X、4.X 版本的客户尽快升级到相应的 Stable 版本，或者考虑升级到 5.X 系列的 SDK。

5.21.x 系列是基于 5.20.0 Dev 版本推出的稳定版本

5.21.3 Stable​

发布日期：2026/05/29

优化功能：

  • 优化多聊天室场景下聊天室消息与 KV 数据拉取机制，提升多聊天室并发使用时的数据更新及时性与稳定性。

5.21.1 Stable​

发布日期：2025/10/17

优化功能：

  • IMKit 兼容 iOS 26 系统 UI。

5.21.0 Stable​

发布日期：2025/9/18

新增功能

  • IMLib 增加逐条消息已读功能。
  • IMLib 优化会话列表支持超级群会话类型。
  • IMLib 新增批量设置置顶接口。
  • IMLib 新增拉取远端会话列表接口。
  • IMKit 新增 HTML 流式消息。
  • IMLib 图片消息中增加缩略图的宽 (thumWidth) 和高 (thumHeight) 属性。
  • IMLib 消息体非法时统一转为 UnknownMessage。
  • IMLib 优化了文件下载的本地命名格式。
  • IMKit 和 IMLib 新增了信息托管资料提供内容审核服务的能力。
  • 新增了 IMLib 撤回消息时可设置 isDelete、isAdmin、disableNotification 属性。
  • IMLib 新增了 RCLocalConfiguration 配置管理类（取代RCConfig.plist）。
  • IMLib 支持了接收、监听流式消息的能力。
  • IMKit 支持流式消息的展示。
  • IMKit 新增了 SPM 集成方式。
  • IMLib 支持 IPv6。
  • 新增了 IMLib 设置和获取支持时区的全局免打扰接口。
  • 新增了 IMLib 群组信息变更同步全量群组数据的回调接口。
  • 新增了 IMLib 统计本地通知的点击事件接口。
  • 新增了 IMLib RCConversation的latestRCMessage属性，该属性是会话中最新一条的完整消息体RCMessage。
  • 声明了 IMLib Swift 调用设置代理的方法名。
  • 新增支持了 IMKit 会话中引用消息的草稿能力。
  • 按会话免打扰级别获取总未读消息数支持了系统会话类型。
  • iOS 发送多端同步阅读状态支持了系统会话类型。
  • 新增了 RCMessaage的disableUpdateLastMessage属性，该属性可以控制是否更新到会话最新一条消息。
  • 完善了 IMKit 用户信息托管的群组相关能力的 UI。
  • 适配了跨平台自定义消息的逻辑。
  • 信息托管服务中新增群组及成员管理能力。
  • 信息托管服务中新增好友关系管理能力。
  • IMKit 新增群组及成员管理、好友关系管理能力。
  • 适配了 iOS 18。
  • 新增了 SDK 数据库升级回调。
  • 关闭了 bitcode。
  • 发送消息支持设置 HarmonyOS 推送属性。
  • 在线状态订阅新增了 HarmonyOS 平台。
  • 加入聊天室成功回调增加加入时间。
  • 新增用户信息托管功能，支持修改、查询、订阅托管的用户信息。
  • 新增一个置顶空会话的开关配置，开发者可以选择是否同步置顶的空会话。
  • 新增了 IMKit 会话页面消息全部拉取完的回调。
  • 新增了批量获取会话信息的 API。
  • 新增了用来控制会话置顶操作是否更新操作时间的 API。
  • 新增了聊天室消息排重开关。
  • 支持了在指定会话中，对指定消息类型的历史消息，按关键字进行搜索的功能。
  • 新增了客户端订阅用户在线状态订阅的功能。

问题修复：

  • 修复了同账号多端，系统会话不同步消息未读的问题。
  • 修复了 IM 连接时偶现产生的内存泄漏问题。
  • IMKit 修复了图文消息、合并转发消息的会话摘要显示问题。
  • IMLib 修复了 getConversationListByFilters:option:completion: 接口参数校验多端不一致的问题。
  • IMKit 修复群成员列表用户重复显示的问题。
  • 修复了 iOS 26 暗黑模式下，定位消息入库超限制导致消息发送失败的问题。
  • IMLib 修复了发送媒体消息的回调中消息信息不完整的问题。
  • IMLib 修复了申请加入群组事件回调的 operationTime 不准确问题。
  • IMLib 修复了插入消息时，sentTime 赋值错误问题。
  • IMKit 修复了 XS Max 手机上输入框UI出错。
  • IMLib 修复了过滤发送已读回执时间为 -1 的情况。
  • IMLib 修复了发送超级群已读同步失败问题。
  • IMLib 修复了服务端调用一次设置 KV 接口，客户端收到了两次回调的问题。
  • IMKit 修复了上传图片过程中滚动消息, 有概率出现上传进度重置为 0 的现象。
  • IMKit 修复了【聊天文件页】用户名展示不全的问题。
  • IMKit 修复了点击引用的引用消息无法打开查看的问题。
  • 修复了 IMLib 多端同步阅读状态影响双端用户的未读数的问题。
  • 修复了 IMLib 逐条转发图片点击放大后也是缩略图的问题。
  • 修复了 IMLib 小视频消息传入的 size、duration 类型与安卓不匹配。
  • 修复了 IMLib 连接耳机播放音乐时拍摄录像视频，音乐不会暂停会外放。
  • 修复了 IMLib 超级群拉取的 RC:RcNtf 消息信息不全的问题。
  • 修复了 IMLib 获取消息接口 getMessages:targetId:option:complete:error: 逻辑问题。
  • 修复了 IMKit iOS 18 点击电话号码文本消息没有唤起拨号功能的问题。
  • 修复了 IMKit 在输入内容时切换到语音模式，左侧切换按钮图标错误的问题。
  • 修复了 IMKit 发送视频消息，打开相册在预览页选中视频弹出错误提示，无法选中的问题。
  • 修复了 IMKit 会话输入框默认内容无法隐藏问题。
  • 修复了 IMLib iOS 18 无法发送包含空间音频的视频文件问题。
  • 修复了 IMKit iOS 18 连续播放音频问题。
  • 修复 IMKit 照片选取时偶现无法定位到最新照片的问题。
  • 修复 IMKit 在 iOS 11.4.1 手机上 ，tableView 不设置 footerView 会显示多余横线的问题。
  • 修复了位置共享卸载重装再进入会话仍显示位置共享中小灰条的问题。
  • 解决了发送媒体消息 pushcontent 赋值问题。
  • 是否同步置顶空会话的开关默认值改为 NO，默认不同步置顶的空会话。
  • 修复了 IMKit 合并转发页面文件下载不能取消的问题。
  • 修复了引用消息原文件已下载，但点击引用处的文件依然显示开始下载的问题。
  • 修复了文件断点下载后可能出现的不完整的问题.

优化功能：

  • 优化了 IMLib 超级群消息扩展处理逻辑。
  • 优化了 IMLib 信息托管接口回调和通知逻辑。
  • 优化了 IMLib 插入媒体消息的逻辑。
  • 优化了 RCComplexTextMessageCell 电话和链接点击事件，与文本消息效果一致。
  • 优化了拖拽小视频播放进度条时，播放按钮的显示。
  • 优化了合并转发消息的内容显示格式。
  • 优化了消息撤回机制，现在撤回消息时会同时撤回命令消息中携带的用户信息（UserInfo）和额外信息（extra）。

5.7.x 系列是基于 5.8.0 Dev 版本推出的稳定版本

5.7.11 Stable​

发布日期：2025/9/2

问题修复：

  • IMLib 修复了获取消息接口造成消息下行增多的问题。

5.7.9 Stable​

发布日期：2025/7/18

优化功能：

  • IMLib 增加用户级别配置同步完成回调。
  • IMLib 增加获取未标记的会话列表接口。

5.7.8 Stable​

发布日期：2025/7/8

问题修复：

  • IMLib 修复文件分片下载失败的问题。

5.7.7 Stable​

发布日期：2025/6/20

问题修复：

  • IMLib 修复上报日志偶现崩溃的问题。

5.7.6 Stable​

发布日期：2025/6/5

问题修复：

  • IMKit 修复 XS Max 手机上输入框 UI 出错的问题。

5.7.5 Stable​

发布日期：2025/5/16

优化功能：

  • IMLib 新增了带用户 ID 的连接接口 connectWithUserId:token:timeLimit:dbOpened:success:error:。

问题修复：

  • IMLib 修复弱网下 DNS 解析超时销毁线程导致崩溃的问题。

5.7.4 Stable​

发布日期：2025/4/24

优化功能：

  • 新增了聊天室 KV 回调接口，支持按 KV 设置顺序获取回调。

5.7.3 Stable​

发布日期：2025/2/6

优化功能：

  • 在合并转发功能中，若包含小视频消息，则不再显示右上角的“更多文件”按钮。
  • 新增支持私聊会话的阅读状态同步功能。
  • 优化了视频压缩逻辑。

问题修复

  • 修复了在移除扩展的回调中查询当前消息时，显示扩展未移除的问题。
  • 修复了聊天室内，服务封禁聊天室成员，再解封后，客户端断网重连不重新自动加入聊天室的问题。
  • 修复了插入图片消息后，通过 msgId 获取这个消息并发送时无法发送原图的问题。
  • 修复了在输入内容时切换到语音模式时，左侧切换按钮图标显示错误的问题。
  • 修复了发送多端同步阅读状态时，未支持系统会话的问题。
  • 修复了点击电话号码文本消息时未唤起拨号功能，以及点击邮箱时未跳转到邮件页的问题。
  • 修复了发送视频消息时，在相册预览页选中视频后弹出错误提示且无法选中的问题。
  • 修复了在合并转发详情页中，点击文件名包含英文单引号的文件时无响应的问题。
  • 修复了 iPhone 16 手机从相册选择手机录制的视频发送失败的问题。
  • 修复了 placeholderLabel 默认内容无法隐藏的问题。

5.7.2 Stable​

发布日期：2024/10/23

优化功能：

  • 增加了是否开启同步空置顶会话的功能。
  • 优化了退出会话时草稿缓存的逻辑。

问题修复

  • 修复了发送媒体消息 pushcontent 无法赋值的问题。
  • 关闭了 bitcode 和解决了 iOS 18 兼容性问题。
  • 修复了获取远端消息无失败回调的问题。

5.7.0 Stable​

发布日期：2024/05/23

优化功能：

  • 优化了初始化接口偶现调用卡顿的问题。
  • 优化了引用消息中文件名称过长时的显示方式。
  • 优化了预览位置消息时位置锚点的显示速度。
  • 增加了一个会话消息删除失败的弹窗提示。当用户在没有网络连接的情况下尝试删除会话消息时，系统会弹出此弹窗，告知用户删除操作失败。
  • 优化了合并转发消息的内容显示格式。
  • 优化了会话列表断网的文字提示。

问题修复：

  • 修复了引用消息原文件已下载，但点击引用处的文件依然显示开始下载的问题。

5.5.X 系列是基于 5.4.8 Dev 版本推出的稳定版本。

5.5.4 Stable​

发布日期：2024/03/20

优化功能：

  • 优化媒本消息内部处理逻辑

5.5.3 Stable​

发布日期：2024/02/29

优化功能：

问题修复：

  • 修复 RongLocationlib NSMutableArray *delegateArray 内存泄漏
  • 修复 IMKit 录入小视频后会内存泄露的问题。
  • 修复调用 AVAudioSession 的 setCategory 与第三方冲突，导致录制语音消息失败的问题。

5.5.2 Stable​

发布日期：2023/12/08

优化功能：

  • 消息推送属性（RCMessagePushConfig）中的 RCAndroidConfig 增加荣耀推送配置。
  • 补全初始化配置 RCInitOption 中区域码（AreaCode）枚举值。
  • 优化 SDK 连接逻辑。

问题修复：

  • 修复接收消息线程阻塞的问题。

5.5.0 Stable​

发布日期：2023/09/08

优化功能：

  • IMKit 优化为在被撤回的消息本地已不存在时，仍然插入小灰条消息。
  • IMLib 移除断线重连后延后 2 秒再自动加入聊天室的行为。
  • 优化 IMKit 单聊、群聊会话页面消息加载速度。
  • 调整 SDK 重连时间间隔为 0.05s, 0.25s, 0.5s, 1s, 2s, 4s, 8s, 16s, 32s。之后每 64s 重试一次。
  • 加固了 IMKit SDK，防止极少数情况下非法字符导致的崩溃问题

问题修复：

  • 修复 IMKit 在录制界面中途关闭屏幕，再恢复录制，导致视频无声音的问题。
  • 修复 IMKit 在引用回复显示用户名时偶现的崩溃问题。
  • 修复 12小时制模式下, 全局免打扰不生效的问题。
  • IMLib 优化删除单个会话所有消息耗时较长的问题
  • 修复 IMKit 选择图片时展示列表时有滚动，相册列表页面空白的问题。
  • 修复 IMKit 合并转发的消息过长（超过 4 行），没有...省略号展示的问题。
  • 修复 IMKit 会话界面启用位置插件，点击位置插件，弹出的视图导致导航栏及状态栏变黑的问题。
  • 修复 IMKit 多选按钮没有刷新出来的问题。
  • 修复 IMKit 选择图片时展示列表时有滚动，相册列表页面空白的问题。
  • 修复 IMKit 件消息发送检查内容错误未返回的问题。
  • 修复阿拉伯语文本内容是左对齐的的错误。
  • 修复 IMKit 会话页面开启动态常用语后，右滑会话页面但不退出该页面，导致页面 UI 混乱的问题
  • 修复未初始化进入会话页面 Crash 的问题
  • 修复用户收取离线的扩展（KV）更新消息不全的问题。

5.3.X 系列是基于 5.3.5 Dev 版本推出的稳定版本。5.3.X 系列稳定版本现已过时，请尽快升级到最新 Stable 版本，或最新 dev 版本。

5.3.7 Stable​

发布日期：2023/07/07

优化功能

  • 弃用 defaultRemoteHistoryMessageCount 和 defaultLocalHistoryMessageCount，使用 defaultMessageCount 设置进入会话页面后下拉刷新从远端获取消息的条数。

问题修复

  • 修复转发消息时因消息扩展的值非字符串类型造成的闪退问题
  • 优化获取指定时间戳前或后消息接口，以实际传入时间戳为准，SDK 内部不做时间戳 +1 或-1 处理
  • 修复用户收取离线的扩展（KV）更新消息不全的问题。
  • 修复 通过 unReadMentionedLabel 自定义字体颜色无效的问题

5.3.6 Stable​

发布日期：2023/05/05

  1. IMLib/IMKit SDK 支持在消息推送属性配置中指定 vivo 推送 category 参数。
  2. IMLib/IMKit SDK 支持在消息推送属性配置中指定华为推送 category 参数。

5.1.9 稳定版是 5.X 系列首个稳定版本。5.1.9 Stable 版本已过时，请尽快升级到最新 Stable 版本，或最新 dev 版本。

5.1.9 Stable​

发布日期：2022/08/22

请尽快升级到最新 Stable 版本，或最新 dev 版本。

新增功能：

  1. 增加获取@未读消息列表接口