Skip to main content

Release Notes (Stable Version)

Note

Only the IM SDK for Android/iOS platforms has development and stable version distinctions.

Design Principles​

The Android platform provides stable versions of IMLib SDK and IMKit.

  • The stable version of the SDK meets certain metrics in terms of online runtime duration, stability, and usage volume.
  • Emphasizes stability over introducing new features.

Release Cycle and Version Number Rules​

The IM SDK version numbering rules differ before and after version 5.4.X. Post 5.4.X versions make it easier to distinguish between development and stable versions.

  • Starting from version 5.4.X and later, Stable versions occupy the second digit of the version number. Even second digits indicate development versions, while odd second digits indicate stable versions. For example, 5.5.X is the version number used for stable SDK versions.
  • Before 5.4.X, the stable version numbering rules were not fixed.
  • RC monitors the usage of Stable versions by customers and regularly updates stable versions, with a maximum update cycle of two months.

Maintenance Instructions​

  1. If RC releases a new Stable version under the actively developed major version number (currently 5.X), we recommend customers using Stable versions to upgrade to the new Stable version. After the release of a new Stable version, maintenance efforts for historical stable versions will be reduced accordingly.
  2. For historical major versions (2.X, 4.X) of the SDK that are no longer actively developed, RC maintains only one Stable version. Customers still using 2.X or 4.X versions are advised to upgrade to the corresponding Stable version as soon as possible, or consider upgrading to the 5.X series SDK.

The 5.21.x series is a stable version based on the 5.20.0 Dev version

5.21.1 Stable​

Release Date: 2025/10/17

New Features

  • IMKit adds support for Android 16.

Bug Fixes:

  • IMLib replaces DES encryption with AES encryption in RongHttpDnsUtil.
  • IMLib fixes an issue where illegal message bodies were converted to UnknowMessage.
  • IMLib fixes some online null pointer issues.

5.21.0 Stable​

Release Date: 2025/9/18

New Features

  • Adds support for Android 16KB page size.
  • Adds client-side functionality to subscribe to user online status.
  • Updates Honor push notifications.
  • Supports keyword-based search for historical messages of specified types in designated conversations.
  • Adds a callback in IMKit when all messages in a conversation page are loaded.
  • Adds APIs for batch retrieval of conversation information.
  • Adds a switch to control whether pinning a conversation updates the operation time.
  • Adds a switch for chatroom message deduplication.
  • Adds user profile hosting functionality, supporting modification, query, and subscription of hosted user information.
  • Adds a configuration switch for pinning empty conversations, allowing developers to choose whether to synchronize pinned empty conversations.
  • Supports configuration of heartbeat interval time.
  • Adds server-side timestamp when users join chatrooms in the JoinChatRoomResponse return information.
  • Adds HarmonyOS platform to PushConfig.
  • Online status subscription supports the HarmonyOS platform.
  • Adds a database upgrade status callback interface DatabaseUpgradeStatusListener to monitor database upgrade progress.
  • Adds support for Android 15 system.
  • IMKit and IMLib's profile hosting service adds group and member management capabilities.
  • IMKit and IMLib's profile hosting service adds friend relationship management capabilities.
  • IMKit one-to-one chat shows typing status and supports high-definition voice messages (RC:HQVCMsg).
  • IMLib targeted messages support Official Account type.
  • IMLib removes image and video access permissions.
  • IMLib adapts cross-platform custom message logic.
  • Updates IMKit user profile hosting group functionality.
  • Updates IMLib multi-device synchronization interface to support system conversations.
  • Updates IMLib to support retrieving total unread message count by conversation Do Not Disturb level for system conversations.
  • Message adds a disableUpdateLastMessage field to control whether updating the last message in a conversation is prohibited.
  • Updates SDK compilation version and some third-party library versions.
  • IMKit supports saving draft messages with quoted messages.
  • Adds IMLib interfaces for setting and getting global Do Not Disturb with timezone support.
  • Adds IMLib callback interface for synchronizing full group data when group information changes.
  • Upgrades third-party vendor push SDK versions in IMLib.
  • IMKit adds mention (@) functionality when saving message drafts.
  • IMLib adds capability to receive and listen to streaming messages.
  • IMKit adds support for displaying streaming messages.
  • IMKit and IMLib profile hosting adds content moderation capability.
  • IMLib supports IPv6.
  • IMLib supports setting isDelete, isAdmin, and disablePush properties when recalling messages.
  • IMKit adapts to Android 15.
  • IMKit changes streaming message implementation to WebView.
  • IMLib adds thumbnail width (thumWidth) and height (thumHeight) properties to image messages.
  • IMLib uniformly converts illegal message bodies to UnknownMessage.
  • IMLib optimizes local naming format for file downloads.
  • IMLib adds per-message read functionality (Message Read V5).
  • IMLib conversation list supports ultra group conversations.
  • IMLib adds conversation pinning interface (supports ConversationTopOption parameter).
  • IMKit streaming messages support HTML format.
  • IMLib RongCoreClient adds a connect interface with user ID for troubleshooting connection-related issues.
  • Optimizes error code 26002 for user-level settings functionality.
  • IMLib adds paginated interface to retrieve untagged conversation information.
  • IMLib removes control of request protocol (HTTPS) by cleartextTrafficPermitted property.

