[iOS]极光推送JPushSDK开发--准备篇

关于iOS中的推送, 我们使用最多的可能就是极光了, 关于极光推送, 这里不做过多的介绍, 可到其官网进行学习, 这里主要是介绍集成的大致过程.

一. 创建推送证书

1.1. 创建 APP ID

登陆苹果开发者中心developer.apple.com, 进入后台:

[iOS]极光推送JPushSDK开发--准备篇_第1张图片

选择Certificates, Identifiers&Profiles, 然后选择Identifiers下的App IDs , 右侧右上角 "+", 新建一个APP ID:

[iOS]极光推送JPushSDK开发--准备篇_第2张图片
新建 APP ID

下一步, 这里给你的ID 设置一个名字, 便于记忆就好:

[iOS]极光推送JPushSDK开发--准备篇_第3张图片
设置APP ID 信息

注意: 这里的APP ID Suffix, 一定要选择Explicit App ID(精确型), 不要选择下面的通配型(Wildcard App ID), 一般直接使用项目的 Bundle Identifier即可;

下面的App Services, 勾选Push Notifications:

[iOS]极光推送JPushSDK开发--准备篇_第4张图片
选择服务

然后, 根据页面提示继续, 完成即可;

PS: 如果是已有的APP ID 可点击下面的Edit, 来勾选 Push Notifications

[iOS]极光推送JPushSDK开发--准备篇_第5张图片
编辑 App ID

1.2 创建推送证书

然后选择Certificates下的 all, 点击右侧右上角 "+", 新建一个证书:

[iOS]极光推送JPushSDK开发--准备篇_第6张图片

然后来到下面这个界面, 选择你需要创建的证书类型:


[iOS]极光推送JPushSDK开发--准备篇_第7张图片
选择证书类型

Development下的:
Apple Push Notification service SSL (Sandbox) :测试环境下的推送证书

Production下的:
Apple Push Notification service SSL (Sandbox & Production): 发布环境, 推送证书

最好两种证书都创建一个, 一个用于测试, 一个用于发布;

然后来到:

[iOS]极光推送JPushSDK开发--准备篇_第8张图片
选择 APP ID

这里选择刚刚创建的 含有推送服务App ID

继续, 下个页面,不用设置, 接下来会来到:

[iOS]极光推送JPushSDK开发--准备篇_第9张图片
选择CSR请求文件

这里需要使用电脑的钥匙串访问来请求一个证书,:

[iOS]极光推送JPushSDK开发--准备篇_第10张图片

填写相关信息:

[iOS]极光推送JPushSDK开发--准备篇_第11张图片

这里选择的 保存到磁盘, 所以上面的邮箱可以随便写, 建议选择保存到磁盘, 然后选择个保存位置, 即可!

然后,回到证书申请页面, 选择刚刚使用钥匙串创建的请求证书, 下一步:
Download这个新的证书, 双击, 安装到钥匙串, 然后打开钥匙串:

[iOS]极光推送JPushSDK开发--准备篇_第12张图片

上面选择 登录, 下面选择 我的证书, 然后在右侧就能找到你刚刚安装的证书, 导出:

[iOS]极光推送JPushSDK开发--准备篇_第13张图片
导出证书

选择保存位置, 设置文件名称, 文件格式, 一定要选择个人信息交换(.p12)

[iOS]极光推送JPushSDK开发--准备篇_第14张图片

点击存储的时候, 会弹出设置密码的界面, 这里的密码一定要设置,而且不能忘记, 安装弹框提示, 至完成即可!
这样, 桌面上就要我们设置好的p12文件, 也就是我们配置好的推送证书.

二. 在极光平台创建应用

要想使用极光的服务, 需要注册成为极光的开发者.这里可在其官网进行注册, 然后进入控制台:

[iOS]极光推送JPushSDK开发--准备篇_第15张图片
极光控制台

应用管理中创建一个应用:
设置应用名称, 选择应用图标:

[iOS]极光推送JPushSDK开发--准备篇_第16张图片

下面的 Android不用管, 直接来到 iOS

[iOS]极光推送JPushSDK开发--准备篇_第17张图片

需要注意的是: 这里的证书密码必须要设置, 我之前导出时没有设置密码, 这里直接什么都没填, 但是认证一直不能通过, 所以要设置密码;

然后, 创建我的应用, 即可;我们就获取到了AppKey;

在最后弹出的页面中, 我们可以查看证书是否可用:

