近期重要更新

• 新增全新的通用版 UI 组件，原有的 UI 组件（基础版）依旧保留，您可以根据需求自行选择基础版或通用版 UI 组件。具体请参见UIKit UI 组件库。
• 会话模块支持音视频通话功能。实现音视频通话的具体说明，请参见实现音视频通话。
• 会话模块支持地理位置消息功能，具体实现方法参见实现地理位置消息功能。

---

[9.6.2] - 2023-07-12

升级必看

自 V9.6.2 起：

• 废弃 ConversationRepo、ContactRepo、TeamRepo ，将其功能全部合并至 ChatKit 包中。并将注册监听相关接口，按照功能分类，分别迁移至 ChatObserverRepo、ContactObserverRepo、ConversationObserverRepo、TeamObserverRepo。

• 废弃 searchkit-ui，将其功能合并至 contactkit-ui中。

新增

新增全新的通用版 UI 组件，原有的 UI 组件（基础版）依旧保留，您可以根据需求自行选择基础版或通用版 UI 组件。具体请参见UIKit UI 组件库。

变更

升级 NIM SDK 版本到 v9.11.0。

[9.5.3] - 2023-04-24

新增

• 新增@功能，支持在群组中@群成员，在会话列表中收到@消息会高亮展示。
• 会话相关页面新增标记（pin）列表，可查看所有标记的消息。
• 新增回复消息功能，采用非 Thread 模式实现。
• 新增系统通知合并展示功能。

变更

IM UIKit 兼容的 NIM SDK 版本升级到 V9.10.0。

问题修复

修复部分已知问题。

[9.4.1] - 2023-03-17

修复IMKitClient中分步初始化接口config()和initSDK的调用异常问题。

[9.4.0] - 2023-02-28

新增

• 会话模块支持音视频通话功能。实现音视频通话的具体说明，请参见实现音视频通话。
• 圈组中支持表情和语音消息。

变更

• 升级 NIM SDK 版本到 v9.8.0。

• 离线消息支持 NIM SDK 的动态查询历史消息能力，避免出现历史消息拉取不完整的问题。更多详情请参见动态查询历史消息。

问题修复

修复部分已知问题。

[9.3.0] - 2022-12-22

新增

• 新增地理位置消息功能，具体实现方法参见实现地理位置消息功能。

• 新增文件消息功能（升级后可直接使用）。

  

变更

集成会话界面（chatkit-ui）之前不再需要调用ChatKitClient.init方法对该模块进行初始化，相关文档参见集成会话界面。

问题修复

修复部分已知问题。

[9.2.11] - 2022-11-23

变更

升级NIM SDK版本到 v9.6.4

问题修复

修复圈组、群设置中拍照功能异常。

[9.2.10] - 2022-11-04

新增

• 新增IChatInputMenu类支持对会话界面（即聊天界面）输入框下方的按钮进行个性化配置，可通过ChatUIConfig进行配置。相关自定义示例请参见在界面底部菜单栏增加按钮。
• 新增IChatPopMenu类支持对会话界面的消息长按菜单进行个性化配置，可通过ChatUIConfig进行配置。相关自定义示例请参见不展示消息长按菜单。
• ChatKitClient中新增addCustomAttach和addCustomViewHolder方法，分别用于添加自定义消息附件和自定义消息的 ViewHolder。相关说明请分别参见自定义消息处理和实现自定义消息的UI展示。
• MessageProperties中新增对界面标题的个性化定制能力。相关自定义示例请参见修改界面标题栏右侧图标。
• ContactUIConfig中新增IContactViewLayout支持对通讯录页面视图的个性化定制。相关自定义示例请参见在头部模块增加提示消息。
• 新增IConversationViewLayout支持个性化配置会话列表页面视图，可在ConversationUIConfig中配置。相关自定义示例请参见在会话列表顶部增加提示条。
• 新增SettingRepo类，提供通用配置方法，如通过setDeleteWithAlias方法可设置删除好友时删除昵称、通过setShowReadStatus方法设置是否展示已读未读状态等。

优化改进

• 长按 loading 和发送失败消息，展示回复转发等功能。
• 发送某些视频消息对端接收失败时，增加提示：云信IM视频下载失败。
• 发送 1s 语音消息撤回时，撤回通知消息换行展示。
• UI 和文案展示优化。

[9.2.9] - 2022-09-01

新增 API

• 新增MessageProperties类，可通过该类下的selfMessageRes设置当前用户发送消息的背景资源 ID。
• 新增MessageProperties类，可通过该类下的receiveMessageRes设置当前用户接收消息的背景资源 ID。

变更

• 未实现功能去除，包括：
  • 去除文件发送入口
  • 去除多选选项
  • 去除标记列表
  • 去除“我的”界面的收藏选项和收藏的入口
