iOS 远程推送的实现

iOS的推送可以用下图简单的概括:

这里 Provider 是指某个应用的Developer，当然如果开发者使用AVOS Cloud的服务，把发送消息的请求委托给我们，那么这里的Provider就是AVOS Cloud的推送服务程序了。上图可以分为三步：

第一步：AVOS Cloud推送服务程序把要发送的消息、目的设备的唯一标识打包，发给APNs。

第二步：APNs在自身的已注册Push服务的应用列表中，查找有相应标识的设备，并把消息发送到设备。

第三步：iOS系统把发来的消息传递给相应的应用程序，并且按照设定弹出Push通知

为了实现消息推送，有两点非常重要：

1. App的推送证书

要能够完整实现一条消息推送，需要我们在App ID中打开Push Notifications，需要我们准备好Provisioning Profile和SSL证书，并且一定要注意Development和Distribution环境是需要分开的。最后，把SSL证书导入到AVOS Cloud平台，就可以尝试远程消息推送了。具体的操作流程如下：

(1). 登录 iPhone Developer Connection Portal （链接）然后点击 App IDs
(2). 创建一个 Apple ID ，如：com.chenjungang.apnstest 注意：通配符 ID 不能用于推送通知服务。
(3). 点击 Apple ID 旁的“Configure”，根据“向导” 的步骤生成一个签名上传，然后下载生成的许可证。
(4). 双击 .cer 文件将你的 aps_development.cer 导入 Keychain 中。
(5). 在 Mac 上打开“钥匙串访问”，然后在“登录”中选择 "密钥"分类，找到我们创建的证书，然后右击“Apple Development IOS Push Services: com.tadpole.TestAPNs” > 导出 “Apple Development IOS Push Services: com.chenjungang.apnstest”。保存为 cert.p12 文件。
(6). 通过终端命令将这个 cert.p12 文件转换为 PEM 格式，打开终端， cd 进入证书所在目录，执行如下命令：(Java 直接给 .p12 文件，Php 给 pem 文件)

openssl pkcs12 -in cert.p12 -out apple_push_notification_production.pem -nodes -clcerts

执行完上面命令会在当前目录下生成一个名为apple_push_notification_production.pem文件，这个文件就是我们需要得到php连接APNS 的文件，将apple_push_notification_production.pem和push.php放入同一目录上传到服务器，push.php的代码如下：

 1 <?php 
 2 $deviceToken = 'ad853c20 3a9b874e 00d0cde2 44a73752 999bb250 9fa36129 0525d5d0 a6ba3e4c';
 3 
 4 // Put your private key's passphrase here:
 5 $passphrase = '123456';
 6 
 7 // Put your alert message here:
 8 $message = 'This is some push message!';
 9 $ctx = stream_context_create();
10 stream_context_set_option($ctx, 'ssl', 'local_cert', 'apple_push_notification_production.pem');
11 stream_context_set_option($ctx, 'ssl', 'passphrase', $passphrase);
12 
13 // Open a connection to the APNS server
14 //这个为正式的发布地址
15  //$fp = stream_socket_client(“ssl://gateway.push.apple.com:2195“, $err, $errstr, 60, //STREAM_CLIENT_CONNECT, $ctx);
16 //这个是沙盒测试地址，发布到appstore后记得修改哦
17 $fp = stream_socket_client(
18 'ssl://gateway.sandbox.push.apple.com:2195', $err,
19 $errstr, 60, STREAM_CLIENT_CONNECT|STREAM_CLIENT_PERSISTENT, $ctx);
20 if (!$fp)
21 exit("Failed to connect: $err $errstr" . PHP_EOL);
22 echo 'Connected to APNS' . PHP_EOL;
23 
24 // Create the payload body
25 $body['aps'] = array(
26 'alert' => $message,
27 'sound' => 'default'
28 );
29 
30 // Encode the payload as JSON
31 $payload = json_encode($body);
32 
33 // Build the binary notification
34 $msg = chr(0) . pack('n', 32) . pack('H*', $deviceToken) . pack('n', strlen($payload)) . $payload;
35 
36 // Send it to the server
37 $result = fwrite($fp, $msg, strlen($msg));
38 
39 if (!$result)
40 echo 'Message not delivered' . PHP_EOL;
41 else
42 echo 'Message successfully delivered' . PHP_EOL;
43 
44 // Close the connection to the server
45 fclose($fp);
46 
47 ?>

PHP

2. 设备标识DeviceToken

知道了谁要推送，或者说要推送给哪个App之后，APNs还需要知道推到哪台设备上，这就是设备标识的作用。获取设备标识的流程如下：

