git clone https://github.com/Tencent-RTC/TUIKit_iOS_SwiftUI.git

YourApplication/
├── source/                 # 您的工程代码
├── chat/                   # Chat 源码
│   ├── demo/               # 示例工程
│   ├── demo_mini/          # 最小示例工程
│   └── uikit/              # TUIChatKit 组件库
│         ├── TUIChatKit_Swift.podspec
│         ├── components/     # UI 组件
│         ├── page/           # 完整页面
│         └── resources/      # 图片及本地化资源    
├── Podfile                   # 依赖配置文件
├── YourApplication.xcworkspace     # 您的项目文件

import AtomicXCore

// let yourSdkAppID: Int32 = 10_000_000_00  替换为您的实际 SDKAppID
// let testUserID = "testUserID"            替换为您的测试用户 ID
// let userSig = "xxxxxxx"                  该用户对应的 UserSig，从步骤1的控制台获取

LoginStore.shared.login(sdkAppID: yourSdkAppID, userID: testUserID, userSig: userSig) { result in
    DispatchQueue.main.async {
        switch result {
        case .success:
            // 进入会话列表界面等（步骤3）
        case .failure(let error):
            print("login failed: \\(error.code) \\(error.message)")
        }
    }
}


import SwiftUI
import AtomicXCore
import TUIChatKit_Swift

// 进入会话列表页面
NavigationLink(destination: ConversationsDestination())

private struct ConversationsDestination: View {
    @State private var navigationInfo: NavigationInfo?
    @State private var showChat = false

    var body: some View {
        ConversationsPage(
            config: nil,                    // 会话操作配置，nil 使用默认配置
            onConversationClick: { info in  // 会话打开回调，返回会话及可选的定位消息
                navigationInfo = info
                showChat = true
            }
        )
        .navigationBarHidden(true)
        .background(chatNavigationLink)
    }

    // 响应 onConversationClick 进入聊天页面，ChatPageDestination 的定义可以看步骤4构建聊天界面
    @ViewBuilder
    private var chatNavigationLink: some View {
        if let info = navigationInfo {
            NavigationLink(
                destination: ChatPageDestination(
                    conversation: info.conversation,
                    locateMessage: info.locateMessage
                ),
                isActive: $showChat
            ) { EmptyView() }
            .hidden()
        }
    }
}

import SwiftUI
import AtomicXCore
import TUIChatKit_Swift

// 进入单聊
NavigationLink(
    "进入单聊",
    destination: ChatPageDestination(conversation: makeTestC2CConversationInfo(), 
    locateMessage: nil)
)

private func makeTestC2CConversationInfo() -> ConversationInfo {
  var conversation = ConversationInfo(
      conversationID: ChatUtil.getC2CConversationID('test2')
  )
  conversation.type = .c2c
  conversation.title = "与 \\(MiniTestAccount.c2cChatUserID) 聊天"
  return conversation
}

// 进入群聊
NavigationLink(
    "进入群聊",
    destination: ChatPageDestination(conversation: makeTestGroupConversationInfo(), 
    locateMessage: nil)
)

private func makeTestGroupConversationInfo() -> ConversationInfo {
  var conversation = ConversationInfo(
      conversationID: ChatUtil.getGroupConversationID('testGroup')
  )
  conversation.type = .group
  conversation.title = "测试群：\\(MiniTestAccount.chatGroupID)"
  return conversation
}

private struct ChatPageDestination: View {
    @Environment(\\.dismiss) private var dismiss
    let conversation: ConversationInfo
    var locateMessage: MessageInfo? = nil

    var body: some View {
        ChatPage(
            conversation: conversation,      // 会话信息
            locateMessage: locateMessage,    // 需要定位的消息，nil 不指定定位消息
            messageListConfig: nil,          // 消息列表配置，nil 使用默认配置
            messageInputConfig: nil,         // 输入配置，nil 使用默认配置
            isShowMoreButton: false,         // 是否显示导航栏的更多按钮
            showsNavigationBar: true,        // 是否显示 SDK 自绘导航栏
            topBannerView: nil,              // 自定义顶部横幅，nil 不显示
            onBack: { dismiss() },           // 返回按钮点击回调
            onUserClick: nil,                // 用户点击回调，返回用户 ID
            onMoreClick: nil                 // 导航栏标题或更多按钮点击回调
        )
        .navigationBarHidden(true)
    }
}

import SwiftUI
import AtomicXCore
import TUIChatKit_Swift

private struct ContactsDestination: View {
    var body: some View {
        ContactsPage(
            config: nil,                      // 联系人列表配置，nil 使用默认配置
            onContactClick: { item in         // 联系人点击回调，进入联系人信息
                // openChat(makeC2CConversation(item))
            },
            onGroupClick: { item in           // 群点击回调，进入群信息
               // openChat(makeGroupConversation(item))
            }
        )
        .navigationBarTitleDisplayMode(.inline)
        .navigationBarHidden(true)
        // .background(chatNavigationLink)  // 挂载隐藏导航链接，用于打开聊天页
    }
}