环信最新动态库集成第一弹

本篇文章针对第一次集成环信sdk的同学,以自己的集成经验写一个集成示例,希望可以帮到大家.

由于图片比较直观,更容易表达,所以使用大量图片.
先说明下: 环信sdk3.2.2.r2(包含这个版本)之前,都是静态库.a
从开始sdk3.2.3只有动态库.framework.而且需要编译环境最低iOS 8(主要是苹果动态库编译仅支持iOS 8以上),顺便介绍下easeUI建议手动导入,因为很多开发者需求不能满足,需要基于easeUI二次开发,手动导入方便测试和修改源码;easeUI使用指南官方链接:http://docs.easemob.com/im/300iosclientintegration/85easeuiguide

功能上的区别

直接看官方更新日志:http://docs.easemob.com/im/300iosclientintegration/130iosqa

头文件区别:

静态库:

不包含实时语音版本 SDK（HyphenateLite），引用时 #import
包含实时语音版本 SDK（Hyphenate），引用时 #import

动态库:

不包含实时语音版本 SDK（HyphenateLite），引用时 #import
包含实时语音版本 SDK（Hyphenate），引用时 #import

1.从环信官网下载最新动态库sdk3.2.3链接:http://www.easemob.com/download/im

Paste_Image.png

2.我在这里直接拖入包含实时语音sdk和easeUI到空项目如图:

Paste_Image.png

Paste_Image.png

Paste_Image.png

Paste_Image.png

细心的同学发现以前的依赖库并没有添加,基于动态库集成我们不需要添加任何依赖库了.

如果您是静态库集成还是需要导入下面SDK 依赖库有：
CoreMedia.framework
AudioToolbox.framework
AVFoundation.framework
MobileCoreServices.framework
ImageIO.framework
libc++.tbz
libz.tbz
libstdc++.6.0.9.tbz
libsqlite3.tbz
libiconv.tbz (包含实时语音sdk需要导入)

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

Paste_Image.png

3.我们为项目创建一个pch,来处理sdk和easeUI编译,并设置pch路径;

Paste_Image.png

Paste_Image.png

Paste_Image.png

Paste_Image.png

Paste_Image.png

4.下面我们再做一个测试,在客户端注册一个环信账号并登陆;
首先后台设置开放注册模式:

Paste_Image.png

然后我们根据官方文档简单测试: http://docs.easemob.com/im/300iosclientintegration/30iossdkbasic

Paste_Image.png

测试通过注册并登录.哈哈

Paste_Image.png

打包上架appstore之前分离sdk 删除i386 x86_64架构(用于模拟器运行)两个平台 ;(注意分离之后只能真机运行sdk,如果还想模拟器和真机运行,只需把没有分离过的.framework文件替换自己项目里的即可)请参考这位大神链接http://www.jianshu.com/p/f058b25163b8

下面介绍一下对已有项目集成经常遇到报错,解决方案

报错1:首先介绍下环信easeUI里面默认集成第三方库有:

Paste_Image.png

这些第三方库如果自己的已有项目已经存在,需要删除其中一个,一般项目已有的已经很依赖,那就删除环信的即可;有些人这时就不知道怎么整合了,其实可以根据报错可以直接看出报错具体位置,直接导入自己的第三方头文件即可.

报错2:加密库冲突解决

报错一般会提示openssl 和libssl,这个暂时解决办法只有删掉加密库,不要支付宝前端加密.另外如果项目中有其他的音频和视频sdk也会产生冲突, 也只能选择删除其中一个sdk.下图支付宝加密库删除如图:

Paste_Image.png

报错3:报错找不到UIKit框架类名

最近发现pch设置参考官方环信demo,还是报错.发现pch里面使用自定义宏NSLog里面有C语言printf 会导致 报错,注释掉解决

报错4:基于已有项目报错C++变量找不到

因为动态库集成不需要导入依赖库了,但是有些项目会报错找不到C++变量,解决方案导入依赖库libc++.tbz即可.

报错5:build setting => treart warning as errors 设置yes

Paste_Image.png

以上仅供希望大家参考.如有错误请帮忙指出,遇到新的报错和解决方案可以评论下,一起学习和进步.