TIMSDK/Mac/README_ZH.md

English | 简体中文

本文介绍如何快速跑通即时通信 IM 的体验 Demo。

步骤1：创建应用

1. 登录即时通信 IM 控制台。

如果您已有应用，请记录其 SDKAppID 并 配置应用。

2. 在应用管理页面，单击创建新应用，在弹出的对话框中输入应用名称，选择合适的数据中心，单击确定。
3. 创建完成后，可在应用管理页面查看、搜索、管理应用。请记录 SDKAppID 信息。

步骤2：获取密钥信息

1. 在应用管理页面的操作中单击查看密钥。
2. 在弹出的对话框中，单击显示密钥，复制并保存密钥信息。

请妥善保管密钥信息，谨防泄露。

步骤3：下载并配置 Demo 源码

1. 从 Github 克隆即时通信 IM Demo 工程。
2. 打开所属终端目录的工程，找到对应的GenerateTestUserSig文件。

所属平台	文件相对路径
Android	Android/Demo/app/src/main/java/com/tencent/qcloud/tim/demo/signature/GenerateTestUserSig.java
iOS	iOS/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
Mac	Mac/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
Windows	Windows/Demo/IMApp/GenerateTestUserSig.h
Web（通用）	Web/Demo/public/GenerateTestUserSig.js
小程序	MiniProgram/Demo/static/utils/GenerateTestUserSig.js

?本文以使用 Android Studio 打开 Android 工程为例。

3. 设置GenerateTestUserSig文件中的相关参数：

• SDKAPPID：请设置为 步骤1 中获取的实际应用 SDKAppID。
• SECRETKEY：请设置为 步骤2 中获取的实际密钥信息。

!本文提到的获取 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。 正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。

步骤4：编译运行

1. 终端执行以下命令，检查 pod 版本。

pod --version

如果提示 pod 不存在，或则 pod 版本小于 1.7.5，请执行以下命令安装最新 pod。

//更换源
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
//安装 pod
sudo gem install cocoapods -n /usr/local/bin
//如果安装了多个 Xcode ，请使用下面的命令选择 Xcode 版本（一般选择最新的 Xcode 版本）
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
//更新 pod 本地库
pod setup

2. 使用以下命令，加载 ImSDK 库。

cd Mac/TUIKitDemo
pod install

3. 如果安装失败，运行以下命令更新本地的 CocoaPods 仓库列表

pod repo update

4. 进入 Mac/TUIKitDemo 文件夹，打开 TUIKitDemo.xcworkspace 编译运行。