推送(Remote Notification)牽涉到三個角色:你的 App、你的伺服器、Apple 的 APNS。本文把整条鏈路從證書準備到程式碼逐段走過。
1. CSR 檔(CertificateSigningRequest):在 Mac 上產生,用於向 Apple 申請推送證書。開啟「鑰匙串存取」,從選單進入「證書助理 > 從證書頒發機構要求憑證」,填入 email 與名稱,選擇儲存到磁碟即可。
2. 支援 Push 的 App ID:登入 developer.apple.com,進入 Certificates, Identifiers & Profiles > Identifiers > App IDs,新增時 App ID Suffix 必須選 Explicit App ID(不能是 Wildcard),設定 Bundle ID 後勾選 App Services 中的 Push Notifications。
3. 推送證書(.cer):在 Certificates 頁面新增,類型分 Development 與 Production。以 Development 為例,選擇 Apple Push Notification service SSL (Sandbox),指定前述 App ID,上傳 CSR,即可下載 .cer。
4. 伺服器用的憑證檔:若用 Mac 上的 PushMeBaby 工具測試,有 .cer 就夠了。若要用 PHP、Java、C# 自建服務端,還需轉換格式。
轉成 PHP 用的 pem:
// 雙擊 .cer 匯入鑰匙串,然後分別從「憑證」與「私鑰」匯出為 .p12 openssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -in apns-dev-cert.p12 openssl pkcs12 -nocerts -out apns-dev-key.pem -in apns-dev-key.p12 // 合併成一個檔 cat apns-dev-cert.pem apns-dev-key.pem > apns-dev.pem
轉成 Java/C# 用的 p12:
openssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -in apns-dev-cert.p12 openssl pkcs12 -nocerts -out apns-dev-key.pem -in apns-dev-key.p12 openssl pkcs12 -export -in apns-dev-cert.pem -inkey apns-dev-key.pem \ -certfile CertificateSigningRequest.certSigningRequest -name "push" -out push.p12
5. Provisioning Profile:在 Provisioning Profiles 中新增,選 iOS App Development,指定支援 push 的 App ID、對應的憑證,勾選要安裝的裝置 UDID,命名後下載。這個檔案是讓 App 能部署到真機的關鍵。
測試階段可以用開源的 PushMeBaby(https://github.com/stefanhafeneger/PushMeBaby),把專案裡的 .cer 換成自己的、deviceToken 換成自己裝置的即可。它的執行邏輯就是:設定 SSL 憑證、連上 APNS、送出 JSON。
用 PHP 寫服務端也很簡短,因為 PHP 已內建 ssl 支援:
<?php
$deviceToken = '自己的 deviceToken'; // 不可含空白
$body = array("aps" => array(
"alert" => 'message',
"badge" => 2,
"sound" => 'default'
));
$ctx = stream_context_create();
// Windows 環境下 pem 路徑建議用絕對路徑
stream_context_set_option($ctx, "ssl", "local_cert", "apns-dev.pem");
stream_context_set_option($ctx, 'ssl', 'passphrase', '你的通行短語');
// 開發測試連 sandbox,正式發布連正式主機
$fp = stream_socket_client("ssl://gateway.sandbox.push.apple.com:2195",
$err, $errstr, 60, STREAM_CLIENT_CONNECT, $ctx);
if (!$fp) { echo "Failed to connect $err $errstr\n"; return; }
print "Connection OK\n";
$payload = json_encode($body);
$msg = chr(0) . pack("n", 32) . pack("H*", str_replace(' ', '', $deviceToken))
. pack("n", strlen($payload)) . $payload;
fwrite($fp, $msg);
fclose($fp);
?>
可以透過瀏覽器訪問,也可以用 php -f Pusher.php 從命令列執行。這裡用的是最簡單的二進位封包格式;若需要錯誤回報與較好的效能,建議改用 enhanced format 或 HTTP/2 的 provider API。
把 .cer 與 provisioning profile 雙擊匯入 Xcode,在 Build Settings 的 Code Signing 中選好,就能部署到真機。
接收端要分兩種情況處理:
App 未執行:使用者點擊通知後 App 才啟動,此時不會走 didReceiveRemoteNotification:,而是在啟動方法中取得:
NSDictionary *userInfo =
[launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];
App 在前景或背景:前景時系統不顯示提示,直接呼叫 didReceiveRemoteNotification:;背景時使用者點通知後才會呼叫,AppDelegate 的執行順序是 applicationWillEnterForeground → application:didReceiveRemoteNotification → applicationDidBecomeActive。
實務上還有三件事值得補充:一是註冊使用者通知需改用 iOS 8 之後的 UIUserNotificationSettings 搭配 registerUserNotificationSettings:,舊的 registerForRemoteNotificationTypes: 單獨呼叫已不足以顯示提示;二是 deviceToken 會因系統重裝、備份還原而改變,伺服器端必須支援更新與失效清理,並利用 Feedback Service 移除已註銷的 token;三是 APNS 並不保證即時送達,也不保證順序,重要訊息應由 App 主動拉取伺服器補齊,不要把推送當成唯一的通知通道。