2024/01/25 11:27:25

部署场景

开发场景由三个环节组成：设计、预览、部署。本文介绍如何部署场景。

部署场景需要你先下载源代码，再本地集成。

下载源代码

参考如下步骤将源代码下载到本地：

点击下载源代码。
选中你想下载的源代码：
- 下载样式源代码：仅在部分情况下推荐使用，详见集成章节。
- 下载全量源代码：包含样式在内的全量源代码。

下载完毕后解压，你可以看到文件结构如下：

Shell
.
├── 101 Physics_fullcode
│   ├── android
│   │   └── CloudClass-Android
│   ├── ios
│   │   ├── CloudClass-iOS
│   │   └── apaas-extapp-ios
│   └── web
│       └── CloudClass-Desktop
└── 101 Physics_styling
    ├── android
    │   └── CloudClass-Android
    ├── ios
    │   ├── CloudClass-iOS
    │   └── apaas-extapp-ios
    └── web
        └── CloudClass-Desktop

其中：101 Physics_fullcode 和 101 Physics_styling 仅为示例文件名，由你的场景名称、下划线、源代码类型组成。

集成源代码

秒搭提供 Android、iOS、Web、Electron 平台的源代码。本节介绍如何在各平台集成全量源代码和样式源代码。

前提条件

在声网控制台获取 App ID 和 App 证书。
在声网控制台开通灵动课堂服务。
一个有效的 Apple 开发者账号。
一台 iOS 设备（iPhone 或 iPad）。模拟机可能出现功能缺失或者性能问题，所以推荐使用真机。此外，灵动课堂 iOS 端要求运行在 iOS 10 或以上版本。

准备开发环境

在你的设备上运行灵动课堂依赖于 Xcode 和 CocoaPods。

你可参考以下步骤准备开发环境：

打开 App Store，下载并安装 Xcode。要求 Xcode 12.5 或以上版本。
点击链接前往下载 CocoaPods。要求 CocoaPods 1.10 或以上版本。

注意

如果你使用 Swift 开发，需要使用 Swift 5.0 或以上版本。

集成全量源代码

运行以下命令进入 fullcode/ios/CloudClass-iOS/App 目录：
Shell
```
cd fullcode/ios/CloudClass-iOS/App
```
运行以下命令安装依赖包：
Shell
```
pod install
```
成功安装依赖包后，在“访达”窗口中打开 CloudClass-iOS/App 文件夹，双击 AgoraEducation.xcworkspace 并在 Xcode 中打开项目。
在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing，配置你的 Apple 开发者账号和 Bundle Identifier。
连接上你的 iOS 设备后，点击 Xcode 左上角的编译按钮运行项目。
编译成功后，你的场景项目会开始运行。输入房间名、用户名，选择一种班型，然后点击加入。

集成样式源代码

样式源代码不足以集成一个应用项目，仅能修改项目的样式。声网推荐你在如下情况使用样式源代码：

当你已有灵动课堂 aPaaS 项目，现在仅需修改样式。
当你已使用秒搭的全量源代码，现在仅需修改样式。

假设你已有的项目或全量源代码叫 CloudClass-iOS。集成样式源代码修改项目样式的步骤如下：

将样式源代码中部分文件复制到你已有项目中，替换详情如下：
- 将样式源代码中的 styling/ios/CloudClass-iOS/SDKs/AgoraEduUI/Classes/Configs/Scenes 文件夹目录下的所有 .swift 类型的文件复制到你已有项目中的 CloudClass-iOS/SDKs/AgoraEduUI/Classes/Configs/Scenes 文件目录下。
- 将样式源代码中的 styling/ios/CloudClass-iOS/SDKs/AgoraEduUI/Classes/Configs/Theme 文件夹目录下的所有 .swift 类型的文件复制到你已有项目中的 CloudClass-iOS/SDKs/AgoraEduUI/Classes/Configs/Theme 文件目录下。
- 将样式源代码中的 styling/ios/apaas-extapp-ios/AgoraWidgets/Common/UIConfigs/Scenes 文件夹目录下的所有 .swift 类型的文件复制到你已有项目中的 apaas-extapp-ios/AgoraWidgets/Common/UIConfigs/Scenes 文件目录下。
- 将样式源代码中的 styling/ios/apaas-extapp-ios/AgoraWidgets/Common/UIConfigs/Theme 文件夹目录下的所有 .swift 类型的文件复制到你已有项目中的 apaas-extapp-ios/AgoraWidgets/Common/UIConfigs/Theme 文件目录下。
如果复制过程中存在同名文件，请将样式源代码中的 .swift 文件替代已有项目中的 .swift 文件。
在“访达”窗口中打开 CloudClass-iOS/App 文件夹，双击 AgoraEducation.xcworkspace 并在 Xcode 中打开项目。如果不存在 .xcworkspace 文件，请先在 CloudClass-iOS/App 目录下运行 pod install。
在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing，配置你的 Apple 开发者账号和 Bundle Identifier。
连接上你的 iOS 设备后，点击 Xcode 左上角的编译按钮运行项目。
编译成功后，你的场景项目会开始运行。输入房间名、用户名，选择一种班型，然后点击加入。

下载源代码​

集成源代码​

前提条件​

准备开发环境​

集成全量源代码​