集成 iOS SDK


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

下载 SDK

通过 Cocoapods 下载地址

  • 不包含实时语音版本SDK(EaseMobClientSDKLite),引用时 #import <EaseMobSDK/EaseMob.h>
pod 'EaseMobSDK', :git => 'https://github.com/easemob/sdk-ios-cocoapods.git'
  • 包含实时语音版本SDK(EaseMobClientSDK),引用时 #import <EaseMobSDKFull/EaseMob.h>
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 开发使用
  • 环信 iOS EaseMobSDKLite 开发使用
  • 环信 iOS release note 更新说明
  • 环信 iOS UIDemo 工程源码
  • 环信 iOS UIDemo.ipa 打包的 ipa

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

  • lib 静态库,EaseMobSDK/lib中包含静态库 libEaseMobClientSDK.a,EaseMobSDKLite/lib中包含静态库 libEaseMobClientSDKLite.a。libEaseMobClientSDKLite.a 不包含实时语音功能,libEaseMobClientSDK.a包含所有功能。如果你的 APP 中不需要实时语音功能,使用 libEaseMobClientSDKLite.a 即可。
  • resources sdk 的 bundle,包含旧版 SDK 的数据库、消息提示音,SDK 配置文件。其中 SDK 配置文件已加密,旧版 SDK 数据库几乎没什么实质作用。
  • include 包含 SDK 的头文件。

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

  • EaseMobClientSDK/EaseMobClientSDKLite 包含在项目中要引用的总头文件,即在代码中只需 #import“EMSDKFull.h” 或 #import“EaseMob.h” 即可调用所有对应的 API。
  • CallService 包含实时语音相关的接口
  • ChatService 包含聊天相关的接口,比如注册、登录、退出、单聊、群聊、群组等
  • Utility 包含 DeviceManager 和 ErrorManager。DeviceManager 硬件相关接口,ErrorManager 错误码定义

具体接口讲解请转到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 依赖库有:

  • MobileCoreServices.framework
  • CFNetwork.framework
  • libEaseMobClientSDKLite.a
  • libsqlite3.dylib
  • libstdc++.6.0.9.dylib
  • libz.dylib
  • libiconv.dylib
  • libresolv.dylib
  • libxml2.dylib

(如果使用的是 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 成功,可以进行下一步了。