导入 SDK
融云支持使用 CocoaPods 添加远程依赖项、和手动导入 Framework 的方式将 IMLib SDK 集成到您的应用工程中。
RongIMLib 是融云即时通讯的核心能力库,功能包括:消息,会话,推送,聊天室等,以下简称 IMLib
- 如果您需要自行编写 UI 界面,可以使用 IMLib
- 如果您需要会话列表和会话页面等 UI 功能,请转至 IMKit 的文档。
环境要求
名称 | 版本 |
---|---|
Xcode | 11 + |
iOS | 9.0 + |
CocoaPods | 1.10.0 + |
如需安装 CocoaPods 环境,请参照 安装 CocoaPods。
检查版本
在导入 SDK 前,可以前往融云官网 SDK 下载页面确认当前最新版本号。
CocoaPods
融云支持使用 CocoaPods 导入并管理 IMLib SDK 。
pod 版本必须为 1.10.0 或更新版本。具体请查看知识库文档:
具体操作步骤如下:
-
在
podfile
中添加如下内容:pod 'RongCloudIM/IMLib', '~> x.y.z'
提示x.y.z
代表具体版本,请在融云官网 SDK 下载页面或 CocoaPods 仓库查询最新版本。
-
请在终端中运行以下命令:
pod install
提示如果出现找不到相关版本的问题,可先执行
pod repo update
,再执行pod install
。 -
上一步完成后,CocoaPods 会在您的工程根目录下生成一个
xcworkspace
文件,只需通过 XCode 打开该文件即可加载工程。
手动集成
-
前往融云官网 SDK 下载页面,将 IMLib SDK 下载到本地。
-
将下载下来的 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),该插件暂仅适用于使用新加坡数据中心的应用。
-
修改您的项目配置。在
General
->Frameworks,Libraries,and Embedded Binaries
中,将 IMLib SDK 所需的 Framework 全部改为Embed & Sign
。