[image_picker] add requestFullMetadata for iOS (optional permissions)

packages/image_picker/image_picker/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.8.6
+
+* Adds `requestFullMetadata` option to `pickImage`, so images on iOS can be picked without `Photo Library Usage` permission.
+
 ## 0.8.5+2
 
 * Minor fixes for new analysis options.

packages/image_picker/image_picker/lib/image_picker.dart

@@ -191,6 +191,10 @@ class ImagePicker {
   /// the front or rear camera should be opened, this function is not guaranteed
   /// to work on an Android device.
   ///
+  /// Use `requestFullMetadata` (defaults to `true`) to control how much additional information the plugin tries to get.
+  /// If `requestFullMetadata` is set to `true`, the plugin tries to get the full image metadata which may require
+  /// extra permission requests on some platforms, such as `Photo Library Usage` permission on iOS .
+  ///
   /// In Android, the MainActivity can be destroyed for various reasons. If that happens, the result will be lost
   /// in this call. You can then call [retrieveLostData] when your app relaunches to retrieve the lost data.
   ///
@@ -206,13 +210,17 @@ class ImagePicker {
     double? maxHeight,
     int? imageQuality,
     CameraDevice preferredCameraDevice = CameraDevice.rear,
+    bool requestFullMetadata = true,
   }) {
-    return platform.getImage(
+    return platform.getImageFromSource(
       source: source,
-      maxWidth: maxWidth,
-      maxHeight: maxHeight,
-      imageQuality: imageQuality,
-      preferredCameraDevice: preferredCameraDevice,
+      options: ImagePickerOptions(
+        maxWidth: maxWidth,
+        maxHeight: maxHeight,
+        imageQuality: imageQuality,
+        preferredCameraDevice: preferredCameraDevice,
+        requestFullMetadata: requestFullMetadata,
+      ),
     );
   }
 

packages/image_picker/image_picker/pubspec.yaml

@@ -3,7 +3,7 @@ description: Flutter plugin for selecting images from the Android and iOS image
   library, and taking new pictures with the camera.
 repository: https://github.com/flutter/plugins/tree/main/packages/image_picker/image_picker
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+image_picker%22
-version: 0.8.5+2
+version: 0.8.6
 
 environment:
   sdk: ">=2.14.0 <3.0.0"

packages/image_picker/image_picker/test/image_picker_deprecated_test.dart

@@ -57,14 +57,16 @@ void main() {
                 'maxWidth': null,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 1,
                 'maxWidth': null,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
             ],
           );
@@ -103,49 +105,56 @@ void main() {
                 'maxWidth': null,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': null,
                 'maxHeight': 10.0,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': 20.0,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': null,
                 'imageQuality': 70,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': null,
                 'maxHeight': 10.0,
                 'imageQuality': 70,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': 20.0,
                 'imageQuality': 70,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
             ],
           );
@@ -182,6 +191,7 @@ void main() {
                 'maxHeight': null,
                 'imageQuality': null,
                 'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
             ],
           );
@@ -201,6 +211,7 @@ void main() {
                 'maxHeight': null,
                 'imageQuality': null,
                 'cameraDevice': 1,
+                'requestFullMetadata': true,
               }),
             ],
           );

packages/image_picker/image_picker/test/image_picker_test.dart

@@ -52,14 +52,16 @@ void main() {
                 'maxWidth': null,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 1,
                 'maxWidth': null,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
             ],
           );
@@ -98,49 +100,56 @@ void main() {
                 'maxWidth': null,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': null,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': null,
                 'maxHeight': 10.0,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': 20.0,
                 'imageQuality': null,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': null,
                 'imageQuality': 70,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': null,
                 'maxHeight': 10.0,
                 'imageQuality': 70,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
               isMethodCall('pickImage', arguments: <String, dynamic>{
                 'source': 0,
                 'maxWidth': 10.0,
                 'maxHeight': 20.0,
                 'imageQuality': 70,
-                'cameraDevice': 0
+                'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
             ],
           );
@@ -177,6 +186,7 @@ void main() {
                 'maxHeight': null,
                 'imageQuality': null,
                 'cameraDevice': 0,
+                'requestFullMetadata': true,
               }),
             ],
           );
@@ -196,6 +206,26 @@ void main() {
                 'maxHeight': null,
                 'imageQuality': null,
                 'cameraDevice': 1,
+                'requestFullMetadata': true,
+              }),
+            ],
+          );
+        });
+
+        test('passes the full metadata argument correctly', () async {
+          await picker.pickImage(
+              source: ImageSource.camera, requestFullMetadata: false);
+
+          expect(
+            log,
+            <Matcher>[
+              isMethodCall('pickImage', arguments: <String, dynamic>{
+                'source': 0,
+                'maxWidth': null,
+                'maxHeight': null,
+                'imageQuality': null,
+                'cameraDevice': 0,
+                'requestFullMetadata': false,
               }),
             ],
           );

packages/image_picker/image_picker_ios/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.8.6
+
+* Adds `requestFullMetadata` option to `pickImage`, so images on iOS can be picked without `Photo Library Usage` permission.
+
 ## 0.8.5+2
 
 * Minor fixes for new analysis options.

packages/image_picker/image_picker_ios/example/ios/RunnerTests/ImagePickerPluginTests.m

@@ -54,6 +54,7 @@ - (void)testPluginPickImageDeviceBack {
                                                             camera:FLTSourceCameraRear]
                       maxSize:[[FLTMaxSize alloc] init]
                       quality:nil
+                 fullMetadata:@(YES)
                    completion:^(NSString *_Nullable result, FlutterError *_Nullable error){
                    }];
 
@@ -86,6 +87,7 @@ - (void)testPluginPickImageDeviceFront {
                                                             camera:FLTSourceCameraFront]
                       maxSize:[[FLTMaxSize alloc] init]
                       quality:nil
+                 fullMetadata:@(YES)
                    completion:^(NSString *_Nullable result, FlutterError *_Nullable error){
                    }];
 
@@ -177,6 +179,27 @@ - (void)testPickMultiImageShouldUseUIImagePickerControllerOnPreiOS14 {
             [mockUIImagePicker setSourceType:UIImagePickerControllerSourceTypePhotoLibrary]);
 }
 
+- (void)testPickImageWithoutFullMetadataPreiOS14 {
+  if (@available(iOS 14, *)) {
+    return;
+  }
+  id mockUIImagePicker = OCMClassMock([UIImagePickerController class]);
+  FLTImagePickerPlugin *plugin = [FLTImagePickerPlugin new];
+  [plugin setImagePickerControllerOverrides:@[ mockUIImagePicker ]];
+  FlutterMethodCall *call = [FlutterMethodCall methodCallWithMethodName:@"pickImage"
+                                                              arguments:@{
+                                                                @"source" : @(1),
+                                                                @"requestFullMetadata" : @(NO),
+                                                              }];
+
+  [plugin handleMethodCall:call
+                    result:^(id _Nullable r){
+                    }];
+
+  OCMVerify(times(1),
+            [mockUIImagePicker setSourceType:UIImagePickerControllerSourceTypePhotoLibrary]);
+}
+
 #pragma mark - Test camera devices, no op on simulators
 
 - (void)testPluginPickImageDeviceCancelClickMultipleTimes {
@@ -191,6 +214,7 @@ - (void)testPluginPickImageDeviceCancelClickMultipleTimes {
                                                             camera:FLTSourceCameraRear]
                       maxSize:[[FLTMaxSize alloc] init]
                       quality:nil
+                 fullMetadata:@(YES)
                    completion:^(NSString *_Nullable result, FlutterError *_Nullable error){
                    }];