在 iOS 開發流程中,當我們打包並上傳 App 到 App Store Connect 時,偶爾會收到一封標題為「Missing Push Notification Entitlement」的警告郵件。本文將完整梳理這個問題的成因、判斷方式與處理步驟。
Apple 回覆的原文大意如下:
Your app includes an API for Apple's Push Notification service, but the aps-environment entitlement is missing from the app's signature. To resolve this, make sure your App ID is enabled for push notification in the Provisioning Portal. Then, sign your app with a distribution provisioning profile that includes the aps-environment entitlement.
翻譯成白話就是:你的 App 裡包含了 Apple 推送服務(APNs)相關的 API,但在簽名檔案中卻找不到 aps-environment 這項權利(entitlement)。要解決這個問題,你必須確認 App ID 已在開發者後台啟用推送功能,並使用包含 aps-environment 權利的描述檔(Provisioning Profile)重新簽名,然後再次上傳。
如果 App 本身並未使用推送服務,則無需理會這則警告,也可以在後續版本中移除相關 API 以免重複收到通知。若使用第三方框架,可能需要聯繫框架開發者協助移除。
修正完成後,你可以透過 Xcode 或 Application Loader 重新上傳二進位檔至 App Store Connect。若需要更新既有 App,可在 App Store Connect 的 binary details 頁面拒絕這個二進位檔。需要注意的是,一旦拒絕,這個版本就會退出審核隊列,重新提交後審核流程將從頭開始。
這個問題最常見的根源是:App 本身並不需要推送功能,但建立 App ID 時卻勾選了推送服務,同時又沒有配置對應的推送憑證。 這種情況下,直接忽略這則警告即可,它並不影響审核結果,只會影響推送功能是否能正常運作。