Optimizations

  • Optimizes message recall functionality - now recalling a message also recalls the user information (UserInfo) and extra information (extra) carried in command messages.
  • Optimizes content display format for merged forwarded messages.
  • Updates Amap version in IMKit and IMLib, with new version optimizing security compliance.
  • Optimizes usage of Baidu DoH.
  • Optimizes single file upload size limit, defaulting to 100MB maximum per upload.
  • Changes default value of the switch for synchronizing pinned empty conversations to false (default is not to synchronize).
  • Optimizes conversation list sorting.
  • Optimizes display logic for UserInfo in IMKit user-hosted messages.

Bug Fixes

  • Fixes issue where IMKit on HarmonyOS 4.0 didn't fix the length of quoted message bubbles.
  • Fixes issue where IMKit didn't clear cached user information from previous accounts after logout.
  • Fixes occasional ANR in RongCoreClientImpl.connectServer.
  • Fixes issue where clicking on files in quoted messages showed "start download" even when the original file was already downloaded.
  • Fixes occasional issue where the second token would connect successfully when using two different tokens simultaneously.
  • Fixes issue where content was empty when retrieving remote history messages.
  • Fixes IM incorrectly judging no network status, causing connection hangs.
  • Fixes issue where if time difference was 0, it took 60s to get the real value next time.
  • Fixes null pointer exception in StatisticsProcessor.
  • Fixes FCM transparent messages not assigning ChannelId.
  • Fixes crash when creating NotificationChannel with null channelId.
  • Fixes memory leak in ConversationListViewModel in version 5.6.10.
  • Fixes occasional ANR caused by log module initialization not completing during SDK initialization.
  • Fixes vulnerability in Android FileProvider.
  • Fixes issue where enabling multi-device message synchronization caused multi-device read status synchronization failure, leading to inability to synchronize unread counts after reinstallation or multi-device login.
  • Fixes black background issue in IMKit SDK's forward contact selection interface.
  • Fixes occasional black borders in thumbnails when sending images.
  • Fixes incomplete map search information.
  • Fixes null pointer in filterSendMessage.
  • Fixes ANR caused by sendNotification.
  • Fixes issue where receiving call information would prompt that audio/video calls were closed.
  • Fixes issue where banned chatroom members wouldn't automatically rejoin after unban when client reconnected after network disconnection.
  • Adjusts requestCode value for permission requests in IMKit to avoid conflicts with other third-party libraries.
  • Fixes issue where IMKit couldn't delete conversations when only one conversation remained in the list.
  • Fixes issue where IMKit pull-to-refresh couldn't load conversation list.
  • Fixes incomplete RC:RcNtf message information in IMLib ultra groups.
  • Fixes issue where merged forwarded message bubbles in IMKit didn't show original names.
  • Fixes thumbnail display size issues in IMKit.
  • Fixes extended area display issues in IMKit on Android 15.
  • Fixes keyboard popup issues in IMKit conversation pages.
  • Fixes issue where IMLib multi-device read status synchronization affected unread counts for dual-end users.
  • Fixes crash when requesting contacts again after accepting friend requests in IMLib.
  • Fixes issue where long-pressing failed-to-send GIFs in IMKit didn't show more function popups.
  • Fixes abnormal keyboard display on Xiaomi 15 phones in IMKit conversation pages.
  • Fixes incorrect username display logic in IMKit chat file pages.
  • Fixes incorrect operationTime field value in IMLib group hosting acceptGroupApplication callback.
  • Fixes issue where IMLib setConversationToTop didn't return error code 35055 when pinning non-default channels in ultra group conversations.
  • Fixes null pointer when calling RongCoreClientImpl.connect with empty token in IMLib.
  • Fixes IMLib setConversationsToTop interface not restricting conversation types.
  • Fixes some display issues in IMKit pages.
  • Fixes abnormal parsing of originalMessageContent in IMLib ultra group RecallNotificationMessage.
  • Fixes issue where IMLib could normally parse message bodies containing illegal text.
  • Fixes issue where onError for failed message sending in IMLib still returned local timestamps.
  • Fixes occasional crash when IMLib reports push tokens.
  • Fixes issue where IMLib couldn't update message content when recalling messages if local messages didn't exist.
  • Fixes issue where extra field was empty in IMLib recalled messages.

