关于JPush(极光推送)那些事

2017-03-06 本文已影响2807人 Cooci_和谐学习_不急不躁

iOS不倒,博客不停

JPush的文档说明挺不错,非常详细!为什么还要写这篇简书?主要是为了记录自己开发过程,也给一些朋友提供一点点帮助.首先是JPush的文档地址:JPush文档

JPush,推送原理可以看出，JPush iOS Push 包括 2 个部分，APNs 推送(代理)与 JPush 应用内消息。
红色部分是 APNs 推送，JPush 代理开发者的应用（需要基于开发者提供的应用证书），向苹果 APNs 服务器推送。由 APNs Server 推送到 iOS 设备上。
蓝色部分是 JPush 应用内推送部分，即 App 启动时，内嵌的 JPush SDK 会开启长连接到 JPush Server，从而 JPush Server 可以推送消息到 App 里

APNs 通知

APNs 通知：是指通过向 Apple APNs 服务器发送通知，到达 iOS 设备，由 iOS 系统提供展现的推送。用户可以通过 IOS 系统的 “设置” >> “通知” 进行设置，开启或者关闭某一个 App 的推送能力。
JPush iOS SDK 不负责 APNs 通知的展现，只是向 JPush 服务器端上传 Device Token 信息，JPush 服务器端代理开发者向 Apple APNs 推送通知。
获取 APNs 推送内容
应用内消息

应用内消息：JPush iOS SDK 提供的应用内消息功能，在 App 在前台时能够收到推送下来的消息。App 可使用此功能来做消息下发动作。
此消息不经过 APNs 服务器，完全由 JPush 提供功能支持。
APNs通知与应用内消息对比

如果只需要发送通知，则可以忽略应用内消息的处理。对于两种消息的代码处理可以参考API 部分的描述。
JPush API v3 支持同时一次调用同时推送 APNs 通知与 JPush 应用内消息。这在某些应用场景里是有意义的。

APNs 通知与应用内消息对比.png

OK,原理了解之后,下面开始集成.

1:下载JPush的SDK:SDK下载地址

2:在JPush平台注册应用,这里的目的:

A:交付授权,因为在这里开发者需要上传应用的推送开发证书,推送生产证书,这样JPush平台就能去苹果服务器拿去一个推送关键字段:DeviceToken,相当于授权码.
B:平台注册,还会生成一个:AppKey和一个MasterSecret.这两个东西相当于一个登陆账号,一个登陆密码.这样生成出来,JPush就能根据MasterSecret.去校验** AppKey,然后去找绑定在这个 AppKey上面的生产,开发证书授权的DeviceToken**去苹果服务器推送消息.

JPush平台创建应用.jpg 生成成产,开发证书

JPush创建成功.jpg

3 导入SDK

将SDK包解压，在Xcode中选择“Add files to 'Your project name'...”，将解压后的lib子文件夹（包含JPUSHService.h、jpush-ios-x.x.x.a，jcore-ios-x.x.x.a）添加到你的工程目录中。
添加Framework:

CFNetwork.framework
CoreFoundation.framework
CoreTelephony.framework
SystemConfiguration.framework
CoreGraphics.framework
Foundation.framework
UIKit.framework
Security.framework
libz.tbd (Xcode7以下版本是libz.dylib)
AdSupport.framework (获取IDFA需要；如果不使用IDFA，请不要添加)
UserNotifications.framework (Xcode8及以上)
libresolv.tbd (JPush 2.2.0及以上版本需要, Xcode7以下版本是libresolv.dylib)

*4:编译与开启推送功能

编译与开启推送功能

*5:ATS

    <key>NSAppTransportSecurity</key> 
    <dict> 
    <key>NSAllowsArbitraryLoads</key> 
    <true/> 
    </dict>

*6:添加头文件和添加代理

请将以下代码添加到 AppDelegate.m 引用头文件的位置。

 // 引入JPush功能所需头文件
#import "JPUSHService.h"
// iOS10注册APNs所需头文件
#ifdef NSFoundationVersionNumber_iOS_9_x_Max
#import <UserNotifications/UserNotifications.h>
#endif
// 如果需要使用idfa功能所需要引入的头文件（可选）
#import <AdSupport/AdSupport.h>
为AppDelegate添加Delegate
< JPUSHRegisterDelegate >

7:核心代码: 添加初始化代码

添加初始化APNs代码###

请将以下代码添加到

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

