SDK 2.x 至 3.0 升级指南

3.0 中的核心类为 EMClient 类，通过 EMClient 类可以获取到 chatManager、groupManager、contactManager、roomManager对象。原来 2.0 版本的 SDK 很多方法提供了同步、异步回调、异步（block）三种方法，3.0 版只提供同步方法（async开头的方法为异步方法）。

例如：

//2.0版本登录方法，提供了同步、异步、异步block三种方法
- (NSDictionary *)loginWithUsername:(NSString *)username
                          password:(NSString *)password
                             error:(EMError **)pError;
- (void)asyncLoginWithUsername:(NSString *)username
                     password:(NSString *)password;
                     
- (void)asyncLoginWithUsername:(NSString *)username
                     password:(NSString *)password
                   completion:(void (^)(NSDictionary *loginInfo, EMError *error))completion
                      onQueue:(dispatch_queue_t)aQueue;
//3.0版本，网络请求的方法只提供了同步方法
- (EMError *)loginWithUsername:(NSString *)aUsername
                      password:(NSString *)aPassword;                      

注册回调，3.0 SDK 对功能进行了模块化，将不同功能回调封装到不同模块。

//2.0版本回调注册
[[EaseMob sharedInstance].chatManager addDelegate:self delegateQueue:nil];
//3.0版本回调注册需要分模块注册
[[EMClient sharedClient] addDelegate:self delegateQueue:nil];//登录相关的回调
[[EMClient sharedClient].groupManager addDelegate:self delegateQueue:nil];//群组回调
[[EMClient sharedClient].contactManager addDelegate:self delegateQueue:nil];//联系人回调    
[[EMClient sharedClient].roomManager addDelegate:self delegateQueue:nil];//聊天室回调
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];//消息回调

3.0 升级辅助工具（替换枚举、属性、方法名称等）：

python EMReplace.py replacePath

xcode 编译提示工具：

//1. Xcode->build Phases
//2. 添加一个新的Run Script
//3. 填写脚本：python ${路径}/EMChecker.py
//编译运行会有提示

3.0 SDK 大部分代码与 2.0 SDK 比较，逻辑没有变化，为了统一修改了名称。2.0 版本提供的异步方法，对应的回调 3.0 不再支持（注意：3.0 只提供同步方法）。

入口的变化，2.0 版本 [EaseMob shareInstance] → 3.0 版本 [EMClient sharedClient]。