更新日志(开发版)
注意
仅 Android/iOS 平台的 IM SDK 存在开发版、稳定版 区分。开发版(Dev)SDK 首推新功能,同时会得到最快的 bug 修复。
5.18.0 Dev
发布日期:2025/05/08
新增功能
- IMKit 适配 Android 15。
- IMKit 流式消息改为 WebView 实现。
- IMLib 图片消息中增加缩略图的宽 (thumWidth) 和高 (thumHeight) 属性。
- IMLib 消息体非法时统一转为 UnknownMessage。
- IMLib 优化了文件下载的本地命名格式。
问题修复
- IMLib 修复了通过好友申请再次请求通讯录崩溃的问题。
- IMKit 修复了发送失败的动图长按没有更多功能弹窗的问题。
- IMKit 修复了小米 15 系统手机上会话页键盘显示异常的问题。
- IMKit 修复了聊天文件页中,用户名展示逻辑错误的问题。
5.16.1 Dev
发布日期:2025/04/10
问题修复
- 修复了 IMLib 多端同步阅读状态影响双端用户的未读数的问题。
5.16.0 Dev
发布日期:2025/03/28
新增功能
- IMLib 新增了接收、监听流式消息能力。
- IMKit 新增了支持流式消息的展示。
- IMKit、IMLib 信息托管增加了资料审核能力。
- IMLib 支持 IPv6。
- IMLib 撤回消息时,支持设置
isDelete
、isAdmin
、disablePush
属 性。
问题修复
- 修复了 IMKit Android 15 扩展区域展示问题。
- 修复了 IMKit 会话页面键盘弹出问题。
5.14.0 Dev
发布日期:2025/02/28
新增功能
- 新增了 IMLib 设置和获取支持时区的全局免打扰接口。
- 新增了 IMLib 群组信息变更同步全量群组数据的回调接口。
- IMLib 第三方厂商推送 SDK 版本升级。
- IMKit 消息存草稿增加提及 @ 人的功能。
问题修复
- 优化了 IMKit 优化用户托管消息中携带
UserInfo
的展示逻辑。 - 修复了 IMKit 合并转发消息气泡显示的名称不是原名。
- 修复了 IMKit 缩略图展示大小问题。
5.12.3 Dev
发布日期:2025/01/17
新增功能
- IMKit 支持引用消息存草稿。
5.12.2 Dev
发布日期:2024/12/26
新增功能
- 更新了 IMKit 用户信息托管群组功能。
- 更新了 IMLib 支持多端同步接口支持系统会话。
- 更新了 IMLib 按会话免打扰级别获取总未读消息数支持系统会话。
- Message 新增了字段 disableUpdateLastMessage 是否禁止更新会话最后一条消息。
- 更新了 SDK 的编译版本及部分三方库版本。
问题修 复
- 修复了聊天室内封禁聊天室成员,解封后客户端断网重连不重新自动加入聊天室的问题。
- 调整了 IMKit 中申请权限的requestCode值,避免和其他三方库冲突。
- 修复了 IMKit 如果会话列表只剩一个会话的情况 ,删除不掉会话的问题。
- 修复了 IMkit 上拉刷新不能加载会话列表的问题。
5.12.1 Dev
发布日期:2024/10/28
新增功能
- 适配了跨平台自定义消息的逻辑。
5.12.0 Dev
发布日期:2024/10/18
新增功能
- IMKit 和 IMLib 中的信息托管服务新增群组及成员管理能力。
- IMKit 和 IMLib 中的信息托管服务新增好友关系管理能力。
- IMKit 单聊会话正在输入状态显示,支持高清语音消息(
RC:HQVCMsg
) 。 - IMLib 定向消息支持公众号类型。
- IMLib 移除图片和视频访问权限。
问题修复
- 修复了地图搜索信息不全的问题。
- 修复了
filterSendMessage
空指针问题。 - 修复了
sendNotification
导致ANR
的问题。 - 修复了收到通话信息,会提示音视频通话已关闭的问题。
5.10.4 Dev
发布日期:2024/08/29
新增功能
- 新增了 数据库升级状态回调接口
DatabaseUpgradeStatusListener
,通过该接口可以监控数据库升级进度。 - 适配了 Android 15 系统。
问题修复
- 优化了会话列表的排序。
5.10.3 Dev
发布日期:2024/08/20
问题修复
- 修复了 5.10.2 版本中的一些问题,建议将项目依赖从 5.10.2 升级至 5.10.3。
5.10.2 Dev
发布日期:2024/07/31
新增功能
JoinChatRoomResponse
返回信息中增加了用户加入聊天室的服务端时间。PushConfig
增加了 HarmonyOS 平台。- 在线状态订阅支持
HarmonyOS
平台。 - 对上传单个文件的大小进行限制,默认单次上传最大为 100M。
问题修复
- 修复了发送图片时,缩略图偶现黑边的问题。
5.10.1 Dev
发布日期:2024/07/02
问题修复
- 是否同步置顶空会话的开关默认值改为 NO,默认不同步置顶的空会话。
5.10.0 Dev
发布日期:2024/06/28
新增功能
- 新增了用户 信息托管功能,支持修改、查询、订阅托管的用户信息。
- 新增了一个置顶空会话的开关配置,开发者可以选择是否同步置顶的空会话。
- 支持了心跳间隔时间的配置。
- 优化了百度 DoH 的使用
问题修复
- 修复了安卓 FileProvider 存在的漏洞问题。
- 修复了开启多设备消息同步功能后,多端同步阅读状态消息失败,导致卸载重装或者多端登录无法同步消息未读数的问题。
- 修复了 IMKit SDK 转发选择联系人界面背景是黑色的问题。
5.8.2 Dev
发布日期:2024/06/05
新增功能
- 新增了 IMKit 会话页面消息全部拉取完的回调。
- 新增了批量获取会话信息的 API。
- 新增了会话置顶操作是否更新操作时间开关。
- 新增了聊天室消息排重开关。
优化功能
- 优化了合并转发消息的内容显示格式。
- IMKit 和 IMLib 中更新了高德地图版本,高德新版本优化安全合规。
问题修复
- 修复了引用消息原文件已下载,但点击引用处的文件依然显示开始下载的问题。
- 修复了同时使用两个不同 token 连接,偶现 第二个 token 连接成功。
- 修复了 获取远端历史消息,content 为空的问题。
- 修复了 IM 误判没有网路状态,导致连接挂起的问题。
5.8.1 Dev
发布日期:2024/04/29
新增功能
- 增加了客户端订阅用户在线状态的功能。
- IMKit 和 IMLib 中更新了高德地图版本,不再支持 x86 架构。
- 更新了荣耀推送。
- 支持了在指定会话中,对指定消息类型的历史消息,按关键字进行搜索的功能。
优化功能
- 优化了消息撤回功能,现在撤回消息时会同时撤回命令消息中携带的用户信息(
UserInfo
)和额外信息(extra
)。
问题修复
- 修复了获取时间差时如果为0,下次获取真实值需要60s的问题。
- 修复了
StatisticsProcessor
空指针异常的问题。 - 修复了 FCM 透传消息没有赋值
ChannelId
的问题。 - 修复了 channelId 为 null 时,创建
NotificationChannel
失败崩溃的问题。 - 修复了 5.6.10 版本
ConversationListViewModel
内存泄漏的问题。
5.8.0 Dev
发布日期:2024/03/29
新增功能
- 支持获取定向消息的目标用户列表。此功能仅适用于普通群和超级群消息。
- 新增了错误码 34296,针对发送定向消息,当会话类型不是群聊、超级群,且定向消息目标用户列表为空时,返回此错误。
- 新增了协议栈的数据错误码。
优化功能
- 支持配置上报 token 的优先级。
问题修复
- 修复了 IMKit 鸿蒙 4.0 系统引用消息的气泡没有固定长度的问题。
- 修复了 IMKit 退出登录后没有清空上一个账号缓存的用户信息的问题。
- 修复了
RongCoreClientImpl.connectServer
偶现 ANR 的问题。
5.6.10 Dev
发布日期:2024/01/31
问题修复
- 修复了 5.6.8/5.6.9 版本存在的设计缺陷。
5.6.9 Dev
发布日期:2024/01/31
警告
该版本 SDK 已被召回,请勿使用。如已使用,建议尽快升级至 5.6.10 版本。
新增功能:
- 超级群支持发送定向消息,可给指定频道中的指定用户发送消息,频道中其他用户不会收到该条消息。
- 超级群支持同时从本地和远端删除用户的历史消息。
优化功能:
- 设置会话置顶后,如果本地会话列表中不存在该会话(尚未创建或已被删除),SDK 会自动创建该会话,并将其置顶。
- 获取会话列表时,支持通过参数指定返回结果忽略置顶状态,严格按照时间排序返回会话列表。
问题修复
- 修复部分机型上设置重连互踢策略(
setReconnectKickEnable
)后不生效的问题。
5.6.8 Dev
发布日期:2023/12/29
警告
该版本 SDK 已被召回,请勿使用。如已使用,建议尽快升级至 5.6.10 版本。
优化功能:
- 支持小米海外推送服务,需要集成小米国际版推送客户端。
- 推送功能依赖的 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 已更新。
- 优化接收消息的状态处理。接收消息后,无论是否已被同时在线或之前登录的其他设备接收。只要其他设备先收到该消息,该状态值都会变为已接收。如果在其他设备已被阅读,同时还会变为已阅读。
- 会话(
Conversation
)新增操作时间(operationTime
)属性,可在分页获取会话列表时作为传入的时间戳。
问题修复
- 修复主动调用断开连接方法后,
ConnectionStatusListener
会重复触发SIGN_OUT
状态回调的问题。
5.6.7 Dev
发布日期:2023/11/23
新增功能:
- 支持集成荣耀推送,消息推送属性中新增荣耀推送配置参数。
- 消息推送属性中新增 iOS Time Sensitive 时效性配置。
- IMLib 聊天室成员变更功能支持返回当前聊天室人数。
- IMLib 支持新的自定义消息流程。
- IMKit 支持复制引用消息中的被引用内容。
问题修复:
- 修复
CSConversationUIRenderer
空指针的问题。 - 修复
TextMessage
的content
内容为空时,发出的消息缺少content
字段的问题。
5.6.6 Dev
发布日期:2023/10/27
优化功能:
- 优化 SDK 日志上传机制。
问题修复:
- 修复 SDK 内部问题。
5.6.5 Dev
发布日期:2023/10/12
优化功能:
- 优化 SDK 内部日志。
问题修复:
- 修复 5.6.4 版本注册自定义消息失效的问题。
5.6.4 Dev
发布日期:2023/09/25
新增功能:
- 超级群业务可以使用
ChannelClient
下的getRemoteHistoryMessages
方法获取远端历史消息。 - 超级群业务支持使用
getUltraGroupMessageCountByTimeRange
统计本地历史消息数量。 - IMKit 本地通知默认 category 类型设置为
CATEGORY_MESSAGE
。
优化功能:
- 获取本地指定标签下的会话(
getConversationsFromTagByPage
)返回的Conversation
新增isTopForTag
属性,用于标识会话在当前标签下是否已置顶。 - 安全性改进。
问题修复:
- 修复 IMLib 无法连接的问题。
- 修复 IMKit
ConversationListViewModel
内存泄露的问题。 - 修复 IMKit
MessageViewModel.onScrolled
数组越界崩溃的问题。 - 修复
UniqueIdUtils.getUniqueId
崩溃的问题。 - 修复 IMKit 会话列表页面加载问题。
5.6.3 Dev
发布日期:2023/08/31
新增功能:
- IMLib 加入聊天室可返回聊天室当前状态(是否禁言、是否在禁言白名单中、聊天室人数等)信息。聊天室房间事件监听器中新增对应的回调方法。
- IMKit 提供
ToastUtils
类,支持统一拦截 Toast 消息框。 - IMKit 会话页面支持拦截点击常用语按钮的事件。
优化功能:
- IMKit 会话页面的长按删除消息功能改为默认同步删除远端历史消息。
- 支持的 Android 最低版本提升为 5.0,要求
minSdkVersion
最低为 21。
问题修复:
- 修复 IMKit 图片选择页面(PictureSelectorActivity)申请权限没有提供给用户回调的问题。
- 修复 IMKit 点击输入区域扩展面板图片入口后,错误弹出权限提示的问题。
- 修复 IMKit 媒体消息中的视频文件地址中存在特殊字符导致播放视频消息黑屏的问题。
- 修复 IMKit 字体太大导致语音消息倒计时在 UI 上显示不全的问题。
- 修复 IMKit 跳转到指定消息定位不准确的问题。
- 修复 IMKit 中
VideoSlimEncoder
的视频压缩错误的问题。 - 修复 PushDeliveryUpload 相关的 ANR 问题。
5.6.2 Dev
发布日期:2023/08/11
新增功能:
- IMKit/IMLib 支持多端同步系统会话阅读状态,新增错误码 20109。
- IMLib 超级群支持搜索本地数据库中指定用户 ID 发送的消息,支持通过关键词搜索所有频道的消息。
- IMKit 适配 Android 14 新增的照片和视频权限
< uses-permission android:name = "android.permission.READ_MEDIA_VISUAL_USER_SELECTED" />
。
优化功能:
- 优化小米推送 SDK 注册失效,无法获取Token 的情况。增加一次重试获取 Token。
- 调整 SDK 重连时间间隔为 0.05s, 0.25s, 0.5s, 1s, 2s, 4s, 8s, 16s, 32s。之后每 64s 重试一次。
问题修复:
- 修复 IMKit 会话列表的下拉加载框经常出现一直转无法关闭的情况。
- 修复 IMKit 聚合会话未读数不准确的问题
- 修复 IMKit
PicturePagerActivity#java.lang.IllegalStateException: Cannot obtain size for recycled Bitmap
问题。
5.6.1 Dev
发布日期:2023/07/14
优化功能:
- 支持在融云的
libc++_shared.so
不满足项目要求时剔除融云 SDK 中的libc++_shared.so
。详见知识库文档 Libc++_shared.so 标准库常见问题处理方案。 - 优化 IMKit 单聊、群聊会话页面消息加载速度。
问题修复:
- 修复在华为 9.0 系统中偶现单聊发送位置消息崩溃的问题
- 修复内存泄漏的问题。
- 修复 IMKit 初始化
InitOption
配置海外区域码无效的问题。 - 修复调用
startConversation
且fixedMsgSentTime
为首条消息的时间导致会话 页面空白的问题。 - 修复 5.4.6 版本开始收不到不落地通知的问题。
5.6.0 Dev
发布日期:2023/07/03
新增功能:
- 融云 Push 2.0 推送集成方案将第三方厂商推送通道的 SDK 封装成插件,方便开发者快速集成与配置,适用于 IMLib、IMKit 或其他依赖 IMLib 的融云 Android 客户端 SDK。
- 超级群业务中,获取未读 @ 消息的摘要信息
getUltraGroupUnreadMentionedDigests
接口返回的MessageDigestInfo
中新增消息类型标识,可用于筛选数据。
问题修复:
- 修复推送注册死循环问题
- 修复拉取超过 7 天未更新的会话,会话列表最后一条消息显示 null 的问题。
- 修复
getBlacklist
方法在没有黑名单用户时超时的问题。 - 修复多线程操作 LinkedList 集合导致的空指针异常。
- 修复
getConversationList
无回调,多进程情况下线程被阻塞问题。
5.4.7 Dev
发布日期:2023/06/20
问题修复:
- 修复超级群业务的回调方法
onUltraGroupMessageExpansionUpdated
返回的RCMessage
的消息 ID 为 -1 的问题。
5.4.6 Dev
发布日期:2023/06/15
新增功能:
- 新增批量获取当前用户的超级群的未读消息数接口
getUltraGroupConversationUnreadInfoList
一次获取最多 20 个超级群下所有频道的未读数据。
问题修复:
- 修复合并转发消息内邮箱地址不会识别的问题
- 修复 5.4.0 及之后版本上设置消息排重接口
setCheckDuplicateMessage
不生效的问题 - 修复 卸载重装第一次启动,
getConversationListByPage
会延迟5秒才加载的问题 - 修复 MessageViewModel 内存泄漏问题
- 修复调用超级群修改消息内容接口
ModifyUltraGroupMessage
后未更新搜索索引的问题
优化功能:
- 优化后台切换回前台时重连耗时长的问题
- 优化获取指定时间戳前或后消息接口,以实际传入时间戳为准,SDK 内部不做时间戳 +1 或-1 处理
5.4.5 Dev
发布日期:2023/05/29
新增功能:
- 新增聊天室事件通知监听器
ChatRoomNotifyEventListener
,支持在聊天室中执行成员封禁、禁言等操作时接收通知(封禁、禁言时需要指定needNotify
为true
),支持在用户多端加入/退出接收通知。 - 获取超级群获取频道列表时,支持通过
conversation
对象获取 @我 的未读消息数。 - 超级群获取本地历史消息功能支持获取会话中指定时间戳前后、指定数量的消息。
问题修复:
- 修复超级群未读消息数的问题。当前用户在连接状态下,超级群中有人撤回消息时(包括普通消息和 @消息),如消息在当前用户端为未读状态,未读消息及未读 @消息数没 有修改。问题修复后,会对未读消息数做 -1 处理。
- 修复超级群撤回消息小灰条提示重复的问题。超级群中撤回一条消息后,如本地没有找到原始消息,会插入小灰条消息。在特定情况下,可能出现小灰条消息重复的问题。问题修复后,小灰条消息会携带原始消息 ID,以进行排重。
- 修复 IMKit SDK 初始化时传入空
initOption
导致 SDK 崩溃的问题。 - 修复 获取远端历史消息的结果中小视频消息缩略图都相同的问题。
- 修复 IMKit SDK 在特定手机上聊天中选择图片 > 拍照后,按钮没反应的问题
- 修复
getActiveNetworkInfo
ANR 问题 - 修复 会话列表点击事件越界崩溃的问题
- 修复 ipc 进程偶现的连接回调丢失的问题
5.4.4 Dev
发布日期:2023/05/11
新增功能:
- 超级群业务新增获取本地超级群消息的方法
getHistoryMessages
。 - 发送媒体消息方法
sendMediaMessage
接口支持 VoIP 配置。
优化功能:
Message
中增加是否为离线消息字段(isOffline
),对齐 iOS 端。仅在接收消息的回调中有效。
5.4.3 Dev
发布日期:2023/04/21
问题修复:
- 紧急修复 5.4.2 版本中与导航服务地址相关的问题。