友盟消息推送SDK集成

1.创建应用

在友盟有账号的情况下（没有的请自行创建），创建应用之前需要去苹果开发者网站申请一个App ID和配置一个用于推送的APNs证书，下载并安装APNs推送证书后，打开钥匙串从这个证书导出一个.P12的证书文件并保存下来用于创建应用。对APNs证书不了解的可以参考宏创学院提供的证书设置指南：

证书配置      友盟官网

首先在友盟消息推送功能中创建一个应用，上传我们的证书：

创建好应用后进入应用详情页面，点击应用信息，可以看到我们的AppKey和App Master Secret，证书也可以在这里进行修改。

2.下载iOS SDK

友盟iOS SDK文档

选择合适版本的SDK，下载下来之后解压压缩包，找到UMessage_Sdk_1.2.3（1.2.3为版本号，本文以1.2.3示例） 文件夹，里面就是我们需要的文件了（一个.a的库文件，一个.h头文件）。

 

3.SDK基本功能集成

将上述的UMessage_Sdk_1.2.3文件夹拖入工程，若工程的Other Linker Flag中设置了-all_load，则需要添加libz.dylib（iOS 9为lib.tbd）库

• 在AppDelegate类中引入头文件Message.h，在AppDelegate.m的application:didFinishLaunchingWithOptions方法中初始化并注册友盟推送

1. //初始化友盟推送
2. [UMessage startWithAppkey:@"568cd65be0f55ac5610017ea" launchOptions:launchOptions];
4. #if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_8_0
5. //iOS 8之后使用此种方法注册
6. if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8.0) {
7. //远程消息注册类型
8. UIMutableUserNotificationAction *action1 = [[UIMutableUserNotificationAction alloc] init];
9. action1.identifier = @"action1_identifier";
10. action1.title=@"Accept";
11. action1.activationMode = UIUserNotificationActivationModeForeground;// 当点击的时候启动程序
13. // 第二按钮
14. UIMutableUserNotificationAction *action2 = [[UIMutableUserNotificationAction alloc] init];
15. action2.identifier = @"action2_identifier";
16. action2.title = @"Reject";
17. // 当点击的时候不启动程序，在后台处理
18. action2.activationMode = UIUserNotificationActivationModeBackground;
20. // 需要解锁才能处理，如果action.activationMode = UIUserNotificationActivationModeForeground;则下面这个属性被忽略
21. action2.authenticationRequired = YES;
22. action2.destructive = YES;
24. UIMutableUserNotificationCategory *categorys = [[UIMutableUserNotificationCategory alloc] init];
25. // 这组动作的唯一标示
26. categorys.identifier = @"category1";
27. [categorys setActions:@[action1,action2] forContext:(UIUserNotificationActionContextDefault)];
29. UIUserNotificationType types = UIUserNotificationTypeBadge
30. | UIUserNotificationTypeSound
31. | UIUserNotificationTypeAlert;
32. UIUserNotificationSettings *userSettings = [UIUserNotificationSettings settingsForTypes:types
33. categories:[NSSet setWithObject:categorys]];
35. [UMessage registerRemoteNotificationAndUserNotificationSettings:userSettings];
36. } else {
37. // 远程消息注册类型
38. UIRemoteNotificationType types = UIRemoteNotificationTypeBadge
39. | UIRemoteNotificationTypeSound
40. | UIRemoteNotificationTypeAlert;
42. [UMessage registerForRemoteNotificationTypes:types];
43. }
45. #else
46. // iOS8.0之前使用此注册
47. // 远程消息注册类型
48. UIRemoteNotificationType types = UIRemoteNotificationTypeBadge
49. | UIRemoteNotificationTypeSound
50. | UIRemoteNotificationTypeAlert;
52. [UMessage registerForRemoteNotificationTypes:types];
54. #endif
55. //打开调试日志
56. [UMessage setLogEnabled:YES];
57. //不自动清空角标
58. [UMessage setBadgeClear:NO];
59. //app发送渠道，默认为APP Store
60. [UMessage setChannel:nil];

•  消息处理方法

1. //向友盟注册deviceToken
2. - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
3. //打印deviceToken
4. NSLog(@"%@",[[[[deviceToken description] stringByReplacingOccurrencesOfString: @"<" withString: @""] stringByReplacingOccurrencesOfString: @">" withString: @""]
5. stringByReplacingOccurrencesOfString: @" " withString: @""]);
6. //注册deviceToken
7. [UMessage registerDeviceToken:deviceToken];
8. }
9.  
10. //注册远程通知失败
11. - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
12. NSLog(@"注册推送失败，具体错误：%@", error);
13. }
14.  
15. //收到推送消息时调用
16. - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
17. [UMessage didReceiveRemoteNotification:userInfo];
18. }

•  如果需要关闭推送，使用[UMessage unregisterForRemoteNotifications]

4.测试与调试

由于使用的是开发环境，所以推送的时候，需要在友盟注册的应用中添加一个测试设备用来测试。将前面的代码集成到项目里以后，使用真机运行项目，提示注册成功后可以在debug信息中看到获取的DeviceToken，将DeviceToken拷贝下来备用。

得到DeviceToken后进入友盟网站，依次执行下面的操作：

消息推送->立即使用->（你的应用）->开发环境->测试设备->添加测试设备

设备添加完成后就可以进行推送调试了，在测试消息中点击新建测试消息：

参数和提醒方式自行设置，发送方式选择单播，输入设备的DeviceToken，完成后提交即可：

 

确认后等待推送消息发送即可

 

 

 

 

 

 

 

 

至此，消息推送功能基本完成，更多功能请移步友盟iOS SDK集成指南。