(转)苹果推送通知服务（APNs）编程

iPhone 对于应用程序在后台运行有诸多限制&＃xff08;除非你越狱&＃xff09;。因此&＃xff0c;当用户切换到其他程序后&＃xff0c;原先的程序无法保持运行状态。对于那些需要保持持续连接状态的应用程序&＃xff08;比如社区网络应用&＃xff09;&＃xff0c;将不能收到实时的信息。

为解决这一限制&＃xff0c;苹果推出了APNs&＃xff08;苹果推送通知服务&＃xff09;。APNs 允许设备与苹果的推送通知服务器保持常连接状态。当你想发送一个推送通知给某个用户的iPhone上的应用程序时&＃xff0c;你可以使用 APNs 发送一个推送消息给目标设备上已安装的某个应用程序。

本文中&＃xff0c;你将学到创建使用 APNs 的iOS 应用的详细步骤。

创建证书请求

使用APNs 的第一步是生成一个证书请求&＃xff0c;使用该证书请求来申请一个用于开发的 SSL 证书。

1. 打开“钥匙串访问”应用程序。

2. 选择“KeychainAccess -> Certificate Assistant -> Request a Certificate From CertificateAuthority”&＃xff08;如图1 所示&＃xff09;&＃xff1a;

3. 输入所需的信息&＃xff0c;勾选“Saved to disk”选项&＃xff0c;点击 Continue&＃xff08;如图2 所示&＃xff09;&＃xff1a;

4. 使用默认文件名把证书请求进行保存&＃xff08;图3&＃xff09;&＃xff1a;在弹出窗口中&＃xff0c;点击Done。

创建 App ID

每个使用 APNs 的 iOS 应用必须有一个唯一的 App ID。在本步骤中&＃xff0c;你将学到如何创建推送通知中要用到的App ID。

1. 登录iPhoneDeveloper Program&＃xff1a;http://developer.apple.com/iphone/。点击页面右边的“ iPhone Developer Program Portal ”&＃xff08;图4&＃xff09;&＃xff1a;

2. 首先看到的是欢迎页面&＃xff08;图5&＃xff09;&＃xff1a;

3. 点击左边的“App ID”&＃xff0c;然后点击右边的“New App ID”按钮&＃xff08;图6&＃xff09;&＃xff1a;

4. 在 Description 栏输入“PushAppID”&＃xff0c;在“Bundle Seed ID”栏中选择“Generate New”。在“Bundle Identifier”栏&＃xff0c;输入“net.learn2develop.MyPushApp”&＃xff0c;然后点击“Submit”&＃xff08;图7&＃xff09;&＃xff1a;

5. 现在你应该能看到所创建的 App ID 了&＃xff08;图8&＃xff09;&＃xff1a;

配置 App

一旦创建了 App ID&＃xff0c;你还要为推送通知对 App ID 进行一些配置。

1. 点击App ID 右边的 Configure 链接&＃xff0c;会看到如下选项&＃xff08;图9&＃xff09;&＃xff1a;

勾选“Enable for Apple Push Notificationservice”&＃xff0c;点击“Development Push SSL Certificate”右边的“Configure”按钮。

2. 接下来你会看到“Apple Push Notification service SSL Certificate Assistant”页面。点击Continue&＃xff08;图10&＃xff09;&＃xff1a;

3. 点击Choose File 按钮&＃xff0c;选择前面保存的证书请求文件存放地址。点击 Generate&＃xff08;图11&＃xff09;&＃xff1a;

4. 你的SSL 证书会被生成。点击 Continue&＃xff08;图12&＃xff09;&＃xff1a;

5. 点击Download Now 按钮&＃xff0c;下载 SSL 证书。点击 Done&＃xff08;图13&＃xff09;&＃xff1a;

6. 下载的 SSL 证书文件名为 aps.developer.identity.cer。双击&＃xff0c;将证书安装到钥匙串中&＃xff08;图14&＃xff09;。这个证书会在你的程序中用到&＃xff0c;它允许程序接收 APNs 发送来的推送通知。

