Merge pull request #421 from MathiasCochet/develop

iOS 14 update for photos permission

permission_handler/android/src/main/java/com/baseflow/permissionhandler/PermissionConstants.java

@@ -63,7 +63,7 @@ final class PermissionConstants {
     static final int PERMISSION_STATUS_GRANTED = 1;
     static final int PERMISSION_STATUS_RESTRICTED = 2;
     static final int PERMISSION_STATUS_NOT_DETERMINED = 3;
-    static final int PERMISSION_STATUS_NEVER_ASK_AGAIN = 4;
+    static final int PERMISSION_STATUS_NEVER_ASK_AGAIN = 5;
 
     @Retention(RetentionPolicy.SOURCE)
     @IntDef({

permission_handler/example/lib/plugin_example/permission_widget.dart

@@ -37,6 +37,8 @@ class _PermissionState extends State<PermissionWidget> {
         return Colors.red;
       case PermissionStatus.granted:
         return Colors.green;
+      case PermissionStatus.limited:
+        return Colors.orange;
       default:
         return Colors.grey;
     }

permission_handler/ios/Classes/PermissionHandlerEnums.h

@@ -54,6 +54,13 @@
     #define PERMISSION_PHOTOS 1
 #endif
 
+// ios: PermissionGroupPhotosAddOnly
+// Info.plist: NSPhotoLibraryUsageDescription
+// dart: PermissionGroup.photosAddOnly
+#ifndef PERMISSION_PHOTOS_ADD_ONLY
+    #define PERMISSION_PHOTOS_ADD_ONLY
+#endif
+
 // ios: [PermissionGroupLocation, PermissionGroupLocationAlways, PermissionGroupLocationWhenInUse]
 // Info.plist: [NSLocationUsageDescription, NSLocationAlwaysAndWhenInUseUsageDescription, NSLocationWhenInUseUsageDescription]
 // dart: [PermissionGroup.location, PermissionGroup.locationAlways, PermissionGroup.locationWhenInUse]
@@ -92,6 +99,7 @@ typedef NS_ENUM(int, PermissionGroup) {
     PermissionGroupMicrophone,
     PermissionGroupPhone,
     PermissionGroupPhotos,
+    PermissionGroupPhotosAddOnly,
     PermissionGroupReminders,
     PermissionGroupSensors,
     PermissionGroupSms,
@@ -108,6 +116,7 @@ typedef NS_ENUM(int, PermissionStatus) {
     PermissionStatusGranted,
     PermissionStatusRestricted,
     PermissionStatusNotDetermined,
+    PermissionStatusLimited,
 };
 
 typedef NS_ENUM(int, ServiceStatus) {

permission_handler/ios/Classes/PermissionManager.m

@@ -102,7 +102,9 @@
         case PermissionGroupPhone:
             return [PhonePermissionStrategy new];
         case PermissionGroupPhotos:
-            return [PhotoPermissionStrategy new];
+            return [[PhotoPermissionStrategy alloc] initWithAccessAddOnly:false];
+        case PermissionGroupPhotosAddOnly:
+            return [[PhotoPermissionStrategy alloc] initWithAccessAddOnly:true];
         case PermissionGroupReminders:
             return [EventPermissionStrategy new];
         case PermissionGroupSensors:

permission_handler/ios/Classes/strategies/PhotoPermissionStrategy.h

@@ -11,6 +11,7 @@
 #import <Photos/Photos.h>
 
 @interface PhotoPermissionStrategy : NSObject <PermissionStrategy>
+-(instancetype)initWithAccessAddOnly:(BOOL) addOnly;
 @end
 
 #else

permission_handler/ios/Classes/strategies/PhotoPermissionStrategy.m

@@ -7,9 +7,21 @@
 
 #if PERMISSION_PHOTOS
 
-@implementation PhotoPermissionStrategy
+@implementation PhotoPermissionStrategy{
+    bool addOnlyAccessLevel;
+}
+
+- (instancetype)initWithAccessAddOnly:(BOOL)addOnly {
+    self = [super init];
+    if(self) {
+        addOnlyAccessLevel = addOnly;
+    }
+    
+    return self;
+}
+
 - (PermissionStatus)checkPermissionStatus:(PermissionGroup)permission {
-    return [PhotoPermissionStrategy permissionStatus];
+    return [PhotoPermissionStrategy permissionStatus:addOnlyAccessLevel];
 }
 
 - (ServiceStatus)checkServiceStatus:(PermissionGroup)permission {
@@ -24,13 +36,24 @@
         return;
     }
 
+    if(@available(iOS 14, *)) {
+        [PHPhotoLibrary requestAuthorizationForAccessLevel:(addOnlyAccessLevel)?PHAccessLevelAddOnly:PHAccessLevelReadWrite handler:^(PHAuthorizationStatus authorizationStatus) {
+            completionHandler([PhotoPermissionStrategy determinePermissionStatus:authorizationStatus]);
+        }];
+    }else {
     [PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus authorizationStatus) {
         completionHandler([PhotoPermissionStrategy determinePermissionStatus:authorizationStatus]);
     }];
+    }
 }
 
-+ (PermissionStatus)permissionStatus {
-    PHAuthorizationStatus status = [PHPhotoLibrary authorizationStatus];
++ (PermissionStatus)permissionStatus:(BOOL) addOnlyAccessLevel {
+    PHAuthorizationStatus status;
+    if(@available(iOS 14, *)){
+        status = [PHPhotoLibrary authorizationStatusForAccessLevel:(addOnlyAccessLevel)?PHAccessLevelAddOnly:PHAccessLevelReadWrite];
+    }else {
+        status = [PHPhotoLibrary authorizationStatus];
+    }
 
     return [PhotoPermissionStrategy determinePermissionStatus:status];
 }
@@ -45,6 +68,8 @@
             return PermissionStatusDenied;
         case PHAuthorizationStatusAuthorized:
             return PermissionStatusGranted;
+        case PHAuthorizationStatusLimited:
+            return PermissionStatusLimited;
     }
 
     return PermissionStatusNotDetermined;

permission_handler/lib/permission_handler.dart

@@ -67,6 +67,10 @@ extension PermissionCheckShortcuts on Permission {
   /// *Only supported on iOS.*
   Future<bool> get isRestricted => status.isRestricted;
 
+  ///User has authorized this application for limited photo library access.
+  /// *Only supported on iOS.(iOS14+)*
+  Future<bool> get isLimited => status.isLimited;
+
   /// If the user denied this permission and selected to never again show a
   /// request for it. The user may still change the permission's status in the
   /// device settings.

permission_handler/pubspec.yaml

@@ -16,7 +16,10 @@ dependencies:
   flutter:
     sdk: flutter
   meta: ^1.1.6
-  permission_handler_platform_interface: ^2.0.1
+  permission_handler_platform_interface:
+    git:
+      url: https://github.com/MathiasCochet/flutter-permission-handler.git
+      path: permission_handler_platform_interface
 
 dev_dependencies:
   effective_dart: ^1.2.1

permission_handler_platform_interface/lib/src/permission_status.dart

@@ -17,6 +17,10 @@ enum PermissionStatus {
   /// *Only supported on iOS.*
   restricted,
 
+  ///User has authorized this application for limited access.
+  /// *Only supported on iOS (iOS14+).*
+  limited,
+
   /// The user denied access to the requested feature and selected to never
   /// again show a request for this permission. The user may still change the
   /// permission status in the settings.
@@ -36,6 +40,8 @@ extension PermissionStatusValue on PermissionStatus {
       case PermissionStatus.undetermined:
         return 3;
       case PermissionStatus.permanentlyDenied:
+        return 5;
+      case PermissionStatus.limited:
         return 4;
       default:
         throw UnimplementedError();
@@ -48,6 +54,7 @@ extension PermissionStatusValue on PermissionStatus {
       PermissionStatus.granted,
       PermissionStatus.restricted,
       PermissionStatus.undetermined,
+      PermissionStatus.limited,
       PermissionStatus.permanentlyDenied,
     ][value];
   }
@@ -74,6 +81,8 @@ extension PermissionStatusGetters on PermissionStatus {
   /// permission status in the settings.
   /// *Only supported on Android.*
   bool get isPermanentlyDenied => this == PermissionStatus.permanentlyDenied;
+
+  bool get isLimited => this == PermissionStatus.limited;
 }
 
 extension FuturePermissionStatusGetters on Future<PermissionStatus> {
@@ -98,4 +107,6 @@ extension FuturePermissionStatusGetters on Future<PermissionStatus> {
   /// *Only supported on Android.*
   Future<bool> get isPermanentlyDenied async =>
       (await this).isPermanentlyDenied;
+
+  Future<bool> get isLimited async => (await this).isLimited;
 }

permission_handler_platform_interface/lib/src/permissions.dart

@@ -55,47 +55,53 @@ class Permission {
 
   /// Android: Nothing
   /// iOS: Photos
+  /// iOS 14+ read & write access level
   static const photos = Permission._(9);
 
   /// Android: Nothing
+  /// iOS: Photos
+  /// iOS 14+ read & write access level
+  static const photosAddOnly = Permission._(10);
+
+  /// Android: Nothing
   /// iOS: Reminders
-  static const reminders = Permission._(10);
+  static const reminders = Permission._(11);
 
   /// Android: Body Sensors
   /// iOS: CoreMotion
-  static const sensors = Permission._(11);
+  static const sensors = Permission._(12);
 
   /// Android: Sms
   /// iOS: Nothing
-  static const sms = Permission._(12);
+  static const sms = Permission._(13);
 
   /// Android: Microphone
   /// iOS: Speech
-  static const speech = Permission._(13);
+  static const speech = Permission._(14);
 
   /// Android: External Storage
   /// iOS: Access to folders like `Documents` or `Downloads`. Implicitly
   /// granted.
-  static const storage = Permission._(14);
+  static const storage = Permission._(15);
 
   /// Android: Ignore Battery Optimizations
-  static const ignoreBatteryOptimizations = Permission._(15);
+  static const ignoreBatteryOptimizations = Permission._(16);
 
   /// Android: Notification
   /// iOS: Notification
-  static const notification = Permission._(16);
+  static const notification = Permission._(17);
 
   /// Android: Allows an application to access any geographic locations
   /// persisted in the user's shared collection.
-  static const accessMediaLocation = Permission._(17);
+  static const accessMediaLocation = Permission._(18);
 
   /// When running on Android Q and above: Activity Recognition
   /// When running on Android < Q: Nothing
   /// iOS: Nothing
-  static const activityRecognition = Permission._(18);
+  static const activityRecognition = Permission._(19);
 
   /// The unknown only used for return type, never requested
-  static const unknown = Permission._(19);
+  static const unknown = Permission._(20);
 
   /// Returns a list of all possible [PermissionGroup] values.
   static const List<Permission> values = <Permission>[
@@ -109,6 +115,7 @@ class Permission {
     microphone,
     phone,
     photos,
+    photosAddOnly,
     reminders,
     sensors,
     sms,
@@ -132,6 +139,7 @@ class Permission {
     'microphone',
     'phone',
     'photos',
+    'photosAddOnly',
     'reminders',
     'sensors',
     'sms',

permission_handler_platform_interface/pubspec.yaml

@@ -3,7 +3,7 @@ description: A common platform interface for the permission_handler plugin.
 homepage: https://github.com/baseflow/flutter-permission-handler/tree/master/permission_handler_platform_interface
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 2.0.1
+version: 2.0.2
 
 dependencies:
   flutter: