您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

用 Java 實現 iPhone 推送通知:APNs 服務端完整實戰

編輯:iOS 開發綜合

先理清推送的三個角色

蘋果的推送服務(APNs)背後其實是一條清晰的閉環鏈路:App 在設備端向系統註冊,拿到一個 device token;App 把這個 token 上報給自家的服務端(也就是 provider);服務端帶著 token、通知內容與展示形式,把請求轉交給蘋果,再由蘋果投遞到目標設備。

設備端獲取 token 的環節這裡不展開,關鍵是把拿到的 token 字串完整地存進後端資料庫,後續所有推送都以它為依據。

至於越獄設備拿不到 token 的狀況,可以透過 Cydia 安裝 Push Doctor 這類補丁來繞過限制,具體安裝方式網路上資料很多,這裡不贅述。

Provider 要做的事其實很單純

用最樸素的語言描述:provider 透過憑證與蘋果伺服器建立 TLS/SSL 加密連線,通過身份驗證之後,把符合蘋果規範的二進位資料流寫進 socket 即可。沒有魔法,就是一次帶憑證的 HTTPS 式握手加上一段特定格式的封包。

第一步:取得推送憑證

蘋果提供兩套憑證,用途完全不同:

  • Development(開發):搭配 Debug 包使用,主要給內部測試。
  • Production(生產):搭配正式上架或企業簽發的包使用。

下載入口在 iOS Provisioning Portal。這裡有兩個容易卡住的前提:

  1. 登入用的 Apple Developer 帳號必須是團隊中權限最高的 Agent(又稱 Team Agent、創始帳號)。企業帳號尤其如此,否則 App ID 列表中根本不會出現 Configure 連結;個人帳號則無此顧慮。
  2. 該 App ID 必須先執行過 Configure,並勾選啟用 Push Notification 服務。

完成後點進 Configure 頁面,按下 Download,就能拿到一組專為推送簽發的憑證。

第二步:處理憑證格式

如果你寫的是跑在 Mac 上的 Objective-C 程式,這一步可以跳過,Xcode 會直接吃 Developer 憑證。

但在 Java 環境下,Java 的 keystore 需要「憑證 + 對應的私鑰」兩者合併,因此必須在鑰匙串(Keychain)中找到當初簽發憑證時產生的那把私鑰,把它和剛下載的推送憑證一起匯出為 .p12 檔。

操作流程:在鑰匙串中選中「我的憑證」下展開的那一項,右鍵選擇匯出兩項,格式選 Personal Information Exchange (.p12)。系統會要求你設定一組檔案密碼,接著再要求輸入當前登入帳號的密碼以授權匯出,完成後檔案即產生出來。

重要提醒:雖然可以留空密碼,但 Java 端在載入空密碼的 p12 時會直接拋出異常,實務上請務必設定一組非空密碼並妥善保存。

第三步:寫 Java 端發送程式

Mac 平台有現成範例可直接參考(PushMeBaby),把 deviceToken 與憑證換成自己的即可運行。若要在 Java 中實作,最常見的選擇是開源的 JavaPNS 函式庫,搭配以下相依套件:

  • bcprov-jdk16-145-1.jar(BouncyCastle 加密實作)
  • commons-io-2.0.1.jar
  • commons-lang-2.5.jar
  • log4j-1.2.16.jar
  • javapns-jdk16-163.jar

核心程式碼如下:

package com.sdunisi.iphone.apns.send;

import javapns.back.PushNotificationManager;
import javapns.back.SSLConnectionHelper;
import javapns.data.Device;
import javapns.data.PayLoad;

public class MainApnsSend {

    public static void main(String[] args) throws Exception {
        try {
            String deviceToken = "e775b5892f3334427c14def8aa4d8189a4ec1c795020072f4baa7ee92e50b1db";

            PayLoad payLoad = new PayLoad();
            payLoad.addAlert("我的 push 測試");
            payLoad.addBadge(1);
            payLoad.addSound("default");

            PushNotificationManager pushManager = PushNotificationManager.getInstance();
            pushManager.addDevice("iPhone", deviceToken);

            // 測試環境:gateway.sandbox.push.apple.com:2195
            // 正式環境:gateway.push.apple.com:2195
            String host = "gateway.sandbox.push.apple.com";
            int port = 2195;
            String certificatePath = "/Users/jcjc/Desktop/push_p.p12";
            String certificatePassword = "sunlg";

            pushManager.initializeConnection(host, port, certificatePath,
                    certificatePassword, SSLConnectionHelper.KEYSTORE_TYPE_PKCS12);

            Device client = pushManager.getDevice("iPhone");
            pushManager.sendNotification(client, payLoad);

            pushManager.stopConnection();
            pushManager.removeDevice("iPhone");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

幾個實務上會踩到的細節

第一,環境必須對應。Development 憑證只能配 sandbox 位址,Production 憑證只能配正式位址,兩者錯配會出現連線成功但永遠收不到通知的窘境。

第二,Badge 是覆寫而非累加。addBadge 送出的數字會直接覆蓋桌面上現有的紅圈數字,伺服器端需要自行維護未讀計數。

第三,連線可以重複利用。每次推送都重建 SSL 握手成本很高,正式服務應把連線物件池化,長時間保持。

第四,要處理蘋果的回饋。APNs 另有一組 feedback 服務,能查詢哪些 token 已因關閉通知或卸載 App 而失效,定期清理這些 token 才能維持送達率。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved