本文介绍网易云信即时通讯 IM SDK（简称 NIM SDK）稳定版 iOS 端 v9.x.x 及以下版本的更新日志。有关 v10.x.x 版本，请参考《IM 即时通讯 V10》iOS 更新日志。

单击展开了解什么是稳定版，以及与开发版的区别。

稳定版基于 开发版，可满足常见 IM 应用业务场景，但更注重稳定性。开发版则主要是在可商用的基础上，提供新功能与特性。

稳定版与开发版的主要差异点如下：

• 稳定版相较开发版，在更长周期内获得了更多用户的验证，且修复了多个历史版本的已知问题，稳定性保障更佳。
• 最新稳定版基于开发版 V9.17.0，后续稳定版在该版本基础上迭代。

近期重要更新

• 从 v9.17.0 起，推出最新稳定版，整体性能和稳定性进一步提升。
• 从 v8.9.122 起，支持按会话类型批量清理未读数和查询未读数，具体请参考 最近会话。
• 从 v8.9.111 起，第三方回调登录 支持第三方服务器采用动态 token 鉴权的场景。
• 从 v8.9.109 起，支持聊天室定向消息功能，具体请参考 发送聊天室定向消息。

---

9.17.0 (2024-07-04)

基于 IM 开发版 V9.17.0，推出最新稳定版，后续稳定版自 V9 系列开始迭代。

新增特性

• 新增圈组临时禁言功能，具体请参考 圈组临时禁言。
• 新增圈组频道分组自定义排序能力，具体请参考 搜索服务器和频道（频道分组）。
• 新增圈组查询未在频道分组下的频道信息能力，具体请参考 频道管理。

性能优化

• 推出最新稳定版，整体性能和稳定性进一步提升。

• 跨平台支持增强，支持 XCFramework 打包。

• 圈组插件化，可根据需求灵活加载，提升应用的定制性和响应速度。

  若需要使用圈组能力，除了需要引入 NIMSDK，还需要单独引入 NIMSDK/QChat，具体请参考 集成 SDK。

• 存储上传稳定性提升，显著提高文件传输的稳定性和可靠性。

• 多项内部优化，进一步提升性能。

API 新增

方法/回调/类	说明
NIMQChatServerManager.mute	在指定圈组服务器中对指定成员进行临时禁言或解除临时禁言。
NIMQChatServerManager.getMuteMemberByPage	在指定圈组服务器中分页查询被临时禁言的成员列表。
NIMQChatChannelManager.mute	在指定频道中对指定成员进行临时禁言或解除临时禁言。
NIMQChatChannelManager.getMuteMemberByPage	在指定频道中分页查询被临时禁言的成员列表。
getUncategorizedChannelsByPage	分页查询当前服务器中不在频道分组下的频道列表。
NIMQChatChannelCategory	频道分组对象新增 reorderWeight 字段，表示自定义排序标识，在分页查询频道分组时可根据该字段进行自定义排序。
getCategoriesInServerByPage	查询频道分组列表接口的入参中新增 sortType（排序类型）和 cursor （分页）字段，可设置排序类型实现 按自定义权重排序 查询频道分组。

8.9.128 (2024-04-11)

NIM iOS SDK 中新增 PrivacyInfo.xcprivac 隐私文件，兼容苹果公司的隐私更新。具体导入方式请参考 苹果隐私策略说明。

8.9.127 (2024-03-28)

修复已知问题。

8.9.126 (2024-03-20)

• 优化信令模块（呼叫功能）。
• 其他内部优化。

8.9.125 (2024-03-07)

修复已知问题。

8.9.124 (2024-02-02)

新增特性

新增动态查询连续完整的历史消息功能，具体请参考 动态查询历史消息。

相较于频繁从云端获取，该查询方法在保证历史消息完整的同时，减少了耗时和耗能。

API 变更

方法/类/枚举	说明
getMessagesDynamically	动态查询连续完整的历史消息。

8.9.123 (2024-01-19)

新增特性

• 支持按照群成员类型查询成员列表信息。（高级群和超大群）
• 支持按照关键字检索成员。（仅超大群）

API 新增

