Global IM UIKit 快速开始

本页用 5 步完成 Global IM UIKit 接入：导入 ImpIaaSIMUIKit → 初始化 IMLib 客户端 → 创建 ViewModel → 组装 ViewController → 运行并验证（会话列表 / 聊天 / 发送 / 已读 / 主题）。Swift 与 Objective-C 示例并列给出。

1. 环境与导入

   iOS 13+、Xcode 15+；CocoaPods 添加 `ImpIaaSIMUIKit`（自动依赖 IMLib / IMKit），或 SPM 添加包。

2. 初始化 IMLib

   `ImpIaaSIM.client(options:)` 创建客户端并 `connect`；UIKit 不重复建连。

3. 创建 ViewModel

   用客户端创建 `ChatListViewModel` / `ChatViewModel`，注入 DataSource / options。

4. 组装 ViewController

   把 ViewModel、Theme、Delegate 传给 `ChatListViewController` / `ChatViewController`。

5. 运行与验证

   进入会话列表 → 打开聊天 → 发送文本 → 已读/撤回 → 切换主题；宿主实现 Delegate 的导航与详情。

1. 环境与导入​

# Podfile
platform :ios, '13.0'
target 'YourApp' do
  pod 'ImpIaaSIMUIKit', '~> 1.0'   # 自动依赖 ImpIaaSIM / ImpIaaSIMKit
end

// Package.swift 或 Xcode → Add Package Dependencies
.package(url: "https://example.com/ImpIaaSIMUIKit.git", from: "1.0.0")

2. 初始化 IMLib​

import ImpIaaSIM
import ImpIaaSIMUIKit

let client = ImpIaaSIM.client(options: IMPClientOptions(
    appkey: "YOUR_APP_KEY",
    serverUrl: "https://im.example.com"
))
let res = await client.connect(token: TOKEN)
if res.code != 0 { print("connect failed:", res.code, res.msg ?? "") }

#import <ImpIaaSIM/ImpIaaSIM.h>
#import <ImpIaaSIMUIKit/ImpIaaSIMUIKit.h>

IMPOSClient *client = [[IMPOSClient alloc] initWithAppkey:@"YOUR_APP_KEY"
                                                serverUrl:@"https://im.example.com"];
[client connectWithToken:TOKEN completion:^(IMPOSResult *result) {
    if (result.code != 0) { NSLog(@"connect failed: %ld %@", (long)result.code, result.msg); }
}];

3. 创建 ViewModel​

// 会话列表状态机
let listViewModel = IMPChatListViewModel(
    client: client,
    dataSource: nil,
    options: nil
)

// 聊天页状态机（单聊示例）
let chatViewModel = IMPChatViewModel(
    client: client,
    conversationType: .privateChat,
    targetId: "user2",
    options: nil
)

IMPOSGlobalChatListViewModel *chatListViewModel =
    [[IMPOSGlobalChatListViewModel alloc] initWithClient:client dataSource:nil options:nil];

IMPOSGlobalChatViewModel *chatViewModel =
    [[IMPOSGlobalChatViewModel alloc] initWithClient:client conversationType:1 /* 单聊 */ targetId:@"user2" options:nil];

ViewModel 的事件：stateChanged(state)、error(err) / messagesChanged(change)、sendStateChanged(localId,state)、typingChanged(userId,typing)。

4. 组装 ViewController​

// 组装 Global UIKit 会话列表页并交给宿主导航
let listViewController = IMPChatListViewController(
    viewModel: listViewModel,
    theme: .light,
    delegate: nil,
    options: nil
)
navigationController.pushViewController(listViewController, animated: true)

5. 运行与验证​

• 会话列表：进入页面后 ViewModel 触发加载，列表展示会话、未读与连接态横幅。
• 聊天：点击会话由宿主 push `ChatViewController`；发送文本后气泡经历发送中 → 已发送 → 已读。
• 已读/撤回：进入会话自动已读（可关闭），撤回消息替换为占位。
• 主题：运行中切换 `ChatUITheme`，页面即时生效，无需重建。
• 两个账号验证收发：同进程只允许一个登录态，用两台模拟器或真机 + 模拟器。

组件索引​

下一步：架构分层、与 IMKit 的关系与迁移、主题定制。