iOS推送通知梳理
无论您的应用在前台还是后台本地推送还是远程推送都可以用来帮助用户获得您应用的最新特性信息。因此推送功能对于您的APP还是至关重要的功能,重点介绍远程推送,中间穿插着会捎带介绍本地推送同时我们的重点还是放在APP对于推送的处理而关于后台与APNs之间的联系需要单独介绍。
参考信息
Local and Remote Notification Programming Guide归档信息
User Notifications Framework Reference
User Notifications UI Framework Reference
应用配置推送能力
我们需要在应用中提前配置好各项能力才能享受推送带来的便利
我们需要推送能力需要首先获得推送的权限,
同时如果我们需要特定的推送展示特定的操作能力即给推送通知添加按钮我们就需要提前配置推送的Categories和对应的Action(无需启动进入应用就可以完成相应的事件)
获取推送权限
通常如果你需要展示通知的alert,伴随着声音、显示小标在你的app icon上、展示自定义的操作按钮在通知上时需要你在application:didFinishLaunchingWithOptions:方法之前配置好相关内容。
UNUserNotificationCenter *userNotificationCenter = [UNUserNotificationCenter currentNotificationCenter];
userNotificationCenter.delegate = self;
// 想要发起推送首先需要向用户发起授权请求 options是你需要授权的样式 UNAuthorizationOptionProvisional是临时通知(不会弹窗提示用户授权而是先尝试发送通知没有alert和声音只是在通知栏列表有可以在通知栏再次进行选择授权)下面的方法只会在第一次的时候询问后续就不会了
[userNotificationCenter requestAuthorizationWithOptions:(UNAuthorizationOptionAlert | UNAuthorizationOptionSound | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
}];
调用上面的requestAuthorizationWithOptions:completionHandler:方法来获得用户的权限,如果所有的都同意则在completionHandler中granted返回Yes否则返回NO,该方法只会在应用第一次调用该方法的时候弹框提醒用户,然后记录在系统中在随后的调用中则不会再次提醒。之后用户也可以在设置中重新进行修改。
注意:在options中如果有UNAuthorizationOptionProvisional则是临时通知,应用不会提醒用户授权而是首先尝试安静的发送通知,它不会伴随声音或Banner或显示在锁屏页面,它只会展示在通知中心的历史记录里而且包含两个按钮保留或关闭(即先发送通知然后由用户决定是否授权)
我们可以在设置中随时修改通知的权限,因此在我们需要发送本地推送前需要判断当前的权限。调用方法进行获取getNotificationSettingsWithCompletionHandler:
配置推送分类
对于一些推送提供操作按钮方便用户之间进行任务的处理,需要我们先向系统注册对应的Categories。Categories定义了我们APP支持的推送类型而且告诉了系统我们需要的展示成什么样式,我们可以为对应的Categories关联上自定义的操作。
UNNotificationAction *action1 = [UNNotificationAction actionWithIdentifier:@"OptionNone" title:@"OK-OptionNone" options:UNNotificationActionOptionNone];
UNNotificationAction *action2 = [UNNotificationAction actionWithIdentifier:@"OptionForeground" title:@"OK-OptionForeground" options:UNNotificationActionOptionForeground];
UNNotificationAction *action3 = [UNNotificationAction actionWithIdentifier:@"OptionDestructive" title:@"OK-OptionDestructive" options:UNNotificationActionOptionDestructive];
UNNotificationAction *action4 = [UNNotificationAction actionWithIdentifier:@"OptionAuthenticationRequired" title:@"OK-OptionAuthenticationRequired" options:UNNotificationActionOptionAuthenticationRequired];
UNNotificationCategory *invitationCategory = [UNNotificationCategory categoryWithIdentifier:@"INVITATION" actions:@[action1,action2,action3,action4] intentIdentifiers:@[] options:UNNotificationCategoryOptionNone];
[userNotificationCenter setNotificationCategories:[NSSet setWithObjects:invitationCategory, nil]];
如上面的代码我们需要创建UNNotificationCategory对象,Identifier即对应的category的唯一标识当你需要推送的通知与你的category对应上则在远程推送的payload中添加category字段值就是你定义的Identifier,actions是你想要的操作按钮最多支持4个,UNNotificationCategoryOptions指示如何处理对应的推送(UNNotificationCategoryOptionCustomDismissAction在你清楚通知的时候会将事假发送给代理方法由response.actionIdentifier接收)。如果我们点击了对应的action也会在代理方法的response.actionIdentifier中拿到对应的UNNotificationAction的identifier。
注册远程推送
这部分应该也是输入关于推送的配置项,要想获得远程推送的能力首先需要我们的设备向APNs发起注册,同时如果成功APNs将会返回给我们DeviceToken这是由应用和设备唯一确定的。
// 2. 向APNs注册远程推送通知
[[UIApplication sharedApplication] registerForRemoteNotifications];
/// 设备成功注册远程推送成功的处理方法
/// @param application 应用程序
/// @param deviceToken 设备token
-(void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// 在设备获取成功设备的 device token我们需要将它同步给我们的服务器(后台需要将它与对应的用户关联)
// 不要在本地存储DeviceToken 因为再重装应用或从备份恢复,或重装系统后deviceToken会变化,如果你每次请求新的每次都会得到最新的
[self sendDeviceTokenToProviderService:deviceToken];
NSLog(@"deviceToken");
}
/// 用户注册远程推送通知失败的处理方法
/// @param application 应用
/// @param error 错误信息
-(void)application:(UIApplication *)application
didFailToRegisterForRemoteNotificationsWithError:(nonnull NSError *)error {
// 当设备没有连接网络,或apns不能连接,或app没有合适的签名权限
// 我们可以在失败发送后设置一个标识并在以后尝试再次注册
NSLog(@"deviceToken fail: %@",error.localizedDescription);
}
获得远程推送的能力,需要我们是付费开发者并且在apple developer页面为对应的app打开了推送能力我们可以在XCode上设置该能力--前提是我们的profile 文件中具备了APS Environment Entitlement(producction生产环境,development开发环境), 否则在注册时候会失败在失败的回调中返回对应的错误
注意: 尽量在每次启动应用的时候向APNs发起注册,同时收到DeviceToken后同步给app 自己的服务器。不要去存储DeviceToken因为再你重装应用或更新系统后会发生变化,不同环境下的也是不同的。同时保证我们获得最新的DeviceToken,
在APNs注册成功后如果没有发生变化将会在你调用注册后很快的返回,只有在改变之后才会与APNs进行请求。deviceToken 长度是不固定的。
在获取失败的方法中我们可以做一个记录然后再合适的时机重新注册。
发送本地推送通知
本地推送由程序员在项目中发起来提醒用户相关的信息,当应用不再前台系统将会弹窗的形式提醒用户。如果应用在前台系统提供机会在内部直接处理。
发送本地推送的步骤:
创建并配置一个UNMutableNotificationContent对象
创建一个推送触发器,即何时发送推送(触发器目前包括三个时间,日历,位置)
用上面的两个对象创建 UNNotificationRequest对象
调用 addNotificationRequest:withCompletionHandler:方法来发送推送。
如果需要展示对应的Action按钮我们要在UNMutableNotificationContent中为categoryIdentifier赋值上我们在应用启动时配置的Category的identifier
定义推送的铃声默认是系统提供的,我们也可以自定义。
UNMutableNotificationContent* content = [[UNMutableNotificationContent alloc] init];
content.title = [NSString localizedUserNotificationStringForKey:@"本地推送title" arguments:nil];
content.body = [NSString localizedUserNotificationStringForKey:@"本地推送的body"
arguments:nil];
content.categoryIdentifier = YLWNotificationInvitationCategoryIdentifier;
content.sound = [UNNotificationSound soundNamed:@"sound.caf"];
// 时间触发器
UNTimeIntervalNotificationTrigger *timeTrigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:10 repeats:NO];
UNNotificationRequest* request = [UNNotificationRequest
requestWithIdentifier:[NSUUID UUID].UUIDString content:content trigger:timeTrigger];
[[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
}];
当你想要显示一个推送的提醒需要title和body内容。
UNMutableNotificationContent 觉得了推送的内容,UNNotificationTrigger决定了何时发起推送。UNNotificationRequest的identify保证推送的唯一性。
添加推送自定义铃声content.sound = [UNNotificationSound soundNamed:@"sound.caf"];导入不超过30s的声音文件放入项目主目录下,在Build Phases 下Copy Bundle Resourceses下添加声音文件
注意:我们可以对内容的文字进行本地国际化的处理,我们使用 localizedUserNotificationStringForKey:arguments:方法对文字进行本地化,这个方法会在将要发送的时候进行文本的替换,为什么不用NSLocalizedString是因为我们有可能在推送发送前修改手机的语言。
UNMutableNotificationContent* content = [[UNMutableNotificationContent alloc] init];
content.title = [NSString localizedUserNotificationStringForKey:@"Hello!" arguments:nil];
content.body = [NSString localizedUserNotificationStringForKey:@"Hello_message_body"
arguments:nil];
处理接收到的推送
处理应用在前台的推送
当应用在前台时可以安静的处理推送或者告诉系统去继续展示推送提醒,系统默认是安静的接收,如果你想让系统继续去展示推送提醒,在代理方法userNotificationCenter:willPresentNotification:withCompletionHandler: 里调用提供的completionHandler并带入你想展示的操作。
处理应用在后台时的推送或应用没有启动
当你点击了一个自定义按钮操作或点击推送通知,会在代理方法userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:中接收到信息
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
withCompletionHandler:(void (^)(void))completionHandler {
if ([response.notification.request.content.categoryIdentifier isEqualToString:@"TIMER_EXPIRED"]) {
// Handle the actions for the expired timer.
if ([response.actionIdentifier isEqualToString:@"SNOOZE_ACTION"])
{
// Invalidate the old timer and create a new one. . .
}
else if ([response.actionIdentifier isEqualToString:@"STOP_ACTION"])
{
// Invalidate the timer. . .
}
}
// Else handle actions for other notification types. . .
}
能拿到对应的分类信息和自定义操作信息,同时系统提供了两个自定义的操作信息
UNNotificationDismissActionIdentifier 是用户点击了推送通知的清楚关闭操作
UNNotificationDefaultActionIdentifier 是用户没有点击其他自定义按钮来启动应用(点击了推送信息)
远程推送的流程简介
获取推送能力,首先需要确保应用获得了用户的授权,因此我们需要首先发起授权请求。
获取远程推送能力我们需要向APNs发起注册请求,APNs会根据您的设备和应用生成一个唯一的DeviceToken然后返回给您的应用。
向APNs注册成功后得到DeviceToken,这时我们需要将DeviceToken同步给我们应用自己的服务器(我们后台需要将DeviceToken与对应的用户信息进行关联方便在将来对指定的用户进行推送),如果注册失败建议我们记录一个标记位在合适的时候再重新发起注册。
当后台服务需要发送通知时,将对应的DeviceToken和构建好的payload发给APNs
APNs收到发送请求在合适的时机发送给对应的设备应用。
应用收到推送进行处理。
附加:应用可以使用notification service app extensions来修改推送的内容再通知分发给用户之前。你可以使用这种类型的扩展来实现端到端加密您的应用程序的通知,修改通知内容之前交付,或下载额外的图像或媒体相关的通知。
附加:应用可以使用notification content app extensions来自定义您的应用通知样式。
以上就是远程推送的大体流程,了解了大体流程之后我们开始详细的介绍学习将推送技能熟练掌握。
配置远程推送的支持
支持远程推送可以使我们应用在没有运行的状况下也能接收到最新的数据,为了支持远程推送我们需要以下步骤:
打开远程推送
向APNs注册并收到一个独有的device token
发送device token给你的服务器
实现接收远程推送的方法
在上面关于推送的配置中已经介绍了远程推送的注册流程这里不再赘述。
远程推送的处理
在上面处理接收到的推送小节中介绍了关于推送的处理,远程还是本地推送在处理上并没有上面区别。
修改推送的内容(Notification Service Extension)
开发者可以利用Notification Service Extension修改推送的内容在推送到达用户之前。我们可以用Notification Service Extension来处理远程推送的payload信息。
解密发送的数据
下载图片或其他的多媒体文件并把他们添加到对应推送的附件
改变推送的body或title文字
添加其他的标识或修改userInfo字典的内容
添加Notification Service Extension到你的项目中
想要在应用中的notification servie app extension处理您的远程推送,必须按照要求来设计payload信息格式(如果没有严格按照要求则会直接发送)。
遵循以下要求:
包含mutable-content值为1
包含alert 字典并且字典内部含有title和body
修改推送样式UI(Notification Content Extension)
使用Notification Content Extension来自定义通知的UI,我们可以使用categoryIdentifier字端为用户的本地货远程推送进行自定义UI.
一个Notification Content Extension只能对应一个单独的category.我们需要在对应的extension的info.plist中NSExtension-》NSExtensionAttributes-》UNNotificationExtensionCategory填写我们定义的category, 自定义UI即可。
注意:
你可能会添加多个Notification Content Extension,但是每个通知必须支持一组唯一的通知类别,默认UNNotificationExtensionCategory是一个string确定唯一的一个category,当我们需要支持多个时可以将其改为Array
我们也可以隐藏不显示默认显示UI(title、subTitle、body)通过在info.plist中添加字段UNNotificationExtensionDefaultContentHidden值为true
总结
到现在关于客户端相关内容应该就介绍完了,自己的语言功底太low但还是希望能帮助到大家。下一篇会介绍关于Apple Push Notification service (APNs)的内容。