Skip to main content

Release Notes (Stable Version)

Note

Only the IM SDK for Android/iOS platforms distinguishes between development and stable versions.

Design Principles​

The iOS 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 numbers in the second digit indicate development versions, while odd numbers indicate stable versions. For example, 5.5.X is the version number used for stable SDK versions.
  • Before version 5.4.X, the stable version numbering rules were not fixed.
  • RC monitors the usage of Stable versions by customers and updates them regularly, with a maximum update cycle of two months.

Maintenance Notes​

  1. If a new Stable version is released under the major version number (currently 5.X) that RC is actively developing, we recommend that customers using Stable versions 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

Optimizations:

  • IMKit now supports iOS 26 system UI.

5.21.0 Stable​

Release Date: 2025/9/18

New Features

  • IMLib adds per-message read status functionality (Read Receipt V5).
  • IMLib optimizes the conversation list to support ultra group conversation types.
  • IMLib adds a batch set-top interface.
  • IMLib adds a pull remote conversation list interface.
  • IMKit adds HTML streaming messages.
  • IMLib adds width (thumWidth) and height (thumHeight) attributes for thumbnails in image messages.
  • IMLib now converts illegal message bodies to UnknownMessage uniformly.
  • IMLib optimizes the local naming format for file downloads.
  • IMKit and IMLib add the ability for information hosting profiles to provide content moderation services.
  • Added the ability to set isDelete, isAdmin, and disableNotification properties when recalling messages in IMLib.
  • IMLib adds the RCLocalConfiguration configuration management class (replacing RCConfig.plist).
  • IMLib supports the ability to receive and listen to streaming messages.
  • IMKit supports the display of streaming messages.
  • IMKit adds SPM integration.
  • IMLib supports IPv6.
  • Added global Do Not Disturb interfaces for setting and getting supported time zones in IMLib.
  • Added a callback interface in IMLib for synchronizing full group data when group information changes.
  • Added an interface in IMLib to track local notification click events.
  • Added the latestRCMessage property to RCConversation in IMLib, which is the complete message body RCMessage of the latest message in the conversation.
  • Declared the method name for setting delegates in IMLib for Swift calls.
  • Added support for draft capabilities of quoted messages in IMKit conversations.
  • Getting the total unread message count by conversation Do Not Disturb level now supports system conversation types.
  • iOS sending multi-device synchronized read status now supports system conversation types.
  • Added the disableUpdateLastMessage property to RCMessaage, which controls whether to update to the latest message in the conversation.
  • Improved the UI for group-related capabilities in IMKit user information hosting.
  • Adapted cross-platform custom message logic.
  • Added group and member management capabilities to the information hosting service.
  • Added friend relationship management capabilities to the information hosting service.
  • IMKit adds group and member management, and friend relationship management capabilities.
  • Adapted to iOS 18.
  • Added SDK database upgrade callbacks.
  • Disabled bitcode.
  • Sending messages now supports setting HarmonyOS push attributes.
  • Online status subscriptions now include the HarmonyOS platform.
  • The successful callback for joining a chatroom now includes the join time.
  • Added user information hosting functionality, supporting modification, query, and subscription of hosted user information.
  • Added a switch configuration for pinning empty conversations, allowing developers to choose whether to synchronize pinned empty conversations.
  • Added a callback in IMKit for when all messages in a conversation page have been pulled.
  • Added an API for batch retrieval of conversation information.
  • Added an API to control whether pinning a conversation updates the operation time.
  • Added a chatroom message deduplication switch.
  • Supported the ability to search historical messages by keyword for specified message types in specified conversations.
  • Added the ability for clients to subscribe to user online status updates.

