本文介绍如何快速跑通 IM Demo 来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示：
登录页 | 会话列表页 | 聊天页 |
 |  |  |
快速体验
前提条件
开通服务
1. 登录 即时通信 IM 控制台。如果您已有应用，请记录其 SDKAppID 和密钥信息。
2. 在应用管理页面，单击创建新应用。
3. 输入应用名称、选择合适的数据中心，单击确定即可完成应用的创建。
4. 在应用管理页面的 SDKAppID 列获取 SDKAppID 和密钥信息。
注意：
1. 查看密钥信息需要验证身份。
2. 密钥信息为敏感信息，为防止他人盗用，请妥善保管，谨防泄露。
环境准备
在开始之前，请确保您已满足下列要求：
Xcode 10 及以上版本。
iOS 9.0 及以上真机或模拟器。
CocoaPods 1.7.5 及以上版本。如尚未安装，请参考 CocoaPods Guides - Getting Started 进行安装。
一个有效的 Chat 应用。请参考上文 “开通服务” 章节获取或创建。
操作步骤
您可以参考视频教程来快速跑通：
也可以参考下文了解具体步骤。
获取 Demo
说明：
为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。在正式上线商用前，请您替换为自己设计或拥有版权的其他表情包。请注意，下图所示的默认小黄脸表情包版权属于腾讯云，您可以通过升级至 IM 企业版套餐 免费使用该表情包。
1. 下载 Swift Chat UIKit 工程。
2. 打开所属终端目录的工程，找到对应的
GenerateTestUserSig.swift 文件。 iOS 路径：Chat_UIKit/Swift/TUIKitDemo/TUIKitDemo/Private/GenerateTestUserSig.swift
3. 设置
GenerateTestUserSig.swift 文件中的相关参数：public_SDKAPPID：请设置为前文中获取的实际应用 SDKAppID。
public_SECRETKEY：请设置为前文中获取的实际密钥信息。
1. SDK 下载 页面。
2. 打开所属终端目录的工程，找到对应的
GenerateTestUserSig.h 文件。2.1 iOS 路径：iOS/Demo/TUIKitDemo/Private/GenerateTestUserSig.h
2.2 Mac 路径：Mac/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
3. 设置
GenerateTestUserSig.h 文件中的相关参数：SDKAPPID：请设置为前文中获取的实际应用 SDKAppID。
SECRETKEY：请设置为前文中获取的实际密钥信息。
注意：
本文提到的获取 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
配置 Demo
终端执行以下命令，安装依赖库。
// iOScd Swift/TUIKitDemopod install
// iOScd iOS/TUIKitDemopod install// Maccd Mac/TUIKitDemopod install
说明：
如果安装失败，执行
pod repo update 命令更新本地的 CocoaPods 仓库列表。编译并运行 Demo
注意：
Demo 默认集成了音视频通话功能，由于该功能依赖的音视频 SDK 暂不支持模拟器，请使用真机调试或者运行 Demo。
双击 Demo 目录下的
TUIKitDemo.xcworkspace，运行项目：1. Swift 项目进入 Swift/TUIKitDemo 文件夹，打开
TUIKitDemo.xcworkspace 编译运行。2. OC 项目进入 iOS/TUIKitDemo 文件夹，打开
TUIKitDemo.xcworkspace 编译运行。进入 Mac/TUIKitDemo 文件夹，打开
TUIKitDemo.xcworkspace 编译运行。以运行 iOS 设备为例：
1. 将 iOS 设备连接至电脑，在设备上选择设置 > 隐私与安全性 > 开发者模式，打开开发者模式。
2. 在 Xcode 界面顶部的 iOS Device 选项中选择您用来测试的 iOS 设备。
3. 在项目 TARGETS 的 Signing & Capabilities 界面勾选 Automatically manage signing，然后在每一个 Target 下配置您的苹果开发者账号和 Bundle Identifier。如果尚未在 Xcode 中登录 Apple ID，请先在 Xcode > Preferences > Accounts 中添加您的开发者账号或 Apple ID。
4. 点击运行按钮开始编译。编译成功后，您的设备上会自动安装好腾讯云 IM App。
5. 打开 App，输入任意 userid 即可创建并登录用户账号。
6. 为方便测试消息互通，您可以创建两个不同的用户账号，添加好友后互相发送消息。
1、添加好友 | 2、搜索好友 | 3、通讯录新增好友 | 4、与好友聊天 |
 |  |  |  |
开通云端审核功能
在消息发送、资料修改等场景中，可能会扩散不合适的内容，特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容，不仅严重损害了用户们的身心健康，还有可能违法并导致业务被监管部门查封。
即时通信 IM 支持云端审核（反垃圾信息）功能，可针对不安全、不适宜的内容进行自动识别、处理，为您的产品体验和业务安全保驾护航。您可直接前往 云端审核控制台 开通免费试用，每个应用可免费试用7天（含10000次免费抵扣量）。
常见问题
1. 若执行 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. 安装 podsudo gem install cocoapods -n /usr/local/bin# 如果安装了多个 Xcode ，请使用下面的命令选择 Xcode 版本（一般选择最新的 Xcode 版本）。sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer# 3. 更新 pod 本地库pod setup
2. 找不到兼容的 TUICore 版本
使用 CocoaPods 获取 Demo 时，当
Podfile.lock 文件中锁定的版本与插件依赖的 TUICore 版本不兼容时，您可能会遇到下列报错：CocoaPods could not find compatible versions for pod "TUICore"
请按照下列步骤来操作：
1. 在您的 Demo 项目根目录下运行下列命令删除
Podfile.lock 文件：rm Podfile.lock
2. 运行下列命令更新本地代码仓库：
pod repo update
3. 运行下列命令重新安装：
pod update
操作完成后，您会看到生成新的
Podfile.lock 文件并可以正常安装依赖。3. 不受信任开发者
如果您在真机上进行调试，编译成功后 iOS 设备上弹出不受信任的开发者提示，则先点击取消关闭该提示，然后在 iOS 设备上选择设置 > 通用 > VPN 与设备管理，在开发者 App 中选择信任该开发者，然后再打开 Demo App 进行体验。
