快速集成极光推送

** Tips:** 不同版本极光推送SDK集成各有差异,各位童鞋在集成时一定要注意版本号,本人集成的是基于 极光SDK JPush SDK-3.0.1的版本.

注意:极光推送的远程推送是免费的,但相应的用户统计,终端统计等功能是不免费。如果你需要用户统计,终端统计这些功能意味着需要付费才能使用。

先祭出极光SDK(内附极光官方Demo)

参考链接

极光推送官方文档
开发证书配置
APNs 推送原理及问题
iOS 推送全解析,你不可不知的所有 Tips!

集成步骤

1.远程推送原理
2.[Xcode8创建项目,配置自动创建App ID/证书/配置文件](#Xcode8创建项目,配置自动创建App ID/证书/配置文件)
3.[创建APNs 推送证书](#创建APNs 推送证书)
4.[在极光推送后台创建应用,并上传APNs 推送证书](#在极光推送后台创建应用,并上传APNs 推送证书)
5.项目中集成极光推送SDK
6.成功运行
7.极光推送后台发送远程推送测试

<a id = 远程推送原理></a> 1.远程推送原理

当iOS设备联网的情况下,苹果服务器和iOS设备建立了一个长链接,即便应用处于挂起和后台的状态,苹果可以给iOS设备中的应用发送通知。

远程推送原理
远程推送原理

注:
1.iOS:iOS设备
2.APNS Server:苹果服务器
3.Your App: 自己的应用
4.Your Server:自己的服务器

1.1 推送流程

  • iOS 应用注册推送通知,iOS设备将设备的UDID和应用的Bundle ID到苹果服务器。
  • 苹果服务器将接收到的UDID和Bundle ID加密生成一个deviceToken,并返回给对应iOS应用。
  • iOS应用将接收到的deviceToken发送到自己的服务器,服务器并保存。
  • 自己的服务器需配置APNs 推送证书,当需要推送时,去后台查询推送目标设备的deviceToken,将消息和deviceToken一起发送给苹果服务器。
  • 苹果服务器通过deviceToken找到对应设备下的对应应用,推送消息。
注意:

1.我们的应用真机测试需要创建对应App ID/证书/配置文件, 这步可以用Xcode8 自动创建,而不需要到苹果开发者平台去创建。如果不是Xcode8,则需要去开发者平台申请,并且在Xcode配置,保证真机测试即可。
2.我们自己的服务器需要配置 APNs 推送证书,同样的分为开发证书和生产证书。需要到苹果开发者平台去申请。
3.如果不借助第三方推送平台,我们需要完成推送流程中的1,3,4步。借助极光推送,那么我们只需要完成推送流程中的1,3步,但同样需要我们申请APNs 推送证书,并且上传到极光推送平台。

<a id = "Xcode8创建项目,配置自动创建App ID/证书/配置文件"></a>2. Xcode8配置自动创建App ID/证书/配置文件

2.1 在Xcode8下,确保已经登录付费苹果开发者帐号。请开启Application Target的Capabilities->Push Notifications选项。

开启远程推送
开启远程推送

2.2 *勾选自动管理App ID/证书/配置文件 *


勾选自动管理
勾选自动管理

2.3 检查Xcode生产的App ID/证书/配置文件这步配置好了就可以真机运行了。

检查Xcode生产的App ID/证书/配置文件
检查Xcode生产的App ID/证书/配置文件

<a id = "创建APNs 推送证书"></a>3. 创建APNs 推送证书

3.1 登录开发者网站,并点击按钮创建证书

创建推送证书
创建推送证书

3.2 选择开发环境APNs 推送证书点击右下角按钮创建

创建开发环境APNs 推送证书
创建开发环境APNs 推送证书

3.3 选择工程的App ID

选择工程的App ID
选择工程的App ID

3.4 上传证书请求文件,不知道的童鞋可参照开发证书配置

上传证书请求文件
上传证书请求文件

附: 3.4.1 请求文件的创建流程


从证书颁发机构请求证书
从证书颁发机构请求证书

存储到磁盘
存储到磁盘

存储
存储

请求文件
请求文件

3.5 点击下载证书,并双击安装到钥匙串.

安装APNs 推送证书
安装APNs 推送证书

3.6 打开钥匙串,并参照下图指示,找到对应的APNs 推送证书,并选择右键导出.

钥匙串导出证书
钥匙串导出证书

3.7 设置证书名字,并选择证书存放位置。

设置证书名字
设置证书名字

3.8.设置证书密码,可不填。极光推送支持证书设置密码,但像leanCloud
推送不支持证书设置密码,各位童鞋可按照实际情况来。最后输入电脑开机密码,导出证书。

设置证书密码
设置证书密码

输入电脑开机密码导出证书
输入电脑开机密码导出证书

<a id = "在极光推送后台创建应用,并上传APNs 推送证书"></a> 4.在极光推送后台创建应用,并上传APNs 推送证书

4.1 登录极光推送平台,切换到控制台,并创建应用。接下来在应用信息中上传开发APNs 推送证书。生产环境APNs 推送证书配置类似,不做赘述.

上传`APNs推送证书
上传`APNs推送证书

4.2 核对应用的Bundle ID 等信息是否正确.

核对应用信息
核对应用信息

<a id = "项目中集成极光推送SDK"></a> 5. 项目中集成极光推送SDK

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

// 引入JPush功能所需头文件
#import "JPUSHService.h"
// iOS10注册APNs所需头文件
#ifdef NSFoundationVersionNumber_iOS_9_x_Max
#import <UserNotifications/UserNotifications.h>
#endif
// 如果需要使用idfa功能所需要引入的头文件(可选)
#import <AdSupport/AdSupport.h>

5.2 添加Delegate
为AppDelegate添加Delegate。
参考代码:

@interface AppDelegate ()<JPUSHRegisterDelegate>

@end

5.3 添加初始化代码

配置 key
static NSString *appKey = @"c3d* **** **** **** **** ***8";
//static NSString *channel = @" ";
static BOOL isProduction = FALSE;

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [self setup_APNs];
    [self setup_JpushdidFinishLaunchingWithOptions:launchOptions];
    
    return YES;
}

5.3.1 添加初始化APNs代码

//添加初始化APNs代码
- (void)setup_APNs{
    //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];
}

5.3.2 添加初始化JPush代码

//添加初始化JPush代码
- (void)setup_JpushdidFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 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:nil
                 apsForProduction:isProduction
            advertisingIdentifier:advertisingId];
    
}
  • 部分参数说明:

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

