这篇文章我同事总结的, 感谢茗荚小草, 以下为原文.
- 参考了: iOS推送小结
- 本文内容包含:
iOS 7 - 基本的通知推送
iOS 8 - 通知+自定义button
iOS 9 - 通知+自定义button+快捷回复
使用Houston在本地调试远程通知
安装houston
gem install houston
安装完之后
apn push "<19904e80 0ab7f3e7 bc59ba36 3fda26f3 f4c69568 81cecc7f 4c675143 ba6fc83d>" -c /Users/bjhl/Desktop/apppush_for_CRM/apple_push_notification.pem -m "hello" -b "15" -d key=CRM -y actionCategory
-c 指定.pem文件的地址,-m 通知的文本内容 ,-b 角标的数量, -y category的标识符
要发送静默通知,.pem 文件之后,只添加-n 即可。-n 代表content-availabel
"<>"中的string为deviceToken。
在使用之前首先需要准备好pem证书文件
- pem文件由钥匙串中的Push Services证书和它的私钥文件导出的p12文件转化的来的。
- 在钥匙串中同时选中Push Services证书和它的私钥文件,右键导出为cert.p12文件,
- 使用下面的命令,将p12文件转化为applepushnotification.pem文件
openssl pkcs12 -in cert.p12 -out applepushnotification.pem -nodes -clcerts
- 有了pem文件就可以开始在终端测试远程通知了,pem文件在链接APNS时需要使用。
Push Services证书
- 首先需要生成一个certSigningRequest(CSR)文件
- 打开应用程序中的“钥匙串访问”软件,从菜单中选择 “钥匙串访问”-》“证书助理”-》“从证书颁发机构请求证书”,邮箱和名称填写,然后选择保存到磁盘,就可以在本地生成一个CertificateSigningRequest.certSigningRequest文件.
- developer.apple.com,在App IDs列表找到CRM的,进入编辑,勾选Push Notifications。打开推送服务。
- 生成推送证书.cer文件。用于生产服务端需要的文件.pem。
- 勾选Push Notification之后,出现一个列表,用来Manage and generate your certificates below。对应着生成Development SSL Certificate和Production SSL Certificate。选择Development SSL Certificate的create Certificate。
- 首先会提示你需要一个CSR文件。就是第一步中使用钥匙串生成的文件,上传,continue,continue,就可以下载一个aps_development.cer文件。保存到本地
- 双击该文件,钥匙串中就会出现一个Apple Development IOS push services证书。
- 之后就可以进行准备pem文件操作了。
上述准备工作做好之后,xcode运行
通过didRegisterForRemoteNotificationsWithDeviceToken 获取deviceToken
- 可能出现didFailToRegisterForRemoteNotificationsWithError: error = Code=3000 "未找到应用程序的“aps-environment”的授权字符串" ;
- 需要检查xcode 的TARGETS-capabilities 打开Push Notifications开关。
app处理接收到的通知
根据收到通知时,app的不同状态,app的处理方式不同
- app不在运行状态。推送通知显示,当用户点击通知,app的
- application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;
方法会被调用,通知内容通过launchOptions参数的形式被传递并处理 - app运行在前台。推送通知不会被显示,app收到通知后会立即调用方法
-application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
- app在运行状态,且不在前台,用户点击通知,app进入前台,调起方法
- application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler
iOS7中通知的代理方法
- application:didReceiveLocalNotification:(iOS 4.0–10.0Deprecated)
- application:didReceiveRemoteNotification:(app在前台时才会调用, iOS 3.0–10.0Deprecated)
- application:didReceiveRemoteNotification:fetchCompletionHandler:(当收到远程推送,该方法会被调用,iOS 7.0+)
iOS8中推送代理方法只有两个:
- application:handleActionWithIdentifier:forRemoteNotification:completionHandler:(iOS 8.0–10.0Deprecated)
- application:handleActionWithIdentifier:forLocalNotification:completionHandler:(iOS 8.0–10.0Deprecated)
iOS8中方法中的idenfier参数就对应着不同的action的唯一标识,用户点击通知上任何一个自定义的action之后,都会调用此方法
iOS 10中推送:
UNUserNotificationCenterDelegate
可交互的通知
iOS8拥有了全新的通知中心,有全新的通知机制。当屏幕顶部收到推送时只需要往下拉,就能看到快速操作界面,并不需要进入该应用才能操作。在锁屏界面,对于推送项目也可以快速处理。基本上就是让用户尽量在不离开当前页面的前提下处理推送信息,再次提高处理效率。
app不在前台时,出现推送通知,下拉或者3D touch 该通知都可以出现自定义的操作。
一般的远程推送消息 payload最大为2kb,256字节,超过该限制,APNS拒绝转发。
payload实际是一个JSON字典
- payload中主要的aps字典部分能做到
- 展示一个通知消息给用户
- 展示app的角标,
- 播放一段声音
- 静默通知, 比如悄悄升级
- 需要content-availabel=1,不能包括alert,sound,badge
- 调起方法application:didReceiveRemoteNotification:fetchCompletionHandler:
- 需要检查xcode 的targets->capabilities,勾选Background Modes中的Remote notifications
- aps数据部分的key:value,(其中的key是有apple定义的)
- alert:内容可以使简单的string,也可以是Dictionary
- badge:app的角标
- sound:声音文件的名字string,然后在app的bundle中去寻找
- content-availabel:数字,为1表示静默通知
- category:string,根据字符串去app中匹配自定义的一组action
初始化
要使用自定义的action,需要先判断当前系统为8.0+,再使用UIUserNotificationSettings,UIMutableUserNotificationCategory,UIMutableUserNotificationAction,自定义通知的操作。
- 初始化多个action
UIMutableUserNotificationAction *action1 = [[UIMutableUserNotificationAction alloc] init];
//UIUserNotificationActivationModeBackground 不会调起app到前台,在后台处理
//UIUserNotificationActivationModeForeground 点击该按钮时启动app到前台,且当前模式下setAuthenticationRequired默认为YES,
[action1 setActivationMode:UIUserNotificationActivationModeBackground];
[action1 setTitle:@"Background"];//展示在通知上的title
[action1 setIdentifier:@"action1"];//action的唯一标识
[action1 setDestructive:YES];//当前操作按钮为红色
[action1 setAuthenticationRequired:YES];//需要解锁与否
……
action2, action3, action4, action5, action6, action7
- 使用一组action初始化UIMutableUserNotificationCategory
UIMutableUserNotificationCategory *actionCategory = [[UIMutableUserNotificationCategory alloc] init];
[actionCategory setIdentifier:@"actionCategory"];//这组动作的标识,同后台约定
[actionCategory setActions:@[action1, action2, action3, action4, action5, action6, action7] forContext:UIUserNotificationActionContextDefault];
//使用UIUserNotificationActionContextDefault没有action数目限制,但是action过多屏幕太短也无力……,UIUserNotificationActionContextMinimal不展示action
- 使用category初始化UIUserNotificationSettings ,注册远程通知
NSSet *category = [NSSet setWithObject:actionCategory];
UIUserNotificationType types = (UIUserNotificationTypeAlert|UIUserNotificationTypeSound|UIUserNotificationTypeBadge);
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:category];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
[[UIApplication sharedApplication] registerForRemoteNotifications];
iOS8以下的系统,注册远程通知:
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:
(UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound | UIRemoteNotificationTypeAlert)];
- 远程通知的处理
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
NSLog(@"application:didReceiveRemoteNotification:fetchCompletionHandler");
//TODO:对远程通知的处理
if(completionHandler) {
completionHandler(UIBackgroundFetchResultNoData);
}
}
- (void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification:(NSDictionary *)userInfo completionHandler:(void (^)())completionHandler {
NSLog(@"handleActionWithIdentifier:forRemoteNotification");
//TODO:对远程通知的处理,用户tap了identifier匹配的action之后的操作
if(completionHandler) {
completionHandler();
}
}
通知中心的快速回复 iOS 9.0–10.0Deprecated
以上为点击通知的按钮,进行操作,iOS9增加了一个供用户快速回复的Category类型
UIUserNotificationActionBehaviorTextInput(iOS 9.0–10.0Deprecated)
- 快捷输入action的初始化
if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 9.0) {
//iOS 支持在通知中心快速回复输入文字
UIMutableUserNotificationAction *inputAction = [[UIMutableUserNotificationAction alloc] init];
inputAction.behavior = UIUserNotificationActionBehaviorTextInput;
inputAction.activationMode = UIUserNotificationActivationModeBackground;
[inputAction setTitle:@"inputAction"];
[inputAction setIdentifier:@"inputAction"];
[inputAction setDestructive:NO];
//设置发送键的title
inputAction.parameters = @{UIUserNotificationTextInputActionButtonTitleKey:@"哇塞"};
}
- 对于快捷输入的action,需要使用
- (void)application:(UIApplication *)application handleActionWithIdentifier:(nullable NSString *)identifier forRemoteNotification:(NSDictionary *)userInfo withResponseInfo:(NSDictionary *)responseInfo completionHandler:(void(^)())completionHandler;
方法中的responseInfo中的UIUserNotificationActionResponseTypedTextKey
对应的value
来获取输入的文字。