didReceiveRemoteNotificationメソッドがiOS 13以上で呼ばれない理由

特定の手続きをしないと、iOS 13以上でサイレントプッシュを使っている時にAppDelegateのdidReceiveRemoteNotificationが呼ばれないことがわかりました。

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    print("PUSH arrived.")
    completionHandler(.noData)
}

サーバー側でヘッダーにapns-push-type: backgroundを付けるか、もしくは以下のようにペイロードJSONのaps部分に空のalertを付けると、無事呼ばれるようになりました。

{
    "aps": {
        "alert": {},
        "content-available": 1
    }
}

WWDC2019で発表された正式な方法らしい前者が理想ですが、もしサーバーがカスタムヘッダーをサポートしていない場合は後者のほうが簡単です。

注意点

ヘッダーにapns-push-type: alertを明示的につけていると、ペイロードJSONの内容に関わらずサイレントプッシュとみなされなくなり、didReceiveRemoteNotificationが呼ばれないらしいので、気をつけましょう。

参考文献

• iOS 13 beta 7 Silent Push Bug |Apple Developer Forums
• iOS 13 and Xcode 11 Changes That Affect Push Notifications
  • APNS Priority must be set to 5 for background notifications