目录

集成 iOS SDK


在您阅读此文档时,我们假定您已经具备了基础的 iOS 应用开发经验,并能够理解相关基础概念。

下载 SDK

通过 Cocoapods 下载地址

pod 'EaseMobSDK', :git => 'https://github.com/easemob/sdk-ios-cocoapods.git'
pod 'EaseMobSDKFull', :git => 'https://github.com/easemob/sdk-ios-cocoapods-integration.git'

直接下载

您可以到环信官网下载环信 SDK。

到此您已经下载好了 SDK,下面开始学习 SDK 的集成使用吧!

注: 由于 iOS 编译的特殊性,为了方便开发者使用,我们将 i386 x86_64 armv7 armv7s arm64 几个平台都合并到了一起,所以 SDK 的静态库(.a 文件)比较大。实际集成编译出 ipa 后,根据调用功能的多少,实际只会增加 2MB 左右。

SDK 目录讲解

从官网上下载下来的包中分为如下四部分:

iOS EaseMobSDK(EaseMobSDKLite) 中有三个子文件夹:include、lib、resources,请不要擅自修改这些文件夹的任何东西,下面依次介绍这三个子文件夹。

主要介绍下 include,所有的接口都在这个文件夹中。

具体接口讲解请转到Apple Docs

注:

  1. include 包含5个子文件夹:CallService、ChatService、EaseMobClientSDK、EaseMobClientSDKLite、Utility。
  2. 类似 EM@Manager 命名格式的文件夹的内部结构都是相似的。delegates 文件夹包含各种代理接口,internal 文件夹包含各种协议的声明,types 文件夹包含各种实例的声明。

配置工程

导入 SDK

将下载好的 SDK 文件夹(EaseMobSDK)拖入到项目中,并勾选上 Destination。

导入SDK

设置工程属性

第 1 步:向 Build Phases → Link Binary With Libraries 中添加依赖库。

添加依赖库

SDK 依赖库有:

(如果使用的是 xcode7,后缀为 tbd)

第 2 步:向 Build Settings → Linking → Other Linker Flags 中添加 -ObjC(注意大小写)

添加-ObjC(注意大小写)

(如果项目中使用 -ObjC 有冲突,可以添加 -force_load 来解决)

格式为: -force_load[空格]EaseMobSDK/lib/libEaseMobClientSDKLite.a(静态库的路径)

1. 先添加一个-force_load。

添加-force_load

2. 将静态库拖动到上一步添加的 -force_load 下面。

将静态库拖动到-force_load下面

最终效果:

最终效果

编译工程

以上步骤进行完后,编译工程,如果没有报错,恭喜你,集成 SDK 成功,可以进行下一步了。