公司项目中需要集成即时聊天的功能,在现有项目的基础上集成环信最新的SDK遇到了很多坑
环信开发文档里有详细的说明,在这里就不做介绍了
参考注册并创建应用
此步可以略过 或者参考集成 iOS SDK 前的准备工作
在项目中集成的是不包含实时语音版本的SDK,就是此版本为例
通过 Cocoapods
下载地址:
不包含实时语音版本 SDK(HyphenateLite)
,引用时 #import <HyphenateLite_CN/EMSDK.h>
pod 'HyphenateLite_CN'
或者在环信官网下载最新的SDK
CoreMedia.framework
AudioToolbox.framework
AVFoundation.framework
MobileCoreServices.framework
ImageIO.framework
libc++.dylib
libz.dylib
libstdc++.6.0.9.dylib
libsqlite3.dylib
(如果使用的是 xcode7,后缀为 tbd)
第 2 步:SDK 不支持 bitcode,向 Build Settings → Linking → Enable Bitcode 中设置 NO。
#import “EMSDK.h”
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions { // 环信 //AppKey:注册的AppKey,详细见下面注释。 //apnsCertName:推送证书名(不需要加后缀),详细见下面注释。 EMOptions *options = [EMOptions optionsWithAppkey:@"110108007702#xingnltest"]; //options.apnsCertName = @"istore_dev"; [[EMClient sharedClient] initializeSDKWithOptions:options]; return YES;} // APP进入后台- (void)applicationDidEnterBackground:(UIApplication *)application{ [[EMClient sharedClient] applicationDidEnterBackground:application];} // APP将要从后台返回- (void)applicationWillEnterForeground:(UIApplication *)application{ [[EMClient sharedClient] applicationWillEnterForeground:application];}
EMError *error = [[EMClient sharedClient] registerWithUsername:@"8001" password:@"111111"];if (error==nil) { NSLog(@"注册成功");}
EMError *error = [[EMClient sharedClient] loginWithUsername:@"8001" password:@"111111"];if (!error) { NSLog(@"登录成功");}
EaseUI 封装了 IM 功能常用的控件(如聊天会话、会话列表、联系人列表)。旨在帮助开发者快速集成环信 SDK。
按照官网的EaseUI 使用指南集成之后总是有很多的bug,但是官网介绍的又不够详细,坑了很多像我一样的小白开发者,这这里详细的介绍介绍一下如何正确的集成EaseUI
先看一下EaseUI 中用到的第三方库:
MWPhotoBrowser
: 图片处理库,浏览显示MJRefresh
: 用于页面刷新MBProgressHUD
: 用于提示加载刷新如果你的项目是使用pod管理的,并且有MJRefresh
,MBProgressHUD
第三方库,那么可以删除EaseUI
中重复的库,但是不能直接删除EaseUI->EMUIKit->3rdparty->MWPhotoBrowser的文件夹, 这个MWPhotoBrowser
文件夹下并不只是有MWPhotoBrowser
,还有环信自己封装的EMSDWebImage
,还有第三方的DACircularProgress
及PSTCollectionView
建议使用官方Demo中的EaseUI,而不是使用github上的EaseUI工程
把官方Demo中的EaseUI拖入自己的项目中
编译之后,我的项目出现了26个错误
解决方案:
查看EaseUI目录下的EaseUI-Prefix.pch
文件,把里面的代码拷贝在自己项目的pch
文件中,并删除EaseUI-Prefix.pch
,并在自己的代码中添加#ifdef __OBJC__
#endif
如下图所示
走到这一步后我的项目中还有一个错误,是EaseUI中的第三方框架PSTCollectionView
报错,错误如下:
这个错误没有正常解决,但是使用了暴力的方法解决了这个错误,如果有更好的方法,可以一起讨论
我的解决方法;
pod管理了EaseUI->EMUIKit->3rdparty目录下的MBProgressHUD
,MJRefresh
以及MWPhotoBrowser
还有DACircularProgress
把重复的文件去掉就可以. 特别注意MWPhotoBrowser目录下的EMSDWebImage需要自己拷贝一份,并导入项目中.
而PSTCollectionView
,我在项目中搜索了一下,发现EaseUI并没有使用到这个框架,所以就直接删除了
调整之后我的文件结构如下:
编译整个项目,然后没有错误了
update:2016.11.14
今天咨询了环信的客服
Q: 我导入EaseUI后PSTCollectionView报错
A:什么错误,截图我看下
我把上面的错误截图发过去了
A:return nil;
修改之后的代码:- (NSArray *)visibleCells { return [[_allVisibleViewsDict allValues] filteredArrayUsingPredicate:[NSPredicate predicateWithBlock:^BOOL(id evaluatedObject, NSDictionary *bindings) { return nil;// return [evaluatedObject isKindOfClass:PSTCollectionViewCell.class] && CGRectIntersectsRect(self.bounds, [evaluatedObject frame]); }]];}
Q: 请问PSTCollectionView在EaseUI中的作用是什么啊!我在项目中把PSTCollectionView删除的项目也不报错
A:就是一个弹窗,自定义的提示,不用也不影响
Q: 还有一个疑问,在集成环信的时候需要自己的服务器吗
A: 正常是需要的
Q:那什么是需要用我的服务器来管理的呢
A:注册环信id,其他的接口 根据你们的需求调用
环信客服还是很给力的
EaseMessageViewController *chatController = [[EaseMessageViewController alloc] initWithConversationChatter:@"8001" conversationType:EMConversationTypeChat]; [self.navigationController pushViewController:chatController animated:YES];
运行一下项目语音文字图片都没有问题EaseEmotionManager
并没有实例化EaseMessageViewController
的viewDidLoad
中添加如下代码 [self setupEmotion]; EaseEmotionManager *manager= [[EaseEmotionManager alloc] initWithType:EMEmotionDefault emotionRow:3 emotionCol:7 emotions:[EaseEmoji allEmoji]]; [self.faceView setEmotionManagers:@[manager]]; // 默认下拉刷新是关闭的,需要手动打开 self.showRefreshHeader = YES;
效果图如下:
根据文档上的介绍,但是却不展示会话列表
EaseConversationListViewController *chatListVC = [[EaseConversationListViewController alloc] init];
这里也需要手动添加一些代码,主要也是打开下拉刷新
在viewDidLoad
中添加
// 打开下拉刷新 [self tableViewDidTriggerHeaderRefresh]; self.showRefreshHeader = YES;
效果图如下:
但是还是存在一个问题就是会话列表不能及时刷新数据
解决方案
在viewWillAppear中添加以下代码
//刷新会话 [self refreshAndSortView];
至此集成环信最新的SDK以及EaseUI就完成了,并完成了单聊和会话列表的功能.如下想展示头像的话,都需要修改EaseUI中的代码.
联系客服