快速上手
本教程旨在帮助开发者快速了解和掌握 IMLib SDK (融云即时通讯能力库) 的基础集成流程与核心通信能力。通过本教程,您将完成 IMLib SDK 导入、初始化、设置监听、建立连接和发送消息等全流程操作。
环境要求
- Xcode 需要使用 Xcode 11 及以上的版本。
- 苹果设备的系统需要使用 iOS 9.0 及以上的版本。
- 如果您打算通过 CocoaPods 集成 SDK,需要使用 CocoaPods 1.10.0 及以上的版本。这是因为 IMLib SDK 5.1.1 版本后变更为 XCFramework,而 CocoaPods 是从 1.10.0 版本后才完整支持 XCFramework 的集成方式,具体请参见知识库文档。
如需安装 CocoaPods 环境,请参照 安装 CocoaPods。
准备工作
-
访问融云控制台,注册您的开发者账号。注册成功后,控制台自动在开发环境中为您创建一个应用。
-
在控制台的基本信息页,获取您的应用在开发环境的 AppKey。您可在基本信息页查看应用的信息,如 App Key、App Secret、所属数据中心(默认为北京)。
如您想自己创建应用,参考如何创建应用,并获取对应环境 App Key 和 App Secret。
提示每个应用均拥有两个不同的 App Key,分别对应开发环境与生产环境,且两个环境之间数据相互隔离。在您的应用正式上线前,建议切换到生产环境的 App Key,以便完成上线前全流程测试和最终发布。
导入 SDK
融云支持通过 CocoaPods 添加远程依赖和将 IMLib 的相关 XCFramework 本地库导入应用 工程两种集成方式。从 IMLib 5.12.2 开始,SDK 也支持通过 Swift Package Manager 的方式导入。下文以通过 CocoaPods 添加远程依赖为示例。
-
如果您的项目中没有
Podfile
文件,您需要打开终端并进入到项目的根目录,在终端中运行pod init
命令,之后系统会自动创建一个默认的Podfile
文件,在项目中的Podfile
文件中添加如下内容:rubypod 'RongCloudIM/IMLib', '~> x.y.z'
提示其中
x.y.z
代表 IMLib 具体的版本号,您可以在融云官网 SDK 下载页面或在终端中通过先执行pod repo update
,再执行pod search RongCloudIM
命令在 CocoaPods 仓库查询 IMLib 最新的版本。 -
打开终端并进入到
Podfile
文件所在的目录,在终端中运行以下命令:shellpod install
提示如果终端中出现类似
CocoaPods could not find compatible versions for
等找不到相关版本的报错,可先在终端中执行pod repo update
命令,再执行pod install
命令。 -
通过 XCode 打开项目目录下的
xcworkspace
文件加载工程。
初始化 SDK
IMLib SDK 相关接口的调用都需要导入 SDK 的头文件:
#import <RongIMLibCore/RongIMLibCore.h>
为确保您可以正常连接融云服务器和使用融云即时通讯服务(IM 服务),您须调用 init 方法初始化 IMLib SDK。初始化前,您须在融云控制台中获取 App Key,并设置好 RCInitOption(初始化配置)。
RCInitOption 中封装了 areaCode (数据中心的区域码),naviServer(导航服务地址)、fileServer(文件服务地址)、statisticServer(数据统计服务地址)和 crashMonitorEnable(崩溃监控开关)。详见初始化。
如果您使用北京数据中心,则不需设置 RCInitOption,IMLib SDK 默认连接北京数据中心。
NSString *appKey = @"Your_AppKey"; // example: bos9p5rlcm2ba
RCInitOption *initOption = nil;
[[RCCoreClient sharedCoreClient] initWithAppKey:appKey option:initOption];
如果您使用海外数据中心,则须传入海外数据中心对应的 AreaCode。
NSString *appKey = @"Your_AppKey"; // example: bos9p5rlcm2ba
RCInitOption *initOption = [[RCInitOption alloc] init];
initOption.areaCode = RCAreaCodeSG;// 新加坡数据中心
[[RCCoreClient sharedCoreClient] initWithAppKey:appKey option:initOption];
如果您使用的开发版 IMLib SDK 版本号小于 5.4.2,或者稳定版 IMLib SDK 版本号小于等于 5.3.8,则您须调用 RCCoreClient 的 initWithAppKey 方法,并传入 App Key 来进行初始化。详见初始化。
监听消息
通过设置消息接收监听器,用户可接收所有类型的实时消息和离线消息。
为确保接收所有离线消息,请在初始化 SDK 后,连接 IM 融云服务器之前设置监听器。
[[RCCoreClient sharedCoreClient] addReceiveMessageDelegate:self object:nil];
- (void)onReceived:(RCMessage *)message left:(int)nLeft object:(id)object {
}