tencent cloud

文档反馈

SDK 集成

最后更新时间:2024-12-20 17:37:26
    本文主要介绍如何快速将 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 创建一个新工程时, 可能会因为此选项导致编译运行失败,建议您关闭此选项。
    
    
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持