本文介绍网易云信即时通讯 IM SDK（简称 NIM SDK）开发版适配 Flutter 开发框架 10.x.x 及以上版本的更新日志。有关稳定版 9.x.x 及以下版本，请参考《IM 即时通讯 V9》Flutter 更新日志。

10.9.3(2025-09-09)

新增特性

• 支持删除历史漫游消息功能。
• 新增当前聊天账号设置功能。
• Android 平台支持设置消息提醒的类型。
• Android 平台支持设置通知的自定义通道。

API 更新

方法/回调/类	说明	兼容平台
clearRoamingMessage	新增接口，用于删除历史漫游消息。	Android、iOS、macOS、Window
setCurrentConversation	新增接口，用于设置当前的聊天账号。	Android、iOS、macOS、Window
V2NIMLoginOption	在登录参数中新增 offlineMode 字段，表示是否启用离线模式，默认不开启。	Android、iOS
notificationChannelProvider	新增接口，用于设置通知的自定义通道。	Android
makeCategory	新增接口，用于设置消息提醒的类型。	Android

兼容版本

• 底层 Android NIM SDK 升级至 v10.9.45。
• 底层 iOS NIM SDK 升级至 v10.9.40。
• 底层 macOS/Windows NIM SDK 升级至 v10.9.40。

10.9.2 (2025-08-25)

版本说明：

该版本适配鸿蒙操作系统（HarmonyOS），为 Beta 版本。

环境要求：

使用该版本需要满足以下条件：

• 已配置 Flutter 鸿蒙开发环境（ 参考 鸿蒙官方文档）。
• Flutter 版本：3.27.5-ohos-0.0.2。

引入方式：

该版本接入方式采用 git 依赖，暂未上传至 pub。

在项目的 pubspec.yaml 中添加以下 git 依赖，然后执行 flutter pub get。

yamldependencies:
nim_core_v2:
    git:
    url: "https://github.com/netease-kit/NIM-Flutter-SDK-OHOS.git"

10.9.1 (2025-07-23)

macOS 和 Windows 平台功能对齐移动端。

10.9.0 (2025-06-25)

新增特性

• 新增群成员特别关注功能。
• 新增本地登录信息的查询功能。
• 新增删除或清空好友申请/入群申请功能。
• 新增本地消息全文搜索功能。
• 新增置顶会话查询能力。
• 支持查询指定用户是否在黑名单中。
• 支持消息过滤功能。
• 支持在初始化时配置 NIM SDK 的通知栏回调（Android）。
  • 支持配置是否启用 NIM SDK 的用户信息。
  • 支持配置是否开启定制通知栏消息提醒的文案。
• 支持设置自定义推送 Token（Android）。
• 优化全文检索云端历史消息。您可以按照指定条件，全局检索整个应用内的云端历史消息。

API 更新

方法/回调/类	说明
addTeamMembersFollow	新增方法，用于添加特别关注群成员列表。
removeTeamMembersFollow	新增方法，用于移除特别关注群成员列表。
getCurrentLoginClient	新增方法，用于查询本地登录的相关信息。
clearAllAddApplication	新增方法，用于清空所有好友申请。
deleteAddApplication	新增方法，用于删除指定的好友申请。
clearAllTeamJoinActionInfo	新增方法，用于清空所有入群申请。
deleteTeamJoinActionInfo	新增方法，用于清空所有入群申请。
clearHistoryMessage	新增 clearMode 入参，可自由选择清空 本地和云端 或 仅本地 的历史消息。
getOwnerTeamList	新增方法，用于获取当前自己的群组列表。
searchCloudMessagesEx	新增方法，用于全文检索云端历史消息。
getMessageListEx	新增方法，用于查询历史消息列表。分页接口，可以根据参数组合查询各种类型，每次默认 50 条消息。
checkBlock	新增方法，用于查看指定用户是否在黑名单中。
getStickTopConversationList	新增方法，用于查询当前置顶的全量会话列表。
searchLocalMessages	新增方法，用于全文检索本地历史消息。
updateLocalMessage	新增方法，用于更新本地插入的消息。
getPushMobileOnDesktopOnline	新增方法，用于查询桌面端在线时，移动端是否需要推送。
getCollectionListExByOption	新增方法，用于按条件分页获取收藏信息，较 getCollectionListByOption 方法，回参新增 totalCount 字段，表示收藏总数。
inviteMemberEx	新增方法，用于邀请成员加入群组。

兼容版本

• 底层 Android NIM SDK 升级至 v10.9.10。
• 底层 iOS NIM SDK 升级至 v10.9.10。

10.8.0 (2025-05-26)

特性变更

支持 IM AI 数字人支持流式输出模式，通过实时分片传输 AI 生成的内容，降低响应延迟、支持中断控制，显著改善用户交互体验。

API 更新

