iOS集成环信的会话列表

2017-07-05 本文已影响577人 jay_den

参考
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中：

SDK

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】。

修改为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
关联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

如下图所示：

设置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);
  }