导入 SDK
SDK 支持两种方式导入方式:
- 通过
CocoaPods
管理依赖,CocoaPods
是目前最流行的Cocoa
项目库依赖管理工具之一,考虑到便捷与项目的可维护性,我们更推荐您使用CocoaPods
导入并管理 SDK ; - 手动导入 SDK 并管理依赖;
注意
必须保持 RongCloudIM
所有导入的模块版本号一致。
CocoaPods 🔥¶
导入¶
-
CocoaPods安装
请参照 CocoaPods 安装
-
使用 CocoaPods 导入融云 SDK
-
执行
pod search RongCloudIM
Pod 库 SDK功能 依赖关系 RongCloudIM/IMLib IMLib库 无 RongCloudIM/IMKit IMKit库 需导入IMLib RongCloudIM/RedPacket 红包库 需导入IMLib、IMKit RongCloudIM/RongSticker 表情库 需导入IMLib、IMKit RongCloudIM/Sight 小视频库 需导入IMLib、IMKit -
cd
到 工程目录 -
执行
pod init
-
执行
open -e Podfile
-
添加 pod 内容
示例:
-
执行
pod install
-
双击
.xcworkspace
文件
-
升级¶
- 执行
pod repo update
- 执行
pod search RongCloudIM
- 替换
Podfile
文件内容 - 执行
pod install
查看版本¶
查看当前使用的 SDK 版本,可以在 Podfile.lock
文件中看到当前工程中使用的 SDK 版本。
如下:当前项目使用的是 2.9.15
版本的SDK
常见问题
特殊情况下,由于网络或者别的原因,通过 CocoaPods 下载的文件可能会有问题。 需要删除 CocoaPods 的缓存 ~/Library/Caches/CocoaPods/Pods/Release
目录,再次导入即可。
手动导入¶
文件说明¶
使用 IMKit
,需要将所有的文件导入工程中;
使用 IMLib
,需要导入除 RongIMKit.framework
和 RongCloud.bundle
之外的所有文件。
文件 | 说明 | 是否必须导入 |
---|---|---|
RongIMKit.framework |
IMKit 的 framework 库 | 使用 IMKit 必须导入 |
RongIMLib.framework |
IMLib 的 framework 库 | 必须导入 |
libopencore-amrnb.a |
第三方开源语音库 | 必须导入 |
libopencore-amrwb.a |
第三方开源语音库 | 必须导入 |
libvo-amrwbenc.a |
第三方开源语音库 | 必须导入 |
RongCloud.bundle |
资源包,包含图片和铃声等资源 | 必须导入 |
Emoji.plist |
表情包 | 必须导入 |
zh-Hans.lproj |
中文语言包 | 必须导入 |
2、添加系统库依赖
您除了在工程中导入 SDK 之前,还需要添加如下系统库的引用。
需导入的库 | |||
---|---|---|---|
AssetsLibrary.framework |
AudioToolbox.framework |
AVFoundation.framework |
CFNetwork.framework |
CoreAudio.framework |
CoreGraphics.framework |
CoreLocation.framework |
CoreMedia.framework |
CoreTelephony.framework |
CoreVideo.framework |
ImageIO.framework |
libc++.tbd |
libc++abi.tbd |
libsqlite3.tbd |
libstdc++.tbd |
libxml2.tbd |
libz.tbd |
MapKit.framework |
OpenGLES.framework |
QuartzCore.framework |
SystemConfiguration.framework |
UIKit.framework |
Photos.framework |
SafariServices.framework |
3、在 Xcode
项目 Build Settings
的 Other Linker Flags
中,增加 -ObjC
。
查看版本¶
手动导入的 SDK 版本,在 Finder
中打开 RongIMKit.framework
和 RongIMLib.framework
,在各自的文件夹中都有一个 Info.plist
文件,打开即可看见版本号。
Info.plist
文件