本文根据此文稍作精简: https://www.jianshu.com/p/d18c51b3321d
作者:Poker_Facer
一、本文总结了项目iOS8-10的通知适配工作
iOS推送通知几乎每年都在改,直到iOS10的出现,苹果对这块进行了重构。本文总结了一下项目中iOS8-10的通知模块适配工作。
二、实际开发中的适配工作
在实际开发中,iOS8-10的适配代码如下:
- (void)setupWithOptions:(NSDictionary *)launchOptions {
// iOS8-10.0 注册通知
if (!IS_IOS(10.0)) {
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
}
// iOS10.0+ 开启通知权限
else {
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
center.delegate = self;
UNAuthorizationOptions options = UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options completionHandler:^(BOOL granted, NSError * _Nullable error) {
}];
}
// 启动极光推送SDK
[JPUSHService setupWithOption:launchOptions
appKey:kJPUSHAppKey
channel:channel
apsForProduction:VERSION_RELEASE
advertisingIdentifier:nil];
// 极光推送日志打印开关
if (VERSION_RELEASE) {
[JPUSHService setLogOFF];
} else {
[JPUSHService setDebugMode];
}
// 注册极光推送(内部会调用registerForRemoteNotifications注册APNS)
JPUSHRegisterEntity *entity = [[JPUSHRegisterEntity alloc] init];
entity.types = JPAuthorizationOptionAlert | JPAuthorizationOptionBadge | JPAuthorizationOptionSound;
[JPUSHService registerForRemoteNotificationConfig:entity delegate:self];
}
iOS10通过UNNotificationTrigger这个类的子类来区分远程通知和本地通知。
-
iOS8 通知请求权限修改。即UIRemoteNotificationType由UIUserNotificationType代替,并加入了UIUserNotificationSettings。
-
iOS9 通知加入可输入操作。
-
iOS10 通知重构,全新框架UNUserNotifications。
三、远程通知与本地通知的触发和调用
各版本通知中使用的类图表:
各版本通知类图.png
1、普通本地通知
- 程序杀死状态。
所有版本,本地通知在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
方法中获取。[launchOptions objectForKey:UIApplicationLaunchOptionsLocalNotificationKey]
即为我们需要的本地通知对象。没有通知时launchOptions为空。 - 程序后台状态。
iOS10以下,在点击通知会调用- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
方法。
iOS10会调用- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler
方法。 - 程序前台状态。
iOS10以下不会触发通知栏,并且还是调用- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
方法。
iOS10会立马触发- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler
方法,并且能根据completionHandler回调配置通知的显示样式。点击通知后同样会触发- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler
方法。
值得注意的是,程序后台状态下,代理方法都是在用户点击通知后才会执行,收到通知点击应用图标启动是不会走代理方法的。
程序杀死状态下启动应用只会触发
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
方法。
iOS10所有的通知,都只会触发下面两个方法。而区分远程还是本地通知,就是前面提到的UNNotificationTrigger的子类,当UNNotificationRequest的trigger为UNPushNotificationTrigger时,说明此通知为远程通知,否则为本地通知。下面为代理方法:
// iOS10通知代理方法,应用程序在前台的时候调用
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
UNNotificationRequest *request = notification.request;
NSDictionary *userInfo = request.content.userInfo;
if ([request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
NSLog(@"收到了一个远程推送:%@", userInfo);
} else {
NSLog(@"收到了一个本地推送:%@", userInfo);
}
//此方法回调,设置程序前台时banner提示框的显示选项
completionHandler(UNNotificationPresentationOptionAlert | UNNotificationPresentationOptionSound);
}
// iOS10通知代理方法,通知前后台点击时会触发。
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(nonnull void (^)(void))completionHandler {
NSDictionary *userInfo = response.notification.request.content.userInfo;
// 只有本地通知才能获取到这个key对应的value
NSData *modelData = userInfo[CYLocalNotificationModelKey];
if (modelData) {
[[CYLocalNotificationMgr sharedManager] handleLocalNotificationResponse:response];
}
completionHandler();
}
远程通知和本地通知之所以能统一规范,就是因为其原理类似,唯一的区别在于远程通知需要获取用户的token,通过苹果的APNS将通知发送给对应用户,而具体通知的内容则由后台配置的那个aps字典决定了。
2、普通远程通知
下面是iOS8-9远程通知相关的代理方法
/**
已经收到远程推送消息
@param userInfo 收到的userInfo信息
*/
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
if (application.applicationState == UIApplicationStateActive) {
NSLog(@"程序运行中收到通知");
} else {
NSLog(@"程序不活跃中收到通知");
}
}
/**
后台模式收到的远程推送信息,需要开启后台模式的远程推送,实现了此方法,上面的方法就失效。
*/
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
if (application.applicationState == UIApplicationStateActive) {
NSLog(@"程序运行中收到通知");
} else {
NSLog(@"程序不活跃中收到通知");
}
completionHandler(UIBackgroundFetchResultNewData);
}
远程推送需要后台配置title等参数,也就是在本地通知中设置的那些什么alertTitle,alertBody啥子的。基本格式如下:
{
"aps" : {
"alert" : {
"title" : "主标题",
"subtitle" : "子标题",
"body" : "通知内容"
},
"badge" : 2,
"sound" : "alert.wav"
},
"custom" : "something"
}
其中aps为固定对象,后台需要传输自己的参数可以自行添加与aps并列的键值对。
- subtitle是iOS10才有的,iOS10之前加不加无所谓。
- sound为提示音,默认为default,自定义时别忘了后缀。
- custom为自扩展字段,比如iOS10中图片和视频的连接地址就可以放这里。
3、高级远程通知
所谓高级,无非就是iOS10以下的可操作通知、iOS10中通知的增删改,以及UNNotificationServiceExtension和UNNotificationContentExtension这两个通知扩展了。由于是远程通知,这里仅附上测试aps格式,方便测试。
{
"aps" : {
"alert" : {
"title" : "这是title",
"subtitle" : "这是subtitle",
"body" : "这是body"
},
"mutable-content" : "1",
"category" : "myNotificationCategory"
}
}
- 此aps可以用来测试上述所有高级远程通知。
- category中的值必须与测试可操作通知时的category值一样。
- 测试UNNotificationContentExtension时,必须和plist文件中的UNNotificationExtensionCategory所对应的值保持一致,编译对应的Scheme即可。
- 凡是需要对通知内容做修改的都要加上mutable-content字段,UNNotificationServiceExtension中需要使用。例如下载通知中传来的图片或视频,先下载后再通知。
- 通知的增删改都是根据request中的identifier进行查找和区分的。
通知其实也就这些,只是改的多,显得乱而已。理解了通知的流程与原理,处理这一模块的问题也就能得心应手。
网友评论