iOS app Push

iOS 7 -基本的通知推送
iOS 8 -通知+自定义action
iOS 9 -通知+自定义action+快捷回复
iOS 10 -新框架UserNotifications

使用Houston在本地调试远程通知

参考iOS推送小结
Ruby的运行
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-available
"< >"中的string为deviceToken。

houston主页还提供了脚本文件.rb，修改对应的token参数,更改pem文件路径，运行ruby脚本，成功即可。

在使用之前首先需要准备好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开关。
- 打开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

image

iOS 7中通知的代理方法

application:didReceiveLocalNotification:(iOS 4.0–10.0 Deprecated)
application:didReceiveRemoteNotification:(app在前台时才会调用, iOS 3.0–10.0 Deprecated)
application:didReceiveRemoteNotification:fetchCompletionHandler:(当收到远程推送，该方法会被调用,iOS 7.0+)
- 服务端的推送中必须带有参数content-available 才能在app后台运行时调起这个方法，否则不携带该参数就跟7之前的普调推送一样，后台app不会调起这个方法
- 如果app被用户手动kill，那么还是不会调起这个方法
- 即使用户禁止通知，在符合条件下，该方法还是会被调起
- 该方法有个弊端：当app是未运行状态时，从通知栏点击通知并启动app时，didFinishLaunchingWithOptions和didReceiveRemoteNotification:fetchCompletionHandler会先后被调起，导致通知被多次处理

iOS 8中推送代理方法只有两个：

application:handleActionWithIdentifier:forRemoteNotification:completionHandler:(iOS 8.0–10.0Deprecated)
application:handleActionWithIdentifier:forLocalNotification:completionHandler:(iOS 8.0–10.0Deprecated)
iOS 8中方法中的idenfier参数就对应着不同的action的唯一标识，用户点击通知上任何一个自定义的action之后，都会调用这个方法

可交互的通知

iOS 8拥有了全新的通知中心，有全新的通知机制。当屏幕顶部收到推送时只需要往下拉，就能看到快速操作界面，并不需要进入该应用才能操作。在锁屏界面，对于推送项目也可以快速处理。基本上就是让用户尽量在不离开当前页面的前提下处理推送信息，再次提高处理效率。
app不在前台时，出现推送通知，下拉或者3D touch 该通知都可以出现自定义的操作。

image

一般的远程推送消息 payload最大为2kb，256字节，超过该限制，APNS拒绝转发。

payload实际是一个JSON字典

参考官方文档：
Creating the Remote Notification Payload
Payload Key Reference

payload中主要的aps字典部分能做到
- 展示一个通知消息给用户
- 展示app的角标，
- 播放一段声音
- 静默通知, 比如悄悄升级
  - 需要content-available=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-available:数字，为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.0 Deprecated

以上为点击通知的按钮，进行操作，iOS 9增加了一个供用户快速回复的action类型
UIUserNotificationActionBehaviorTextInput（iOS 9.0–10.0 Deprecated）

快捷输入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，需要使用application:(UIApplication *)application handleActionWithIdentifier:(nullable NSString *)identifier forRemoteNotification:(NSDictionary *)userInfo withResponseInfo:(NSDictionary *)responseInfo completionHandler:(void(^)())completionHandler方法中的responseInfo中的UIUserNotificationActionResponseTypedTextKey对应的value来获取输入的文字。

iOS 10中推送：UNUserNotificationCenterDelegate
iOS 10提供了两个代理方法来处理通知，将本地和远程通知的方法合并了

userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler;
userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler

iOS 10 有个特性，不管app在前台还是后台，有通知到达就会展示出来。10之前的系统，位于前台的app收到通知是不会有弹框提醒的

iOS 7,8,9 推送通知