第一步：App打开推送开关，用户要确认TA希望获得该App的推送消息

第二步：App获得一个DeviceToken

第三步：App将DeviceToken保存起来，这里就是通过[AVInstallation saveInBackground]将DeviceToken保存到AVOS Cloud

第四步：当某些特定事件发生，开发者委托AVOS Cloud来发送推送消息，这时候AVOS Cloud的推送服务器就会给APNs发送一则推送消息，APNs最后消息送到用户设备

推送相关的几个概念

消息类型

一条消息推送过来，可以有如下几种表现形式：

1. 显示一个alert或者banner，展现具体内容

2. 在应用icon上提示一个新到消息数

3. 播放一段声音

开发者可以在每次推送的时候设置，在推送达到用户设备时开发者也可以选择不同的提示方式。

本地消息通知

iOS上有两种消息通知，一种是本地消息（Local Notification），一种是远程消息(Push Notification，也叫Remote Notification)，设计这两种通知的目的都是为了提醒用户，现在有些什么新鲜的事情发生了，吸引用户重新打开应用。

本地消息什么时候有用呢？譬如你正在做一个To-do的工具类应用，对于用户加入的每一个事项，都会有一个完成的时间点，用户可以要求这个To-do应用在事项过期之前的某一个时间点提醒一下TA。为了达到这一目的，App就可以调度一个本地通知，在时间点到了之后发出一个Alert消息或者其他提示。

我们在处理推送消息的时候，也可以综合运用这两种方式。

代码里面如何实现推送

首先，我们要获取DeviceToken。

App需要每次启动的时候都去注册远程通知——通过调用UIApplication的registerForRemoteNotificationTypes:方法，传递给它你希望支持的消息类型参数即可，例如：

 1 #define IS_IOS8_AND_UP ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0)
 2 
 3 -(void)settingPushMessage:(UIApplication*)application
 4 {
 5     
 6     if (IS_IOS8_AND_UP) {
 7         [application registerForRemoteNotifications];
 8         UIUserNotificationType types = UIUserNotificationTypeBadge|UIUserNotificationTypeSound|UIUserNotificationTypeAlert;
 9         [application registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:types categories:nil]];
10     }else{
11         //消息推送支持的类型
12         UIRemoteNotificationType types =
13         (UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound);
14         //注册消息推送
15         [[UIApplication sharedApplication]registerForRemoteNotificationTypes:types];
16     }
17     
18 }
19 
20 - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
21 {
22     //获取token
23     NSString* token = [NSString stringWithFormat:@"%@",deviceToken];
24     token = [token stringByReplacingOccurrencesOfString:@"<" withString:@""];
25     token = [token stringByReplacingOccurrencesOfString:@">" withString:@""];
26     [[NSUserDefaults standardUserDefaults] setObject:token forKey:@"APVNToken"];
27     
28     NSLog(@"token====%@",token);
29 }
30 - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
31 {
32     //这里是获取token失败
33     NSString *error_str = [NSString stringWithFormat: @"%@", error];
34     NSLog(@"Failed to get token, error:%@", error_str.description);
35 }
36 - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
37 {
38     //在此处理接收到的消息。
39     NSLog(@"Receive remote notification : %@",userInfo);
40 }

View Code

请注意：注册流程需要在app每次启动时调用，这并不不会带来额外的负担，因为iOS操作系统在第一次获得了有效的device token之后，会本地缓存起来，以后app再调用registerForRemoteNotificationTypes:的时候会立刻返回，并不会再进行网络请求。另外，app层面不应该对device token进行缓存，因为device token也有可能变化——如果用户重装了操作系统，那么APNs再次给出的device token就会和之前的不一样，又或者是，用户restore了原来的backup到新的设备上，那么原来的device token也会失效。

其次，我们要处理收到消息之后的回调

我们可以设想一下消息通知的几种使用场景：

1，在app没有被启动的时候，接收到了消息通知。这时候操作系统会按照默认的方式来展现一个alert消息，在app icon上标记一个数字，甚至播放一段声音。

2，用户看到消息之后，点击了一下action按钮或者点击了应用图标。如果action按钮被点击了，系统会通过调用application:didFinishLaunchingWithOptions:这个代理方法来启动应用，并且会把notification的payload数据传递进去。如果应用图标被点击了，系统也一样会调用application:didFinishLaunchingWithOptions:这个代理方法来启动应用，唯一不同的是这时候启动参数里面不会有任何notification的信息。

