集成

更新时间：2023-05-15 17:25

1 前提条件

由于 ZegoWhiteboardView SDK 需要与 ZegoExpress-Video SDK（含白板功能）搭配使用，请同时集成 ZegoExpress-Video SDK（含白板功能），详情请参考实时音视频的快速开始 - 集成。
- 互动白板 SDK 中已包含 ZegoExpress-Video SDK（含白板功能），无需单独下载。
- 如已集成过 ZegoExpress-Video SDK，需要删除旧包并重新集成互动白板 SDK 中获取的包，避免 ZegoExpress-Video SDK 和 ZegoWhiteboardView SDK 版本不匹配造成初始化失败。

如果需要使用文件共享功能，请下载 ZegoDocsView SDK。

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

此步骤以如何创建新项目为例，如果是集成到已有项目，可忽略此步。

启动 Xcode，在 “Welcome to Xcode” 窗口中单击 “Create a new Xcode project” 或选择 “File > New > Project” 菜单。在出现的表单中，选择 iOS 平台，并在 “Application” 下选择 “App”。
填写表单并选取各个选项来配置项目，单击 “Next”。

必须提供 “Product Name” 和 “Organization Identify”，用于创建在整个系统中标识 App 的 “Bundle Identify”。

开发者可通过以下任意一种方式实现集成 SDK。

安装 CocoaPods，安装方法及常见问题请参考 CocoaPods 常见问题 - 安装 CocoaPods。
打开终端，进入项目根目录，执行 pod init 命令创建 Podfile 文件。
打开 Podfile 文件，添加 pod 'ZegoWhiteboardView/Express'。
执行 pod install 命令安装 SDK。
在工程中导入 ZegoWhiteboardView SDK 头文件 #import <ZegoWhiteboardView/ZegoWhiteboardView.h>。

SDK 库文件中包含 iphoneos 和 iphoneos_simulator 两个文件夹，区别如下：

iphoneos 仅用于真机调试。用户在最终发布时，需要使用此文件下的 ZegoWhiteboardView.framework，否则可能被苹果打回。
iphonos_simulator 包含了真机和模拟器调试的库。如果用户开发过程中使用模拟器调试，需要导入此文件夹下的 ZegoWhiteboardView.framework。但是最终发布时，要切换回 iphoneos 文件下的 framework。

在下面的设置步骤中，请选择符合开发要求的 framework 文件。

请参考下载 SDK 包，下载最新版本的 SDK，下载完成后进行解压。
手动将 SDK 动态库文件，拷贝到项目目录下。
打开 Xcode，选择 “File > Add Files to "xxx"（xxx 为项目名）” 菜单，添加 SDK 库文件到项目。
选择 “TARGETS > General > Frameworks,Libraries,and Enbedded Content” 菜单，添加 “ZegoWhiteboardView.framework”，将 “Embed” 设置为 “Embed & Sign”。
选择 “TARGET > General > Deployment Target”，设置 8.0 或以上版本。