跳到主要内容

导入 SDK

融云支持使用 CocoaPods 添加远程依赖项、和手动导入 Framework 的方式将 IMLib SDK 集成到您的应用工程中。

RongIMLib 是融云即时通讯的核心能力库,功能包括:消息,会话,推送,聊天室等,以下简称 IMLib

  • 如果您需要自行编写 UI 界面,可以使用 IMLib
  • 如果您需要会话列表和会话页面等 UI 功能,请转至 IMKit 的文档。

环境要求

名称版本
Xcode11 +
iOS9.0 +
CocoaPods1.10.0 +

如需安装 CocoaPods 环境,请参照 安装 CocoaPods

检查版本

在导入 SDK 前,可以前往融云官网 SDK 下载页面确认当前最新版本号。

CocoaPods

融云支持使用 CocoaPods 导入并管理 IMLib SDK 。

pod 版本必须为 1.10.0 或更新版本。具体请查看知识库文档:

https://help.rongcloud.cn/t/topic/747

具体操作步骤如下:

  1. podfile 中添加如下内容:

    pod 'RongCloudIM/IMLib', '~> x.y.z'
    提示
  2. 请在终端中运行以下命令:

    pod install
    提示

    如果出现找不到相关版本的问题,可先执行 pod repo update,再执行 pod install

  3. 上一步完成后,CocoaPods 会在您的工程根目录下生成一个 xcworkspace 文件,只需通过 XCode 打开该文件即可加载工程。

手动集成

  1. 前往融云官网 SDK 下载页面,将 IMLib SDK 下载到本地。

  2. 将下载下来的 SDK 导入您的项目中,所需的 SDK 如下:

    Framework资源文件
    IMLib
    • RongIMLib.xcframework
    • RongIMLibCore.xcframework
    • RongChatRoom.xcframework
    • RongCustomerService.xcframework
    • RongLocation.xcframework(5.2.5 及之后版本:无需导入)
    • RongDiscussion.xcframework
    • RongPublicService.xcframework
    • RCConfig.plist
    Translation(可选)
    • RongTranslation.xcframework
    提示

    仅 5.2.2 及之后版本的 SDK 支持翻译插件(Translation),该插件暂仅适用于使用新加坡数据中心的应用。

  3. 修改您的项目配置。在 General -> Frameworks,Libraries,and Embedded Binaries 中,将 IMLib SDK 所需的 Framework 全部改为 Embed & Sign