创建 Provisioning Profile

接下来&＃xff0c;需要创建 provisioning profile 以便允许应用程序安装到真实设备上。

1. 回到iPhone Development Program Portal&＃xff0c;点击 Provisioning 栏&＃xff0c;点击 New Profile 按钮&＃xff08;图15&＃xff09;&＃xff1a;

2. Profile Name 栏输入 MyDevicesProfile&＃xff0c;在 App ID 栏选择 PushAppID。在Devices 栏&＃xff0c;勾选所有你想激活的设备&＃xff08;在 iPhone Developer Program Portal 的 Devices 页中注册的所有设备&＃xff09;。点击 Submit&＃xff08;图16&＃xff09;。

3. provisioning  profile 会等待审核。几秒钟后&＃xff0c;它会显示在页面上。点击Download 按钮下载该 provisioning profile&＃xff08;图17&＃xff09;&＃xff1a;

4. 下载下来的provisioning profile 名为 MydevicesProfile.mobileprovision。

激活设备

创建 provision profile 后&＃xff0c;你可以将它安装到真实设备中。

1. 将iPhone 或 iPod 连接到 Mac。

2. 把下载下来的 MyDevicesProfile.mobileprovision 文件拖到Dock 栏的 Xcode 图标上。

3. Xcode 的 Organizer 程序将启动&＃xff0c;选择当前连机的设备。可以看到MyDevicesProfile 已自动安装到设备上了&＃xff08;图18&＃xff09;。

创建 iPhone 应用程序

1. 打开Xcode&＃xff0c;创建 View-Based Application 项目&＃xff0c;命名为 ApplePushNotification。

2. 把一个 WAV 文件&＃xff08;本例是 beep.wav&＃xff09;拖到Xcode 的 Resouces 文件夹&＃xff08;图19&＃xff09;。

3. 展开Xcode 中的 Targets 项目&＃xff0c;选择ApplePushNotification&＃xff0c;按下 ⌘&＃43;i&＃xff0c;在 info 出口&＃xff0c;点击Properties 标签栏&＃xff08;图20&＃xff09;&＃xff1a;

在 Identifier 文本框&＃xff0c;输入net.learn2develop.MyPushApp.

4. 点击 Build 标签栏&＃xff0c;在 search 输入框中键入Code Signing。在 Any iPhone OS Device 选项&＃xff0c;选择正确的 profile&＃xff08;图21&＃xff09;&＃xff1a;

5. 在 ApplePushNotificationAppDelegate.m 文件中&＃xff0c;输入以下代码&＃xff08;加粗部分&＃xff09;&＃xff1a;

#import "ApplePushNotificationAppDelegate.h"

#import "ApplePushNotificationViewController.h"

&＃64;implementation ApplePushNotificationAppDelegate

&＃64;synthesize window;

&＃64;synthesize viewController;

- (void)applicationDidFinishLaunching:(UIApplication*)application {   

   [window addSubview:viewController.view];

   [window makeKeyAndVisible];

    NSLog(&＃64;"Registeringfor push notifications...");   

    [[UIApplication sharedApplication]

       registerForRemoteNotificationTypes:

        (UIRemoteNotificationTypeAlert |

        UIRemoteNotificationTypeBadge |

        UIRemoteNotificationTypeSound)];

}

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

    NSString *str &＃61; [NSString

       stringWithFormat:&＃64;"Device Token&＃61;%&＃64;",deviceToken];

    NSLog(str);

}

- (void)application:(UIApplication*)appdidFailToRegisterForRemoteNotificationsWithError:(NSError *)err {

    NSString *str &＃61; [NSStringstringWithFormat: &＃64;"Error: %&＃64;", err];

    NSLog(str);   

}

