googleAPNS:https://code.google.com/p/apns-php/wiki/CertificateCreationphp
推送证书建立:html
1,登录官网:iPhone Developer Program Portaljava
2,选择APP IDs。 (or click here)node
3,建立一个app id,注意不要选择Explicit,不要选择Wildcard。ios
4,继续向下进行。直至完成建立。--->建立PUSH SSL CER(Apple Documentation: Creating the SSL Certificate and Keys)编程
5,生成SSL证书后,双击加入Keychain中(建立成功的话,证书下方会有私钥)。json
6,在keychain中,右击证书,导出证书为**.p12(不要注入密码)。安全
7,开启终端,更改目录到p12文件所在处,用命令将PKCS12证书更改成PEM格式文件,命令:服务器
openssl pkcs12 -in **.p12 -out **.pem -nodes -clcerts
8,在后台ApnsPHP中应用PEM文件。网络
APP中APNS的实现:ObjectiveC page
推送通知至某设备,DeviceToken是依据DeviceID和APPlicationID,经由apple生成。故是惟一的(per device and per application)。
code demo: http://code.google.com/p/apns-php/source/browse/trunk/Objective-C%20Demo
----------------------------------------------------------------------------------------------------
简述:
想让应用程序的推送功能正常工做,你须要至关多的努力,这个过程很是繁琐。如下是这个过程的概述图:
1.应用程序须要激活推送通知功能。在使用以前,用户须要确认他是否愿意接受这些推送功能。
2.应用程序接到一个“device token”。你能够认为“device token”是推送通知发送信息的目的地址。
3.应用程序会将“device token”发送给你的服务器
4.当你的应用程序发生了有趣的事情,你的服务器向 “×××送通知的服务器(Apple Push Notification Service,缩写,APSN)”发送通知。
5.APSN再向用户的设备(例如,iPhone,iPad等)发送通知。
当用户的设备接受到推送通知,将会显示提醒框,播放提示声音,更新图标的未读信息数目。用户能够经过点击提醒框来加载应用程序,苹果公司给推送通知加入了可选内容,你能够根据需求来操做推送通知。
当iOS4实现了本地通知和多任务,苹果的推送通知是否还有使用价值?固然有!
本地通知被定时事件调度限制,而且只有VOIP、导航、后台音频播放这些应用在后台没有被限制。若是当应用程序处于关闭状态时,你想将外部事件的发生通知给你的应用程序用户,仍然须要推送通知。
在这篇教程中,我将解释推送通知系统实现的细节以及如何在应用中创建推送。这里有不少要解释的,这须要(您)花点儿时间去明白。
你须要为推送作些什么
在你的应用中添加推送通知,你须要:
一台iPhone或者iPad 推送通知不能在模拟器上实现,因此你须要在设备上测试。
一个iOS开发者证书 你须要一个新的AppID和每一个应用程序使用的推送证书,推送服务器须要的“SSL ”证书,你可在iOS开发网站上作这些。
若是你想跟随这篇教程的例子学习,你将须要建立你本身的推送证书和SSL证书,你不可使用个人这些证书。由于得到正确的证书是很重要的,我将详细解释如何获得一个推送证书。
一个联网的服务器 推送通知一般是由服务器来发送的。对于开发,你可使用一个Mac来代替服务器(咱们将在教程中这样作),可是发布的产品,你至少须要相似VPS( Virtual Private Server )的服务器。
一个廉价的共享虚拟主机帐户不能知足发布产品的须要。你须要在服务器的后台启动一个进程,安装一个SSL证书,而且可以在某个端口中可以外联TLS。
大部分的共享虚拟主机并不让你实现这些功能,即便若是申请的这些需求经过了。不管怎么样,我真的建议你使用一个VPS主机,像Linode。
解析一个推送通知
你的服务器负责建立一个推送通知消息,因此了解一个推送通知消息的构成是有必要的。
一个推送通知是一个短信息,由“device token”,“payload–负载内容”,和其余的一些字节组成。“payload–负载内容”是咱们感兴趣的部分,由于它包含着咱们实际想发送出去的数据。
你的服务器必须提供“payload–负载内容”,它是以JSON的字典的数据格式来组织数据的。下面是一个很简单的推送消息payload:
{ "aps": { "alert": "Hello, world!", "sound": "default" } }
对于不了解JSON的人,一个block的划分由一对花括号“{}”包裹,其中包含一个由“键/值 (key/value)”对组成的“字典”,(就像NSDictionary)。
“payload–负载内容”就是一个“字典”,包含了至少一个“aps”项,“aps”自己也是一个“字典”。在咱们的例子中,“aps”包含 “alert”和“sound”字段。当这个推送通知被接收后,它将显示一个包含“Hello, world!”内容的提醒框,而且播放标准的提示音。
你能够向“aps”添加另外的选项,来配置通知,例如
{ "aps": { "alert": { "action-loc-key": "Open", "body": "Hello, world!" }, "badge": 2 } }
如今“alert”是一个字典。”action-loc-key” 对应的value替代了“View”按钮上的文本内容,”badge”字段包含的数字将被显示在应用图标上,这个通知不会播放提示音。
有不少途径去设置JSON的“payload–负载”内容,你能够改变播放声音,你能够提供本地化的文本,而且添加本身的字段。更多信息,请详见官方Local and Push Notification Programming Guide。
推送通知的目标就是精短;“payload–负载内容”的大小不能超过256个字节。这样留给你的空间和一条短消息或者一个tweet消息的大小同样。一个小型的推送服务不会在换行符和空格上浪费空间,这样一条推送就像下面所显示的:
{“aps”:{“alert”:”Hello, world!”,”sound”:”default”}}
上面这条消息可读性比较低,可是它节省了足够的字节,因此牺牲可读性是值得的。若是一个推送通知的payload超过了256个字节,那么这个推送就不会被“APNS”接受。
关于推送通知常见的错误
推送通知是不可靠的
推送通知是不可靠的!即便APNS(Apple Push Notification Service×××送通知服务)服务器接受了推送通知,仍然没法保证该通知最终会被送达。
就你的服务器而言,推送通知会被发出而且遗忘掉;当你将通知发送到APNS后,没有办法查出它所处的状态。通知送达的时间也从几秒到半小时不等。
一样,用户的iPhone不是全部时间均可以收到推送通知。好比,由于指定的端口被封,手机处于一个不容许和APNS链接的WIFI网络。或者手机已经关机了。
APNS将会在手机链接到可用网络后下发从该机器收到的最后一条通知,可是只会尝试有限的时间。一旦发送超时,此条通知就会永远丢失!
After looking at the APNS Server Bill
推送通知会使开销很大!若是你掌控了须要推送的内容,在你的应用中加入推送功能至关容易和廉价,可是当你有好多用户和数据须要轮询的时候,这个功能就会使得服务器开销庞大(译者注:不必定指价格,包括是资源消耗)。
好比,你打算在本身的RSS订阅更新的时候通知用户,这样作没问题。由于你控制着RSS订阅,而且知道它什么时候发生变化——当你更新网站内容时——因而你的服务器能够在合适的时候发出通知。
可是若是你的应用是一款RSS阅读器,容许用户添加自定义的连接呢?这种状况下,你须要构建一些机制去检测那些订阅的更新。
实际上,这意味着你的服务器为了检查那些订阅的变化,须要不停的轮询它们。若是你拥有不少用户,你可能不得不安装一堆新服务器去处理这些工做和知足带宽需求。对于这类应用,推送会变得异常昂贵,可能不值得去作。
好了,理论上足够了。下面到时间来学习如何使用推送了。在咱们投入到美好的事物——编程!以前——有一些无聊的搭建环境的工做须要在iOS Provisioning Portal上完成,因此让咱们尽快完成它。
Provisioning Profiles和证书,天哪!
APNS须要一个证书
在你的应用中使用推送通知,须要用一个配置过推送功能的provisioning profile来签名。此外,你服务器全部与APNS的通信都须要进行SSL证书签名。
Provisioning profile和SSL证书紧密联系在一块儿,而且只对一个App ID有效。这个保护措施能够保证只有你的服务器能够发推送通知到你的应用,其它服务器不能够。
正如你所知道的,应用程序在开发和发布阶段使用不一样的provisioning profiles。一样,推送服务器的证书也有两种:
· Development. 若是你的应用程序运行在debug模式,而且使用的是Development provisioning profile (Code Signing Identity 是 “iPhone Developer”)签名的,你的服务器必须使用Development证书。
· Production. 使用Ad Hoc方式发布的,或发布在App Store(Code Signing Identify 是 “iPhone Distribution”)上的应用程序,必须和使用Production证书签名的服务器通信。若是这里面有不匹配,推送通知将没法送达你的应用。
在这篇教程里,咱们不须要为分发profiles和证书烦恼,只须要使用Development版本的便可。
1,生成证书签名请求(Certificate Signing Request, CSR)
还记得你在注册成为iOS开发者以后,如何去iOS Provisioning Portal生成一个开发证书吗?若是记得,下面的步骤应该会比较熟悉。不过,我仍然建议你准确地按照步骤来作。由于大多数在实现推送通知过程当中遇到的问题,都是因为证书问题引发的。
数字证书基于公钥-私钥加密方法。你不须要知道任何关于证书的加密方法,可是你要知道证书一直会与一个私钥搭配使用。
证书是密钥对的非秘密的部分。将它发送给其它人是安全的,好比经过SSL通信的过程当中就会包含证书。然而,对于私钥,固然是私有的。它是秘密的。你的私钥只对你有用,对其余人没用。要重视的是:若是你没有私钥的话,就没法使用证书。
每当申请一个数字证书的时候,你须要提供一个证书签名请求,简称CSR。当你建立了CSR后,会生成一个新的私钥保存到keychain应用程序中。而后 你将CSR发送到一个证书颁发机构(目前状况下就是iOS Developer Portal),它会根据CSR中的信息生成SSL证书。
打开Mac中的Keychain Access程序(在Applications/Utilities下),选择菜单中的Request a Certificate from a Certificate Authority…
若是菜单中没有“Request a Certificate from a Certificate Authority with key”选项,就先去下载安装WWDR Intermediate Certificate。而且确认Keychain Access窗口里没有私钥被选中。
如今,你应该会看到下面的窗口:
在里面输入你的邮件地址,听有人推荐说最好使用和注册IOS开发者证号一样的邮件地址,但看起来任何邮件地址均可以。在Common Name中输入“PushChat”。你能够输入任何字符串,但最好是有意义的。这会使你之后容易查找这个私钥。
选择Saved to disk选项,点击Continue。将文件保存为“PushChat.certSigningRequest”。
2,建立 App ID
每一个使用 APNs 的 iOS 应用必须有一个惟一的 App ID。在本步骤中,你将学到如何建立推送通知中要用到的App ID。
1. 登陆iPhoneDeveloper Program:http://developer.apple.com/iphone/。点击页面右边的“ iPhone Developer Program Portal ”(图4):
2. 首先看到的是欢迎页面(图5):
3. 点击左边的“App ID”,而后点击右边的“New App ID”按钮(图6):
4. 在 Description 栏输入“PushAppID”,在“Bundle Seed ID”栏中选择“Generate New”。在“Bundle Identifier”栏,输入“net.learn2develop.MyPushApp”,而后点击“Submit”(图7):
5. 如今你应该能看到所建立的 App ID 了(图8):
配置 App
一旦建立了 App ID,你还要为推送通知对 App ID 进行一些配置。
1. 点击App ID 右边的 Configure 连接,会看到以下选项(图9):
勾选“Enable for Apple Push Notificationservice”,点击“Development Push SSL Certificate”右边的“Configure”按钮。
2. 接下来你会看到“Apple Push Notification service SSL Certificate Assistant”页面。点击Continue(图10):
3. 点击Choose File 按钮,选择前面保存的证书请求文件存放地址。点击 Generate(图11):
4. 你的SSL 证书会被生成。点击 Continue(图12):
5. 点击Download Now 按钮,下载 SSL 证书。点击 Done(图13):
6. 下载的 SSL 证书文件名为 aps.developer.identity.cer。双击,将证书安装到钥匙串中(图14)。这个证书会在你的程序中用到,它容许程序接收 APNs 发送来的推送通知。
3,建立 Provisioning Profile
接下来,须要建立 provisioning profile 以便容许应用程序安装到真实设备上。
1. 回到iPhone Development Program Portal,点击 Provisioning 栏,点击 New Profile 按钮(图15):
2. Profile Name 栏输入 MyDevicesProfile,在 App ID 栏选择 PushAppID。在Devices 栏,勾选全部你想激活的设备(在 iPhone Developer Program Portal 的 Devices 页中注册的全部设备)。点击 Submit(图16)。
3. provisioning profile 会等待审核。几秒钟后,它会显示在页面上。点击Download 按钮下载该 provisioning profile(图17):
4. 下载下来的provisioning profile 名为 MydevicesProfile.mobileprovision。
4,激活设备:建立 provision profile 后,你能够将它安装到真实设备中。
--------------------------------------------------
你的app能够查看哪些推送类型被启用,用如下代码来查看
UIRemoteNotificationType enabledTypes = [[UIApplication sharedApplication] enabledRemoteNotificationTypes];
为了能收到推送消息,咱们还要在app中添加一些内容。将下列代码添加到PushChatAppDelegate.m中:
- (void)application:(UIApplication*)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData*)deviceToken{ NSLog(@”My token is: %@”, deviceToken);}- (void)application:(UIApplication*)application didFailToRegisterForRemoteNotificationsWithError:(NSError*)error{ NSLog(@"Failed to get token, error: %@", error); }
当你的应用程序注册远程通知时,它将会尝试得到一个“设备标记(device token)”。
这是一个32字节数字,标识你的设备的惟一性。 能够把device token理解为推送消息的接收地址。
再次运行程序,你应该能在Xcode的控制台窗口看到下面这个:
My token is:
<740f4707 bebcf74f 9b7c25d4 8e335894 5f6aa01d a5ddb387 462c7eaf 61bb78ad>
这个标识是一个封装的二进制数据结构,装入一个NSData对象里。苹果不但愿你看见它的内部信息,就咱们而言知道它是32字节长就够了。
正如你上面所看到的,标识也可用64位十六进制字符表示,咱们将用这种格式使用设备标识,固然还要去掉分隔符和空格。
若是你在模拟器上运行这个程序,因为你的模拟器不支持推送通知,didFailToRegisterForRemoteNotificationsWithError方法将被调用。
这个应用就是这样。还有一件事要作,以后咱们立刻就能够看到一些推送通知,当即行动!
我以前已经提到了几回,你须要建立一个服务器,它将推送通知给你的app。
第一次测试程序,咱们不会去创建一个服务器。相反,我会给大家一个很是简单的PHP脚本,
,来创建一个链接到APNS并发送一个推送通知到您所指定的设备。你能够直接在mac电脑上运行这个脚本
下载这些SimplePush代码并解压缩,你须要在simplepush.php作些改变。
//把你的设备标识写在这里(没有空格):$deviceToken = '0f744707bebcf74f9b7c25d48e3358945f6aa01da5ddb387462c7eaf61bbad78'; //密码放在这里$passphrase = 'pushchat'; // 把你的推送消息放在这里:$message = 'My first push notification!';
你须要从app中拷贝device token到$deviceToken变量。肯定删掉了空格以及分隔符。它应该是64位的十六进制字符。把你私钥密码短语放到$passphrase变量,以及你想发送的信息放到$message中。
拷贝你的ck.pem 文件到SimplePush目录,记住,这个ck.pem文件同时包含你的证书和私钥。
而后打开一个终端并键入:
若是一切顺利,脚本应该会显示:
Connected to APNS
Message successfully delivered
注意, 当应用程序是开着的你不会看到任何东西。消息传过来了,可是咱们在app中没有作任何处理消息的方法。
若是显示一些错误信息,simplepush.php脚本退出,检查你是否正确制做PEM文件,
如今,脚本究竟作了什么并不重要。在这个系列的第二部分,咱们会创建一个真正的推送服务器,到那时候咱们会就此作更多的说明。
此时,你已经成功创建了一个app来接收推送通知,而且经过自定义的PHP代码发送了第一条推送通知。
----------------------
建立 Push Notification Provider
Push Notification Provider 是一个应用程序,用于经过 APNs 发送推送通知给 iPhone 应用。
经过 APNs 发送推送通知有几个步骤:
1. 使用前面建立的 SSL 证书与 APNs 通信;
2. 构造所要发送的消息载体;
3. 发送载体到APNs;
APNs 是一个基于流的 TCP socket,你的 provider 以 SSL 协议与其通信。推送通知(包括载体)是以二进制流的方式发送的。和APNs 创建链接后,你能够维持该链接并在链接中断以前发送多个通知。
技巧: 应避免每发送一次推送通知就创建、关闭一次链接。频繁的创建、关闭链接可能会被 APNs 认为是 DOS ***,从而拒绝发送 provider 的推送通知发送请求。
一个推送通知消息的格式如图24 所示:
更多细节,请参考 Apple Push Notification Service Programming Guide。
载体(payload)是 JSON 字符串(最长 256 字节),封装了你发送给 iOS 应用的信息。这是一个 payload 的例子:
{
"aps": {
"alert" : "Yougot a new message!" ,
"badge" : 5,
"sound" : "beep.wav"},
"acme1" : "bar",
"acme2" : 42
}
写provider以前,咱们须要生成php Push Notification sender须要的证书文件:
1)在Keychain Access.app里选定这个新证书(Apple Development Push Services*),导出到桌面,保存为Certificates.p12.
2)而后运行以下命令:
见第一部分。
下面是一个简单的push notification proivder写法:
<span style="font-size:16px;"><?php
$deviceToken = '38c866dd bb323b39 ffa73487 5e157ee5 a85e0b7ce90d56e9 fe145bcc 6c2c594b'; // masked for security reason
// Passphrase for the private key (ck.pem file)
// $pass = '';
// Get the parameters from http get or from command line
$message = $_GET['message'] or $message = $argv[1] or $message = 'Message received from javacom';
$badge = (int)$_GET['badge'] or $badge = (int)$argv[2];
$sound = $_GET['sound'] or $sound = $argv[3];
// Construct the notification payload
$body = array();
$body['aps'] = array('alert' => $message);
if ($badge)
$body['aps']['badge'] = $badge;
if ($sound)
$body['aps']['sound'] = $sound;
$ctx = stream_context_create();
stream_context_set_option($ctx, 'ssl', 'local_cert', 'ck.pem');
// assume the private key passphase was removed.
// stream_context_set_option($ctx, 'ssl', 'passphrase', $pass);
$fp = stream_socket_client('ssl://gateway.sandbox.push.apple.com:2195', $err, $errstr, 60, STREAM_CLIENT_CONNECT, $ctx);
if (!$fp) {
print "Failed to connect $err $errstrn";
return;
}
else {
print "Connection OKn";
}
$payload = json_encode($body);
$msg = chr(0) . pack("n",32) . pack('H*', str_replace(' ', '', $deviceToken)) . pack("n",strlen($payload)) . $payload;
print "sending message :" . $payload . "n";
fwrite($fp, $msg);
fclose($fp);
?></span>
运行结果:Connection OKnsending message :{"aps":{"alert":"Message received from javacom"}}n
效果图在下面。
为了省去本身编写 push notification provider 的麻烦,你也可使用 Stefan Hafeneger 写的一个 Mac OS X 应用程序:PushMeBaby,下载地址
1. 在Xcode 中打开 PushMeBaby。
2. 右击 Resouces 文件夹,选择 Add Existing Files…,选择前面所下载到的aps.developer.identity.cer 文件(图25)。
3. 在 ApplicationDelegate.m 文件中,修改以下代码(加粗部分):
- (id)init {
self = [super init];
if(self != nil) {
self.deviceToken = @"38c866dd bb323b39 ffa73487 5e157ee5 a85e0b7ce90d56e9 fe145bcc 6c2c594b";
self.payload = @"{"aps":{"alert":"Yougot a new message!","badge":5,"sound":"beep.wav"},"acme1":"bar","acme2":42}";
self.certificate = [[NSBundle mainBundle]
pathForResource:@"aps_developer_identity" ofType:@"cer"];
}
return self;
}
4. 按下 +R,运行程序。将会问你是否容许使用证书,点击Always Allow(老是容许)(图26):
在 iPhone/iPod,确认 ApplePushNotification 程序未运行。点击 Push 按钮,会向设备发送一条推送通知。服务器实际上发送了下列消息给APN 服务器:
{
"aps": {
"alert" : "Yougot a new message!" ,
"badge" : 5,
"sound" : "beep.wav"},
"acme1" : "bar",
"acme2" : 42
}
5. 若是消息推送成功,将会在 iPhone/iPod 上出现下图(图27):
6. 若是如今按下 +R 调试 ApplePushNotification 程序,而后从 PushMeBaby 中发送一条消息,控制台会显示以下输出:
2009-11-24 21:11:49.182 ApplePushNotification[1461:207]key: acme1, value: bar
2009-11-24 21:11:49.187 ApplePushNotification[1461:207]key: aps, value: {
alert = "You got a new message!";
badge = 5;
sound = "beep.wav";
}
2009-11-24 21:11:49.191 ApplePushNotification[1461:207]key: acme2, value: 42
几个注意的问题:
1.若是申请ssl 证书时不是用的新的apple id,而是原来已经存在的,那么设置好以后要把对应的provisioning profile
也更新一下, 而后去下载新的profile替换掉老的,否则运行会有错。
2.若是你用的是企业版的开发者证书,别人可能没有权限去申请这个ssl 证书,当你替他申请好证书后,应该把证书和证书对
的私钥一块儿发给他,这样他在本地安装私钥时才会有对应的密钥。
3.当push notification到达时,程序状态不一样,效果也是不同的,通常来讲程序能够分为下面三种状态:
1)程序不在运行(后台和前台都不在运行)
这时候若是push notification到了,会弹出一个alertview,当你点击action按钮时,会启动程序,并执行程序delegate.m文件里的
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
方法,因此你能够在这里作一些处理:
//看是否有push notification到达,并作相应处理,这个方法和local notification相同,但注意key要对应就行
UILocalNotification * remoteNotification = [launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];
if (remoteNotification) {
//弹出一个alertview,显示相应信息
UIAlertView * al = [[UIAlertView alloc]initWithTitle:@"receive remote notification!" message:@"hello" delegate:self cancelButtonTitle:@"Ok" otherButtonTitles:nil, nil];
[al show];
[al release];
}
2)程序在运行(不管是在前台仍是后台)
当push notification到达时,若是程序在前台运行并不会弹出alertview,而是直接执行下面方法:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
UIAlertView * al = [[UIAlertView alloc]initWithTitle:@"receive remote notification!" message:@"hey" delegate:self cancelButtonTitle:@"ok" otherButtonTitles:nil, nil];
[al show];
[al release];
}
在这个方法里你能够获取到userInfo字典来进行相应处理。
若是程序是在后台运行,则会弹出一个alertview,当你点击action按钮,也会执行上面同样的方法。
因此若是你想要程序在push notification到达时,针对前台和后台运行作区分处理,你能够在上面方法里先作一个状态的
判断:
//能够根据application状态来判断,程序当前是在前台仍是后台
UIApplicationState state = [application applicationState];
if (state == UIApplicationStateInactive) {
// Application was in the background when notification
// was delivered.
}
本文转载自:http://blog.csdn.net/chowpan/article/details/17927747