[iOS]极光推送JPushSDK开发--准备篇_第18张图片
应该状态

可以看到, 我这里的开发环境的证书状态是 已验证, 就是可用的, 成产环境的证书我没有上传, 所以此处的状态是 未上传, 点击左侧的 ?, 可以查看各个状态的含义:

[iOS]极光推送JPushSDK开发--准备篇_第19张图片
证书状态

三. 配置Xcode

3.1 集成SDK

首先在官网下载SDK, 将解压后的文件夹中的Lib 文件夹拖入到你的项目中:
有下面这三个文件:

[iOS]极光推送JPushSDK开发--准备篇_第20张图片

然后, 添加系统依赖库:

[iOS]极光推送JPushSDK开发--准备篇_第21张图片
添加系统依赖库

添加系统 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)
3.2 开启Push Notifications

来到Xcode的Capabilities, 打开Push Notifications, 如果是首次打开, 可能会弹出一个界面, 让你选择开发者账号, 选择你创建推送证书那个账号即可, 完成后如下图所示:

[iOS]极光推送JPushSDK开发--准备篇_第22张图片
3.3 关于网络访问权限

不过, 就要全面使用ATS, 所以这个操作, 以后可能就不行了:

info.plist文件添加NSAppTransportSecurity, 类型为字典 , 然后添加一个key: NSAllowsArbitraryLoads, 类型bool, 值为: YES,即可;

注意: 对于JPush 2.1.9 及以上的版本是支持ATS访问的, 所以在使用大于2.1.9版本的JPushSDK的时候, 不需要进行这个设置了, 这里使用的是3.0版本, 所以不需配置这一项.

3.4 使用API

以下只是极光推送文档中的实例代码!!!
在项目AppDelegate, 添加以下代码:

// 引入JPush功能所需头文件
#import "JPUSHService.h"
// iOS10注册APNs所需头文件
#ifdef NSFoundationVersionNumber_iOS_9_x_Max
#import 
#endif

并实现代理:

@interface AppDelegate ()

@end


-(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 *categories for iOS10 or later
    // NSSet *categories for iOS8 and iOS9
  }
  [JPUSHService registerForRemoteNotificationConfig:entity delegate:self];

// 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:advertisingId]; 

上面的方法中的几个参数, 官方的解释是这样的:

  • appKey :极光管理后台创建应用后自动生成的AppKey值。请确保应用内配置的 AppKey 与 Portal 上创建应用后生成的 AppKey 一致。
  • channel : 指明应用程序包的下载渠道,为方便分渠道统计,具体值由你自行定义,如:App Store。
  • apsForProduction : 1.3.1版本新增,用于标识当前应用所使用的APNs证书环境。0 (默认值)表示采用的是开发证书,1 表示采用生产证书发布应用。
    注:此字段的值要与Build Settings的Code Signing配置的证书环境一致。
  • advertisingIdentifier : IDFA 广告标示符

实现系统推送代理方法:

// 注册APNs成功并上报DeviceToken
- (void)application:(UIApplication *)application 
didRegisterForRemoteNotificationsWithDeviceToken:(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);
}

实现JPUSHRegisterDelegate 相关代理方法, 处理通知回调方法

#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];
}

然后, 在真机上, 测试,控制台输出包含以下信息的log, 说明已成功集成:

--------------------------- JPush Log ----------------------------
--------------------JPush SDK Version:3.0.0--build:13----------
--------------------JCore Lib Version:1.0.0------------
-----------------AppKey:e7f56fsafssdd61f72de59a----------------
----------------------------------------------------------------

四. 测试发送

来到极光的开发者服务后台, 在应用管理中找到你的应用, 然后点击进入, 选择推送-->发送通知:

[iOS]极光推送JPushSDK开发--准备篇_第23张图片
编辑推送内容

这里编辑需要发送的内容;
然后, 选择推送对象:

[iOS]极光推送JPushSDK开发--准备篇_第24张图片

这里选择的是开发环境和所有人, 然后立即发送即可! 这样, 你安装了这个App的设备就会收到这一条推送信息:

[iOS]极光推送JPushSDK开发--准备篇_第25张图片

以上便是最基本集成过程, 其他的业务需求, 可在此基础上进行相关逻辑的编写.
此篇文章对应的demo为:https://github.com/LQQZYY/LZJPush, 可以作为参考.

(完)

你可能感兴趣的:([iOS]极光推送JPushSDK开发--准备篇)