Skip to main content

Release Notes (Stable Version)

Note

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

Design Principles​

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

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

Release Cycle and Version Number Rules​

The version number rules for the IM SDK differ before and after version 5.4.X. Post-5.4.X, it's easier to distinguish between development and stable versions.

  • From version 5.4.X onwards, the Stable version occupies the second digit in 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 the stable SDK.
  • Before 5.4.X, the version number rules for stable versions were not fixed.
  • RC monitors the usage of Stable versions by customers and updates the stable version regularly, with the longest update cycle being 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 the Stable version upgrade to the new Stable version. After the release of a new Stable version, the maintenance effort for previous stable versions is 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 or consider upgrading to the 5.X series SDK.

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

5.7.3 Stable​

Release Date: 2025/02/06

Bug Fixes:

  • Fixed an issue where only microphone permission was requested when clicking on a short video on Android 9.
  • Fixed an issue in IMKit where the delete operation was abnormal when only one conversation remained in the conversation list.
  • Fixed an issue where only the latest conversation was displayed after pulling down to load more conversations in the conversation list.
  • Fixed an issue where the read status was not updated in the conversation list when the last message in a 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, adding support for a 16K Page Size.
  • Moved the logic for declaring and requesting 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 album.

Bug Fixes:

  • Fixed a crash issue when calling switchappkey.
  • Fixed a memory leak issue in the gallery.
  • Fixed incomplete information in map search.
  • Fixed an issue where short videos recorded in extreme cases could not be displayed properly.
  • Fixed a subtle black border issue in image thumbnails on the chat UI.

5.7.1 Stable​

Release Date: 2024/06/20

Optimizations:

  • Improved the data processing performance of the SDK.

5.7.0 Stable​

Release Date: 2024/05/23

Optimizations:

  • The push module for Xiaomi overseas has ceased publication.
  • Updated the Honor push module.
  • Updated the version of Amap, no longer supporting the x86 architecture.

Bug Fixes:

  • Fixed an issue where the difference between local time and server time was 0, requiring 60 seconds to obtain the real value next time.
  • Fixed an issue where FCM data messages did not assign a ChannelId.
  • Fixed incorrect prompts in the album preview page.
  • Added a prompt for oversized GIFs in the gallery, informing users that overly large GIF files cannot be sent.
  • Added a pop-up notification for failed message deletion in conversations. When a user attempts to delete a conversation message without a network connection, this pop-up will inform the user that the deletion failed.
  • Fixed an issue where the more options button did not appear on the right after switching from text to voice input in the keyboard.
  • Fixed an issue where the chat UI displayed empty after disconnecting from the network.

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

5.5.3 Stable​

Release Date: 2024/02/29

Optimizations:

  • The vivo push SDK dependency for the push feature has been upgraded from 3.0.0.4 to 3.0.0.7. If you are using the push (legacy) integration, please ensure you also upgrade the vivo push SDK. The vivo push SDK included in the official download package has been updated.
  • The OPPO push SDK dependency for the push feature has been upgraded from 3.1.0 to 3.4.0. If you are using the push (legacy) integration, please ensure you also upgrade the OPPO push SDK. The OPPO push SDK included in the official download package has been updated.

Bug Fixes:

  • Fixed a memory leak issue in the chat UI.
  • Fixed an issue where frequent SUSPEND connection state callbacks occurred due to multi-threading in extreme cases.
  • 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 the MessagePushConfig in the AndroidConfig.
  • Completed the AreaCode enumeration values in the InitOption initialization configuration.

Bug Fixes:

  • Fixed an issue where FCM data message notifications were not automatically canceled after being clicked on certain 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 an issue with database encryption.

5.5.0 Stable​

Release Date: 2023/09/08

Optimizations:

  • The minimum supported Android version has been raised to 5.0, requiring minSdkVersion to be at least 21.

Bug Fixes:

  • Fixed an issue in IMKit where the pull-down loading spinner in the conversation list frequently remained spinning and could not be closed.
  • Fixed an issue in IMLib where connections occasionally failed after the app was in the background for a period of time and then returned to the foreground.

The 5.3.X series is a stable version based on the 5.3.5 Dev version. The 5.3.X series stable versions are now outdated. Please upgrade to the latest Stable version or the latest dev version as soon as possible.

5.3.8 Stable​

Release Date: 2023/07/07

Bug Fixes

  • Optimized the interface for retrieving messages before or after a specified timestamp. The actual timestamp passed in is used, and the SDK no longer adds or subtracts 1 from the timestamp internally.
  • Fixed an issue where getConversationList had no callback and threads were blocked in multi-process scenarios.
  • Fixed an issue where conversation drafts were not restored after killing the app process and restarting.
  • Fixed an issue where user information was empty in conversations with drafts after killing the app and restarting.
  • Fixed an issue where messages sent after selecting a friend from the address book turned into drafts upon returning to the message list.

5.3.7 Stable​

Release Date: 2023/07/07

The 5.3.7 Stable version number has been deprecated. Please do not use it.

5.3.6 Stable​

Release Date: 2023/05/05

New Features

  1. The IMLib/IMKit SDK now supports specifying the vivo push category parameter in the message push configuration.
  2. The IMLib/IMKit SDK now supports specifying the Huawei push category parameter in the message push configuration.

5.1.9 Stable is the first stable version in the 5.X series. The 5.1.9 Stable version is now outdated. Please upgrade to the latest Stable version or the latest dev version as soon as possible.

5.1.9 Stable​

Release Date: 2022/08/22

New Features:

  1. Adapted to Android 12.
  2. Added an interface to retrieve the list of unread @ messages.
Last updated on