集成环信UI！

其实环信集成大体上不是很难，但是有几个注意点。
首先，我集成的是环信3·0，官网上的文档跟实际的api稍稍有点区别，但凑合凑合大致还是能看的。
首先我们看一下如何集成登录以及集成登录的时候遇到的问题：
 

[[EMClient sharedClient] loginWithUsername:self.userNameField.text password:self.passwordField.text completion:^(NSString *aUsername, EMError *aError) {}]; // [[EMClient sharedClient] addDelegate:self delegateQueue:nil];

当我们设置当前控制器为代理的时候，这里跟以前设置代理属性稍稍有点不一样，说到这里，必须要提到一个概念“多播代理”，集成环信的时候，大部分的api基本都是以代理方法来实现，环形本来也是基于XMPPFramework框架来开发的，很早之前，在XMPPFramework就接触过这个多播代理，我们以前所理解的代理可能就是控制器之间的逆向传值，这个是属于一对一的，也就是说只能有一个对象成为我的代理，这里的“多播代理”的唯一区别就是代理对象可以有很多个， 只要当前控制器设置了代理属性，那么当执行这个代理方法的时候，遵循这个代理属性的控制器就会调用这个代理方法。
这里的一个注意点就是添加代理一定不要忘了移除代理,这个暂且算一个小小的注意点。

- (void)dealloc {

    [[EMClient sharedClient] removeDelegate:self];

}

那么继续往下看，环信还提供给我们了自动登录的功能，也就是说只要第一次登录成功以后，环信里面会把登录成功的账号和密码都保存在本地，具体的我也看了一下沙盒中的文件：
可以看到这个是以plist文件存储的，而且是放在Library/Preferences文件夹下，于是我大胆猜想，这个应该是使用[NSUserDefaults standardUserDefaults]这种存储方法实现的。当然了这个并不重要
我们继续看环信提供给我们的api

[EMClient sharedClient].options.isAutoLogin

上面这个方法其实取值就是从而本地取值，对应的就是上面截图中的emAutoLogin属性对应的值。
我们做自动登录的时候的逻辑，比如我的demo中的逻辑是这样的：
当我第一次登录的时候，这个时候isAutoLogin的属性为NO,加载登录界面，当我退出以后，在后台将这个应用程序退出（杀死），这时候我们再次进入，此时isAutoLogin的属性值为Yes那么我们直接加载主界面，说到这里有一个问题当我们自动登录的时候，是向服务器发送的异步请求，只有当我们自动登录成功以后，才会去显示主界面，才会去加载“联系人列表”“会话列表”等。我们怎么知道自动登录是否成功？别着急，往下看
在环信的官网文档上也能看到环形给我们提供了一个代理方法，当我们自动登录无论是否成功，都会回调这个代理方法。

#pragma mark - 发生自动登录的时候回调用该方法

- (void)autoLoginDidCompleteWithError:(EMError *)aError {

    // 隐藏菊花

    [MBProgressHUD dh_hideIndicatorForView:self.view];

    if (!aError) {

        NSLog(@"自动登录");

    } else {

        // 展示错误信息

        [MBProgressHUD dh_showInfoWithTitle:@"登录提示" subTitle:aError.errorDescription toView:self.view afterDelay:.5];

    }

}

至于上面方法中的逻辑因项目而异。仅供参考、
说完登录这块以后，下面就要说说联系人列表了，环信的EaseUI提供了联系人列表，但是我这里没有集成UI，我使用的自定义的UI，关于联系人列表这块主要使用的是以下代理

// 添加代理

[[EMClient sharedClient].contactManager addDelegate:self delegateQueue:nil];

关于联系人列表这块根据官方文档提供的api大致可以集成，比较简单，我在集成的过程中也没有碰到什么问题，所以这里不作细说。

哦，其实说到这里还有一个问题，当我们集成环信的EaseUI的时候，把EaseUI拖进来的时候会报错：如下：


其实碰到上面这个问题还是很好解决的，这个是因为用到了UIKit里的类，但是只导入了Foundation框架，这个错误在其他类里也会出现，我们可以手动修改Founfation为UIKit，但是我不建议这么做，第一这个做法的工程量比较大， 在其他类里面也要导入，二，不利于移植，当以后环信更新的时候我们还是需要做同样的操作，这里我的做法的创建一个pch文件，在pch文件里面导入UIKit。

说到这里又要多说一句了，在Xcode6.x之前，创建一个新的iOS工程的时候 会pch文件默认就会被创建，但是自从Xcode6.x(具体版本我也不太清楚)以后pch文件就被取消了，如果要用到，需要用户自动创建，苹果官方取消这一文件，至少说明一个道理，苹果不推荐开发者使用pch文件，这是因为我们如果把大量的文件都写在pch文件里面，那么当程序启动的时候会去把pch中引入的头文件都去加载到内存中，这样以来就会造成，编译很慢，程序启动很慢。所以我们应该尽量避免在使用pch文件的时候导入大量的框架或者文件。

上面说到了集成UI，在环信提供给我们的UI中需要依赖如下第三方库：

为什么要说这个呢？我在集成这个UI之前，就已经使用cocoapods导入了MBprogressHUD，这里又引入EaseUI，就会造成冲突，这个时候的解决方法其实很简单：把EaseUI中的MBProgressHUD删除就可以了,如下所示：

最后，当我们集成“聊天列表”的时候写了如下代码

#pragma tableView的代理方法----监听每一行的点击

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {    

   // 获取当前好友

    UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];

    // 跳转控制器

    EaseMessageViewController *chatController = [[EaseMessageViewController alloc] initWithConversationChatter:cell.textLabel.text conversationType:EMConversationTypeChat];

//    [self.navigationController pushViewController:chatController animated:YES];

    [self.navigationController showViewController:chatController sender:nil];   

}

可以了 就是这么简单!