Bug Fixes:

  • Fixed the issue where system conversations did not synchronize unread messages across multiple devices for the same account.
  • Fixed memory leaks that occasionally occurred during IM connections.
  • IMKit fixed the issue with conversation summary display for image-text messages and merged forwarded messages.
  • IMLib fixed the parameter validation inconsistency across devices for the getConversationListByFilters:option:completion: interface.
  • IMKit fixed the issue where users were displayed repeatedly in group member lists.
  • Fixed the issue where message sending failed due to exceeding the limit for location message storage in iOS 26 dark mode.
  • IMLib fixed the issue where message information was incomplete in the callback for sending media messages.
  • IMLib fixed the inaccurate operationTime in the callback for group join requests.
  • IMLib fixed the incorrect sentTime assignment when inserting messages.
  • IMKit fixed the UI issue with the input box on XS Max phones.
  • IMLib filtered cases where the read receipt time was -1.
  • IMLib fixed the issue where supergroup read synchronization failed.
  • IMLib fixed the issue where the client received two callbacks when the server called the set KV interface once.
  • IMKit fixed the issue where the upload progress could reset to 0 when scrolling messages during image upload.
  • IMKit fixed the issue where usernames were not fully displayed in the [Chat Files] page.
  • IMKit fixed the issue where clicking a quoted message within a quote could not be opened for viewing.
  • Fixed the issue where IMLib multi-device synchronized read status affected the unread count for dual-device users.
  • Fixed the issue where clicking to enlarge a forwarded image in IMLib still showed a thumbnail.
  • Fixed the issue where the size and duration types for short video messages in IMLib did not match those on Android.
  • Fixed the issue where music would not pause and would play externally when recording videos with headphones connected in IMLib.
  • Fixed the issue where supergroup-pulled RC:RcNtf messages in IMLib had incomplete information.
  • Fixed the logic issue with the getMessages:targetId:option:complete:error: message retrieval interface in IMLib.
  • Fixed the issue where clicking phone number text messages in IMKit on iOS 18 did not trigger the dialer.
  • Fixed the issue where the left toggle button icon was incorrect when switching from input mode to voice mode in IMKit.
  • Fixed the issue where selecting a video from the preview page in the album when sending a video message in IMKit showed an error prompt and could not be selected.
  • Fixed the issue where default content in the IMKit conversation input box could not be hidden.
  • Fixed the issue where IMLib on iOS 18 could not send video files containing spatial audio.
  • Fixed the issue with continuous audio playback in IMKit on iOS 18.
  • Fixed the occasional issue in IMKit where photo selection could not locate the latest photo.
  • Fixed the issue in IMKit on iOS 11.4.1 phones where tableView displayed extra horizontal lines if footerView was not set.
  • Fixed the issue where the location sharing gray bar still appeared after uninstalling and reinstalling the app and re-entering the conversation.
  • Resolved the issue with pushcontent assignment when sending media messages.
  • The default value for the switch to synchronize pinned empty conversations is now NO, meaning pinned empty conversations are not synchronized by default.
  • Fixed the issue where file downloads in the IMKit merged forwarding page could not be canceled.
  • Fixed the issue where the original file of a quoted message was downloaded, but clicking the file in the quote still showed "Start Downloading."
  • Fixed the issue where files might be incomplete after resuming a broken download.

Optimizations:

  • Optimized the supergroup message extension processing logic in IMLib.
  • Optimized the callback and notification logic for information hosting interfaces in IMLib.
  • Optimized the logic for inserting media messages in IMLib.
  • Optimized the phone and link click events in RCComplexTextMessageCell to match the text message effect.
  • Optimized the display of the play button when dragging the progress bar in short video playback.
  • Optimized the content display format for merged forwarded messages.
  • Optimized the message recall mechanism; recalling a message now also recalls the user information (UserInfo) and extra information (extra) carried in the command message.

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 fixed the issue where the message retrieval interface caused an increase in downstream messages.

5.7.9 Stable​

Release Date: 2025/7/18

Optimizations:

  • IMLib added a callback for user-level configuration synchronization completion.
  • IMLib added an interface to retrieve unmarked conversation lists.

5.7.8 Stable​

Release Date: 2025/7/8

Bug Fixes:

  • IMLib fixed the issue where file chunk downloads failed.

5.7.7 Stable​

Release Date: 2025/6/20

Bug Fixes:

  • IMLib fixed the occasional crash when reporting logs.

5.7.6 Stable​

Release Date: 2025/6/5

Bug Fixes:

  • IMKit fixed the UI issue with the input box on XS Max phones.

5.7.5 Stable​

Release Date: 2025/5/16

Optimizations:

  • IMLib added a connection interface with user ID connectWithUserId:token:timeLimit:dbOpened:success:error:.

Bug Fixes:

  • IMLib fixed the issue where DNS resolution timeout in weak networks destroyed threads and caused crashes.

5.7.4 Stable​

Release Date: 2025/4/24

Optimizations:

  • Added a chatroom KV callback interface, supporting callbacks in the order of KV settings.

5.7.3 Stable​

Release Date: 2025/2/6

Optimizations:

  • In the merged forwarding feature, if a short video message is included, the "More Files" button in the upper right corner is no longer displayed.
  • Added support for read status synchronization in private conversations.
  • Optimized video compression logic.

