文档概览/
Live/
SDK/
iOS/
Get Started/
Step1: Install SDK/

Step1: Install SDK

本文主要介绍如何快速将 RTC Room Engine SDK 集成到您的 iOS 项目中。

开发环境要求

Xcode 15 及以上。
iOS 13.0 及以上。
CocoaPods 环境安装，点击查看。
项目已配置有效的开发者签名。

集成 SDK

方案一：使用 CocoaPods

安装 CocoaPods

在终端窗口中输入如下命令（需要提前在 Mac 中安装 Ruby 环境）：
sudo gem install cocoapods

创建 Podfile 文件

进入项目所在路径输入以下命令行，之后项目路径下会出现一个 Podfile 文件。
pod init

编辑 Podfile 文件

请您按照如下方式设置 Podfile 文件：
platform :ios, '13.0'

target 'App' do
  use_frameworks!
  # 添加 RoomEngine SDK
  pod 'RTCRoomEngine'
end

更新并安装 SDK

在终端窗口中输入如下命令以更新本地库文件，并安装 Chat SDK：
pod install
或使用以下命令更新本地库版本：
pod update
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…。
2. 在弹出的对话框右上角输入网址: https://github.com/Tencent-RTC/RTCRoomEngine_SwiftPM.git。
3. 选择 Dependency Rule 为 Branch，分支名为 main，或者选择您需要的版本号，Add to Project 选择当前项目。


4. 单击 Add Package 进入设置 target 界面。



5. 单击 Add Package 完成集成。

引用 RoomEngine SDK

然后在项目需要使用 SDK API 的文件里，引入 RoomEngine 模块。
import RTCRoomEngine

常见问题

Xcode 15 开发者沙盒选项问题

Sandbox: bash(xxx) deny(1) file-write-create



当您使用 Xcode 15 创建一个新工程时， 可能会因为此选项导致编译运行失败，建议您关闭此选项。