方法/回调/类	说明
clearUnreadCountByGroupId	新增方法，用于根据会话分组 ID 清除分组内所有会话的消息总未读数。
stopAIStreamMessage	新增方法，用于停止 AI 数字人流式输出消息，可以选择直接停止输出，或撤回/更新已输出的 AI 数字人消息。
regenAIMessage	新增方法，用于重新输出 AI 数字人消息，可以选择直接更新覆盖已输出的消息，或者直接创建一条新的 AI 数字人消息。
stopAIModelStreamCall	新增方法，用于向服务器请求停止流式输出 AI 数字人消息。
onProxyAIModelStreamCall	新增 AI 数字人流式输出回调。
sendMessage	接口更新，发送消息的 AI 数字人配置参数中新增输出模式字段（aiStream）字段，选择是否使用流式输出 AI 数字人消息。
proxyAIModelCall	接口更新，向 LLM 发起模型调用请求方法的 AI 数字人配置参数中新增输出模式字段（aiStream），选择是否流式输出 AI 数字人消息。

10.6.1 (2025-05-08)

新增特性

支持聊天室队列功能。具体请参考 聊天室队列管理。

API 变更

方法/回调/类	说明
V2NIMChatroomQueueService	新增聊天室队列服务类，提供注册/注销聊天室队列监听器、初始化队列、清空队列、管理队列元素等接口。

10.6.0 (2025-04-18)

新增特性

• 新增云端会话分组功能，支持按照自定义维度将会话进行分组，方便用户管理和查询会话。具体请参考 会话分组管理。
• 新增本地会话功能。详情请参考 本地会话管理。
• 新增群定向消息功能。发送群消息时，可以指定接收消息的群成员列表。

修复

• 修复 Android 端更新本地消息本地扩展问题 updateMessageLocalExtension。
• 修复 iOS 端角标配置问题。
• 修复 iOS 端登录回调 loginExtension 问题。

API 变更

方法/回调/类	说明
V2NIMLocalConversationService	新增本地会话服务类，提供创建、删除、更新、获取、置顶本地会话，本地会话消息未读数相关、注册本地会话监听等接口。
V2NIMConversationGroupService	新增云端会话分组服务类，提供创建、删除、更新、获取云端会话分组，注册云端会话分组监听等接口。
NIMSendMessageParams	新增 targetConfig 参数，用于实现群定向消息功能。

10.5.1 (2025-04-14)

在 Android 项目中，NIM Flutter SDK 编译时使用 JDK 8 (JDK 1.8)，提高 JDK 8 环境的兼容性。

10.5.0 (2025-03-25)

新增特性

• 新增聊天室服务功能。详情请参考 聊天室 相关集成参考。
• 新增消息更新功能。
• 新增消息序列化和反序列化功能。
• 新增清空所有好友申请功能。
• 新增 Android 端的通知配置。

API 更新

相关 API 请参考 聊天室 相关 API。

方法/回调/类	说明
V2NIMChatroomClient	聊天室接口类，包括注册/注销聊天室实例监听，创建、进入、退出、销毁聊天室等接口。
V2NIMChatroomMessageCreator	聊天室消息构建接口类，支持构建多种类型的聊天室消息。
V2NIMChatroomService	聊天室服务接口类，包括注册/注销聊天室监听器、收发聊天室消息、管理聊天室成员、维护聊天室信息等接口。
modifyMessage	更新消息，实现消息的二次编辑能力。
messageSerialization	消息序列化为字符串。
messageDeserialization	消息字符串转换为消息。
clearAllAddApplication	清空所有好友申请。
updateNotificationConfigAndroid	更新通知栏设置，仅支持 Android 平台。
enableNotificationAndroid	配置消息提醒，仅支持 Android 平台，iOS平台请关闭通知权限。

兼容版本

• 底层 Android NIM SDK 升级至 v10.8.21。
• 底层 iOS NIM SDK 升级至 v10.8.20。

10.4.0 (2025-01-20)

新增特性

• 新增 新版信令 功能。
• Android 平台支持 AGP8（Android Gradle Plugin）。

兼容版本

底层 NIM SDK 升级至 v10.7.0。

10.3.5 (2025-01-07)

修复获取历史消息报错的问题。

10.3.4 (2024-12-24)

新增 用户在线状态事件订阅 功能。

10.3.3 (2024-11-22)

修复 iOS 端无法拉取群组更新属性的问题。

10.3.1 (2024-09-02)

优化 PC 端部分已知问题。

10.3.0 (2024-08-23)

网易云信即时通讯首次发布适配 Flutter 开发框架的 V10 系列 SDK，NIM Flutter SDK 已发布到 pub 库，您可以通过配置 pubspec.yaml 自动下载更新，详情请参考 集成 Flutter SDK。

10.3.0 版本支持以下功能：

• 支持多端登录、单聊/群聊、用户信息以及好友关系功能模块。
• 支持多样化的消息类型。
• 支持群组管理、用户和好友管理能力。