feat(ios): add carplay notification permissions option

Author: derrik-fleming

permission_handler/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 12.0.2
+
+- Enhanced iOS notification permission checking to include CarPlay notification settings on iOS 10.0+ devices.
+- Updates `permission_handler_apple` dependency to version 9.4.8.
+
 ## 12.0.1
 
 - Updates the correspondence between permission groups and the key values of Info.plist in the README.md.

permission_handler/README.md

@@ -110,6 +110,7 @@ You must list the permission you want to use in your application:
           'PERMISSION_LOCATION_WHENINUSE=0',
 
           ## dart: PermissionGroup.notification
+          ## Note: On iOS 10.0+, includes CarPlay notification permissions
           'PERMISSION_NOTIFICATIONS=1',
 
           ## dart: PermissionGroup.mediaLibrary
@@ -161,7 +162,7 @@ You must list the permission you want to use in your application:
 | PermissionGroup.photosAddOnly                                                               | NSPhotoLibraryAddUsageDescription                                                                              | PERMISSION_PHOTOS_ADD_ONLY             |
 | PermissionGroup.location, PermissionGroup.locationAlways, PermissionGroup.locationWhenInUse | NSLocationUsageDescription, NSLocationAlwaysAndWhenInUseUsageDescription, NSLocationWhenInUseUsageDescription  | PERMISSION_LOCATION                    |
 | PermissionGroup.locationWhenInUse                                                           | NSLocationWhenInUseUsageDescription                                                                            | PERMISSION_LOCATION_WHENINUSE          |
-| PermissionGroup.notification                                                                | PermissionGroupNotification                                                                                    | PERMISSION_NOTIFICATIONS               |
+| PermissionGroup.notification                                                                | PermissionGroupNotification (iOS 10.0+ includes CarPlay notifications)                                        | PERMISSION_NOTIFICATIONS               |
 | PermissionGroup.mediaLibrary                                                                | NSAppleMusicUsageDescription, kTCCServiceMedia                                                                 | PERMISSION_MEDIA_LIBRARY               |
 | PermissionGroup.sensors                                                                     | NSMotionUsageDescription                                                                                       | PermissionGroupSensors                 |
 | PermissionGroup.bluetooth                                                                   | NSBluetoothAlwaysUsageDescription, NSBluetoothPeripheralUsageDescription                                       | PermissionGroupBluetooth               |
@@ -264,7 +265,7 @@ The status of the setting will determine whether the permission is `granted` or
 
 The following permissions will show no dialog:
 
-- Notification
+- Notification (Note: On iOS, requesting notification permission includes CarPlay notifications on iOS 10.0+ devices)
 - Bluetooth
 
 The following permissions will show no dialog, but will open the corresponding setting intent for the user to change the permission status:

permission_handler/pubspec.yaml

@@ -2,7 +2,7 @@ name: permission_handler
 description: Permission plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to request and check permissions.
 repository: https://github.com/baseflow/flutter-permission-handler
 issue_tracker: https://github.com/Baseflow/flutter-permission-handler/issues
-version: 12.0.1
+version: 12.0.2
 
 environment:
   sdk: ^3.5.0
@@ -25,7 +25,7 @@ dependencies:
     sdk: flutter
   meta: ^1.7.0
   permission_handler_android: ^13.0.0
-  permission_handler_apple: ^9.4.6
+  permission_handler_apple: ^9.4.8
   permission_handler_html: ^0.1.1
   permission_handler_windows: ^0.2.1
   permission_handler_platform_interface: ^4.3.0

permission_handler_apple/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [9.4.8]
+
+* Enhanced notification permission checking to include CarPlay notification settings on iOS 10.0+ devices.
+
 ## 9.4.7
 
 * Increases minimum supported Flutter version to 3.3.0, and removes code only

permission_handler_apple/ios/Classes/strategies/NotificationPermissionStrategy.m

@@ -36,6 +36,7 @@ - (void)requestPermission:(PermissionGroup)permission completionHandler:(Permiss
     authorizationOptions += UNAuthorizationOptionSound;
     authorizationOptions += UNAuthorizationOptionAlert;
     authorizationOptions += UNAuthorizationOptionBadge;
+    authorizationOptions += UNAuthorizationOptionCarPlay;
     [center requestAuthorizationWithOptions:(authorizationOptions) completionHandler:^(BOOL granted, NSError * _Nullable error) {
       if (error != nil || !granted) {
         completionHandler(PermissionStatusPermanentlyDenied);
@@ -60,6 +61,18 @@ + (PermissionStatus)permissionStatus {
       permissionStatus = PermissionStatusPermanentlyDenied;
     } else if (settings.authorizationStatus == UNAuthorizationStatusNotDetermined) {
       permissionStatus = PermissionStatusDenied;
+    } else if (settings.authorizationStatus == UNAuthorizationStatusAuthorized) {
+      if (@available(iOS 10.0, *)) {
+        if (settings.carPlaySetting == UNNotificationSettingEnabled) {
+          permissionStatus = PermissionStatusGranted;
+        } else if (settings.carPlaySetting == UNNotificationSettingDisabled) {
+          permissionStatus = PermissionStatusGranted;
+        } else {
+          permissionStatus = PermissionStatusGranted;
+        }
+      } else {
+        permissionStatus = PermissionStatusGranted;
+      }
     }
     dispatch_semaphore_signal(sem);
   }];

permission_handler_apple/pubspec.yaml

@@ -2,7 +2,7 @@ name: permission_handler_apple
 description: Permission plugin for Flutter. This plugin provides the iOS API to request and check permissions.
 repository: https://github.com/baseflow/flutter-permission-handler
 issue_tracker: https://github.com/Baseflow/flutter-permission-handler/issues
-version: 9.4.7
+version: 9.4.8
 
 environment:
   sdk: ">=2.18.0 <4.0.0"

permission_handler_platform_interface/lib/src/permissions.dart

@@ -170,7 +170,20 @@ class Permission {
   /// Permission for accessing ignore battery optimizations (Android only).
   static const ignoreBatteryOptimizations = Permission._(16);
 
-  /// Permission for pushing notifications.
+  /// Permission for requesting notification permissions.
+  ///
+  /// **iOS**: Requests both general and CarPlay notification permissions on iOS 10.0+.
+  /// Status checking includes CarPlay settings when available, with graceful fallback
+  /// for older devices.
+  ///
+  /// **Android/Other platforms**: Standard notification permission behavior.
+  ///
+  /// Example:
+  /// ```dart
+  /// // Automatically includes CarPlay on supported iOS devices
+  /// final status = await Permission.notification.status;
+  /// final result = await Permission.notification.request();
+  /// ```
   static const notification = Permission._(17);
 
   /// Permission for accessing the device's media library.