快速跑通灵动课堂 GitHub 项目

本文介绍如何获取灵动课堂 iOS 端 GitHub 源码并运行项目，快速启动并体验灵动课堂。

技术原理

下图展示了启动灵动课堂的基本流程。

当你的 app 客户端请求加入灵动课堂时：

1. 你的 app 客户端向 app 服务端申请 RTM Token。
2. 你的 app 服务端使用 Agora App ID、App 证书和用户 uuid 生成一个 RTM Token，返回给 app 客户端。详见生成 RTM Token。
3. 你的 app 客户端调用 API 并传入用户 ID、房间 ID 和 RTM Token 启动灵动课堂。灵动课堂云服务会根据你传入的房间 ID 为该课堂自动创建一个房间。

前提条件

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

准备开发环境

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

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

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

获取源码

灵动课堂 iOS 端的源码位于 GitHub CloudClass-iOS 仓库和 apaas-extapp-ios 仓库。你可参考以下步骤获取源码：

1. 运行以下命令将 CloudClass-iOS 仓库克隆到本地：

    git clone https://github.com/AgoraIO-Community/CloudClass-iOS.git

2. 运行以下命令进入 CloudClass-iOS 目录并切换分支至指定版本。将 {VERSION} 替换为要切换的版本号：

    cd CloudClass-iOS

    git checkout release/{VERSION}

   例如要切换到 2.6.1 版本分支，执行以下命令：

    git checkout release/2.6.1

   声网建议你切换到最新发版分支。参考下图在 GitHub 仓库中查看最新发版分支：

   

3. 运行以下命令将 apaas-extapp-ios 仓库克隆到本地。

    git clone https://github.com/AgoraIO-Community/apaas-extapp-ios.git

   apaas-extapp-ios 仓库需要和 CloudClass-iOS 仓库位于同一目录下，如下图所示：

   

4. 运行以下命令进入 apaas-extapp-ios 目录并切换分支至指定版本。将 {VERSION} 替换为要切换的版本号（建议与 CloudClass-iOS 的版本保持一致）：

    cd apaas-extapp-ios

    git checkout release/{VERSION}

启动灵动课堂

按照以下步骤启动灵动课堂：

1. 运行以下命令进入 CloudClass-iOS/App 目录：

    cd CloudClass-iOS/App

2. 运行以下命令安装依赖包。

    pod install

   如下图所示：

   

3. 成功安装依赖包后，在“访达”窗口中打开 CloudClass-iOS 文件夹，双击 AgoraEducation.xcworkspace 在 Xcode 中打开项目。

   

   

4. 在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing，配置你的 Apple 开发者账号和 Bundle Identifier。

   

5. 连接上你的 iOS 设备后，点击 Xcode 左上角的运行按钮运行项目。

   

6. 运行成功后，你可以在 iOS 设备上看到以下画面。输入房间名、用户名，选择一种班型，然后点击加入，即可进入灵动课堂。

   

后续步骤

现在你已经初步体验了灵动课堂的功能，接下来可将灵动课堂集成到你自己的项目中。