好凉一个秋

好久没有发动态了，今天介绍一下极光推送，关于apple通知的一些原理，这里就不做细致的介绍了，想要了解内部推送的原理，大家可以在简书搜索iOS开发知识汇总专题,点击链接//www.greatytc.com/collection/b9235769faa3 可直接进入，或者搜索微信公众号iOS开发知识汇总

Snip20161024_2.png

now,我们从创建好极光应用开始，获得appkey之后，打开xcode，进入项目，如图，可以看到有个开关，push notifications

通知开关

entitlements.png

but在这之前，很多人没有push notificaitons开关，don't worry，进入极光主页，你会发现，需要导入各种依赖库

依赖库.png

我们在xcode下的Build Phases逐个添加依赖库，如图

Build Phases

导入依赖库之后，在这里最关键的依赖库是UserNotificationcations.framework（xcode8及以上），关闭程序，重新启动，开关就会出现，然后打开开关,如图

Push Notifications

在开关下面，steps有两个项目，第一个如果爆红，说明没有导入项目所需的证书及配置文件（即在apple developer 生成的证书及配置文件） ，导入即可；如果第二个爆红，可能是因为你不小心删除了项目名.entitlements文件，解决方法是，关闭push Notifications开关之后再打开即可生成，如果不行的话，关闭程序，在关闭打开开关即可，如果 如果再不行，去你的废纸篓里面找被你删除的项目名.entitlements文件，重新拖到项目中重启项目即可

Build Settings
如果你的工程需要支持小于7.0的iOS系统，请到Build Settings 关闭 bitCode 选项，否则将无法正常编译通过。
设置 Search Paths 下的 User Header Search Paths 和 Library Search Paths，比如SDK文件夹（默认为lib）与工程文件在同一级目录下，则都设置为"$(SRCROOT)/{静态库所在文件夹名称}"即可 。《来自极光文档》

2.允许Xcode7支持Http传输方法

如果您使用的是2.1.9及以上的版本则不需要配置此步骤
如果用的是Xcode7或更新版本，需要在App项目的plist手动配置下key和值以支持http传输:
选择1：根据域名配置
在项目的info.plist中添加一个Key：NSAppTransportSecurity，类型为字典类型。
然后给它添加一个NSExceptionDomains，类型为字典类型；
把需要的支持的域添加給NSExceptionDomains。其中jpush.cn作为Key，类型为字典类型。
每个域下面需要设置2个属性：NSIncludesSubdomains、NSExceptionAllowsInsecureHTTPLoads。 两个属性均为Boolean类型，值分别为YES、YES。《来自极光文档》 。如图

Snip20161024_10.png

配置完以上之后，进入项目的appdelegate里面，首先导入头文件和遵循代理

#import "AppDelegate.h"
#import "JPUSHService.h"
#ifdef NSFoundationVersionNumber_iOS_9_x_Max
#import <UserNotifications/UserNotifications.h>
#endif

@interface AppDelegate ()<JPUSHRegisterDelegate>

在系统方法里面申请通知权限,这里最高只适用到xcode8.1（iOS10.1.2），以后如果出现iOS11在做更新改变

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
   if ([[UIDevice currentDevice].systemVersion floatValue] >= 10.0) {
        JPUSHRegisterEntity * entity = [[JPUSHRegisterEntity alloc] init];
        entity.types = UNAuthorizationOptionAlert|UNAuthorizationOptionBadge|UNAuthorizationOptionSound;
        [JPUSHService registerForRemoteNotificationConfig:entity delegate:self];
    }
    else if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) {
        //可以添加自定义categories
        [JPUSHService registerForRemoteNotificationTypes:(UIUserNotificationTypeBadge |
                                                          UIUserNotificationTypeSound |
                                                          UIUserNotificationTypeAlert)
                                              categories:nil];
    }
    else {
        //categories 必须为nil
        [JPUSHService registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge |
                                                          UIRemoteNotificationTypeSound |
                                                          UIRemoteNotificationTypeAlert)
                                              categories:nil];
    }
[JPUSHService setupWithOption:launchOptions appKey:appKey
                          channel:channel
                 apsForProduction:isProduction
            advertisingIdentifier:nil];  // 这里是没有advertisingIdentifier的情况，有的话，大家在自行添加
    //注册远端消息通知获取device token
    [application registerForRemoteNotifications];
}

注意：appkey一定不要忘了从极光复制过来

获取deviceToken

