一分钟跑通 Demo

最近更新时间:2019-09-17 10:45:04

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

步骤1:创建应用

  1. 登录即时通信 IM 控制台
    说明:

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

  2. 在【应用列表】页,单击【创建应用】。
  3. 在【创建新应用】对话框中,填写新建应用的信息,单击【确认】。
    应用创建完成后,自动生成一个应用标识 SDKAppID,请记录 SDKAppID 信息。

步骤2:获取密钥信息

  1. 单击目标应用所在行的【应用配置】,进入应用详情页面。
  2. 单击帐号体系集成右侧的【编辑】,配置帐号管理员信息,单击【保存】。
  3. 单击【查看密钥】,拷贝并保存密钥信息。
    注意:

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

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

  1. Github 克隆即时通信 IM Demo 工程。

  2. 打开所属终端目录的工程,找到对应的GenerateTestUserSig文件。

    所属平台 文件相对路径
    Android Android/app/src/main/java/com/tencent/qcloud/tim/demo/signature/GenerateTestUserSig.java
    iOS iOS/TUIKitDemo/TUIKitDemo/Debug/GenerateTestUserSig.h
    Mac Mac/TUIKitDemo/TUIKitDemo/Debug/GenerateTestUserSig.h
    Windows cross-platform/Windows/IMApp/IMApp/GenerateTestUserSig.h
    Web(通用) H5/dist/debug/GenerateTestUserSig.js
    小程序 WXMini/dist/wx/debug/GenerateTestUserSig.js
    说明:

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

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

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

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

步骤4:编译运行

用各端的 IDE 直接编译运行即可。

其中 iOS 和 Mac Demo 的编译运行需要使用 pod 集成,详情步骤如下:

  1. 终端执行以下命令,检查 pod 版本。
    pod --version
    若提示 pod 不存在,或 pod 版本小于 1.7.5,请执行以下命令安装最新 pod。
    //更换 gem 源
    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 库。
    //iOS
    cd iOS/TUIKitDemo
    pod install
    //Mac
    cd Mac/TUIKitDemo
    pod install
  3. 编译运行:
    • iOS 进入 iOS/TUIKitDemo 文件夹,打开TUIKitDemo.xcworkspace编译运行。
    • Mac 进入Mac/TUIKitDemo 文件夹,打开TUIKitDemo.xcworkspace编译运行。