本文主要介绍如何快速将 RTC Room Engine SDK 集成到您的 iOS 项目中。
开发环境要求
Xcode 15 及以上。
iOS 13.0 及以上。
项目已配置有效的开发者签名。
集成 SDK
方案一:使用 CocoaPods
安装 CocoaPods
在终端窗口中输入如下命令(需要提前在 Mac 中安装 Ruby 环境):
sudo gem install cocoapods
创建 Podfile 文件
进入项目所在路径输入以下命令行,之后项目路径下会出现一个 Podfile 文件。
编辑 Podfile 文件
请您按照如下方式设置 Podfile 文件:
platform :ios, '13.0'
target 'App' do
use_frameworks!
pod 'RTCRoomEngine'
end
更新并安装 SDK
在终端窗口中输入如下命令以更新本地库文件,并安装 Chat SDK:
或使用以下命令更新本地库版本:
pod 命令执行完后,会生成集成了 SDK 的 .xcworkspace 后缀的工程文件,双击打开即可。若 pod 搜索失败,建议尝试更新 pod 的本地 repo 缓存。更新命令如下:
pod setup
pod repo update
rm ~/Library/Caches/CocoaPods/search_index.json
方案二:使用 Spm
1. 打开您的 Xcode 项目,在 Xcode 菜单依次单击 File > Add Package Dependencies…。
3. 选择 Dependency Rule 为 Branch,分支名为 main,或者选择您需要的版本号,Add to Project 选择当前项目。
4. 单击 Add Package 进入设置 target 界面。
5. 单击 Add Package 完成集成。
引用 RoomEngine SDK
然后在项目需要使用 SDK API 的文件里,引入 RoomEngine 模块。
常见问题
Xcode 15 开发者沙盒选项问题
Sandbox: bash(xxx) deny(1) file-write-create
当您使用 Xcode 15 创建一个新工程时, 可能会因为此选项导致编译运行失败,建议您关闭此选项。
本页内容是否解决了您的问题?