//Required
//notice: 3.0.0及以后版本注册可以这样写，也可以继续用之前的注册方式
JPUSHRegisterEntity * entity = [[JPUSHRegisterEntity alloc] init];
entity.types = JPAuthorizationOptionAlert|JPAuthorizationOptionBadge|JPAuthorizationOptionSound;
if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) {
    // 可以添加自定义categories
    // NSSet<UNNotificationCategory *> *categories for iOS10 or later
    // NSSet<UIUserNotificationCategory *> *categories for iOS8 and iOS9
}
[JPUSHService registerForRemoteNotificationConfig:entity delegate:self];

添加初始化JPush代码###

// Optional
// 获取IDFA
// 如需使用IDFA功能请添加此代码并在初始化方法的advertisingIdentifier参数中填写对应值
//    NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
// Required
// init Push
// notice: 2.1.5版本的SDK新增的注册方法，改成可上报IDFA，如果没有使用IDFA直接传nil
// 如需继续使用pushConfig.plist文件声明appKey等配置内容，请依旧使用[JPUSHService setupWithOption:launchOptions]方式初始化。
[JPUSHService setupWithOption:launchOptions appKey:appKey
                      channel:channel
             apsForProduction:isProduction
        advertisingIdentifier:nil];

注册APNs成功并上报DeviceToken###

- (void)application:(UIApplication *)applicationdidRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    /// Required - 注册 DeviceToken
    [JPUSHService registerDeviceToken:deviceToken];
}

实现注册APNs失败接口（可选）###

- (void)application:(UIApplication *)application   didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
    //Optional
    NSLog(@"did Fail To Register For Remote Notifications With Error: %@",error);
}

添加处理APNs通知回调方法###

下面这几个方法也是核心代码,这是对通知的回调方法,通知达到之后会调用这下面的方法,所以说也是必须要实现的.JPush考虑很周全,涉及到了各个版本,但是方法太多,要是能一个方法处理完就更好了.

 #pragma mark- JPUSHRegisterDelegate
// iOS 10 Support
- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler {
  // Required
  NSDictionary * userInfo = notification.request.content.userInfo;
  if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
    [JPUSHService handleRemoteNotification:userInfo];
  }
  completionHandler(UNNotificationPresentationOptionAlert); // 需要执行这个方法，选择是否提醒用户，有Badge、Sound、Alert三种类型可以选择设置
}

// 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];
  }
  completionHandler();  // 系统要求执行这个方法
}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

  // Required, iOS 7 Support
  [JPUSHService handleRemoteNotification:userInfo];
  completionHandler(UIBackgroundFetchResultNewData);
}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {

  // Required,For systems with less than or equal to iOS6
  [JPUSHService handleRemoteNotification:userInfo];
}

调用,成功打印:###

2016-08-19 17:12:12.745823 219b28[1443:286814]  | JPUSH | I -     [JPUSHLogin] 
----- login result -----  
uid:5460310207   
registrationID:171976fa8a8620a14a4

程序到这,也就基本集成完毕:

8:还有推送的一些新特性极光新特性地址

action.jpg

