快速上手
本教程是为了让新手快速了解融云即时通讯能力库(IMLib)。在本教程中,你可以体验集成 SDK 的基本流程和 IMLib 的基础通信能力。
前置条件
-
注册开发者账号。注册成功后,控制台会默认自动创建您的首个应用,默认生成开发环境下的 App Key,使用国内数据中心。
-
获取开发环境的应用 App Key。如不使用默认应用,请参考 如何创建应用,并获取对应环境 App Key 和 App Secret。
提示每个应用具有两个不同的 App Key,分别对应开发环境与生产环境,两个环境之间数据隔离。在您的应用正式上线前,可切换到使用生产环境的 App Key,以便上线前进行测试和最终发布。
环境要求
名称 | 版本 |
---|---|
Xcode | 11 + |
iOS | 9.0 + |
CocoaPods | 1.10.0 + |
SDK 5.1.1 及其以后要求使用 CocoaPods 1.10.0 +,具体请参见知识库文档。
导入 SDK
-
在
podfile
中添加如下内容:pod 'RongCloudIM/IMLib', '~> x.y.z'
提示x.y.z
代表具体版本,请在融云官网 SDK 下载页面或 CocoaPods 仓库查询最新版本。 -
请在终端中运行以下命令:
pod install
提示如果出现找不到相关版本的问题,可先执行
pod repo update
,再执行pod install
。 -
上一步完成后,CocoaPods 会在您的工程根目录下生成一个
xcworkspace
文件,只需通过 XCode 打开该文件即可加载工程。
初始化 SDK
融云即时通讯客户端 SDK 核心类为 RCCoreClient
和 RCIMClient
。在初始化 SDK 时,需要传入生产或开发环境的 App Key。
导入 SDK 头文件。
#import <RongIMLib/RongIMLib.h>
如果 SDK 版本 ≧ 5.4.2,请使用以下初始化方法。
NSString *appKey = @"Your_AppKey"; // example: bos9p5rlcm2ba
RCInitOption *initOption = nil;
[[RCCoreClient sharedCoreClient] initWithAppKey:appKey option:initOption];
初始化配置(RCInitOption
)中封装了区域码(RCAreaCode),导航服务地址(naviServer
)、文件服务地址(fileServer
)、数据统计服务地址(statisticServer
)配置。不作设置表示全部使用默认配置。SDK 默认连接北京数据中心。
如果 App Key 不属于中国(北京)数据中心,则必须传入有效的初始化配置。初始化详细说明参见初始化。