跳到主要内容

更新日志（稳定版）

注意

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

设计原则​

Android 平台提供稳定版 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.2 Stable​

发布日期：2026/01/16

问题修复

  • IMLib 修复了少数机型上崩溃捕获时堆栈重复循环的问题。

5.21.1 Stable​

发布日期：2025/10/17

新增功能

  • IMKit 适配 Android 16。

问题修复：

  • IMLib RongHttpDnsUtil 中 DES 加密方式更换为 AES 加密。
  • IMLib 修复消息体非法转为 UnknowMessage 引发的问题。
  • IMLib 修复部分线上空指针的问题。

5.21.0 Stable​

发布日期：2025/9/18

新增功能

  • 适配 Android 16KB page size。
  • 增加了客户端订阅用户在线状态的功能。
  • 更新了荣耀推送。
  • 支持在指定会话中，对指定消息类型的历史消息，按关键字进行搜索。
  • 新增了 IMKit 会话页面消息全部拉取完的回调。
  • 新增了批量获取会话信息的 API。
  • 新增了会话置顶操作是否更新操作时间开关。
  • 新增了聊天室消息排重开关。
  • 新增了用户信息托管功能，支持修改、查询、订阅托管的用户信息。
  • 新增了置顶空会话的开关配置，开发者可以选择是否同步置顶的空会话。
  • 支持心跳间隔时间的配置。
  • JoinChatRoomResponse 返回信息中增加了用户加入聊天室的服务端时间。
  • PushConfig 增加了 HarmonyOS 平台。
  • 在线状态订阅支持 HarmonyOS 平台。
  • 新增了数据库升级状态回调接口 DatabaseUpgradeStatusListener，通过该接口可以监控数据库升级进度。
  • 适配了 Android 15 系统。
  • IMKit 和 IMLib 中的信息托管服务新增群组及成员管理能力。
  • IMKit 和 IMLib 中的信息托管服务新增好友关系管理能力。
  • IMKit 单聊会话正在输入状态显示，支持高清语音消息（RC:HQVCMsg）。
  • IMLib 定向消息支持公众号类型。
  • IMLib 移除图片和视频访问权限。
  • IMLib 适配了跨平台自定义消息的逻辑。
  • 更新了 IMKit 用户信息托管群组功能。
  • 更新了 IMLib 支持多端同步接口支持系统会话。
  • 更新了 IMLib 按会话免打扰级别获取总未读消息数支持系统会话。
  • Message 新增了字段 disableUpdateLastMessage，用于控制是否禁止更新会话最后一条消息。
  • 更新了 SDK 的编译版本及部分第三方库版本。
  • IMKit 支持引用消息存草稿。
  • 新增了 IMLib 设置和获取支持时区的全局免打扰接口。
  • 新增了 IMLib 群组信息变更同步全量群组数据的回调接口。
  • IMLib 第三方厂商推送 SDK 版本升级。
  • IMKit 消息存草稿增加提及 @ 人的功能。
  • IMLib 新增了接收、监听流式消息能力。
  • IMKit 新增了支持流式消息的展示。
  • IMKit、IMLib 信息托管增加了资料审核能力。
  • IMLib 支持 IPv6。
  • IMLib 撤回消息时，支持设置 isDelete、isAdmin、disablePush 属性。
  • IMKit 适配 Android 15。
  • IMKit 流式消息改为 WebView 实现。
  • IMLib 图片消息中增加缩略图的宽（thumWidth）和高（thumHeight）属性。
  • IMLib 消息体非法时统一转为 UnknownMessage。
  • IMLib 优化了文件下载的本地命名格式。
  • IMLib 新增逐条消息已读功能。
  • IMLib 会话列表支持超级群会话。
  • IMLib 新增会话置顶接口（支持 ConversationTopOption 参数）。
  • IMKit 流式消息支持 HTML 格式。
  • IMLib RongCoreClient 新增了带用户 ID 的 connect 接口，方便根据所传用户 ID 对连接相关问题进行排查。
  • 用户级别设置功能 26002 错误码优化。
  • IMLib 新增分页获取未打过标签的会话信息接口。
  • IMLib 去除了由 cleartextTrafficPermitted 属性控制请求协议（HTTPS）。

优化功能

  • 优化了消息撤回功能，现在撤回消息时会同时撤回命令消息中携带的用户信息（UserInfo）和额外信息（extra）。
  • 优化了合并转发消息的内容显示格式。
  • IMKit 和 IMLib 中更新了高德地图版本，高德新版本优化安全合规。
  • 优化了百度 DoH 的使用。
  • 优化了对上传单个文件的大小进行限制，默认单次上传最大为 100 MB。
  • 是否同步置顶空会话的开关默认值改为 false，默认不同步置顶的空会话。
  • 优化了会话列表的排序。
  • 优化了 IMKit 用户托管消息中携带 UserInfo 的展示逻辑。