Bug Fixes

  • Fixed the issue where extensions appeared unremoved when querying the current message in the remove extension callback.
  • Fixed the issue where, in chatrooms, after a server ban on a chatroom member was lifted, the client did not automatically rejoin the chatroom upon reconnecting.
  • Fixed the issue where inserting an image message and then retrieving it via msgId to send could not send the original image.
  • Fixed the issue where the left toggle button icon was incorrect when switching from input mode to voice mode.
  • Fixed the issue where sending multi-device synchronized read status did not support system conversations.
  • Fixed the issue where clicking phone number text messages did not trigger the dialer and clicking emails did not redirect to the mail page.
  • Fixed the issue where selecting a video from the preview page in the album when sending a video message showed an error prompt and could not be selected.
  • Fixed the issue where clicking files with single quotes in their names in the merged forwarding details page did not respond.
  • Fixed the issue where sending videos recorded on iPhone 16 from the album failed.
  • Fixed the issue where default content in placeholderLabel could not be hidden.

5.7.2 Stable​

Release Date: 2024/10/23

Optimizations:

  • Added functionality to toggle synchronization of empty pinned conversations.

  • Optimized draft caching logic when exiting conversations.

Bug Fixes:

  • Fixed the issue where pushcontent could not be assigned when sending media messages.

  • Disabled bitcode and resolved iOS 18 compatibility issues.

  • Fixed the missing failure callback when retrieving remote messages.

5.7.0 Stable​

Release Date: 2024/05/23

Optimizations:

  • Optimized occasional initialization interface lag.

  • Improved display of overly long filenames in quoted messages.

  • Enhanced display speed of location anchors when previewing location messages.

  • Added a failure alert for message deletion attempts during offline mode.

  • Improved content display format for merged forwarded messages.

  • Optimized network disconnection prompts in conversation lists.

Bug Fixes:

  • Fixed the issue where clicking quoted files showed "Downloading" despite being already downloaded.

The 5.5.X series is a stable version based on the 5.4.8 Dev release.

5.5.4 Stable​

Release Date: 2024/03/20

Optimizations:

  • Optimized internal processing logic for media messages

5.5.3 Stable​

Release Date: 2024/02/29

Optimizations:

Bug Fixes:

  • Fixed memory leak in RongLocationlib's NSMutableArray *delegateArray

  • Fixed memory leak after recording short videos in IMKit.

  • Resolved conflicts with third-party AVAudioSession setCategory calls causing voice message recording failures.

5.5.2 Stable​

Release Date: 2023/12/08

Optimizations:

  • Added Honor push configuration to RCAndroidConfig in message push attributes (RCMessagePushConfig).

  • Completed AreaCode enum values in initialization options (RCInitOption).

  • Optimized SDK connection logic.

Bug Fixes:

  • Fixed message reception thread blocking.

5.5.0 Stable​

Release Date: 2023/09/08

Optimizations:

  • IMKit now inserts gray bar notifications even when locally deleted messages are recalled.

  • IMLib removed the 2-second delay before auto-rejoining chatrooms after reconnection.

  • Improved message loading speed in IMKit one-to-one and group chat UIs.

  • Adjusted SDK reconnection intervals to: 0.05s, 0.25s, 0.5s, 1s, 2s, 4s, 8s, 16s, 32s, then every 64s.

  • Hardened IMKit SDK against rare crashes caused by illegal characters.

Bug Fixes:

  • Fixed silent video recordings when screen turned off mid-recording.

  • Fixed occasional crashes when displaying usernames in message replies.

  • Resolved 12-hour clock mode global DND failures.

  • Optimized IMLib performance when deleting all messages from a conversation.

  • Fixed blank photo album lists during image selection.

  • Added ellipsis for merged forwarded messages exceeding 4 lines.

  • Fixed black navigation/status bars when using location plugin.

  • Resolved missing multi-select button refreshes.

  • Fixed content validation errors in file messages.

  • Corrected Arabic text alignment.

  • Fixed UI corruption when swiping conversation pages with dynamic phrases enabled.

  • Prevented crashes when entering conversations without initialization.

  • Fixed incomplete offline KV message updates.

The 5.3.X series (based on 5.3.5 Dev) is now deprecated. Please upgrade to the latest Stable or Dev version.

5.3.7 Stable​

Release Date: 2023/07/07

Optimizations

  • Deprecated defaultRemoteHistoryMessageCount and defaultLocalHistoryMessageCount in favor of unified defaultMessageCount for pull-to-refresh message retrieval.

Bug Fixes

  • Fixed crashes when forwarding messages with non-string extensions.

  • Optimized timestamp-based message retrieval to respect exact input values.

  • Fixed incomplete offline KV message updates.

  • Resolved custom font color issues in unReadMentionedLabel.

5.3.6 Stable​

Release Date: 2023/05/05

Last updated on