集成IOS 环信SDK

集成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目录讲解

1. 从官网上下载下来的包中分为如下四部分：

环信 iOS SDK 开发使用

环信 iOS release note 更新说明

环信 iOS UIDemo 工程源码

环信 iOS UIDemo.ipa 打包的ipa

2. IOS SDK中有三个子文件夹:include、lib、resources，请不要擅自修改这些文件夹的任何东西，下面依次介绍这三个子文件夹。

lib 静态库，包含连个静态库libEaseMobClientSDK.a和libEaseMobClientSDKLite.a。libEaseMobClientSDKLite.a不包含实时语音功能，libEaseMobClientSDK.a包含所有功能。如果你的app中不需要实时语音功能，删掉libEaseMobClientSDK.a只使用libEaseMobClientSDKLite.a即可。

resources sdk的bundle，包含旧版sdk的数据库、消息提示音，sdk配置文件。其中sdk配置文件已加密，旧版sdk数据库几乎没什么实质作用。

include 包含sdk的头文件。

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

EaseMobClientSDK/EaseMobClientSDKLite 包含在项目中要引用的总头文件，即在代码中只需#import”EMSDKFull.h”或#import”EaseMob.h”即可调用所有对应的api。

CallService 包含实时语音相关的接口

ChatService 包含聊天相关的接口，比如注册、登录、退出、单聊、群聊、群组等

Utility 包含DeviceManager和ErrorManager。DeviceManager硬件相关接口，ErrorManager错误码定义

具体接口讲解请转到Apple Docs

注：

include包含5个子文件夹：CallService、ChatService、EaseMobClientSDK、EaseMobClientSDKLite、Utility。如果无需实时语音功能，将CallService和EaseMobClientSDK删掉即可。

类似EM@Manager命名格式的文件夹的内部结构都是相似的。delegates文件夹包含各种代理接口，internal文件夹包含各种协议的声明，types文件夹包含各种实例的声明。

配置工程

1. 导入SDK

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



2. 设置工程属性

2.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

2.2. 向Build Settings → Linking → Other Linker Flags 中 添加-ObjC(注意大小写)



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

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

step1. 先添加一个-force_load



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



step3. 最终效果

编译工程

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