跳转至

导入 SDK

SDK 支持两种方式导入方式:

  • 通过 CocoaPods 管理依赖, CocoaPods 是目前最流行的 Cocoa 项目库依赖管理工具之一，考虑到便捷与项目的可维护性，我们更推荐您使用 CocoaPods 导入并管理 SDK ；
  • 手动导入 SDK 并管理依赖；

注意

必须保持 RongCloudIM 所有导入的模块版本号一致。

CocoaPods 🔥

导入

  1. CocoaPods安装

    请参照 CocoaPods 安装

  2. 使用 CocoaPods 导入融云 SDK

    1. 执行 pod search RongCloudIM

      1558355608531

      Pod 库 SDK功能 依赖关系
      RongCloudIM/IMLib IMLib库 无
      RongCloudIM/IMKit IMKit库 需导入IMLib
      RongCloudIM/RedPacket 红包库 需导入IMLib、IMKit
      RongCloudIM/RongSticker 表情库 需导入IMLib、IMKit
      RongCloudIM/Sight 小视频库 需导入IMLib、IMKit

      IM CocoaPods 功能模块详细介绍。

    2. cd 到 工程目录

    3. 执行 pod init

    4. 执行 open -e Podfile

    5. 添加 pod 内容

      示例：

      podInfo

    6. 执行 pod install

    7. 双击 .xcworkspace 文件

升级

  1. 执行 pod repo update
  2. 执行 pod search RongCloudIM
  3. 替换 Podfile 文件内容
  4. 执行 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 文件，打开即可看见版本号。

image

Info.plist 文件

image