Permalink
Browse files

Remove deprecated push notification method info

Summary:
This PR seeks to improve the documentation of PushNotificationIOS.

The method didReceiveRemoteNotification without a fetch completion handler is deprecated by Apple and they [discourage using it](https://developer.apple.com/reference/uikit/uiapplicationdelegate/1623117-application) in favor of the [version with the handler](https://developer.apple.com/reference/uikit/uiapplicationdelegate/1623013-application).

Reasons for this change:

1. Our docs say that this method is required for remote notifications, but it's not. (It's one of possibilities with a recommendation not to use it.)
2. The method is deprecated by Apple and people shouldn't use it.
3. If you use the deprecated method, in 99% of the cases it will behave in a different way from what you'd expect. In particular, you won't get remote notifications when your app is in the background.

As there's no benefit (as far as I know) of using the method, I don't think we should even mention it to the users.

This is a re-opened PR that was mis
Closes #11109

Differential Revision: D4232800

Pulled By: javache

fbshipit-source-id: d3b509db41a549aa7fbc41753c648085df43d8ee
  • Loading branch information...
1 parent 51efaab commit 9c7952d9e1848d71fd8d964b1cfc0909ef3157be @sharnik sharnik committed with Facebook Github Bot Nov 25, 2016
Showing with 0 additions and 10 deletions.
  1. +0 −10 Libraries/PushNotificationIOS/PushNotificationIOS.js
@@ -96,21 +96,11 @@ export type PushNotificationEventName = $Enum<{
* {
* [RCTPushNotificationManager didReceiveRemoteNotification:userInfo fetchCompletionHandler:completionHandler];
* }
- * // Optionally implement this method over the previous to receive remote notifications. However
- * // implement the application:didReceiveRemoteNotification:fetchCompletionHandler: method instead of this one whenever possible.
- * // If your delegate implements both methods, the app object calls the `application:didReceiveRemoteNotification:fetchCompletionHandler:` method
- * // Either this method or `application:didReceiveRemoteNotification:fetchCompletionHandler:` is required in order to receive remote notifications.
- * //
* // Required for the registrationError event.
* - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
* {
* [RCTPushNotificationManager didFailToRegisterForRemoteNotificationsWithError:error];
* }
- * // Required for the notification event.
- * - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)notification
- * {
- * [RCTPushNotificationManager didReceiveRemoteNotification:notification];
- * }
* // Required for the localNotification event.
* - (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
* {

0 comments on commit 9c7952d

Please sign in to comment.