- (void)application:(UIApplication*)application didReceiveRemoteNotification:(NSDictionary*)userInfo {

    for (id key in userInfo) {

       NSLog(&＃64;"key: %&＃64;, value: %&＃64;", key, [userInfo objectForKey:key]);

    }   

}

- (void)dealloc {

   [viewController release];

   [window release];

   [super dealloc];

}

&＃64;end

6. 按下 ⌘&＃43;R 运行程序&＃xff08;在真实设备&＃xff09;。按下 shift&＃43;⌘&＃43;R 显示Debugger Console 窗口。查看设备输出到控制台的 device token&＃xff08;图22&＃xff09;。在下图&＃xff0c;device token 是 38c866dd bb323b39 ffa73487 5e157ee5 a85e0b7c e90d56e9fe145bcc 6c2c594b。记下device token&＃xff08;复制、粘贴到一个文本文件里&＃xff09;

7. 如果查看 iPhone/iPod 上的“Settings”程序&＃xff0c;你会发现一个 Notifications 的项&＃xff08;图23&＃xff09;&＃xff1a;

创建 Push Notification Provider

Push Notification Provider 是一个应用程序&＃xff0c;用于通过 APNs 发送推送通知给 iPhone 应用。

通过 APNs 发送推送通知有几个步骤&＃xff1a;
1. 使用前面创建的 SSL 证书与 APNs 通讯&＃xff1b;

2. 构造所要发送的消息载体&＃xff1b;

3. 发送载体到APNs&＃xff1b;

APNs 是一个基于流的 TCP socket&＃xff0c;你的 provider 以 SSL 协议与其通讯。推送通知&＃xff08;包括载体&＃xff09;是以二进制流的方式发送的。和APNs 建立连接后&＃xff0c;你可以维持该连接并在连接中断之前发送多个通知。

技巧&＃xff1a; 应避免每发送一次推送通知就建立、关闭一次连接。频繁的建立、关闭连接可能会被 APNs 认为是 DOS 攻击&＃xff0c;从而拒绝发送 provider 的推送通知发送请求。

一个推送通知消息的格式如图24 所示&＃xff1a;

更多细节&＃xff0c;请参考 Apple Push Notification Service Programming Guide。

载体&＃xff08;payload&＃xff09;是 JSON 字符串&＃xff08;最长 256 字节&＃xff09;&＃xff0c;封装了你发送给 iOS 应用的信息。这是一个 payload 的例子&＃xff1a;

{

   "aps": {

        "alert" : "Yougot a new message!" ,

        "badge" : 5,

        "sound" : "beep.wav"},

    "acme1" : "bar",

    "acme2" : 42

}

写provider之前&＃xff0c;我们需要生成php Push Notification sender需要的证书文件&＃xff1a;
  1)在Keychain Access.app里选定这个新证书(Apple Development Push Services*),导出到桌面,保存为Certificates.p12.

  2)然后运行如下命令:

   1.     openssl pkcs12 -clcerts -nokeys -out cert.pem -in Certificates.p12
   2.     openssl pkcs12 -nocerts -out key.pem -in Certificates.p12
   3.     openssl rsa -in key.pem -out key.unencrypted.pem
   4.     cat cert.pem key.unencrypted.pem > ck.pem

下面是一个简单的push notification proivder写法&＃xff1a;

运行结果&＃xff1a;Connection OKnsending message :{"aps":{"alert":"Message received from javacom"}}n

效果图在下面。

为了省去自己编写 push notification provider 的麻烦&＃xff0c;你也可以使用 Stefan Hafeneger 写的一个 Mac OS X 应用程序&＃xff1a;PushMeBaby&＃xff0c;下载地址

1. 在Xcode 中打开 PushMeBaby。

2. 右击 Resouces 文件夹&＃xff0c;选择 Add Existing Files…&＃xff0c;选择前面所下载到的aps.developer.identity.cer 文件&＃xff08;图25&＃xff09;。