// 获取deviceToken
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
    [JPUSHService registerDeviceToken:deviceToken];
}
// 注意 ：此方法在ios 3 以后可以使用，但是在很多朋友可能会遇到不调用此方法的情况，也就无法获取deviceToke，这里提供一种解决方案
-(void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings
{
    [application registerForRemoteNotifications];
}    
关于这个deviceToken，iOS10系统上，每次卸载重装将产生新的app，如果没有卸载重装，每次请求获得的device token是不变的。
另外官网也对device token的变化进行了说明：

To protect user privacy, do not use device tokens to identify user devices. Device tokens change when the user updates the operating system and when a device’s data and settings are erased. As a result, apps should always request the current device token at launch time.

// ios 10 support 处于前台时接收到通知

// ios 10 support 处于前台时接收到通知
- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler
{
    NSDictionary * userInfo = notification.request.content.userInfo;
    if ([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
// 添加各种需求。。。。。
    }
    completionHandler(UNNotificationPresentationOptionAlert); 
// 处于前台时，添加需求，一般是弹出alert跟用户进行交互，这时候completionHandler(UNNotificationPresentationOptionAlert)这句话就可以注释掉了，这句话是系统的alert，显示在app的顶部，
}

    */ 如果处于前台时需要自定义弹框或者弹出alert，可以看一下//www.greatytc.com/p/d2a42072fad9 这篇文章

// iOS 10 Support 点击处理事件

// iOS 10 Support  点击处理事件
- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
    // Required
    
    NSDictionary * userInfo = response.notification.request.content.userInfo;
    if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
        //推送打开
        if (userInfo)
        {
            // 取得 APNs 标准信息内容
//            NSDictionary *aps = [userInfo valueForKey:@"aps"];
//            NSString *content = [aps valueForKey:@"alert"]; //推送显示的内容
//            NSInteger badge = [[aps valueForKey:@"badge"] integerValue]; //badge数量
//            NSString *sound = [aps valueForKey:@"sound"]; //播放的声音
            
           // 添加各种需求。。。。。
        
        [JPUSHService handleRemoteNotification:userInfo];
        completionHandler(UIBackgroundFetchResultNewData);
    }
    completionHandler();  // 系统要求执行这个方法
}

// iOS7 及以上接收到通知

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    
    // Required, iOS 7 Support
    [JPUSHService handleRemoteNotification:userInfo];
    completionHandler(UIBackgroundFetchResultNewData);
}

这里在iOS7及以上系统的方法中，如果需要在前台和后台做不同的处理的时候，需要判断一下app 的状态，判断方式如下

 if ([UIApplication sharedApplication].applicationState == UIApplicationStateActive) {
        
        // 处于前台时 ，添加各种需求代码。。。。

    }else if ([UIApplication sharedApplication].applicationState == UIApplicationStateBackground)
    {
        // app 处于后台 ，添加各种需求
    }

那么问题来了，前台后台收到推送的方法都有了，还有一种情况。。。。。程序完全退出的时候，这种情况下，点击通知会走下面这个方法(即注册通知时的方法，程序的入口)

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
}

在这个方法里，我们需要判断一下程序是否处于完全退出状态，判断方法如下

 NSDictionary *remoteNotification = [launchOptions objectForKey: UIApplicationLaunchOptionsRemoteNotificationKey];
   
    if (remoteNotification)
    {

   // 程序完全退出时，点击通知，添加需求。。。

  }

# 需要注意的地方：
有可能有些小伙伴在集成过程中用ios10的手机测试的时候，
在推送通知的时候ios10和ios7的两个代理方法都走了，具体原因具体对待，如果实在找
不到问题所在，这里提供两个方法，one：在ios10的两个代理方法的首尾加入以下语句
#ifdef NSFoundationVersionNumber_iOS_9_x_Max 
#endif      // ios10中加入这两句话
在ios7的代理方法首尾加入以下语句
#if __IPHONE_OS_VERSION_MAX_ALLOWED > __IPHONE_7_1  
#endif   // ios7中加入这两句话
第二种方法是直接在ios7的代理方法中加入判断：
if ([[UIDevice currentDevice].systemVersion floatValue] < 10.0）

// 基于iOS 6 及以下的系统版本 接收到通知

// 基于iOS 6 及以下的系统版本，如果 App状态为正在前台或者点击通知栏的通知消息，那么此函数将被调用，并且可通过AppDelegate的applicationState是否为UIApplicationStateActive判断程序是否在前台运行。此种情况在此函数中处理：
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
    // Required,For systems with less than or equal to iOS6
    
    // iOS 10 以下 Required
     [JPUSHService handleRemoteNotification:userInfo];
}

//最后清除角标

- (void)applicationDidEnterBackground:(UIApplication *)application {
    [[UIApplication alloc] setApplicationIconBadgeNumber:0];
}

// 点击之后badge清零
- (void)applicationWillEnterForeground:(UIApplication *)application {
    
    [application setApplicationIconBadgeNumber:0];
    [[UNUserNotificationCenter alloc] removeAllPendingNotificationRequests];
}

其他功能：

1 . 后台传入不同的值，点击通知进入不同的界面，可以在极光的官网发送通知界面，展开可选设置，使用附加字段，这里我加了一个键值对key和值可以自行设置，然后在工程中需要进行判断，

设置附加字段

