跳到主要内容

更新日志（稳定版）

注意

仅 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.7.x 系列是基于 5.8.0 Dev 版本推出的稳定版本

5.7.10 Stable​

发布日期：2025/7/22

问题修复：

  • 修复了 x86 和 ARMv7 架构下部分第三方库未适配 16KB page size 的问题。

5.7.9 Stable​

发布日期：2025/7/18

优化功能：

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

问题修复：

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

5.7.6 Stable​

发布日期：2025/6/16

优化功能：

  • 适配了 16 KB page sizes。

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，新增支持 Page Size 16K。
  • 将声明和请求 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. 增加获取@未读消息列表接口
最后于 更新