问题修复

  • 修复了 IMKit 鸿蒙 4.0 系统引用消息的气泡没有固定长度的问题。
  • 修复了 IMKit 退出登录后没有清空上一个账号缓存的用户信息的问题。
  • 修复了 RongCoreClientImpl.connectServer 偶现 ANR 的问题。
  • 修复了引用消息原文件已下载，但点击引用处的文件依然显示开始下载的问题。
  • 修复了同时使用两个不同 token 连接时，偶现第二个 token 连接成功的问题。
  • 修复了获取远端历史消息时，content 为空的问题。
  • 修复了 IM 误判没有网路状态，导致连接挂起的问题。
  • 修复了获取时间差时如果为 0，下次获取真实值需要 60s 的问题。
  • 修复了 StatisticsProcessor 空指针异常的问题。
  • 修复了 FCM 透传消息没有赋值 ChannelId 的问题。
  • 修复了 channelId 为 null 时，创建 NotificationChannel 失败崩溃的问题。
  • 修复了 5.6.10 版本 ConversationListViewModel 内存泄漏的问题。
  • 修复了 SDK 初始化时，偶现日志模块初始化未完成，导致日志打印阻塞造成 ANR 的问题。
  • 修复了 Android FileProvider 存在的漏洞问题。
  • 修复了开启多设备消息同步功能后，多端同步阅读状态消息失败，导致卸载重装或者多端登录无法同步消息未读数的问题。
  • 修复了 IMKit SDK 转发选择联系人界面背景是黑色的问题。
  • 修复了发送图片时，缩略图偶现黑边的问题。
  • 修复了地图搜索信息不全的问题。
  • 修复了 filterSendMessage 空指针问题。
  • 修复了 sendNotification 导致 ANR 的问题。
  • 修复了收到通话信息时，会提示音视频通话已关闭的问题。
  • 修复了聊天室内封禁聊天室成员，解封后客户端断网重连不重新自动加入聊天室的问题。
  • 调整了 IMKit 中申请权限的 requestCode 值，避免和其他第三方库冲突。
  • 修复了 IMKit 如果会话列表只剩一个会话的情况下，删除不掉会话的问题。
  • 修复了 IMKit 上拉刷新不能加载会话列表的问题。
  • 修复了 IMLib 超级群拉取的 RC:RcNtf 消息信息不全的问题。
  • 修复了 IMKit 合并转发消息气泡显示的名称不是原名的问题。
  • 修复了 IMKit 缩略图展示大小问题。
  • 修复了 IMKit Android 15 扩展区域展示问题。
  • 修复了 IMKit 会话页面键盘弹出问题。
  • 修复了 IMLib 多端同步阅读状态影响双端用户的未读数的问题。
  • 修复了 IMLib 通过好友申请再次请求通讯录崩溃的问题。
  • 修复了 IMKit 发送失败的动图长按没有更多功能弹窗的问题。
  • 修复了 IMKit 小米 15 系统手机上会话页键盘显示异常的问题。
  • 修复了 IMKit 聊天文件页中，用户名展示逻辑错误的问题。
  • 修复了 IMLib 群组托管 acceptGroupApplication 回调中 operationTime 字段值错误的问题。
  • 修复了 IMLib setConversationToTop 设置超级群会话置顶时，非默认频道未返回 35055 错误码的问题。
  • 修复了 IMLib token 为空时调用 RongCoreClientImpl.connect 方法空指针问题。
  • 修复了 IMLib setConversationsToTop 接口未限制会话类型的问题。
  • 修复了 IMKit 页面显示的一些问题。
  • 修复了 IMLib 超级群 RecallNotificationMessage 消息 originalMessageContent 解析异常的问题。
  • 修复了 IMLib 消息体中注入了非法文字也能正常解析的问题。
  • 修复了 IMLib 发消息失败 onError 返回的时间戳还是本地时间戳的问题。
  • 修复了 IMLib 上报推送 Token 时偶现崩溃的问题。
  • 修复了 IMLib 撤回消息时本地消息不存在导致无法更新消息内容的问题。
  • 修复了 IMLib 撤回消息携带的 extra 字段返回为空的问题。

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

5.7.11 Stable​

发布日期：2025/9/2

问题修复：

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

5.7.10 Stable​

发布日期：2025/7/22

问题修复：

  • 修复了部分 IMLib 相关问题。

5.7.9 Stable​

发布日期：2025/7/18

优化功能：

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

问题修复：

  • 修复了用户级别设置功能会返回 26002 错误的问题。

5.7.6 Stable​

发布日期：2025/6/16

优化功能：

  • 优化了部分 IMLib 相关问题。

5.7.5 Stable​

发布日期：2025/5/16

优化功能：

  • IMLib 新增了带用户 ID 的连接接口，方便根据所传用户 ID 对连接相关问题进行排查。

    Java
    public static RongCoreClient connect(
                final String token,
                final int timeLimit,
                final String userId,
                final IRongCoreCallback.ConnectCallback connectCallback)

问题修复：

  • 遴选近期消息断档 bugfix。

5.7.4 Stable​

发布日期：2025/4/24

优化功能：

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

5.7.3 Stable​