代码如下：大家可以在点击通知会走的方法中调用此方法

// 传入字段，根据字段改变需求
- (void)ExtrasOfNotificationWithUserInfo:(NSDictionary *)userInfo
{
    if (userInfo)
    {
        // 取得 APNs 标准信息内容
//        NSDictionary *aps = [userInfo valueForKey:@"aps"];
//        NSString *content = [aps valueForKey:@"alert"]; //推送显示的内容
//        NSInteger badge = [[aps valueForKey:@"badge"] integerValue]; //badge数量
//        NSString *sound = [aps valueForKey:@"sound"]; //播放的声音
        // 取得Extras字段内容
        NSString *customizeField1 = [userInfo valueForKey:@"key"]; //服务端中Extras字段，key是自己定义的,需要与极光的附加字段一致
        // 若传入字段的值为1，进入相应的页面
        if ([customizeField1 integerValue] == 1){
            //是推送打开
            UIStoryboard *sb = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
            MainTabbarVC *rootTabBarC = [sb instantiateViewControllerWithIdentifier:@"MainTabbarVC"];
            [UIApplication sharedApplication].delegate.window.rootViewController = rootTabBarC;
// 下面的方法是自己封装的
            [rootTabBarC enterToElectronicInvoice];
        }
    }
    
}

 注意：这里的跳转方法可能不适用所有项目，大家可以看一下下面的链接，或许能够找到适合你工程的跳转方法

1.2 极光的点击通知的方法- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler 是对系统方法的封装，他的userInfo中含有自定义添加的key，但是其他三方库例如AWS的推送机制中就不包含自定义添加的key，这时候只能通过aps中的默认userInfo传递特定的值，aps的结构如下

iOS 10 之前
{  
   "aps":{  
      "alert":"内容",
      "badge":1,
      "sound":"default",
      "userinfo":{"username":"tom"}
   }
}


iOS 10及之后(iOS7、iOS8、iOS9可通用此模板)
{  
   "aps":{  
      "alert":{  
         "title":"标题", // 
         "subtitle":"子标题", // 一般使用title就能满足需求
         "body":"内容"
      },
      "badge":1, //角标数
      "sound":"default", //声音
      "userinfo":{ //通知内容信息
           "playid":"123",
           "username":"tom",
           "sex":1
      }
   }
}

如果只传递一串字符串或者不是按照上述格式发送通知消息，那么会默认把你传递的字符串全部转化成alert的内容，全部弹出来，所以在aws中我们可以这样定义

APNS_SANDBOX : "{"aps":{"alert":" title message", "userInfo":"username"}}"

这样在app中收到的弹出消息仅仅为title message ，而userInfo可以用来做其他的用处

2 . 指定用户发送远程通知，这里指定用户不能只根据DeviceToken来进行发送，在极光的官网也没有可以使用DeviceToken发送的选项，如下图

极光发送消息针对的人群

这里的Registration ID 并不是DeviceToken，话不多说，下面我们介绍一种使用别名Alias的方法，我们知道指定用户发送，无非是已经注册了本公司账号的人群，你想给不同的人推不同的消息，那么我们指定用户的时候，实际上是根据用户在我们公司注册的账号进行发送特定消息，例如用户的账单状态等等，所以我们可以在用户登陆账号之后，给用户分配一个id用做唯一标示，绑定极光的别名或者tag，当然这里绑定别名还是tag可以和后台商量一下，用什么其实都是可以的，代码如下

[JPUSHService setTags:nil alias:USER_INFO.userID fetchCompletionHandle:^(int iResCode, NSSet *iTags, NSString *iAlias) {
                NSLog(@"设置结果:%i 用户别名:%@",iResCode,USER_INFO.userID);
            }];
// 这是极光提供的方法，USER_INFO.userID是用户的id，你可以根据账号或者其他来设置，只要保证唯一便可


// 不要忘了在登出之后将别名置空
[JPUSHService setTags:nil alias:@"" fetchCompletionHandle:^(int iResCode, NSSet *iTags, NSString *iAlias) {
        NSLog(@"设置结果:%i 用户别名:%@",iResCode,USER_INFO.userID);
    }];

绑定完别名之后，指定用户发送消息的任务就可以交给后台了。如果你想自己测试一下，那就打印一下USER_INFO.userID ,然后自己用极光给自己推送，如图

根据自己的Alias给自己推送消息

有些朋友问我为啥收到通知有些方法就是不调用，这里要细心一点，有些方法是需要点击alert才会走，如果发送通知没有走进你想调试的方法里注意一下，是不是需要点击一下alert

至此，ios极光推送的集成就简单说到这里，未完。。。待续。。。觉得好的，就点个赞，有问题的可以私信我，或者加我qq：1162719523，同不同意那就不知道了

ios 收到远程通知，弹出提示框，点击确定跳转到消息界面：//www.greatytc.com/p/d2a42072fad9