这样就能给你推送添加操作:
具体代码:

    UNNotificationAction *closeAction = [UNNotificationAction actionWithIdentifier:@"close" title:@"关闭" options:UNNotificationActionOptionDestructive];
    UNNotificationAction *enterAction = [UNNotificationAction actionWithIdentifier:@"enter" title:@"进入" options:UNNotificationActionOptionForeground];
    UNNotificationAction *unLockAction = [UNNotificationAction actionWithIdentifier:@"unLock" title:@"解锁" options:UNNotificationActionOptionAuthenticationRequired];
    UNTextInputNotificationAction *inputAction = [UNTextInputNotificationAction actionWithIdentifier:@"input" title:@"输入" options:UNNotificationActionOptionAuthenticationRequired];  UNNotificationCategory *category = [UNNotificationCategory categoryWithIdentifier:@"comment-reply" actions:@[inputAction,enterAction,unLockAction,closeAction] intentIdentifiers:@[] options:UNNotificationCategoryOptionNone];
    [[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:[NSSet setWithObject:category]];

iOS 10 想要对这些操作action处理:

- (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
    // Required
    NSString *identifier = response.actionIdentifier;
    if ([identifier isEqualToString:@"close"]) {
        //对输入的文字作处理
        NSLog(@"close");
    }else if ([identifier isEqualToString:@"input"]){
         //
        NSLog(@"input");
    }else if ([identifier isEqualToString:@"enter"]){
        //enter
        NSLog(@"enter");
    }else if ([identifier isEqualToString:@"unLock"]){
        //enter
        NSLog(@"unLock");
    }
    NSLog(@"didReceiveNotificationResponse:response == %@",response);
    NSLog(@"didReceiveNotificationResponse:center == %@",center);
    NSDictionary * userInfo = response.notification.request.content.userInfo;
    if([response.notification.request.trigger isKindOfClass:    [UNPushNotificationTrigger class]]) {
        [JPUSHService handleRemoteNotification:userInfo];
    }
    completionHandler();  // 系统要求执行这个方法
}

iOS 9 想要对这些操作action处理:

 - (void)application:(UIApplication *)applicationhandleActionWithIdentifier:(NSString *)identifier  forRemoteNotification:(NSDictionary *)userInfo  completionHandler:(void (^)())completionHandler {
    if ([identifier isEqualToString:@"close"]) {
        //对输入的文字作处理
        NSLog(@"close");
        NSLog(@"forRemoteNotification == %@",userInfo);
    }else if ([identifier isEqualToString:@"input"]){
    //
        NSLog(@"input");
        NSLog(@"forRemoteNotification == %@",userInfo);
    }else if ([identifier isEqualToString:@"enter"]){
        //enter
        NSLog(@"enter");
        NSLog(@"forRemoteNotification == %@",userInfo);
    }else if ([identifier isEqualToString:@"unLock"]){
        //enter
        NSLog(@"unLock");
        NSLog(@"forRemoteNotification == %@",userInfo);
      }
    completionHandler();
}

iOS 8 想要对这些操作action处理:

- (void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forLocalNotification:(UNNotificationRequest *)notificatio  completionHandler:(void (^)())completionHandler {
    if ([identifier isEqualToString:@"close"]) {
        //对输入的文字作处理
        NSLog(@"close");
        NSLog(@"forRemoteNotification == %@",userInfo);
    }else if ([identifier isEqualToString:@"input"]){
    //
        NSLog(@"input");
        NSLog(@"forRemoteNotification == %@",userInfo);
    }else if ([identifier isEqualToString:@"enter"]){
        //enter
        NSLog(@"enter");
        NSLog(@"forRemoteNotification == %@",userInfo);
    }else if ([identifier isEqualToString:@"unLock"]){
        //enter
        NSLog(@"unLock");
        NSLog(@"forRemoteNotification == %@",userInfo);
      }
    completionHandler();
}

上面三个方法还可以对附件:attachment操作处理;
9:这里还介绍一下关于设置tags和alias

/*!
 * 下面的接口是可选的
 * 设置标签和(或)别名（若参数为nil，则忽略；若是空对象，则清空；详情请  参考文档：https://docs.jiguang.cn/jpush/client/iOS/ios_api/）
 * setTags:alias:fetchCompletionHandle:是新的设置标签别名的方法，不再需要显示声明回调函数，只需要在block里面处理设置结果即可.
 * WARN: 使用block时需要注意循环引用问题
 */
+ (void)setTags:(NSSet *)tags alias:(NSString *)alias callbackSelector(SEL)cbSelector object:(id)theTarget;

10:设置Badge

+ (BOOL)setBadge:(int)value

清空JPush服务器中存储的badge值，即 [setBadge:0]
+ (void)resetBadge

11:API 用于移除待推送或已在通知中心显示的推送（支持iOS10，并兼容iOS10以下版本）

+ (void)removeNotification:(JPushNotificationIdentifier *)identifier;

iOS10以上identifier设置为nil，则移除所有在通知中心显示推送和待推送请求，也可以通过设置identifier.delivered和identifier.identifiers来移除相应在通知中心显示推送或待推送请求，identifier.identifiers如果设置为nil或空数组则移除相应标志下所有在通知中心显示推送或待推送请求；iOS10以下identifier设置为nil，则移除所有推送，identifier.delivered属性无效，另外可以通过identifier.notificationObj传入特定推送对象来移除此推送。

12:极光还有下面的功能(因为项目没有集成,没有仔细研究):极光响应SDK地址

AddNotification: 广告推送
FindNotification: 查询推送
SetLocalNotification: 地理推送
clearAllLocalNotification:用于清除所有注册的通知

花了一周时间学习极光推送,虽然时间有点长,但是对于我自己来说很不错了,沉下心来慢慢学东西,不管外面iOS多么多么惨,但是只要一天iOS不倒,我还会坚持学习,坚持学