網路上關於 iOS 推播通知服務(APNS)的原理與實作介紹很多,但大多零散。本文把整個流程串起來,重點放在幾個真的會卡住人的環節。
APNS 的運作涉及三方:你的伺服器、Apple 的 APNS 閘道、以及使用者的裝置。完整步驟是:
1. 在開發者後台為 App ID 啟用 Push Notifications,並產生推送憑證
2. App 向系統註冊遠端推播,取得裝置 token
3. App 把 token 回報給你的伺服器
4. 伺服器用憑證與 APNS 閘道建立連線,帶著 token 送出訊息
5. APNS 把訊息轉發給目標裝置
其中第 1 步的設定錯誤,會導致第 2 步就拿到錯誤,是最常見的失敗點。
在 Apple Developer 後台開啟 APNS 服務、下載推送憑證的詳細操作,網路上已有大量圖文說明,這裡不贅述。要強調的是順序問題,這正是筆者卡最久的地方。
手機端取得 token 的程式碼本身很簡單,在 AppDelegate 中實作:
- (void)application:(UIApplication *)app
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// 把 deviceToken 回報給自己的伺服器
}
前提是 App ID 的 APNS 功能已經啟用,否則根本叫不到這個回呼。
實作過程中,筆者反覆遇到這個錯誤:
Error Domain=NSCocoaErrorDomain Code=3000 UserInfo=0x1179f0 "未找到應用程序的"aps-environment"的權利字符串"
原因:工程使用的 Provisioning Profile 不正確。App 內沒有 aps-environment 這個 entitlement,系統就拒絕註冊推播。
解法步驟:
1. 確認在 Apple Developer 後台,對應的 App ID 已設定成類似 com.company.appname 的明確格式。若使用 xxxx.* 這種萬用字元寫法,可能會匹配到錯誤的 App ID,這是很多人忽略的點。
2. 啟用 App ID 的 Push 功能,並在 configure 中把開發環境/正式環境的憑證都配置好。
3. 撤銷(revoke)舊的 provisioning profile,重新產生並下載。
4. 把新的 profile 安裝到測試機與 Xcode 中。
這裡有個順序陷阱:必須先在 configure 中設定好 push 功能,然後才 download profile。如果兩者順序顛倒,下載到的 profile 裡就不含 push entitlement。
若你已經不確定自己是先 download 還是先 configure,最保險的做法是:先確認 configure 都設好了,然後到 profile 清單點擊 Modify,把 profile 改成一個新名字,再安裝這個新的 profile 到手機和 Xcode。改名能強制成出一份全新的檔案,避開快取問題。
筆者花在這個問題上的時間超過半天。事後回想,根本原因在於沒有一個乾淨的測試環境——舊的 profile 快取、裝置上殘留的舊設定、Xcode 內的舊 provisioning 檔案混在一起,很難判斷哪一層出了問題。如果你照著上述步驟執行後問題依舊,很可能是有某個環節沒有真正更新到。
Mac 端的發送工具可以使用 PushMeBaby 這類開源範例專案。使用前有兩件事要做:
· 把製作憑證時產生的 .cer 檔加入專案,並同步修改程式碼中 .cer 的檔名
· 把程式碼中的 device token 替換成手機實際取得的 token
一個 64 位環境的編譯錯誤。筆者的機器是 Mountain Lion 10.8.2(64 位),執行時出現:
The run destination My Mac 64-bit is not valid for Running the scheme 'PushMeBaby'.
解法:把專案 PROJECT 與 TARGET 的 Build Settings 中,architecture 設為 64 位、Base SDK 設為 10.8,Clean 之後重新執行即可。這類老專案的 scheme 設定與新版 Xcode 不相容的問題相當常見,遇到時先檢查這兩個項目通常就能解決。
Development 與 Production 憑證不能混用。APNS 的閘道位址有兩組:開發環境用 gateway.sandbox.push.apple.com,正式環境用 gateway.push.apple.com。用錯組合,連線會被拒絕。Debug 時要記得把發送端指向 sandbox。
模擬器收不到推播。模擬器不支援遠端推播通知(早期版本),必須用實體裝置測試。這點在 iOS 上尤其要記住,因為它連 token 都拿不到。
token 會變動。裝置 token 並非永久有效——使用者重新安裝 App、還原裝置、或系統長時間未啟動 App 時都可能改變。伺服器端必須設計更新機制,並處理 APNS 回報的失效 token(feedback service)以清理資料。
Payload 有大小限制。單一推播的 payload 上限依 iOS 版本而異(早期為 256 bytes,後續放寬至 2KB 甚至 4KB)。設計訊息格式時別把大量資料塞進 payload,應該只放識別資訊,再由 App 收到推播後自行拉取內容。
憑證有到期日。開發者後台產生的 push 憑證通常一年到期,過期後推播會靜默失敗(連線建立不起來但不會有明顯錯誤)。記得設定提醒並提前更新。
整體來說,APNS 的實作難點不在程式碼——手機端與發送端的程式碼都很少——而在於憑證與 profile 的設定正確性。遇到問題時,與其反覆改程式碼,不如先從「profile 是否真的含 aps-environment entitlement」這個方向檢查。