iOS IMKit 初始化

IMKit 不单独建立连接:先初始化 IMLib 客户端并 connect,再初始化 IMKit 门面。门面持有主题、语言、自定义渲染器与组件实例。

初始化顺序​

步骤动作说明
1IMLib 初始化init(options):appkey / serverUrl(幂等)
2IMLib 连接connect(token):成功后触发 CONNECTED
3IMKit 门面初始化静态 init 或构造门面:注入客户端、主题、locale、renderers
4挂载组件mount(container, component, props) / Widget / Fragment

门面与挂载 API​

项值
门面IMKitFacade
挂载IMKitFacade.mount(in: UIView) / update(_:) / destroy()
导出组件IMPConversationListView、IMPChatView、IMPMessageBubble、IMPMessageInput、IMPAvatar、IMPUnreadBadge、IMPTimeSeparator、IMPMessageStatusIndicator、IMPTheme、IMKitFacade
UI 框架UIKit 视图容器 + 组件协议(Swift / Objective-C 双接口),宿主负责装配页面

初始化示例​

Swift
// ios-imkit/init
let client = ImpIaaSIM.client(options: IMPClientOptions(appkey: "YOUR_APP_KEY", serverUrl: "https://im.example.com"))
let initStatus = client.getConnectionStatus()
print(initStatus)

幂等与生命周期​

  • 门面挂载幂等:同一容器重复 mount 复用实例(Web / Electron / Harmony 绑定显式声明);Android init 重复调用复用同一 appkey 的 IMLib 客户端。
  • 组件销毁时释放监听与定时器(输入区 typing 定时器、事件监听),避免内存泄漏与重复回调。
  • 主题可在初始化后动态更新:调用门面 setup/update 或重新挂载;不需要重建 IMLib 客户端。
  • destroy() 只销毁组件实例,不断开 IMLib 连接;IMLib 的 disconnect 由宿主控制。

相关文档​