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

作者: Cooci_和谐学习_不急不躁 | 来源:发表于2017-03-06 10:30 被阅读2807次

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不倒,我还会坚持学习,坚持学

网友评论

滚来滚去的桔子:你好，使用了极光的远程推送 api，想使用系统的本地推送 api 会不会有冲突？
瑞廷:极光推送字数最多可发送多少？
寸光片静: 你好！问下极光的新特性怎么操作， 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]];
这段demo要放哪执行呢？？
刘建国大好人:[UIApplication sharedApplication].applicationIconBadgeNumber = 0;
这句执行完后,通知栏被清空了,怎么能搞定这种情况呢
刘建国大好人:@西单_夜未央怎么做可以,去掉角标,通知栏只删除查看过的那个
Cooci_和谐学习_不急不躁:@刘建国大好人你这是清空badge，你也可以自定义
刘建国大好人:再问个问题哈,- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo 这个方法从来没走过,一直走的都是这个方法- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler 为什么呀他俩都什么区别吗
刘建国大好人:@西单_夜未央找到了哈哈
刘建国大好人:@西单_夜未央 [JPUSHService setTags:nil alias:@"123_nihao" fetchCompletionHandle:^(int iResCode, NSSet *iTags, NSString *iAlias) {
NSLog(@"123====%@",iAlias);
}]; 我这么设置别名怎么不好使啊
Cooci_和谐学习_不急不躁:@刘建国大好人 API解释：调用下面的方法就不调上面的方法
刘建国大好人:在极光后台推送的时候,有个可选设置 : badge 这个是显示app角标数量的吧, 角标数量初始不是我们app决定的吗
Cooci_和谐学习_不急不躁:@刘建国大好人这个badge表示比的通知数量，你可以根据后台接口设置
刘建国大好人:jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler 这个方法只能在ios10中用吗
Cooci_和谐学习_不急不躁:@刘建国大好人不会调用
刘建国大好人:@西单_夜未央 10 之前用了就炸呗?
Cooci_和谐学习_不急不躁:对,这是iOS10的方法
刘建国大好人:你好, 能加个联系方式吗
Cooci_和谐学习_不急不躁:@刘建国大好人你调用这个方法: + (BOOL)setBadge:(int)value
刘建国大好人:@西单_夜未央在通知页面点清除后,app图片上还是有数字显示,这种情况怎么解决啊
Cooci_和谐学习_不急不躁:@刘建国大好人你可以随时发简信给我，我都在线
素酥:你好……如果在发生通知的时候出现丢包的情况，就是有一些手机收的到有一些手机收不到你们是怎么处理的？求教
素酥:@西单_夜未央还有你提的那些意见我都已经排查了……官方回答是：已经成功给了apple服务器了，网络用WiFi的应该没问题，通知设置又是开的，所以我就很想不明白为什么收不到……有时候能收到有时候又收不到这才纠结
素酥:@西单_夜未央那对于丢包有什么解决办法嘛？大神……因为我别名推送昨晚到现在都是目标为1成功为0
Cooci_和谐学习_不急不躁:你好素酥,感谢你在我简书留的评论,在极光推送丢包现象是存在的.尤其对于Android,我在极光平台统计看了,iOS,Android在前期很低.尤其根据机型问题.我们的措施就是先找到为什么会丢包:我们通过极光的msgid和没收到消息的设备的registrationID进行匹对,极光官方也给我们提供不少帮助.
可能原因:
1.网络
2.iOS的apns通知只保留一条离线
3.自定义消息默认不展示，只接受，且iOS只在前台接受
4.iOS除iOS10外，前台收到通知不提醒
希望能够帮到你

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

iOS不倒,博客不停

APNs 通知

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

*5:ATS

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

添加初始化APNs代码###

添加初始化JPush代码###

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

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

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

调用,成功打印:###

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

10:设置Badge

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

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

ios

iOS tips

iOS 进阶开发

iOS开发资料收集

iOS学习

iOS

iOS 开发每天分享优质文章

征服iOS