3. 在 ApplicationDelegate.m 文件中&＃xff0c;修改如下代码&＃xff08;加粗部分&＃xff09;&＃xff1a;

- (id)init {

   self &＃61; [super init];

   if(self !&＃61; nil) {

       self.deviceToken &＃61; &＃64;"38c866dd bb323b39 ffa73487 5e157ee5 a85e0b7ce90d56e9 fe145bcc 6c2c594b";

        self.payload &＃61; &＃64;"{\"aps\":{\"alert\":\"Yougot a new message!\",\"badge\":5,\"sound\":\"beep.wav\"},\"acme1\":\"bar\",\"acme2\":42}";

       self.certificate &＃61; [[NSBundle mainBundle]

           pathForResource:&＃64;"aps_developer_identity" ofType:&＃64;"cer"];

   }

   return self;

}

4. 按下 ⌘&＃43;R&＃xff0c;运行程序。将会问你是否允许使用证书&＃xff0c;点击Always Allow&＃xff08;总是允许&＃xff09;&＃xff08;图26&＃xff09;&＃xff1a;

在 iPhone/iPod&＃xff0c;确认 ApplePushNotification 程序未运行。点击 Push 按钮&＃xff0c;会向设备发送一条推送通知。服务器实际上发送了下列消息给APN 服务器&＃xff1a;

{

   "aps": {

        "alert" : "Yougot a new message!" ,

        "badge" : 5,

        "sound" : "beep.wav"},

    "acme1" : "bar",

    "acme2" : 42

}

5. 如果消息推送成功&＃xff0c;将会在 iPhone/iPod 上出现下图&＃xff08;图27&＃xff09;&＃xff1a;

6. 如果现在按下 ⌘&＃43;R 调试 ApplePushNotification 程序&＃xff0c;然后从 PushMeBaby 中发送一条消息&＃xff0c;控制台会显示如下输出&＃xff1a;

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 &＃61; "You got a new message!";

   badge &＃61; 5;

   sound &＃61; "beep.wav";

}

2009-11-24 21:11:49.191 ApplePushNotification[1461:207]key: acme2, value: 42

几个注意的问题&＃xff1a;

1.如果申请ssl 证书时不是用的新的apple id&＃xff0c;而是原来已经存在的&＃xff0c;那么设置好之后要把对应的provisioning profile

也更新一下&＃xff0c; 然后去下载新的profile替换掉老的&＃xff0c;不然运行会有错。

2.如果你用的是企业版的开发者证书&＃xff0c;别人可能没有权限去申请这个ssl 证书&＃xff0c;当你替他申请好证书后&＃xff0c;应该把证书和证书对

的私钥一起发给他&＃xff0c;这样他在本地安装私钥时才会有对应的密钥。

3.当push notification到达时&＃xff0c;程序状态不同&＃xff0c;效果也是不一样的&＃xff0c;一般来说程序可以分为下面三种状态&＃xff1a;

1)程序不在运行(后台和前台都不在运行)

这时候如果push notification到了&＃xff0c;会弹出一个alertview&＃xff0c;当你点击action按钮时&＃xff0c;会启动程序&＃xff0c;并执行程序delegate.m文件里的

方法&＃xff0c;所以你可以在这里做一些处理&＃xff1a;

2)程序在运行(不论是在前台还是后台)

当push notification到达时&＃xff0c;如果程序在前台运行并不会弹出alertview&＃xff0c;而是直接执行下面方法&＃xff1a;

在这个方法里你可以获取到userInfo字典来进行相应处理。

如果程序是在后台运行&＃xff0c;则会弹出一个alertview,当你点击action按钮&＃xff0c;也会执行上面一样的方法。

所以如果你想要程序在push notification到达时&＃xff0c;针对前台和后台运行做区分处理&＃xff0c;你可以在上面方法里先做一个状态的

判断&＃xff1a;

原文链接&＃xff1a;http://blog.csdn.net/kmyhy/article/details/6688370