3，如果远程消息发送过来的时候，app正在运行，这时候会发生什么呢？

app代理的application:didReceiveRemoteNotification:方法会被调用，同时远程消息中的payload数据会作为参数传递进去。

常见问题FAQ

1. 我能推送长消息吗？

不能，APNs限制了每个notification的payload最大长度是256字节，超长的消息是不能发送的。

2. 推送怎么加声音提醒？

消息推送是可以指定声音的。譬如你可以对正面的反馈使用欢快的声音，对负面的反馈使用低沉一点的声音，都可以达到别出心裁让人眼前一亮的目的。

你需要先放一些aiff、wav或者caf音频文件到app的资源文件中，然后在推送的时候指定不同的音频文件名就可以了。

3. 推送的Badge是怎么回事？

推送并不一定会导致应用图标上红色数字增加，是否显示这一数字，显示成多少，都取决于开发者自己。

在发送推送消息的时候，我们可以选择是否递增这一数字；如果不选择这一项，那么消息推送并不会导致应用图标上红色数字的出现。

好，现在问题来了，这个数字如果搞出来了，怎么让它消失掉呢？

其实我们只需要在任何时候设置 UIApplication.applicationIconBadgeNumber 属性为0，就可以让这个数字消失掉。

一般我们会选择在应用启动的时候（application:didFinishLaunchingWithOptions:方法中），或者干脆一点，在应用每次被切换到前台的时候（applicationWillEnterForeground:方法中），调用这一行代码，即可立刻清除掉Badge数字了。

4. AVOS Cloud平台发出去的通知格式究竟是什么样子的

对于每一条推送消息，都包含一个payload，通常是组成了一个JSON的Dictionary，这其中必不可少的是aps属性，它对应的value也是一个Dictionary，包含下面一些内容：

1）alert消息（文本或Dictionary）

2）应用图标上的红色数字

3）播放的声音文件名

在由推送激活的app打开事件中，application:didFinishLaunchingWithOptions:的options参数就是这个大的Dictionary对象。

1 { 
2     aps =     { 
3         alert = "hello, everyone"; 
4         badge = 2; 
5         sound = default; 
6     }; 
7 }

这里要注意的时alert部分，它的值可以是一个String（文本消息），也可以是一个JSON的Dictionary。当它是文本消息的时候，系统就会把这些文字显示到一个alertview中；如果它也是由一个JSON Dictionary组成的话，其格式如下：

* body

* action-loc-key

* loc-key

* loc-args

* launch-image

body部分就是alertView中将要展现出来的文本消息，loc-属性主要是用来实现本地化消息，launch-image只是app主bundle里的一个图片文件的名称，一般来说我们不指定这一属性。

5. 如何显示本地化的消息

有两种办法可以实现推送消息的本地化：

1）在推送的payload中使用loc-key和loc-args来指定进行本地化，这样Provider方只需要按照统一的格式来发送即可，消息的解析和组装则由客户端来完成。

2）如果推送的payload里面不包含loc-key/loc-args信息，那么Provider方就需要自己做本地化处理，然后给不同的device发送不同的消息，为了做到这一点，还需要app在上传device token的时候也把用户的语言设置信息传回来。

目前，因为AVOS Cloud主要就是瞄准中国大陆市场和海外中文用户，所以我们在推送上还不提供多语言支持。

6. 应用该怎么响应推送消息

上面说的处理流程，只能简单展示一下远程消息，激活用户让他们重新回到app中来。但是有时候，我们希望带给用户更好的使用体验，譬如如果我们告诉用户：张三刚刚评论了你的照片。这时候用户如果点击action按钮进入app，我们是展示具体的评论页面为好，还是展示通常的启动页面然后让用户自己去找张三的评论好？我想负责任的开发者都会选择前者。

要做到灵活响应不同类型的通知消息，我们需要在通知的payload中增加更多信息，而不能仅仅只有alert出来的文字信息。对于AVOS Cloud消息推送平台来讲，就需要开发者使用更高级功能的JSON格式。譬如我们发送这样的json字符串{"action":{"type":4},"alert":"hello, everyone”} 最终在app内会收到这样的UserInfo Dictionary：

1 { 
2     action =     { 
3         type = 4; 
4     }; 
5     aps =     { 
6         alert = "hello, everyone"; 
7         badge = 4; 
8     }; 
9 }

“hello, everyone”会显示到alertView中，但是整个Dictionary会通过launchOptions传递给application: didFinishLaunchingWithOptions: 方法，这样我们在程序里面就可以对不同的消息实现不同的跳转了。