Tips: 不同版本极光推送SDK集成各有差异,各位童鞋在集成时一定要注意版本号,本人集成的是基于 极光SDK JPush SDK-3.0.1的版本.
注意:极光推送的远程推送是免费的,但相应的用户统计,终端统计等功能是不免费。如果你需要用户统计,终端统计这些功能意味着需要付费才能使用。
#参考链接
极光推送官方文档
开发证书配置
APNs 推送原理及问题
iOS 推送全解析,你不可不知的所有 Tips!
###集成步骤
1.远程推送原理
2.Xcode8创建项目,配置自动创建App ID/证书/配置文件
3.创建APNs 推送证书
4.在极光推送后台创建应用,并上传APNs 推送证书
5.项目中集成极光推送SDK
6.获取 APNs(通知) 推送内容
####1.远程推送原理
当iOS设备联网的情况下,苹果服务器和iOS设备建立了一个长链接,即便应用处于挂起和后台的状态,苹果可以给iOS设备中的应用发送通知。
注:
1.iOS:iOS设备
2.APNS Server:苹果服务器
3.Your App: 自己的应用
4.Your Server:自己的服务器
1.1 推送流程
####2. Xcode8配置自动创建App ID/证书/配置文件
2.1 在Xcode8下,确保已经登录付费苹果开发者帐号。请开启Application Target的Capabilities->Push Notifications选项。
2.2 勾选自动管理App ID/证书/配置文件
2.3 检查Xcode生产的App ID/证书/配置文件这步配置好了就可以真机运行了。
####3. 创建APNs 推送证书
3.1 登录开发者网站,并点击按钮创建证书
3.2 选择开发环境APNs 推送证书
点击右下角按钮创建
3.3 选择工程的App ID
3.4 上传证书请求文件,不知道的童鞋可参照开发证书配置
附: 3.4.1 请求文件的创建流程
3.5 点击下载证书,并双击安装到钥匙串.
3.6 打开钥匙串,并参照下图指示,找到对应的APNs 推送证书,并选择右键导出.
3.7 设置证书名字,并选择证书存放位置。
3.8.设置证书密码,可不填。极光推送支持证书设置密码,但像leanCloud
推送不支持证书设置密码,各位童鞋可按照实际情况来。最后输入电脑开机密码,导出证书。
####4.在极光推送后台创建应用,并上传APNs 推送证书
4.1 登录极光推送平台,切换到控制台,并创建应用。接下来在应用信息中上传开发APNs 推送证书。生产环境APNs 推送证书
配置类似,不做赘述.
4.2 核对应用的Bundle ID 等信息是否正确.
####5. 项目中集成极光推送SDK
5.1 添加头文件
请将以下代码添加到 AppDelegate.m 引用头文件的位置。1
2
3
4
5
6
7
8// 引入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。
参考代码:1
2
3@interface AppDelegate ()<JPUSHRegisterDelegate>
@end
5.3 添加初始化代码1
2
3
4配置 key
static NSString *appKey = @"c3d* **** **** **** **** ***8";
//static NSString *channel = @" ";
static BOOL isProduction = FALSE;
1 | - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { |
5.3.1 添加初始化APNs代码1
2
3
4
5
6
7
8
9
10
11
12
13//添加初始化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代码1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17//添加初始化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值。请确保应用内配置的AppKey
与Portal
上创建应用后生成的AppKey
一致。
2.channel
指明应用程序包的下载渠道,为方便分渠道统计,具体值由你自行定义,如:App Store
。
3.apsForProduction1.3.1
版本新增,用于标识当前应用所使用的APNs
证书环境。
0 (默认值)表示采用的是开发证书,1 表示采用生产证书发布应用。
注:此字段的值要与Build Settings的Code Signing
配置的证书环境一致。advertisingIdentifier
详见关于IDFA。
5.3.3 注册APNs成功并上报DeviceToken1
2
3
4
5
6- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
/// Required - 注册 DeviceToken
[JPUSHService registerDeviceToken:deviceToken];
}
5.3.4 实现注册APNs失败接口(可选)1
2
3
4- (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实现该回调方法并添加回调方法中的代码1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34#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];
}
####6 成功运行
真机调试该项目,如果控制台输出以下日志则代表您已经集成成功。1
2
3
42016-08-19 17:12:12.745823 219b28[1443:286814] | JPUSH | I - [JPUSHLogin]
----- login result -----
uid:5460310207
registrationID:171976fa8a8620a14a4
如果调试运行中遇到问题请参考:iOS SDK 调试指南
####7.极光推送后台发送远程推送测试
7.1 登录极光推送,切换到控制台,并点击对应的应用,点击推送按钮,设置推送内容,并发送通知
7.2 选择推送环境iOS开发环境,目标人群,发送时间。再点击可选设置设置消息的具体内容。
7.3 设置消息具体内容。远程推送分为普通推送/后台推送/静默推送3种类型,并且类型由推送消息设置来决定。关于如何设置请参考iOS 推送全解析,你不可不知的所有 Tips!
7.4 iOS设备接收到远程推送
7.5 推送历史可以在这里看得到,但有延迟,可能远程推送已接收到,推送历史数据还没有更新到最新。
Xcode8下集成极光远程推送的简单介绍,到这里就结束了。
祭出自己的JPushDemo