跑通示例源码

---

1 示例源码运行指引

本文介绍如何快速跑通示例源码，体验基础的 RoomKit 服务。

1.1 准备环境

在开始集成 RoomKit SDK 前，请确保开发环境满足以下要求：

1. Xcode 15.0 或以上版本。
2. iOS 12.0 或以上版本且支持音视频的 iOS 设备。
3. iOS 设备已经连接到 Internet。

1.2 前提条件

已在 RoomKit 管理后台 创建项目，并获取初始化 RoomKit SDK 所必须的 SecretID、SecretSign、ProductID等信息。详见 开通 RoomKit 服务。

1.3 运行示例源码

1. 请参考 下载 SDK 包，下载最新版本的 SDK，下载完成后进行解压。

2. 手动将 SDK 动态库文件 “ZegoRoomKitCore.xcframework” 等 7 个库以及 “ZegoRoomKitResources.bundle” 文件 ，拷贝到示例源码 Lib 目录下。 示例源码包含的三个文件夹对应的：

   
   
   如图中所示，示例源码包含以下三个文件夹：
   a. 文件夹 Lib 中存放需要导入的 SDK 包。
   b. 文件夹 roomkit_ios_demo 中存放示例源码的主工程。
   c. 文件夹 roomkit_ui_ios 中存放 UI 开源的工程。
   

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

   a. 打开 Xcode，单击左侧的 ZegoRoomkitDemo 项目。

   

   b. 分别选中 Target 和 Extension Target，单击 Signing & Capabilities 选项卡，将示例源码中的 Team、Bundle Identifier 和 App Groups，修改成开发者自己的值。

   Targets 中选择 ZegoRoomkitDemo 时，修改页面如下：

   

   Targets 中选择 ZegoRoomkitDemoScreenShare 时，修改页面如下：

若没有 App Groups 先进入苹果开发者中心配置：

4. 修改示例源码中 ZegoAuthConstants.h 文件，填充 kSecretID、kSecretSign 和 kProductID。请使用本文 前提条件 中获取的信息正确填写，否则示例源码无法正常运行。

   

5. 将 iOS 设备连接到开发电脑，单击 Xcode 左上角的 Generic iOS Device 选择 iOS 真机或者模拟器。

   

6. 单击 Xcode 左上角的 Build & Run 按钮，编译和运行示例源码。