一、准备工作
1、注册环信帐号
注册一个环信账号之后，我们用注册的帐号登陆。然后创建一个应用，会得到一个对应的AppKey,这个AppKey在初始化环信SDK的时候需要用到。(这个去环信官网自己弄环信)
2、制作推送证书
如果需要做离线推送的功能，需要制作一个推送证书。如果只是需要实现单聊、群聊等功能，可以跳过此步骤。个人建议刚开始接触环信的开发者可以忽略此步骤。制作证书
3、下载环信SDK
二、集成环信的SDK
1、把环信SDK添加到工程中
从环信官网下载下来的是一个压缩包，解压之后，把我们需要的环信SDK，即EaseMobSDK这个文件夹，整个的拖入到我们的工程中。如下图：
在lib文件夹下面有两个静态库，只需要用到一个，根据你的需求选择。
libEaseMobClientSDKLite.a不包含实时语音功能，libEaseMobClientSDK.a包含所有功能。
2、添加对应的依赖库
向Build Phases → Link Binary With Libraries 中添加依赖库
1、MobileCoreServices.framework
2、CFNetwork.frame
3、libsqlite3.tbd
4、libstdc++.6.0.9.tbd
5、libz.tbd
6、libiconv.tbd
7、libresolv.tbd
8、libxml2.tbd
温馨提示：注意不要添加错了，也不能添加少了，添加完毕之后，不要着急，先编译一下。编译成功，则说明没有问题；如果编译报错，则仔细对照上面例举的静态库进行添加，直到编译成功，再进行下一步。
3、配置工程
3.1 不包含语音静态库的配置方法
(1) 删掉libEaseMobClientSDK.a，保留libEaseMobClientSDKLite.a；
(2) 在Build Settings -> Other Linker Flags 添加”fore_load”和”libEaseMobClientSDKLite.a”的相对路径。
如下图所示：
3.2 包含语音静态库的配置方法
(1) 删掉libEaseMobClientSDKLite.a，保留libEaseMobClientSDK.a；
(2) 在Build Settings -> Other Linker Flags 添加”-ObjC”。
如下图所示：
4、验证SDK是否添加成功
在AppDelegate.m文件中添加环信SDK初始化的方法，记得添加头文件”EaseMob.h”。下面提供了我用的测试AppKey，你可以替换成你自己申请的AppKey。编译成功，则说明你已经正确集成了环信的SDK了。
如果编译有问题，可能存在的原因：
(1) 静态库没有添加正确；
(2) 静态库工程配置不正确
#define APPKEY @"1101#testrongyun" //环信APPKEY
#define APNSCert @"TestHuanXin" //环信推送证书名称
#import "AppDelegate.h"
#import "EaseMob.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//初始化环信SDK
[[EaseMob sharedInstance] registerSDKWithAppKey:APPKEY apnsCertName:APNSCert];
return YES;
}
三、添加UI文件到你的工程
集成环信2.0UI文件，需要添加的文件，如下图所示：
添加完成之后，如下图所示：
四、设置pch文件的路径
文件添加成功之后，编译会报错，因为你没有添加pch文件。自己手动添加pch文件(EaseUI-Prefix.pch)，设置一下pch文件的加载路径即可。如下图所示：
在EaseUI-Prefix.pch中添加头文件”EaseUI.h”，如下图：
最后，编译一下，编译成功则说明添加集成UI文件成功。
五,搭建基本框架
1、新建三个UIViewController
新建三个ViewController,继承UIViewController,分别命名为：FirstViewController，SecondViewController，ThirdViewController。如下图所示
2、添加登陆方法
在AppDelegate.m中添加如下代码：
#define APPKEY @"1101#testrongyun" //环信APPKEY
#define APNSCert @"TestHuanXin" //环信推送证书名称
#import "AppDelegate.h"
#import "EaseMob.h"
#import "FirstViewController.h"
#import "SecondViewController.h"
#import "ThirdViewController.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
//初始化环信SDK
[[EaseMob sharedInstance] registerSDKWithAppKey:APPKEY apnsCertName:APNSCert];
//异步登陆的方法(这里的账号密码要去环信后台自己注册)
[[EaseMob sharedInstance].chatManager asyncLoginWithUsername:@"账号" password:@"密码" completion:^(NSDictionary *loginInfo, EMError *error) {
if (!error && loginInfo) {
NSLog(@"登陆成功");
[self setUpNav];
}
} onQueue:nil];
return YES;
}
- (void)setUpNav
{
FirstViewController *firstVC = [[FirstViewController alloc] init];
SecondViewController *secondVC = [[SecondViewController alloc] init];
ThirdViewController *thirdVC = [[ThirdViewController alloc] init];
firstVC.title = @"会话列表";
secondVC.title = @"通讯录";
thirdVC.title = @"设置";
UITabBarController *tabBar = [[UITabBarController alloc] init];
tabBar.viewControllers = @[[[UINavigationController alloc] initWithRootViewController:firstVC],
[[UINavigationController alloc] initWithRootViewController:secondVC],
[[UINavigationController alloc] initWithRootViewController:thirdVC]];
self.window.rootViewController = tabBar;
self.window.backgroundColor = [UIColor whiteColor];
}
@end
编译一下，看下效果。
六、添加与聊天有关的文件
1、添加GifImage文件2、添加chat文件
添加完成之后，编译一下，把报错的地方全部注释掉，有很多地方需要注释掉，这些地方是因为有些我们不需要的文件没有添加进来。(自己注释比较麻烦)
注释好的GifImage和chat文件，下载后无需注释无关代码，可直接使用注释好的文件,
八、实现单聊
在SecondViewController.m中添加如下代码：
#import "SecondViewController.h"#import "ChatViewController.h"@interface SecondViewController (){
NSArray *arrSystem;
NSArray *arrFriends;
}
@property (retain, nonatomic) UITableView *tableView;
@end
@implementation SecondViewController
- (void)viewDidLoad {
[super viewDidLoad];
arrSystem = @[@"申请与通知",@"群聊",@"聊天室"];
_tableView = [[UITableView alloc] initWithFrame:self.view.frame];
_tableView.delegate = self;
_tableView.dataSource = self;
[self.view addSubview:_tableView];
//获取好友列表
[[EaseMob sharedInstance].chatManager asyncFetchBuddyListWithCompletion:^(NSArray *buddyList, EMError *error) {
if (!error) {
NSLog(@"获取成功 -- %@",buddyList);
arrFriends = [NSArray arrayWithArray:buddyList];
[_tableView reloadData];
}
} onQueue:nil];
}
#pragma mark - UITableViewDelegate & UITableViewDataSource
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 2;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
if (section == 0) {
return arrSystem.count;
} else {
return arrFriends.count;
}
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
static NSString *identifier = @"CELL";
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:identifier];
if (cell == nil) {
cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:identifier];
}
switch (indexPath.section) {
case 0:
{
cell.textLabel.text = [arrSystem objectAtIndex:indexPath.row];
cell.imageView.image = [UIImage imageNamed:@"groupPublicHeader"];
break;
}
case 1:
{
EMBuddy *eMBuddy = [arrFriends objectAtIndex:indexPath.row];
cell.textLabel.text = eMBuddy.username;
cell.imageView.image = [UIImage imageNamed:@"chatListCellHead"];
break;
}
default:
break;
}
return cell;
}
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
EMBuddy *buddy = [arrFriends objectAtIndex:indexPath.row];
ChatViewController *chatVC = [[ChatViewController alloc] initWithConversationChatter:buddy.username conversationType:eConversationTypeChat];
chatVC.title = buddy.username; //好友的名字
chatVC.hidesBottomBarWhenPushed = YES;
[self.navigationController pushViewController:chatVC animated:YES];
}
编译,效果
真机运行一下，可能会报错,
解决方案:
把这个值设置成no
网友评论