跑通示例源码

1 概览

本文介绍如何快速跑通示例源码，体验即时通讯服务。

2 准备环境

在运行示例源码前，请确保开发环境满足以下要求：

• Xcode 7.0 或以上版本。
• iOS 9.0 或以上版本且支持音视频的 iOS 设备或模拟器（推荐使用真机）。
• iOS 设备已经连接到 Internet。

3 前提条件

• 请联系 ZEGO 技术支持，申请需要接入 SDK 服务所需的 AppID 和 ServerSecret。
• 请先获取登录 SDK 所需的 Token，详情请参考 使用 Token 鉴权。

4 示例源码目录结构

下列结构为 IM 源码文件的子目录结构，下文所涉及的文件路径均为相对于此目录的路径。

├── ZIMExampleLegacy
│   ├── AppDelegate.h
│   ├── AppDelegate.m
│   ├── Assets.xcassets
│   ├── Base.lproj
│   ├── HUD
│   ├── Info.plist
│   ├── Login
│   ├── MJRefresh
│   ├── Peer
│   ├── PeerMenu
│   ├── Room
│   ├── RoomMenu
│   ├── TabBar
│   └── main.m
├── ZIMExampleLegacy.xcodeproj
│   ├── project.pbxproj
│   ├── project.xcworkspace
│   └── xcuserdata
├── ZIMManager
│   ├── KeyCenter.h
│   ├── KeyCenter.m
│   ├── ZGZIMManager.h
│   └── ZGZIMManager.m
└── libs
    └── IOS

5 运行示例源码

1. 打开 “AppStore”，搜索 “Xcode” 并下载安装。

   

2. 使用 Xcode 打开 “ZIMExampleLegacy.xcodeproj” 文件。

   1. 打开 Xcode，选择左上角的菜单 “File > Open...”。

      

   2. 在解压后的示例源码文件夹中，找到 “ZIMExampleLegacy.xcodeproj” 文件打开。

3. 请参考 下载 SDK，下载最新版本的 SDK 包，解压后，将文件拷贝到示例源码的 “ZIMExampleLegacy/libs/IOS” 目录下，替换掉旧的 SDK 包。

4. 登录 Apple 开发者账号。

   1. 打开 Xcode，选择左上角的菜单 “Xcode > Preferences...”。

      

   2. 单击 “Accounts” 选项卡，单击左下角的 “+”，选择添加 “Apple ID”，单击 “Continue”。

      

   3. 输入 Apple ID 和 Password 登录。

      

5. 修改 Bundle Identifier 和开发者证书。

   1. 打开 Xcode，单击左侧的 “ZIMExampleLegacy” 项目。

      

   2. 打开 TARGETS 选项，单击 “Signing & Capabilities” 选项卡，修改项目的 Bundle Identifier，选择自己的开发者证书。

      

6. 下载的示例源码中缺少 SDK 初始化所需的 AppID 和 Secret，需要修改 “ZIMManager” 文件夹下的 “KeyCenter.m” 文件，请使用本文 3 前提条件 已获取的 AppID 和 Secret 正确填写，否则示例源码无法正常运行。

   + (unsigned int)appID {
       return 1333333333; // Please enter your AppID
   }
   + (NSString *)Secret{
   return @"Secret"; // Please enter your Secret
   }

7. 将 iOS 设备连接到开发电脑，并在 Xcode 选择该设备。

   

8. 单击 Xcode 左上角的 “Build” 按钮编译和运行示例源码。