本文介绍如何获取灵动课堂 iOS 端 GitHub 源码并运行项目,快速启动并体验灵动课堂。
下图展示了启动灵动课堂的基本流程。
当你的 app 客户端请求加入灵动课堂时:
在你的设备上运行灵动课堂依赖于 Xcode 和 CocoaPods。
你可参考以下步骤准备开发环境:
灵动课堂 iOS 端的源码位于 GitHub CloudClass-iOS 仓库和 apaas-extapp-ios 仓库。你可参考以下步骤获取源码:
运行以下命令将 CloudClass-iOS 仓库克隆到本地:
git clone https://github.com/AgoraIO-Community/CloudClass-iOS.git
运行以下命令进入 CloudClass-iOS 目录并切换分支至指定版本。将 {VERSION} 替换为要切换的版本号:
cd CloudClass-iOS
git checkout release/{VERSION}
例如要切换到 2.6.1 版本分支,执行以下命令:
git checkout release/2.6.1
声网建议你切换到最新发版分支。参考下图在 GitHub 仓库中查看最新发版分支:
运行以下命令将 apaas-extapp-ios 仓库克隆到本地。
git clone https://github.com/AgoraIO-Community/apaas-extapp-ios.git
apaas-extapp-ios 仓库需要和 CloudClass-iOS 仓库位于同一目录下,如下图所示:
运行以下命令进入 apaas-extapp-ios 目录并切换分支至指定版本。将 {VERSION} 替换为要切换的版本号(建议与 CloudClass-iOS 的版本保持一致):
cd apaas-extapp-ios
git checkout release/{VERSION}
按照以下步骤启动灵动课堂:
运行以下命令进入 CloudClass-iOS/App 目录:
cd CloudClass-iOS/App
运行以下命令安装依赖包。
pod install
如下图所示:
成功安装依赖包后,在“访达”窗口中打开 CloudClass-iOS 文件夹,双击 AgoraEducation.xcworkspace
在 Xcode 中打开项目。
在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的 Apple 开发者账号和 Bundle Identifier。
连接上你的 iOS 设备后,点击 Xcode 左上角的运行按钮运行项目。
运行成功后,你可以在 iOS 设备上看到以下画面。输入房间名、用户名,选择一种班型,然后点击加入,即可进入灵动课堂。
现在你已经初步体验了灵动课堂的功能,接下来可将灵动课堂集成到你自己的项目中。