The 5.7.x series is a stable version based on the 5.8.0 Dev version

5.7.11 Stable​

Release Date: 2025/9/2

Bug Fixes:

  • IMLib fixes issue where message retrieval interface increased downstream messages.

5.7.10 Stable​

Release Date: 2025/7/22

Bug Fixes:

  • Fixes some IMLib-related issues.

5.7.9 Stable​

Release Date: 2025/7/18

Optimizations:

  • IMLib adds user-level configuration synchronization completion callback.
  • IMLib adds interface to retrieve untagged conversation list.
  • IMLib adds conversation status synchronization completion callback.

Bug Fixes:

  • Fixes issue where user-level settings functionality would return error code 26002.

5.7.6 Stable​

Release Date: 2025/6/16

Optimizations:

  • Optimized some IMLib-related issues.

5.7.5 Stable​

Release Date: 2025/5/16

Optimizations:

  • IMLib added a connection interface with user ID parameter to facilitate troubleshooting connection issues based on the provided user ID.

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

Bug Fixes:

  • Fixed message gap selection issue.

5.7.4 Stable​

Release Date: 2025/4/24

Optimizations:

  • Added chatroom KV callback interface that supports retrieving callbacks in KV setting order.

5.7.3 Stable​

Release Date: 2025/02/06

Bug Fixes:

  • Fixed an issue on Android 9 where only microphone permission request was prompted when clicking short videos.

  • Fixed an issue in IMKit where deleting operation would fail when only one conversation remained in the conversation list.

  • Fixed an issue where only the latest conversation message would display when receiving new messages after pull-to-load in conversation list.

  • Fixed an issue where the conversation list wouldn't update read status when the last message in one-to-one chat was a gray bar message.

  • Fixed a crash issue when calling the registerPush method.

5.7.2 Stable​

Release Date: 2024/10/23

Optimizations:

  • Adapted to Android 15.

  • Moved the declaration and request logic for READ_MEDIA_IMAGES and READ_MEDIA_VIDEO permissions from IMLib to IMKit. If you only use IMLib and require these permissions, please add the corresponding logic in your app.

  • Added support for selecting partial images and videos from the gallery.

