Native (C ABI) IMKit 初始化
IMKit 不单独建立连接:先初始化 IMLib 客户端并 connect,再初始化 IMKit 门面。门面持有主题、语言、自定义渲染器与组件实例。
初始化顺序
| 步骤 | 动作 | 说明 |
|---|---|---|
| 1 | IMLib 初始化 | init(options):appkey / serverUrl(幂等) |
| 2 | IMLib 连接 | connect(token):成功后触发 CONNECTED |
| 3 | IMKit 门面初始化 | 静态 init 或构造门面:注入客户端、主题、locale、renderers |
| 4 | 挂载组件 | mount(container, component, props) / Widget / Fragment |
门面与挂载 API
| 项 | 值 |
|---|---|
| 门面 | IMKit |
| 挂载 | — |
| 导出组件 | — |
| UI 框架 | view-model / 格式化 / 角标 / 状态计算层(不访问网络,不渲染 UI) |
初始化示例
C(view-model 层)
#include "im_sdk.h"
#include "im_kit.h"
im_kit_theme_t* theme = NULL;
im_kit_theme_default(0 /* light */, &theme);
im_kit_conversation_model_t* list = im_kit_conversation_model_new(client);幂等与生命周期
- 门面挂载幂等:同一容器重复 mount 复用实例(Web / Electron / Harmony 绑定显式声明);Android
init重复调用复用同一 appkey 的 IMLib 客户端。 - 组件销毁时释放监听与定时器(输入区 typing 定时器、事件监听),避免内存泄漏与重复回调。
- 主题可在初始化后动态更新:调用门面 setup/update 或重新挂载;不需要重建 IMLib 客户端。
destroy()只销毁组件实例,不断开 IMLib 连接;IMLib 的 disconnect 由宿主控制。