chore(update-plugins): Thu Jan 30 08:05:08 UTC 2025

Author: nativescript-oss

content/plugins/imagepicker.md

@@ -68,6 +68,8 @@ Add the following permissions to the `App_Resources/Android/src/main/AndroidMani
 
 - **targetSdkVersion >=33(Android 13+)**
 
+These are only required when not setting `android.use_photo_picker = true`.
+
 ```xml
 <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
 
@@ -76,6 +78,27 @@ Add the following permissions to the `App_Resources/Android/src/main/AndroidMani
 
 See the complete example [here](https://github.com/NativeScript/plugins/blob/main/tools/assets/App_Resources/Android/src/main/AndroidManifest.xml#L14).
 
+### Android Photo picker
+
+For phones running android 13+ specifying the option `android.use_photo_picker = true` when creating the `ImagePicker` will result in the use of the System Photo Picker.
+
+<!-- tabs: TS -->
+
+```ts
+let imagePickerObj: ImagePicker = imagePickerPlugin.create({
+  mode: 'single',
+  android: { use_photo_picker: true },
+})
+```
+
+This means you can remove the `READ_MEDIA_IMAGES, READ_MEDIA_VIDEO` permissions and do not have to prompt the user for permission.
+
+Full details [here](https://developer.android.com/training/data-storage/shared/photopicker).
+
+You can also now limit the number of images that are selectable in the Photo Picker by specifying the `maximumNumberOfSelection` option.
+
+For phones running < Android 13, this `use_photo_picker` option has no effect.
+
 ### iOS required permissions
 
 Using the plugin on iOS requires the `NSPhotoLibraryUsageDescription` permission. Modify the `app/App_Resources/iOS/Info.plist` file to add it as follows:
@@ -189,7 +212,7 @@ An object passed to the `create` method to specify the characteristics of a medi
 | :---------------------------- | :-------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `mode`                        | `string`                                      | `multiple`                                                                                                              | The mode of the imagepicker. Possible values are `single` for single selection and `multiple` for multiple selection.                                                          |
 | `minimumNumberOfSelection`    | `number`                                      | `0`                                                                                                                     | _Optional_: (`iOS-only`) The minumum number of selected assets.                                                                                                                |
-| `maximumNumberOfSelection`    | `number`                                      | `0`                                                                                                                     | _Optional_: (`iOS-only`) The maximum number of selected assets.                                                                                                                |
+| `maximumNumberOfSelection`    | `number`                                      | `0`                                                                                                                     | _Optional_: (`iOS-only`, `Android-Photo Picker-Only`) The maximum number of selected assets.                                                                                   |
 | `showsNumberOfSelectedAssets` | `boolean`                                     | `true`                                                                                                                  | _Optional_: (`iOS-only`) Display the number of selected assets.                                                                                                                |
 | `prompt`                      | `string`                                      | `undefined`                                                                                                             | _Optional_: (`iOS-only`) Display prompt text when selecting assets.                                                                                                            |
 | `numberOfColumnsInPortrait`   | `number`                                      | `4`                                                                                                                     | _Optional_: (`iOS-only`) Sets the number of columns in Portrait orientation                                                                                                    |