Bug Fixes:

  • Fixed a crash issue when calling switchappkey.

  • Fixed memory leaks in the gallery.

  • Fixed incomplete information in map search.

  • Fixed an issue where recorded short videos might not display properly under extreme conditions.

  • Fixed subtle black borders around image thumbnails in conversation pages.

5.7.1 Stable​

Release Date: 2024/06/20

Optimizations:

  • Optimized SDK data processing performance.

5.7.0 Stable​

Release Date: 2024/05/23

Optimizations:

  • Discontinued publishing of Xiaomi overseas push module.

  • Updated Honor push service.

  • Updated AMap version, no longer supporting x86 architecture.

Bug Fixes:

  • Fixed an issue where if the time difference between local time and server time was 0, it would take 60s to get the real value next time.

  • Fixed an issue where FCM transparent messages didn't have ChannelId assigned.

  • Fixed incorrect prompts in the album preview page.

  • Added warning for oversized GIF files in the gallery to inform users they cannot send excessively large GIFs.

  • Added a failure prompt when deleting conversation messages without network connection.

  • Fixed an issue where the more options button wouldn't appear after switching between text and voice input.

  • Fixed an issue where conversation pages would display empty after network disconnection.

The 5.5.X series are stable versions based on the 5.4.7 Dev version.

5.5.3 Stable​

Release Date: 2024/02/29

Optimizations:

  • Upgraded the vivo push SDK dependency from 3.0.0.4 to 3.0.0.7 for push functionality. If using the legacy push integration solution, please upgrade the vivo push SDK accordingly. The updated vivo push SDK is included in the official download package.

  • Upgraded the OPPO push SDK dependency from 3.1.0 to 3.4.0 for push functionality. If using the legacy push integration solution, please upgrade the OPPO push SDK accordingly. The updated OPPO push SDK is included in the official download package.

Bug Fixes:

  • Fixed memory leaks in conversation pages.

  • Fixed an issue where multithreading could cause frequent SUSPEND connection status callbacks under extreme conditions.

  • Fixed an issue where repeated creation of NaviObserver caused multiple SDK reconnections.

5.5.2 Stable​

Release Date: 2023/12/08

Optimizations:

  • Added Honor push configuration to AndroidConfig in message push attributes (MessagePushConfig).

  • Completed the area code (AreaCode) enumeration values in initialization configuration InitOption.

Bug Fixes:

  • Fixed an issue where FCM transparent push notifications wouldn't auto-cancel after being clicked on some devices.

  • Fixed an issue where getConversationList had no callback and threads were blocked in multi-process scenarios.

5.5.1 Stable​

Release Date: 2023/10/20

Bug Fixes:

  • Fixed database encryption issues.

5.5.0 Stable​

Release Date: 2023/09/08

Optimizations:

  • Raised minimum supported Android version to 5.0, requiring minSdkVersion to be at least 21.

Bug Fixes:

  • Fixed an issue where the pull-to-load spinner in IMKit conversation lists would often keep spinning without closing.

  • Fixed an occasional connection failure issue when IMLib returned from background to foreground after some time.

The 5.3.X series are stable versions based on the 5.3.5 Dev version. The 5.3.X stable series is now outdated - please upgrade to the latest Stable version or latest dev version.

5.3.8 Stable​

Release Date: 2023/07/07

Bug Fixes

  • Optimized the interface for retrieving messages before/after a specified timestamp to use the exact timestamp provided, without SDK internal timestamp adjustment (+1/-1)

  • Fixed an issue where getConversationList had no callback and threads were blocked in multi-process scenarios

  • Fixed an issue where conversation drafts weren't restored after killing and restarting the app

  • Fixed an issue where user information would be empty when re-entering the app with existing drafts after killing the app

  • Fixed an issue where messages sent via contact selection would turn into drafts when returning to the message list

5.3.7 Stable​

Release Date: 2023/07/07

Version 5.3.7 Stable has been deprecated - please do not use it.

5.3.6 Stable​

Release Date: 2023/05/05

New Features

Last updated on