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

李洪强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 成功，能够进行下一步了。