李洪强iOS开发之-环信02_iOS SDK 介绍及导入

iOS SDK 介绍及导入

iOS SDK 介绍

环信 SDK 为用户开发 IM 相关的应用提供的一套完善的开发框架。包括以下几个部分：

SDK_Core: 为核心的消息同步协议实现，完成与服务器之间的信息交换。
SDK: 是基于核心协议实现的完整的 IM 功能，实现了不同类型消息的收发、会话管理、群组、好友、聊天室等功能。
EaseUI: 是一组 IM 相关的 UI 控件，旨在帮助开发者快速集成环信 SDK。

用户可以基于我们提供的 Demo 实现自己的应用，也可以基于 SDK 开发自己应用。

SDK 采用模块化设计，每一模块的功能相对独立和完善，用户可以根据自己的需求选择使用下面的模块：

EMClient: 是 SDK 的入口，主要完成登录、退出、连接管理等功能。也是获取其他模块的入口。
EMChatManager: 管理消息的收发，完成会话管理等功能。
EMContactManager: 负责好友的添加删除，黑名单的管理。
EMGroupManager: 负责群组的管理，创建、删除群组，管理群组成员等功能。
EMChatroomManager: 负责聊天室的管理。

注意：如果您是从 SDK2.x 升级到 3.0，可以参考环信 SDK 2.x到3.0升级文档。

集成 iOS SDK

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

下载SDK

通过 Cocoapods 下载地址：

不包含实时语音版本 SDK（HyphenateSDK），引用时 #import <HyphenateSDK/EMSDK.h>

pod 'HyphenateSDK', :git => 'https://github.com/easemob/hyphenate-cocoapods.git'

包含实时语音版本 SDK（HyphenateFullSDK），引用时 #import <HyphenateFullSDK/EMSDKFull.h>

pod 'HyphenateFullSDK', :git => 'https://github.com/easemob/hyphenate-full-cocoapods.git'

直接下载：

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

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

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

SDK 目录讲解

从官网上下载下来的包中分为如下五部分：

环信 iOS HyphenateSDK 开发使用（不包含实时通话功能）
环信 iOS HyphenateFullSDK 开发使用（包含实时通话功能）
环信 iOS doc SDK 相关API文档
环信 iOS ChatUIDemo3.0 工程源码
环信 iOS EaseUI 工程源码
环信 iOS chatdemo-ui-3.x.x.ipa 打包的 ipa

iOS HyphenateSDK/HyphenateFullSDK 中有两个子文件夹：include、lib。请不要擅自修改这些文件夹的任何东西，下面依次介绍这两个子文件夹。

lib 静态库，包含静态库：libHyphenateSDK.a/libHyphenateFullSDK.a（包含实时语音）。
lib/3rdparty 静态库，包含静态库:libcrypto.a,libcurl.a,libssl.a (从SDK中分离出来第三方依赖静态库,避免与其它SDK冲突)
include 包含 SDK 的头文件。

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

具体接口讲解请转到 Apple Docs。

第三方库介绍

EaseUI 中用到的第三方库：

MWPhotoBrowser: 图片处理库，浏览显示
MJRefresh: 用于页面刷新
MBProgressHUD: 用于提示加载刷新
libopencore-amrnb.a,libopencore-amrwb.a: 用于 amr 与 wav 之间的转换

Demo 中用到的第三方库：

Parse.framework、Bolts.framework: Demo 中的用户信息存储在 Parse，这两个库是 Parse 所需要的库，开发者如果没用 Parse 存储，不要复制到自己项目中
libMobClickLibrary.a: 友盟相关的库，用于环信 Demo 基本信息的统计，开发者不用或者已有别的版本的库不要复制到自己项目

配置工程

导入 SDK

将下载好的 SDK 文件夹（HyphenateSDK）拖入到项目中，并勾选上 Destination。

设置工程属性

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

SDK 依赖库有：

CoreMedia.framework
AudioToolbox.framework
AVFoundation.framework
MobileCoreServices.framework
ImageIO.framework
libc++.dylib
libz.dylib
libstdc++.6.0.9.dylib
libsqlite3.dylib

（如果使用的是 xcode7，后缀为 tbd。）

SDK 包含实时语音依赖库有：

CoreMedia.framework
AudioToolbox.framework
AVFoundation.framework
MobileCoreServices.framework
ImageIO.framework
libc++.dylib
libz.dylib
libstdc++.6.0.9.dylib
libsqlite3.dylib
libiconv.dylib

（如果使用的是 xcode7，后缀为 tbd。）

第 2 步：SDK 不支持 bitcode，向 Build Settings → Linking → Enable Bitcode 中设置 NO。

编译工程

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