• 资源拆分：将依赖资源迁移到 UIKit 库中，不再依赖底层 Common 库的统一资源。

问题修复

• 多语言英文文案更新。
• 修复人员选择器选中的人员头像颜色不一致的问题。
• 修复通知消息界面头像颜色不一致的问题。
• 修复转发消息昵称过长且展示未对齐的问题。

[9.2.7] - 2022-08-18

新增 API

• 新增CommonRepo类，该类中包含用户数据获取方法getUserInfo方法和用户信息更新方法updateUserInfo。
• 在ChatKit-ui模块中，支持传入会话 ID 进入会话界面（包括群聊界面和单聊界面），传入参数的 KEY 值为RouterConstant.CHAT_ID_KRY。
• 增加国际化英文文案，跟随系统切换。

问题修复

• 修复黑名单中昵称展示问题。
• 修复@功能名称展示问题。
• 修复发送视频失败的提示文案。
• 修复权限申请逻辑问题。

[9.2.6] - 2022-08-11

新增 API

• 在IMKitClient类中增加setUserInfoDelegate(IUserInfoDelegate delegate,boolean cache)方法，支持UserInfo信息由业务实现。
• 在IMKitClient类中增加removeUserInfoDelegate方法，移除设置的UserInfo代理类。
• 在ChatKitClient类中增加init(Context context)方法。ChatKit模块初始化接口，需要在 Application 中进行初始化，完成自定义消息解析器CustomAttachParser的初始化。
• 在CustomAttachment类中中增加getContent方法，获取自定义消息的摘要信息，用于展示会话列表中最新消息展示。

问题修复

• 修复用户昵称或者群名称过长造成的 UI 展示问题。
• 修复用户信息获取，保证用户信息优先同步获取，如获取失败则采用异步获取。

[9.2.2] - 2022-06-30

修复自动登录接口中，登录信息同步异常的问题。

[9.2.0] - 2022-06-23

新增特性

序号	新增特性	特性描述
1	UI 层支持个性化配置能力	ChatKit-ui中： 新增ChatUIConfig，支持自定义聊天界面 UI 新增ChatKitClient，提供设置全局参数的接口 ConversationKit-ui中： 新增ConversationUIConfig，支持设置会话列表界面的 UI 自定义 新增ConversationKitClient提供设置全局参数的接口 ContactKit-ui中： 新增ContactUIConfig支持自定义通讯录界面 UI 新增ContactKitClient提供设置全局参数的接口
2	分布初始化	新增config接口和initSDK接口，支持分布初始化
3	通过扩展参数设置群组信息	TeamRepo新增createNormalTeam和createAdvanceTeam方法，支持传入扩展参数fieldsMap:Map<TeamFieldEnum, Serializable>设置群组信息

NIM SDK 版本兼容

IM UIKit 兼容的 NIM SDK 版本升级到 v9.2.5，圈组的系统通知增加新的通知类型，具体请参见 SDK 更新日志。

优化改进

对 Repository 层的接口进行了调整和优化，涉及改动的模块包括ChatMessageRepo、ContactRepo、ConversationRepo、TeamRepo、SearchRepo。

问题修复

修复部分机型首次安装通讯录界面无法即时刷新的问题。

[9.0.2] - 2022-06-07

新增 API

• 在ChatMessageBean类中增加isSameMessage(ChatMessageBean bean)方法，判断消息体是否相同。
• 在ChatMessageAdapter类中增加私有方法removeSameMessage(List message)，去除重复消息。

变更 API

• 在ChatMessageAdapter中的appendMessages和forwardMessages方法增加对removeSameMessage的调用，消息列表增加消息时进行去重。
• MessageCommonBaseViewHolder从Common 库中移除，ChatKitUI中相关 UI 和逻辑移动到在 ChatKitUI 中ChatBaseMessageViewHolder。
• MessageCommonBaseViewHolder 从 Common 库中移除，QChatKitUI 中相关 UI 和逻辑移动到 QChatBaseMessageViewHolder。

问题修复

• 修复重复提示群组创建成功的问题。该问题具体为：创建讨论组和高级群之后，进入讨论组或高级群的会话界面（即聊天界面），部分机型出现重复展示创建成功的提示信息。
• 修复图片库加载图片失败的问题。ContactAvatarView中增加图片库加载图片失败处理，图片加载失败按照纯生背景+昵称的头像模式展示。

[9.0.1] - 2022-05-19

我的模块中，个人信息页面增加账号复制功能。

[9.0.0] - 2022-05-09

网易云信全新一代 IM UIKit 发布。

