[ECO-5119] Opt out default push handler

example/ios/Runner/AppDelegate.swift

@@ -1,17 +1,24 @@
 import UIKit
 import Flutter
 
-@UIApplicationMain
+@main
 @objc class AppDelegate: FlutterAppDelegate {
-  override func application(
-    _ application: UIApplication,
-    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
-  ) -> Bool {
-    GeneratedPluginRegistrant.register(with: self)
-    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
-  }
-    
+    override func application(
+        _ application: UIApplication,
+        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+    ) -> Bool {
+        GeneratedPluginRegistrant.register(with: self)
+        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
+    }
+
     override func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
         NSLog("application:didFailToRegisterForRemoteNotificationsWithError was called with error: %@", error.localizedDescription)
     }
+
+    /// An example of how you handle push notification if you opt-out from using Ably Pushes by adding `AblyFlutterHandlePushNotifications` equal to `NO` in your project's Info.plist file:
+    ///
+    /// (This method is deprecated, use the new one from `UNUserNotificationCenter` as recommented by Apple, it's here for the sake of simplest example)
+    override func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
+        NSLog("Notification received: \(userInfo)")
+    }
 }

example/ios/Runner/Info.plist

@@ -2,6 +2,8 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
+	<key>AblyFlutterHandlePushNotifications</key>
+	<true/>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 	<key>CFBundleDisplayName</key>

ios/Classes/AblyFlutter.m

@@ -695,7 +695,11 @@ +(void)registerWithRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar {
 
     // initializing method channel for round-trip method calls
     FlutterMethodChannel *const methodChannel = [FlutterMethodChannel methodChannelWithName:@"io.ably.flutter.plugin" binaryMessenger:[registrar messenger] codec:methodCodec];
-    AblyFlutter *const ably = [[AblyFlutter alloc] initWithChannel:methodChannel streamsChannel: streamsChannel registrar:registrar];
+    NSNumber *handleAPNs = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"AblyFlutterHandlePushNotifications"];
+    AblyFlutter *const ably = [[AblyFlutter alloc] initWithChannel:methodChannel
+                                                    streamsChannel:streamsChannel
+                                                         registrar:registrar
+                                                        handleAPNs:handleAPNs != nil ? [handleAPNs boolValue] : NO];
 
     // registering method channel with registrar
     [registrar addMethodCallDelegate:ably channel:methodChannel];
@@ -708,18 +712,22 @@ +(void)registerWithRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar {
 
 -(instancetype)initWithChannel:(FlutterMethodChannel *const)channel
                 streamsChannel:(AblyStreamsChannel *const)streamsChannel
-                     registrar:(NSObject<FlutterPluginRegistrar>*)registrar {
+                     registrar:(NSObject<FlutterPluginRegistrar>*)registrar
+                    handleAPNs:(BOOL)handleAPNs {
     self = [super init];
     if (!self) {
         return nil;
     }
     _instanceStore = [AblyInstanceStore sharedInstance];
     _channel = channel;
     _streamsChannel = streamsChannel;
-    UNUserNotificationCenter *const center = UNUserNotificationCenter.currentNotificationCenter;
-    _pushNotificationEventHandlers = [[PushNotificationEventHandlers alloc] initWithDelegate: center.delegate andMethodChannel: channel];
-    center.delegate = _pushNotificationEventHandlers;
-
+
+    if (handleAPNs) {
+        UNUserNotificationCenter *const center = UNUserNotificationCenter.currentNotificationCenter;
+        _pushNotificationEventHandlers = [[PushNotificationEventHandlers alloc] initWithDelegate: center.delegate andMethodChannel: channel];
+        center.delegate = _pushNotificationEventHandlers;
+    }
+
     _handlers = @{
         AblyPlatformMethod_getPlatformVersion: _getPlatformVersion,
         AblyPlatformMethod_getVersion: _getVersion,