• 新增 NIMSuperTeamManager.searchTeamMember 方法按照关键字检索超大群成员。

  Objective-C- (void)searchTeamMembers:(NIMTeamMemberKeywordSearchOption *)option
              completion:(nullable NIMTeamMemberSearchResultHandler)completion;
  

  NIMTeamMemberKeywordSearchOption 参数说明：

  • teamId：高级群 ID。
  • keyword：查询使用的关键字。
  • offset：查询偏移，首次传 0，下一次调用传入上一次返回的 offset。
  • order：NIMMessageSearchOrder，查询方向，即返回结果按照 joinTime（进群时间）升序或降序排序。
  • limit：本次查询最大数量，默认为 10。

• 新增 NIMTeamManager.getTeamMemberList 和 NIMSuperTeamManager.getTeamMemberList 方法按照群成员类型查询高级群和超大群成员。

  Objective-C- (void)getTeamMemberList:(NSString *)teamId
                  option:(NIMTeamMemberRoleTypeSearchOption *)option
              completion:(nullable NIMTeamMemberSearchResultHandler)completion;
  

  NIMTeamMemberRoleTypeSearchOption 参数说明：

  • teamId：群组 ID
  • roleTypes：NIMTeamMemberType，群成员角色类型。
  • offset：查询偏移，首次传 0，下一次调用传入上一次返回的 offset。
  • order：NIMMessageSearchOrder，查询方向，即返回结果按照 joinTime（进群时间）升序或降序排序。
  • limit：本次查询最大数量，默认为 10。

8.9.122 (2023-12-27)

新增特性

• 支持按会话类型批量清理未读数和查询未读数，具体请参考 最近会话。
• 优化蓝牙音频录制与播放功能。
• 优化短时间内发送群消息已读回执过多而导致报错的问题。

API 新增

API	描述
markMessagesReadOfType::	将会话类型批量清理未读数（标记已读）。
messagesReadOfType:	会话消息已读的回调。
unreadCountOfType:	按会话类型获取未读消息数。

8.9.121 (2023-12-08)

新增 queryRecentSessionsWithLimit: 方法，用于查询指定数量的最近会话列表，主要适用于当前最近会话数量较多的场景。

8.9.119 (2023-10-19)

优化第三方回调动态 Token 登录内部逻辑，具体请参考 通过第三方回调登录 IM。

8.9.118 (2023-09-19)

• 优化日志打印逻辑。
• 修复日志模块崩溃问题。

8.9.116 (2023-07-18)

修复日志模块偶现的崩溃问题。

8.9.115 (2023-06-15)

优化内部逻辑。

8.9.114 (2023-05-16)

• 新增 TeamById2 接口，用于根据群组 ID 在本地缓存中查询具体的群组信息。该接口解决了历史接口（TeamById）频繁调用而引起的问题，因此建议使用新接口。
• 优化加载头像的日志打印占日志文件过多的问题。
• 调整 NOS 上传分片大小。
• 修复 SDK 打包上传时提示警告信息的问题。
• 修复 decodeMessageFromData 方法没有反序列化 remoteExt 属性的问题。

8.9.113 (2023-04-23)

• IM & 聊天室登录支持采用动态 Token 鉴权 & 动态 LoginExt 鉴权的场景。
• 修复获取本地历史记录传入 order 无效的问题。
• 修复清除过云端消息的会话无法收到漫游消息的问题。
• 修复由于数据库备份引起的多线程访问冲突问题。
• 修复其他已知问题。

8.9.111 (2023-03-31)

• 引入 NIM SDK 时，支持去除 NIMFtsDB 这个 framework 包。

  开发者引入时可自行选择是否去除 NIMFtsDB，如去除可缩减包体积大小。

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

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

8.9.110 (2023-02-13)

修复部分已知问题。

8.9.109 (2022-12-15)

SDK 包体积增量大小对比

架构	IPA 解压并安装后的增量大小
	稳定版（v8.9.109）	开发版（v9.7.0）
arm64	6.7MB	10.5MB

新增特性

支持聊天室定向消息功能。发送聊天室消息 支持消息接收者列表。

问题修复

修复已知问题。

8.9.108 (2022-11-08)

SDK 包体积增量大小对比

架构	IPA 解压并安装后的增量大小
	稳定版（v8.9.108）	开发版（v9.6.3）
arm64	9.4MB	11.4MB

新增特性

支持聊天室动态登录。

问题修复

• 修复 Thread 消息查询结果包含已撤回和删除消息的问题。
• 修复独立模式登录聊天室异常报错的问题。
• 修复自己发出消息的回调中发送者昵称信息为空的问题。
• 修复其他已知问题。