消息推送之APNS

利用APNS進行消息推送

原理

APNS 是Apple Push Notification Service（Apple Push服務器）的縮寫，是蘋果的服務器。

APNS推送可以分為三個階段：

第一階段：推送服務器應用程序把要發送的消息、目的iPhone的標識打包，發給APNS。

第二階段：APNS在自身的已注冊推送服務的iPhone列表中，查找有相應標識的iPhone，並把消息發到iPhone。

第三階段：iPhone把發來的消息傳遞給相應的應用程序，並且按照設定彈出推送通知。

詳細流程如下：

1、首先是應用程序注冊消息推送服務。

2、APNS向應用程序返回deviceToken。

3、應用程序將deviceToken發送給推送服務端程序。

4、服務端程序向APNS服務發送消息。

5、APNS服務將消息發送給iPhone應用程序。

 

證書生成

網上有很多關於證書生成的詳細步驟，這里不再說明了。

最終生成的證書共包含下面四個

1、pushNotification.certSigningRequest

2、aps_development.cer(下載生成的支持推送服務的證書。)

3、pushNotificationDevprofile.mobileprovision

4、pushNotification.p12

 

下面直接上代碼。

 

客戶端

1、應用程序注冊消息推送服務

在AppDelegate.m的(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions方法中加入注冊消息通知推送服務。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  //判斷是否由遠程消息通知觸發應用程序啟動
    if ([launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey]!=nil) {
        NSLog(@"遠程消息通知觸發應用程序啟動");
    }
    //消息推送注冊
    [[UIApplication sharedApplication] registerForRemoteNotificationTypes:UIRemoteNotificationTypeSound|UIRemoteNotificationTypeAlert|UIRemoteNotificationTypeBadge];
}

 

2、接收deviceToken的方法

在項目的AppDelegate.m中加入以下兩個代理方法

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { 
    NSString *token = [NSString stringWithFormat:@"%@", deviceToken]; 
    //獲取終端設備標識，標識獲取后需要將其發送到服務器端，服務器端推送消息到APNS時需要知道終端的標識，APNS通過注冊的終端標識找到終端設備。
    NSLog(@"My token is:%@", token);   
}  
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {   
    NSString *error_str = [NSString stringWithFormat: @"%@", error];   
    NSLog(@"Failed to get token, error:%@", error_str);   
} 

 

3、接收消息的處理方法

在項目AppDelegate.m中加入消息接收處理代理方法。

- (void)application:(UIApplication *)application 
didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    //在此處理接收到的消息。
    NSLog(@"Receive remote notification : %@",userInfo);
}

 

至此，IOS端的代碼已經碼完了。（^_^）

 

 

服務器

服務器端可以用php、Java、.net等語言實現。本文使用Java語言實現

1、導入jar包

工程建好之后，將JavaPNS_2.2.jar、javapns-jdk16-163.jar、bcprov-jdk16-145.jar這幾個jar包拷貝到工程的lib目錄下。

2、生成服務器端所用的.p12文件（.net或Java等后台）

在mac終端下執行以下指令：

（1）、將aps_development.cer轉換成aps_development.pem格式

$ openssl x509 -in aps_development.cer -inform DER -out aps_development.pem -outform PEM  

（2）、將p12格式的私鑰轉換成pem

$ openssl pkcs12 -nocerts -out Push_Noenc.pem -in pushNotification.p12  

（3）、創建p12文件

$ openssl pkcs12 -export -in aps_development.pem -inkey Push_Noenc.pem -certfile pushNotification.certSigningRequest -name "aps_development" -out aps_development.p12  

這樣我們就得到了在.net或java等后台應用程序中使用的證書文件：aps_development.p12

3、編寫服務器端代碼

package com.push.server;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.Properties;

import javapns.devices.Device;
import javapns.devices.implementations.basic.BasicDevice;
import javapns.notification.AppleNotificationServerBasicImpl;
import javapns.notification.PushNotificationManager;
import javapns.notification.PushNotificationPayload;
import javapns.notification.PushedNotification;

public class SendToAPNS {
    // 從客戶端獲取的deviceToken，在此為了測試，設一個固定值
    private static final String DEVICE_TOKEN = 

"13b11050a3fc064b3692e25c0fbd3b774b39ecb0c55a51ff4fb1373e004577a0";
    List<String> deviceToken = new ArrayList<String>();
    
