跳到主要内容

导入 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 打开该文件即可加载工程。

Swift Package Manager​

提示

通过 Swift Package Manager 导入的方式，从 IMLib 5.12.2 开始支持。

  1. 打开 Xcode 工程。
  2. 选择 File > Add Package Dependency。
  3. 弹出框右上角，粘贴入下面的任一 URL 地址:
  4. Xcode 将会弹出产品选择，IMLibCore 提供核心 IM 能力， 其余组件可根据业务类型自行选择。

组件介绍

融云 IM SDK 提供了如下几种组件供开发者选择使用，以下组件可组合使用，能力介绍如下：

Swift Package动态库描述
IMLibCoreRongIMLibCore.xcframeworkIM 核心功能.
ChatRoomRongChatRoom.xcframework聊天室功能（包含 IMLibCore）
CustomerServiceRongCustomerService.xcframework客服功能（包含 IMLibCore）
DiscussionRongDiscussion.xcframework讨论组功能（包含 IMLibCore）
PublicServiceRongPublicService.xcframework公众号功能（包含 IMLibCore）

手动集成​

  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。

最后于 更新