近期重要更新

• 第三方回调登录支持第三方服务器采用动态 token 鉴权的场景。
• 支持聊天室定向消息功能，具体请参见发送聊天室定向消息。
• 适配 Android v13.0.0。

---

什么是稳定版

稳定版基于开发版，可满足常见 IM 业务场景，更注重稳定性。

开发版在可商用的基础上，提供新功能与特性。

两者的主要差异点如下：

• 稳定版相较开发版，在更长周期内获得了更多用户的验证，且修复了多个历史版本的已知问题，稳定性保障更佳。

• 稳定版基于开发版 V8.9.0，包体积更小（具体见下文的 SDK 包体积大小对比）。

• 稳定版不支持海外节点存储、圈组模块以及其他最新功能。

  具体功能差异如下：

  功能	简介	稳定版	开发版
  融合存储	将数据存储于海外节点如果您的应用涉及海外业务，请选择开发版。	✘	✔
  圈组	用于打造全新社交模式类“Discord”场景	✘	✔
  聊天室空间消息	用于在基于空间坐标的场景下给指定范围内的用户发送消息，如某游戏地图内指定范围内的玩家	✘	✔
  聊天室标签实时更新	实时更新聊天室的用户标签	✘	✔

稳定版环境要求

环境要求	说明
JDK 版本	1.8.0 及以上版本
Android API 版本	API 21、Android 5.0 及以上版本
CPU架构	ARM 64、ARM V7
IDE Android Studio	4.0及以上
其他	依赖 Androidx，不支持 support 库 请使用 Android 系统 5.0 或以上版本的移动设备

[8.9.118] - 2023-08-29

• 支持配置消息提醒（本地通知消息）的类型，具体请参考消息提醒类型。
• 修复 IPV6 URL 转换错误的问题。
• 修复 NOS 文件上传失败的问题。
• Android API 最低版本升级至 21（原 19）。

[8.9.117] - 2023-07-20

• 支持在应用级别配置 SDK 日志打印的开关，减少 SDK 本地查询数据库的操作。
• 取消未登录状态下发送消息的超时机制，直接返回未登录错误码。
• deviceID 和 AppKey 以健值对的方案存储，传入 AppKey 即可获取 device ID。
• 修复文件下载完成后，文件状态异常的问题。
• 修复其他已知问题。

[8.9.116] - 2023-06-14

优化内部逻辑。

[8.9.115] - 2023-05-15

• 推送升级。
• 修复其他已知问题。

第三方推送兼容版本

v8.9.115 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.9.0.300
小米	5.6.2
OPPO	3.1.0
VIVO	3.0.0.4_484
魅族	4.2.3
荣耀	7.0.41.301
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics: 20.0.0

[8.9.114] - 2023-04-27

• IM & 聊天室登录支持采用动态 Token 鉴权 & 动态 LoginExt 鉴权的场景。
• 解决隐私合规问题。
• 修复已登录场景下，数据库打开异常的问题。
• 修复锁屏之后 observeOnlineStatus 回调过于频繁的问题。
• 修复其他已知问题。

[8.9.113] - 2023-03-31

• 第三方回调登录支持第三方服务器采用动态 token 鉴权的场景。

  如果用户登录 IM 时 token 已过期，IM 服务端会重新向第三方服务器发起登录回调请求，并获取新的 token。

• 部分已知问题修复与优化。

[8.9.112] - 2023-02-17

• 修复会话状态更新异常。
• 修复登录超时后的重连机制异常。
• 修复其他已知问题。

[8.9.111] - 2023-01-31

修复数据上报完成后，在主线程中操作数据库时，可能导致卡顿或者应用程序无响应对话框 （ANR）的问题。

[8.9.109] - 2022-12-15

新增特性

• 支持聊天室定向消息功能。发送聊天室消息支持消息接收者列表
• 适配 Android v13.0.0
• 解决隐私合规问题

问题修复

• 修复发送文件消息时文件上传失败但消息发送成功的问题
• 修复获取群昵称异常问题
• 修复偶现的所在高级群被提示已退出的问题
• 修复其他已知问题

第三方推送兼容版本

v8.9.109 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.5.0.300
小米	5.1.0
OPPO	3.1.0
VIVO	3.0.0.4_484
魅族	4.1.0
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics: 20.0.0

[8.9.108] - 2022-11-28

优化 SDK 内部判断当前所在进程的逻辑。

[8.9.107] - 2022-11-08

SDK 包体积增量大小对比

架构	稳定版（v8.9.107）	开发版（v9.6.3）
arm64-v8a	9.73MB	23.64MB
armeabi-v7a	7.38MB	17.66MB

新增特性

• 适配 Android v12.0.0
• 支持数据上报（查看实时监控数据的基础）
• 支持根据用户登录的 App Key 进行数据采集并上报
• 支持聊天室动态登录

问题修复

• 去除 ssid 获取
• 去除自启动和关联启动的行为
• 修复 AES 加密问题
• 去除用户未同意隐私条款前的调用逻辑
• 修复超大群消息开启免打扰失效的问题
• 修复应用启动时偶现的无法启动 NimService 问题
• 修复聊天室偶现的无法收到消息的问题
• 修复插入本地消息是否计未读数和主体未读数判断逻辑不一致的问题
• 修复 Thread 的回复消息数与实际不符的问题
• 修复偶现的日志崩溃问题
• 修复其他已知问题

第三方推送兼容版本

v8.9.107 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.3.0.302
小米	4.5.0
OPPO	3.1.0
VIVO	3.0.0.4_484
魅族	4.1.0
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics: 20.0.0

已知问题

该版本 SDK 中未包含全文检索插件（nim-lucene-x.x.x.jar）。

[8.9.100] - 2022-07-15

NIM SDK 稳定版首次发布。

v8.9.100 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.3.0.302
小米	4.5.0
OPPO	3.0.0
VIVO	3.0.0.4_484
魅族	4.1.0
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics: 20.0.0