IM UIKit 是基于 NIM SDK（网易云信 IM SDK）开发的一款即时通讯 UI 组件库，包括聊天、会话、圈组、搜索、群管理等组件。通过 IM UIKit，可快速集成包含 UI 界面的即时通讯应用。更多 IM UIKit 相关介绍请参见什么是 IM UIKit和快速集成 IM UIKit。

[8.5.0] - 2021-06-22

新增

1. 支持撤回自己给自己发送的消息
2. 成员信息页面增加回调监听，实时更新页面
3. 群设置界面支持群禁言
4. 高级群设置界面新增转让并退出群功能

[8.4.0] - 2021-04-29

新增

1. 会话列表页面收到会话更新通知时，如果数据库中没有此会话，则不创建会话项
2. 获取群消息的已读回执失败时，从本地加载

[8.2.0] - 2020-12-30

变更

1. 对会话进行排序时，不再频繁从数据库读取置顶信息

[8.1.0] - 2020-11-13

变更

1. 登录页新增独立模式进入聊天室入口

[7.8.0] -2020-7-21

变更

1. 手动登录页面可配置设备自定义类型。此类型只在此次登录中生效。
2. 会话置顶会多端同步和漫游

[7.4.0] -2020-3-9

变更

1. 长按消息菜单栏中添加单向删除接口
2. 长按消息菜单栏中的撤回，变更为通知计入未读数和通知不计入未读数的撤回
3. 会话界面（即聊天界面）中菜单栏的云消息记录变更为被清除消息入库和不入库两栏
4. 会话界面（即聊天界面）中菜单栏的清空本地消息记录变更为记录操作和不记录操作两栏

[7.2.0] -2020-1-13

变更

1. 设置页增加配置会话合并类型的项
2. 合并转发外观调整
3. 会话服务展示

[7.0.0] -2019-11-13

变更

1. 封装合并转发功能

[6.9.0] -2019-9-17

变更

1. 修复收到推送通知，头像图片不显示的问题
2. 修改GlobalSearchActivity和SearchMessageAcivity的screenOrientation参数为"behind"

[6.5.0] -2019-5-24

变更

1. 修复发送图片崩溃

[5.9.0] -2018-11-28

变更

1. 修复多处内存泄漏

[5.7.0] - 2018-10-11

新增

1. 设置页面新增通知的振动模式

2. 好友资料页新增置顶操作

[5.6.1] - 2018-9-13

新增

1. 播放音频时贴近耳朵，切换成听筒模式

2. 图片、音频、视频、文件消息在未下载成功前支持转发

变更

1. fix视频聊天切换画面崩溃

2. 视频聊天结束释放资源

[5.1.1] - 2018-05-21

变更

1. 多人通话使用AVChatTextureViewRenderer替换AVChatSurfaceViewRenderer。

[5.0.0] - 2018-03-29

新增

1. 白板模块组件化RTSKit

2. 新增群组已读功能演示

[4.6.0] - 2018-01-04

新增

1. 抽取音视频组件 avchatkit。

2. 集成 fabric 崩溃收集工具。

3. 允许管理员撤回其他成员消息。

[4.4.0] - 2017-11-16

新增

1. 添加全面屏配置。

2. 规避 oppo r11 Toast 崩溃的问题。

变更

1. 更新UIkit图片库，升级 Glide 到 4.2.0。

2. 非透明的 png 资源转成 webp 格式，减小包体积。

3. 被拉黑发消息失败后的交互调整。

4. Demo 开发环境升级到 Android Studio 3.0, Gradle tool 3.0, compile 26, target 26, 适配 O 版本。

5. UIKit 组件重构。

[4.3.0] - 2017-10-12

新增

1. 添加聊天室独立模式Demo。

2. 添加批量清空所有未读数接口演示。

3. 添加搜索历史图片/视频浏览界面。

变更

1. 猜拳文本演示改成图片演示。

2. UIKit 去掉对 avcaht library 的依赖。

3. UIKit Glide 图片库升级到v4.0，解决 gif 动画加载延迟问题。

[4.2.0] - 2017-09-12

新增

1. 聊天室机器人Demo演示。

[4.1.0] - 2017-08-08

新增

1. 添加金融魔方组件，集成金融魔方红包示例。

2. UIKit 添加 APP Icon 未读数红点更新接口 Bader，适配国内主流厂商机型，demo 演示最近会话未读数与 APP icon 红点数同步。

3. 添加多人音视频与 WebRtc 通信开关。

变更

1. 音视频在锁屏被呼叫时自动亮屏并唤起呼叫界面。

2. UIKit @功能重构，修复输入框@遗留的问题。

3. 修复 targetSdkVersion 24及以上时，选择拍摄照片失败问题。

[4.0.0] - 2017-07-06

新增

1. 添加机器人同步、机器人收发消息。

2. 添加机器人UI 组件。