    public void send () {
        // 證書文件(.p12)在服務器端的目錄
        String filePath = null;
        try {
            String path = this.getClass().getClassLoader().getResource("/").getPath();
            filePath = java.net.URLDecoder.decode(path,"utf-8");
        } catch (Exception e){
            e.printStackTrace();
        }
        System.out.println("filePath=" + filePath);
        String certificatePath = (filePath + "conf/ios_development.p12");
        // 獲取ios_development.p12的密碼
        Properties prop = new Properties();  
        FileInputStream fis = null;
        try {
            fis = new FileInputStream(filePath + "conf/pushmessage.properties");
             
        } catch (FileNotFoundException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }  
        try {
            prop.load(fis);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        String certificatePassword = prop.getProperty("password");  
        
        // 構建發送的消息
        String message="{'aps':{'alert':'this is a push message'}}";
        
        // 設別標識
        deviceToken.add(DEVICE_TOKEN);
        // 發送消息
        sendpush(deviceToken, certificatePath, certificatePassword, message, 4, false);
    }
    
     /************************************************
     測試用URL gateway.sandbox.push.apple.com /2195 
     正式發布用URL gateway.push.apple.com / 2195 
    javaPNS_2.2.jar必須
     ***************************************************/
    /**
   * @param tokens   iphone設備的唯一標識

   * @param path   .p12證書文件的路徑

   * @param password  .p12證書文件的密碼

   * @param message   發送的消息內容

   * @param count

   * @param sendCount  true 一對一發送      false 群發

   */
    public void sendpush(List<String> tokens,String path, String password, String message,Integer 

count,boolean sendCount) {
        try {
            // message:{"aps":{"alert":"一條新消息"}}
            PushNotificationPayload payLoad =  PushNotificationPayload.fromJSON(message);
            //payLoad.addAlert(message);
            payLoad.addBadge(count);
            payLoad.addSound("default");
            
            PushNotificationManager pushManager = new PushNotificationManager();
            // true 正式發布用URL
            // false 測試用URL
            pushManager.initializeConnection(new AppleNotificationServerBasicImpl(path, password, 

false));
            List<PushedNotification> notifications = new ArrayList<PushedNotification>(); 
            // 推送方式
            if (sendCount) {
                System.out.println("-------現在進行一對一推送-------");
                Device device = new BasicDevice();
                device.setToken(tokens.get(0));
                PushedNotification notification = pushManager.sendNotification(device, payLoad, 

true);
                notifications.add(notification);
            } else {
                System.out.println("------現在進行群發-------");
                List<Device> device = new ArrayList<Device>();
                for (String token : tokens) {
                    device.add(new BasicDevice(token));
                }
                notifications = pushManager.sendNotifications(payLoad, device);
            }

            List<PushedNotification> failedNotifications = PushedNotification.findFailedNotifications

(notifications);
            List<PushedNotification> successfulNotifications = 

PushedNotification.findSuccessfulNotifications(notifications);
            int failed = failedNotifications.size();
            int successful = successfulNotifications.size();
            
            if (successful > 0 && failed == 0) {
                //log.debug("-----All notifications pushed success (" + 

successfulNotifications.size() + "):");
                System.out.println("-----All notifications pushed success (" + 

successfulNotifications.size() + "):");
            } 
            else if (successful == 0 && failed > 0) {
                //log.debug("-----All notifications pushed failed(" + failedNotifications.size() + 

"):");
                System.out.println("-----All notifications pushed failed(" + 

failedNotifications.size() + "):");
            } 
            else if (successful == 0 && failed == 0) {
                System.out.println("No notifications could be sent, probably because of a critical 

error");
            } 
            else {
                //log.debug("------Some notifications pushed failed (" + failedNotifications.size

() + "):");
                //log.debug("------Others pushed success(" + successfulNotifications.size() + 

"):");
                System.out.println("------Some notifications pushed failed (" + 

failedNotifications.size() + "):");
                System.out.println("------Others pushed success(" + successfulNotifications.size() 

+ "):");
            }
            pushManager.stopConnection();
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 

 至此，服務器端代碼也碼完了。（^_^）

 

APNS推送的特點

從APNS的文檔中大概總結了以下幾點：

1、提供單一發送和群發功能。

2、當用戶手機不在線（可能沒有信號或者關機），APNs會存儲轉發，等用戶在線時再發送。

3、如果用戶長時間不在線，這條信息會被忽略。

4、如果用戶不在線，通知會合並，只會保留最新的一條。

5、payload，就是最后生成的那段Json，不得超過256字節。如果超過了，建議去掉一些不需要的參數，把alert，就是提示

信息的字數減少。

6、發送成功的沒有返回，只有發送失敗的才會返回。

7、如果有error-response，那么這條之后的通知都需要重發。

8、如果出錯了，需要關閉當前的連接，並且重新連接再發。error-response中返回的通知ID，可以幫助我們找出哪條出錯

了，這樣就能知道哪些需要重發了。

9、不要反復多次連接、終止與APNS的連接，否則會被APNS拒絕連接。

10、APNS的feedback service會返回那些已經卸載的設備的deviceToken。對於這些token，下次就不用再發了。可以節省

點資源。需要注意的是：feedback的接口讀取一次，APNS就會清空它的列表，下次再讀取時，返回的就是這兩次讀取之間這

段時間新產生的deviceToken