iOS（UIKit）

下载
聚焦模式
字号
最后更新时间： 2026-09-11 18:12:13
本文介绍如何快速跑通 IM Demo 来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示：
登录页
会话列表页
聊天页
﻿
﻿
﻿
快速体验
您可以点击该页面扫码下载 iOS App，体验详细的即时通信功能：体验 Demo。
前提条件
开通服务
1. 登录控制台。如果您已有应用，请记录其 SDKAppID 及 SDKSecretKey 并直接跳转到下一节。
2. 在概览面板单击创建按钮，开始创建新应用。
﻿
3. 在创建应用弹框中填入应用名称，选择产品为 Chat。
﻿
4. 选择完产品后，会显示出部署区域，请按需选择。
﻿
5. 创建完成后，可在控制台概览面板查看新建应用的 SDKAppID、SDKSecretKey，后续运行 Demo 时需要用到这两个信息。
﻿
禁止：
请妥善保管 SDKSecretKey，谨防泄露！
环境准备
在开始之前，请确保您已满足下列要求：
Xcode：16.0 或以上版本（推荐 Xcode 16.x 系列）。
iOS：14.0 及以上真机（暂时不支持模拟器）。
CocoaPods：1.12.0 及以上版本（推荐 1.16.x）。如尚未安装，请参考 CocoaPods Getting Started 进行安装。
一个有效的 Chat 应用。请参考上文 “开通服务” 章节获取或创建。
操作步骤
本 Demo 基于 TUIKit 构建，提供登录、会话、聊天、联系人等完整体验。请先完成上文 前提条件 中的开通服务与环境准备，再按以下步骤跑通。
获取并配置 Demo
1. 从 CNB 或者 GitHub 克隆 TUIKit 开源工程。
# 从 CNB 中克隆代码 
git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS.git
﻿
# 从 GitHub 中克隆代码 
git clone https://github.com/Tencent-RTC/TUIKit_iOS.git  
Chat 的 Demo 位于仓库的 chat 目录下，并依赖仓库根目录的 call/TUICallKit_Swift 组件。demo 已在 Podfile 文件中按相对路径引入该模块，克隆后无需额外配置依赖路径。整体结构如下：
TUIKit_iOS/
├── call/
│   └── TUICallKit_Swift.podspec     # 音视频通话组件（Chat 依赖）
└── chat/
    ├── demo/                        # Chat View 版示例工程（在此打开并运行）
    └── uikit/                       # Chat View 版 UI 组件库（TUIChatKit）
2. 双击文件 chat/demo/ChatDemo.xcworkspace，打开 Demo 的 Xcode 工程文件。
3. 找到 GenerateTestUserSig.swift 文件（路径：chat/demo/ChatDemo/GenerateTestUserSig.swift），设置以下参数：
SDKAPPID：请设置为前文 “开通服务” 中获取的实际应用 SDKAppID。
SECRETKEY：请设置为前文获取的实际密钥信息。
禁止：
Demo 中登录时获取 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
编译并运行 Demo
1. 终端执行以下命令，安装依赖库。
cd chat/demo
pod install
说明：
如果安装失败，执行 pod repo update 命令更新本地的 CocoaPods 仓库列表。
2. 双击 Demo 目录下的 ChatDemo.xcworkspace，运行项目。
3. 将 iOS 设备连接至电脑，在设备上选择设置 > 隐私与安全性 > 开发者模式，打开开发者模式。在 Xcode 界面顶部的 iOS Device 选项中选择您用来测试的 iOS 设备。
﻿
注意：
Demo 默认集成了音视频通话功能，由于该功能依赖的音视频 SDK 暂不支持模拟器，请使用真机调试或者运行 Demo。
4. 在项目 TARGETS 的 Signing & Capabilities 界面勾选 Automatically manage signing，然后在每一个 Target 下配置您的苹果开发者账号和 Bundle Identifier。如果尚未在 Xcode 中登录 Apple ID，请先在 Xcode > Preferences > Accounts 中添加您的开发者账号或 Apple ID。
﻿
5. 点击运行按钮开始编译。编译成功后，您的设备上会自动安装好腾讯云 IM App。
6. 打开 App，输入任意 UserID 即可创建并登录用户账号。
7. 为方便测试消息互通，可用两个不同的 UserID 分别登录，互相添加好友后即可收发消息。添加好友的操作路径如下：
切换到底部的通讯录标签页。
点击右上角的加号按钮，在弹出的菜单中选择添加好友。
输入对方的 UserID 完成添加，随后双方即可互相发送消息。
常见问题
若执行 pod install 时提示 pod 不存在，或 pod 版本小于 1.7.5，请执行以下命令安装最新 pod。
# 1. 更换 gem 源，
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
﻿
# 2. 安装 pod 
sudo gem install cocoapods -n /usr/local/bin
# 如果安装了多个 Xcode ，请使用下面的命令选择 Xcode 版本（一般选择最新的 Xcode 版本）。
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
﻿
# 3. 更新 pod 本地库
pod setup
不受信任开发者
如果您在真机上进行调试，编译成功后 iOS 设备上弹出不受信任的开发者提示，则先点击取消关闭该提示，然后在 iOS 设备上选择设置 > 通用 > VPN 与设备管理，在开发者 App 中选择信任该开发者，然后再打开 Demo App 进行体验。
表情包的使用
为了尊重版权，IM Demo 工程中包含的大表情元素切图，在正式上线商用前，请您替换为自己设计或拥有版权的其他表情包。请注意，下图所示的默认小黄脸表情包版权属于腾讯云，您可以通过升级至 IM 企业版套餐 免费使用该表情包。
﻿
﻿
﻿
联系我们
如果您在接入或使用过程中有任何疑问或者建议，欢迎 联系我们 提交反馈。