2.X 升级到 5.X（Web）
更新时间:2023-12-14
PDF
本文描述如何从 IMLib SDK 2.X 版本（@rongcloud/imlib-v2） 升级至 5.X 版本的步骤。
Web 平台升级概述
IMLib SDK 5.X 是即时通讯业务客户端 SDK 的最新版本， 对 Typescript 的使用者提供了友好的类型化支持。相对于 2.X 版本，5.X 版本功能更丰富，更稳定，并在之前版本上修复了大量问题，我们建议融云客户尽早升级至新版 IMLib SDK。
融云同时为已集成 IMLib v2 版本（@rongcloud/imlib-v2）的客户提供了基于 Adapter 库（RongIMLib-v2-Adapter）替换升级选项。请注意，Adapter 库仅会提供问题修复，但不会在旧版 SDK 基础上增加新功能。详见关于 Adapter 的说明。
评估升级工作量
IMLib 5x SDK 与旧版 SDK 不兼容。我们整理了新旧版本 SDK API 对应关系与差异。请开发者根据自身 API 使用情况与 API 差异，合理安排开发周期。
- 新旧版本接口接口的名称和参数差异较大。升级前需要详细对照。
- 新旧版本接口返回值差异较大，可根据接口名称速查对照表比对各个接口返回值差异。
从 v2.5 或更早版本升级
IMLib 2.5 及更早版本，需注意如下变更：
- SDK 不再支持公众号与客服插件相关接口！
- IM 链接因网络问题意外中断后，SDK 会自动重连，应用层无需再调用
reconnect方法。 - 若
'RC:ProfileNtf'、'RC:CmdNtf'、'RC:InfoNtf'类型消息的content.data字段为 Json 字符串，需自行解析。 - SDK 不再兼容 IE 浏览器 6 至 8 版本。
具体废弃功能参见下表：
| 分类 | 废弃方法 | 描述 |
|---|---|---|
| 会话 | getConversationUnreadCount | 按会话类型获取会话未读数 |
| 会话 | clearConversations | 按会话类型删除会话 |
| 会话 | clearTotalUnreadCount | 清除所有会话未读数 |
| 讨论组 | createDiscussion | 创建讨论组 |
| 讨论组 | getDiscussion | 获取讨论组信息 |
| 讨论组 | quitDiscussion | 退出讨论组 |
| 讨论组 | addMemberToDiscussion | 加入讨论组 |
| 讨论组 | removeMemberFromDiscussion | 将指定成员移除讨论租 |
| 讨论组 | setDiscussionInviteStatus | 设置讨论组邀请状态 |
| 讨论组 | setDiscussionName | 设置讨论组名称 |
131 6185 6839