本文介绍如何运行示例源码，指引分为两部分：

1. 示例源码运行指引
2. 示例源码工程简介

1 示例源码运行指引

1.1 准备环境

请确保开发环境满足以下技术要求：

• Xcode 14.0 或以上版本。
• iOS 11.0 或以上版本的 iPhone 真机或者模拟器（iPad 真机及模拟器无法正常运行全部功能）。
• iOS 设备已经连接到 Internet。

1.2 前提条件

已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理 中的“项目信息”。

1.3 运行示例源码

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

2. 使用 Xcode 打开 ZegoWhiteboardExample.xcworkspace。

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

b. 在解压后的示例源码文件夹中选择 “ZegoWhiteboardExample.xcworkspace”，并单击 “Open”。

3. 登录 Apple ID 账号。

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

b. 单击 “Account” 选项卡，单击左下角的 “+” 号，选择添加 Apple ID 后单击 “Continue”。

c. 输入 Apple ID 和密码以登录。

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

a. 打开 Xcode，单击左侧的 “ZegoWhiteboardExample” 项目。

b. 单击 “Signing & Capabilities” 选项卡，在 Team 中选择自己的开发者证书。

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

6. 将 iOS 设备连接到开发电脑，单击 Xcode 左上角的 "Generic iOS Device" 选择该 iOS 真机设备。

7. 切换到 Podfile 文件所在的文件夹，在终端运行 pod install 命令，然后等待 pod 加载完毕。

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

2 示例源码工程简介

2.1 界面简介

示例源码主要分为两个页面：

1. 登录页面
2. 白板文件展示和操作页面

登录页面如下：

登录成功后，白板文件展示和操作页面如下：

2.2 功能区说明

白板文件展示和操作页面的功能区主要集成了白板的绘制功能，新增白板功能以及文件的上传和缓存等功能。

功能区的 UITableView 的数据源来自 plists 文件，如下图所示。程序会根据 plist 文件里面的数据源模型的 eventNumber 字段去匹配对应的接口调用。

如果需要新增功能可以通过修改 plist 文件实现。其对应关系如下。

• 绘制 —— ZegoDrawPannel.plist
• 白板 —— ZegoWhiteboardPannel.plist
• 文件 —— ZegoDocsPannel.plist