TIMSDK/Mac/README.md

English | 简体中文

This document introduces how to quickly run through the IM demo.

Step 1. Create an App

1. Log in to the IM console.

If you already have an app, record its SDKAppID and obtain key information.

2. On the Application List page, click Create Application.
3. In the Create Application dialog box, enter the app information and click Confirm. After the app is created, an app ID (SDKAppID) will be automatically generated, which should be noted down.

Step 2: Obtain Key Information

1. Click Application Configuration in the row of the target app to enter the app details page.
2. Click View Key and copy and save the key information.

! Please store the key information properly to prevent disclosure.

Step 3: Download and Configure the Demo Source Code

1. Clone the IM demo project from GitHub.
2. Open the project in the terminal directory and find the GenerateTestUserSig file.

Platform	Relative Path to File
Android	Android/Demo/app/src/main/java/com/tencent/qcloud/tim/demo/signature/GenerateTestUserSig.java
iOS	iOS/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
macOS	Mac/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
Windows	Windows/Demo/IMApp/GenerateTestUserSig.h
Web (general)	Web/Demo/public/GenerateTestUserSig.js
Mini Program	MiniProgram/Demo/static/utils/GenerateTestUserSig.js

? In this document, an Android project is opened by using Android Studio as an example.

3. Set relevant parameters in the GenerateTestUserSig file:

• SDKAPPID: set it to the SDKAppID obtained in Step 1.
• SECRETKEY: enter the key obtained in Step 2.

! In this document, the method to obtain UserSig is to configure a SECRETKEY in the client code. In this method, the SECRETKEY is vulnerable to decompilation and reverse engineering. Once your SECRETKEY is leaked, attackers can steal your Tencent Cloud traffic. Therefore, this method is only suitable for locally running a demo project and feature debugging. The correct UserSig distribution method is to integrate the calculation code of UserSig into your server and provide an application-oriented API. When UserSig is needed, your app can send a request to the business server for a dynamic UserSig. For more information, please see How do I calculate UserSig on the server?.

Step 4: Compile and Run the Demo

1. Run the following command on the terminal to check the pod version:

pod --version

If the system indicates that no pod exists or that the pod version is earlier than 1.7.5, run the following commands to install the latest pod.

// Change sources.
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
// Install pod.
sudo gem install cocoapods -n /usr/local/bin
// If multiple versions of Xcode are installed, run the following command to choose an Xcode version (usually the latest one):
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
// Update the local pod library.
pod setup

2. Run the following commands to load the IMSDK library.

cd Mac/TUIKitDemo
pod install

3. If installation fails, run the following command to update the local CocoaPods repository list:

pod repo update

4. Go to the Mac/TUIKitDemo folder, and open TUIKitDemo.xcworkspace to compile and run the demo.