推送流程
(1)创建Push SSL Certification(推送证书)
(2)iOS客户端注册Push功能并获得DeviceToken
(3)使用Provider向APNS发送Push消息
(4)iOS客户端接收处理由APNS发来的消息
推送流程图:
remote_notif_simple_2x.png- Provider:就是为指定iOS设备应用程序提供Push的服务器。如果iOS设备的应用程序是客户端的话,那么Provider可以理解为服务端(推送消息的发起者)
- APNs:Apple Push Notification Service(苹果消息推送服务器)
- Devices:iOS设备,用来接收APNs下发下来的消息
- Client App:iOS设备上的应用程序,用来接收APNs下发的消息到指定的一个客户端app(消息的最终响应者)
1.获取Device token
App 必须要向 APNs 请求注册以实现推送功能,在请求成功后,APNs 会返回一个设备的标识符即 DeviceToken 给 App,服务器在推送通知的时候需要指定推送通知目的设备的 DeviceToken。在 iOS 8 以及之后,注册推送服务主要分为四个步骤:
- 使用 registerUserNotificationSettings:注册应用程序想要支持的推送类型
- 通过调用 registerForRemoteNotifications方法向 APNs 注册推送功能
- 请求成功时,系统会在应用程序委托方法中返回 DeviceToken,请求失败时,也会在对应的委托方法中给出请求失败的原因。
- 将 DeviceToken 上传到服务器,服务器在推送时使用。
DeviceToken 有可能会更改,因此需要在程序每次启动时都去注册并且上传到你的服务器端。
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
if ([application respondsToSelector:@selector(registerUserNotificationSettings:)]) {
NSLog(@"Requesting permission for push notifications..."); // iOS 8
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:
UIUserNotificationTypeAlert | UIUserNotificationTypeBadge |
UIUserNotificationTypeSound categories:nil];
[UIApplication.sharedApplication registerUserNotificationSettings:settings];
} else {
NSLog(@"Registering device for push notifications..."); // iOS 7 and earlier
[UIApplication.sharedApplication registerForRemoteNotificationTypes:
UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeBadge |
UIRemoteNotificationTypeSound];
}
return YES;
}
- (void)application:(UIApplication *)application
didRegisterUserNotificationSettings:(UIUserNotificationSettings *)settings
{
NSLog(@"Registering device for push notifications..."); // iOS 8
[application registerForRemoteNotifications];
}
成功获取设备token
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
NSString* token =[[deviceToken description] stringByTrimmingCharactersInSet:[NSCharacterSet characterSetWithCharactersInString:@"<>"]];
//获取终端设备标识,这个标识需要通过接口发送到服务器端,服务器端推送消息到APNS时需要知道终端的标识,APNS通过注册的终端标识找到终端设备。
NSString* tokennew = [token stringByReplacingOccurrencesOfString:@" " withString:@""];
[[NSUserDefaults standardUserDefaults] setValue:tokennew forKey:@"tokenid"];
NSLog(@"My token is:%@", tokennew);
}
获取设备token失败
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
NSString *error_str = [NSString stringWithFormat: @"%@", error];
NSLog(@"Failed to get token, error:%@", error_str);
}
2.处理推送消息
1.当程序未启动,用户接收到消息。需要在AppDelegate中的didFinishLaunchingWithOptions得到消息内容
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//...
NSDictionary *payload = [launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];
if (payload) {
//...
}
//...
}
2.当程序在前台运行,接收到消息不会有消息提示(提示框或横幅),程序进入此方法。
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
}
//iOS10新增:处理前台收到通知的代理方法
-(void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler{
NSDictionary * userInfo = notification.request.content.userInfo;
if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
//应用处于前台时的远程推送接受
}else{
//应用处于前台时的本地推送接受
}
//当应用处于前台时提示设置,需要哪个可以设置哪一个
completionHandler(UNNotificationPresentationOptionSound|UNNotificationPresentationOptionBadge|UNNotificationPresentationOptionAlert);
}
3.当程序运行在后台,接收到消息会有消息提示,点击消息后进入程序,AppDelegate的didReceiveRemoteNotification函数会被调用,消息做为此函数的参数传入
-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
}
//iOS10新增:处理后台点击通知的代理方法
-(void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{
NSDictionary * userInfo = response.notification.request.content.userInfo;
if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
//应用处于后台时的远程推送接受
}else{
//应用处于后台时的本地推送接受
}
}
3.模拟推送
生成后台需要的推送证书
- PHP需要的.Pem证书
操作过程:
把推送证书(.cer)转换为.pem文件,执行命令:
$ openssl x509 -in 推送证书.cer -inform der -out 推送证书.pem
把推送证书导出的私钥(.p12)文件转化为.pem文件:
$ openssl pkcs12 -nocerts -out 推送证书私钥.pem -in 推送证书私钥.p12
$ Enter Import Password: //先输入私钥的密码
$ MAC verified OK
$ Enter PEM pass phrase: //设置两次相同的密码短语�
$ Verifying – Enter PEM pass phrase:
// 你首先需要为.p12文件输入pass phrase密码短语,这样OpenSSL可以读它。然后你需要键入一个新的密码短语来加密PEM文件。你需要选择一些更安全的密码短语。为了方便管理,例如我统一使用`pushchat`来作为PEM的密码短语。
// 注意:如果你没有键入一个PEM passphrase,OpenSSL将不会返回一个错误信息,但是产生的.pem文件里面将不会含有私钥。
对生成的这两个pem文件再生成一个pem文件,来把证书和私钥整合到一个文件里:
$ cat 推送证书.pem 推送证书私钥.pem >PHPPush.pem
然后把这个PHPPush.pem给后台基友们,就可以下班啦。
- Java/.Net需要的.p12证书
若使用Java/.Net服务器需要将生成的私钥per文件和cer生成的per文件合并成一个.p12文件
前两个步骤同PHP需要的Pem证书步骤是一样的,只是第三个步骤有些许不同。
注意:第三个步骤这里还需要一个.certSigningRequest(csr)文件。
$ openssl pkcs12 -export -in 推送证书.pem -inkey 推送证书私钥.pem -certfile CertificateSigningRequest.certSigningRequest -name "项目名_Production(或项目名_Development)" -out 项目名_Production(或项目名_Development).p12
然后把这个项目名_Production(或项目名_Development).pem给后台基友们,就可以下班啦。
当然测试推送也比较麻烦,需要模拟真实的推送环境,一般需要后台提供帮助,但是遇到一些后台同事,他们有强烈地信仰着鄙视链的话,很鄙视iOS,心里早就称呼你“死前端”多年了,还那么多事……
4.模拟推送:通过终端推送
<?php
// devicetoken
$deviceToken = '你的deviceToken';
// 私钥密码,生成pem的时候输入的
$passphrase = '123456';
// 定制推送内容,有一点的格式要求,详情Apple文档
$message = array(
'body'=>'你收到一个新订单'
);
$body['aps'] = array(
'alert' => $message,
'sound' => 'default',
'badge' => 100,
);
$body['type']=3;
$body['msg_type']=4;
$body['title']='新订单提醒';
$body['msg']='你收到一个新消息';
$ctx = stream_context_create();
stream_context_set_option($ctx, 'ssl', 'local_cert', 'push.pem');//记得把生成的push.pem放在和这个php文件同一个目录
stream_context_set_option($ctx, 'ssl', 'passphrase', $passphrase);
$fp = stream_socket_client(
//这里需要特别注意,一个是开发推送的沙箱环境,一个是发布推送的正式环境,deviceToken是不通用的
'ssl://gateway.sandbox.push.apple.com:2195', $err,
//'ssl://gateway.push.apple.com:2195', $err,
$errstr, 60, STREAM_CLIENT_CONNECT|STREAM_CLIENT_PERSISTENT, $ctx);
if (!$fp)
exit("Failed to connect: $err $errstr" . PHP_EOL);
echo 'Connected to APNS' . PHP_EOL;
$payload = json_encode($body);
$msg = chr(0) . pack('n', 32) . pack('H*', $deviceToken) . pack('n', strlen($payload)) . $payload;
$result = fwrite($fp, $msg, strlen($msg));
if (!$result)
echo 'Message not delivered' . PHP_EOL;
else
echo 'Message successfully delivered' . PHP_EOL;
fclose($fp);
?>
将上面的代码复制,保存成push.php
然后根据上面PHP需要的Pem证书的步骤生成push.pem
两个文件放在同一目录
执行下面的命令
$ php push.php
结果为
Connected to APNS
Message successfully delivered
则表示发送推送消息成功
网友评论