发布日期：2025/02/06

问题修复：

  • 修复了在 Android 9 系统上，点击小视频时仅提示申请麦克风权限的问题。
  • 修复了 IMKit 中，当会话列表仅剩一个会话时，删除操作异常的问题。
  • 修复了会话列表上拉加载后，收到新会话消息时，仅展示最新一条会话的问题。
  • 修复了单聊中最后一条消息为小灰条消息时，会话列表未更新已读状态的问题。
  • 修复了调用 registerPush 方法时导致崩溃的问题。

5.7.2 Stable​

发布日期：2024/10/23

优化功能：

  • 适配了 Android 15。
  • 将声明和请求 READ_MEDIA_IMAGES 和 READ_MEDIA_VIDEO 权限的逻辑从 IMLib 移到 IMKit。如果您仅使用imlib，且需要用到 READ_MEDIA_IMAGES 和 READ_MEDIA_VIDEO 权限，请在您的APP中添加相应逻辑。
  • 支持从相册中选取部分图片和视频。

问题修复：

  • 修复了调用 switchappkey 崩溃的问题。
  • 修复了修复图库内存泄漏的问题。
  • 修复了地图搜索信息不全的问题。
  • 修复了极端情况下录制小视频发送无法正常显示的问题。
  • 修复了会话页图片缩略图有细微黑边的问题。

5.7.1 Stable​

发布日期：2024/06/20

优化功能：

  • 优化了 SDK 的数据处理性能。

5.7.0 Stable​

发布日期：2024/05/23

优化功能：

  • 小米海外的推送模块停止发布。
  • 更新了荣耀推送。
  • 更新了高德地图的版本，不再支持 x86 架构。

问题修复：

  • 修复了获取本地时间与服务器时间的差值如果为 0，下次获取真实值需要 60s 的问题。
  • 修复了 FCM 透传消息没有赋值 ChannelId 的问题。
  • 修复了相册预览页面中提示语的错误。
  • 增加了图库 gif 图过大提示语，告知用户无法发送过大的 gif 文件。
  • 增加了一个会话消息删除失败的弹窗提示。当用户在没有网络连接的情况下尝试删除会话消息时，系统会弹出此弹窗，告知用户删除操作失败。
  • 修复了键盘输入消息后，点击文字语音切换按钮，右边没有显示更多选择按钮的问题。
  • 修复了断开网络后，会话聊天页面显示空的问题。

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

5.5.3 Stable​

发布日期：2024/02/29

优化功能：

  • 推送功能依赖的 vivo 推送 SDK 从 3.0.0.4 升至 3.0.0.7。如果使用推送（旧版）集成方案，请注意同时升级 vivo 推送 SDK。官网下载包内附带的 vivo 推送 SDK 已更新。
  • 推送功能依赖的 OPPO 推送 SDK 从 3.1.0 升至 3.4.0。如果使用推送（旧版）集成方案，请注意同时升级 OPPO 推送 SDK。官网下载包内附带的 OPPO 推送 SDK 已更新。

问题修复：

  • 修复会话页面内存泄漏的问题。
  • 修复极端情况下，多线程导致的频繁回调 SUSPEND 连接状态的问题。
  • 修复重复创建 NaviObserver 导致 SDK 重连多次的问题。

5.5.2 Stable​

发布日期：2023/12/08

优化功能：

  • 消息推送属性（MessagePushConfig）中的 AndroidConfig 增加荣耀推送配置。
  • 补全初始化配置 InitOption 中区域码（AreaCode）枚举值。

问题修复：

  • 修复在部分机型上点击 FCM 透传方式推送通知后，通知未自动取消的问题。
  • 修复 getConversationList 无回调，多进程情况下线程被阻塞问题。

5.5.1 Stable​

发布日期：2023/10/20

问题修复：

  • 修复数据库加密的问题。

5.5.0 Stable​

发布日期：2023/09/08

优化功能：

  • 支持的 Android 最低版本提升为 5.0，要求 minSdkVersion 最低为 21。

问题修复：

  • 修复 IMKit 会话列表的下拉加载框经常出现一直转无法关闭的情况。
  • 修复 IMLib 在处于后台一段时间再回前台偶先连接不上的问题。

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

5.3.8 Stable​

发布日期：2023/07/07

问题修复

  • 优化获取指定时间戳前或后消息接口，以实际传入时间戳为准，SDK 内部不做时间戳 +1 或-1 处理
  • 修复 getConversationList 无回调，多进程情况下线程被阻塞问题
  • 修复会话草稿在杀掉 App 进程后再启动的情况下后未恢复的问题
  • 修复会话中存在草稿的情况下杀死 App 后重新进入应用，该条会话用户信息为空的问题
  • 修复通过通讯录选择好友发消息后，返回消息列表，刚发的消息变成了草稿的问题

5.3.7 Stable​

发布日期：2023/07/07

5.3.7 Stable 版本号已废弃，请勿使用。

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

新增功能：

  1. 适配 Android 12
  2. 增加获取@未读消息列表接口