参考
IOS快速集成环信IM - 基于官方的Demo优化,5分钟集成环信IM功能
虽然网上的教程很多,但是自己集成的时候还是有一些问题,所以做了这一份来记录,大神们发现有什么问题可以随时留言交流!!
1.首先集成SDK
加入环信IM相关的SDK以及界面代码。下载源码https://github.com/mengmakies/ChatDemo-UI3.00-Simple,将解压后文件夹中的【3rdparty】、【ChatSDK】和【ChatUI】目录复制到新建项目【HxChatDemo】目录下,然后下载SDK(地址https://pan.baidu.com/s/1c1RsUrA) ,解压后后将HyphenateFullSDK和HyphenateSDK文件夹拷贝到目录【/ChatDemo-UI3.0-Sample/ChatDemo-UI3.0/ChatSDK/】目录下, 然后将【ChatSDK】和【ChatUI】这两个目录拖入Xcode中:
2.引入SDK的依赖库。在Xcode中为项目新建一个名为【Frameworks】的group,然后依次按照下面的目录添加依赖库:
SDK 包含实时语音依赖库有:
CoreMedia.framework
AudioToolbox.framework
AVFoundation.framework
MobileCoreServices.framework
ImageIO.framework
libc++.dylib
libz.dylib
libstdc++.6.0.9.dylib
libsqlite3.dylib
libiconv.dylib
// **********官方漏了以下这些系统库********************
CoreMotion.framework
UserNotifications.framework
AssetsLibrary.framework
MapKit.framework
Photos.framework
libbz2.1.0.dylib
// **********官方漏了以下这些系统库*****end***************
后端云LeanCloud需要引入的依赖库:
libicucore.dylib
SystemConfiguration.framework
CoreTelephony.framework
CoreLocation.framework
(如果使用的是 xcode7+,后缀为 tbd。)
注意要把上面的依赖全部加上。
3.向General → Embedded Binaries 中添加依赖库.
需要包含音视频通话功能就添加Hyphenate,不包含就添加HyphenateLite,这里只需要添加一个就可以了
注意:在【Linked Frameworks and Libraries】中,找到【HyphenateLite.framework】和【Hyphenate.framework】,然后将【Required】改为【Optional】。
4.增加预编译头文件pch,保证头文件的全局引用。在【Supporting Files】目录上单机右键 -> 【New File...】 -> 【Other】 -> 【PCH File】 -> 命名为【HxChatDemo-Prefix.pch】,加入如下代码:
#import <Availability.h>
#ifndef __IPHONE_3_0
#warning "This project uses features only available in iOS SDK 3.0 and later."
#endif
// 如果不需要红包功能,直接把这个REDPACKET_AVALABLE宏注释掉,然后:
// 1.删掉红包相关代码:注释掉后,建议在xcode中搜索“REDPACKET_AVALABLE”,然后删掉相关代码;
#define REDPACKET_AVALABLE
// 如果不需要语音通话功能,直接把这个宏注释掉或者改成0,然后:
// 1.删掉音视频相关代码:注释掉后,建议在xcode中搜索“DEMO_CALL”,然后删掉相关代码;
// 2.隐藏音视频通话按钮:EaseChatBarMoreView.m 第115-131行代码注释掉。
#define DEMO_CALL 1 // 1:启用音视频通话;0:禁用音视频通话
#ifdef __OBJC__
#import <UIKit/UIKit.h>
#import <Foundation/Foundation.h>
#import "ChatUIDefine.h"
#import "EMAlertView.h"
#import "TTGlobalUICommon.h"
#import "EaseUI.h"
#if DEMO_CALL == 1
#import <Hyphenate/Hyphenate.h>// 包含音视频通话功能
#else
#import <HyphenateLite/HyphenateLite.h>// 不包含音视频通话功能
#endif
#import "AVOSCloud/AVOSCloud.h"// 后端云LeanCloud
#import "UserCacheManager.h"
#import "UserWebManager.h"
#endif
关联PCH文件,打开【Build Settings】,在【Apple LLVM7.1- language】组中进行如下设置:1.将【Precompile Prefix Header】设置为YES,预编译后的pch文件会被缓存起来,可以提高编译速度;2.修改pch文件路径按照如下格式:将【Building setting】中的【Prefix Header】选项的路径设置为“$(SRCROOT)/项目名称/pch文件名”,例如:
$(SRCROOT)/HxChatDemo/HxChatDemo-Prefix.pch
如果上面的路径不对,可以试一试就只是要pch的文件名字,如下
HxChatDemo-Prefix.pch
记得将ENABLE_BITCODE设置为NO
OK~编译运行成功!!!大功告成!经过如上几个步骤,环信IM功能所需要的SDK以及EaseUI界面代码都被成功导入项目了。
笔者只是需要会话列表界面,最近的会话等界面都没用,而且只是用环信的UI,并没自定制。
只需要跳转到 ContactListViewController 界面就可以了。
SDK集成好了,只需要初始化项目就好了
EMOptions *options = [EMOptions optionsWithAppkey:你的APPkay];
options.apnsCertName = 你的推送证书名字;//如果没有可以写nil
EMError *error = [[EMClient sharedClient]initializeSDKWithOptions:options];
if (!error) {
NSLog(@"初始化成功");
}
else{
NSLog(@"初始化失败 %@",error);
}
error = [[EMClient sharedClient]loginWithUsername:@"test3" password:@"123456"];//用户名密码
if (!error) {
NSLog(@"登录成功");
}
else{
NSLog(@"%@登录失败",error);
}
------------------------------------分割线----------------------------------------------
按教程完成上面操作,但是发现还是运行不了
1.jsonStringEncoded方法报错
这个问题还不懂是什么问题,那位大神知道可以留言告诉一下。
解决方法如下:
2.视频,语音点击没反应
可以试一下把代码的注释了改为用根视图跳转
3.删除红包的代码
如下删除或者注释全部搜索出来的结果
4.各种权限崩溃
查看pist文件是否添加了权限,如果没有可以查看iOS10配置权限
5.发送文件
上文中的文件会有一个发生文件的按钮发送文件
我们只需要打开权限就可以了