5.3.3 注册APNs成功并上报DeviceToken

- (void)application:(UIApplication *)application 
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

  /// Required - 注册 DeviceToken
  [JPUSHService registerDeviceToken:deviceToken];
}

5.3.4 实现注册APNs失败接口(可选)

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

5.3.5 添加处理APNs通知回调方法
请在AppDelegate.m实现该回调方法并添加回调方法中的代码

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

<a id = "成功运行"></a> 6 成功运行

真机调试该项目,如果控制台输出以下日志则代表您已经集成成功。

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

如果调试运行中遇到问题请参考:iOS SDK 调试指南

<a id = "极光推送后台发送远程推送测试"></a>7.极光推送后台发送远程推送测试

7.1 登录极光推送,切换到控制台,并点击对应的应用,点击推送按钮,设置推送内容,并发送通知

点击推送按钮,设置推送内容并发送通知
点击推送按钮,设置推送内容并发送通知

7.2 选择推送环境iOS开发环境,目标人群,发送时间。再点击可选设置设置消息的具体内容。

设置推送目标
设置推送目标

7.3 设置消息具体内容。远程推送分为普通推送/后台推送/静默推送3种类型,并且类型由推送消息设置来决定。关于如何设置请参考iOS 推送全解析,你不可不知的所有 Tips!

设置消息具体内容
设置消息具体内容

7.4 iOS设备接收到远程推送

iOS设备接收到远程推送
iOS设备接收到远程推送

7.5 推送历史可以在这里看得到,但有延迟,可能远程推送已接收到,推送历史数据还没有更新到最新。

推送历史
推送历史

Xcode8下集成极光远程推送的简单介绍,到这里就结束了。
祭出自己的JPushDemo

另外我想说,如果学习不是为了装逼,那将毫无意义!

另外.....

我的愿望是.......

世界和平.........

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容