Full changelog available at: https://github.com/yasirkula/UnityNativeGallery/commits/master

= May 18, 2025 (v1.9.1) =

- Fixed SaveImageToGallery not always truncating the overwritten file (see https://github.com/yasirkula/UnityNativeFilePicker/issues/61)

= Apr 7, 2025 (v1.9.0) =

- BREAKING CHANGE: CheckPermission returns bool instead of Permission (see https://github.com/yasirkula/UnityAndroidRuntimePermissions/issues/14)

- BREAKING CHANGE: Replaced RequestPermission with RequestPermissionAsync (see https://github.com/yasirkula/UnityNativeGallery/discussions/343)

- BREAKING CHANGE: Removed CanOpenSettings since it's now always true

- Updated Unity version to 2021.3.41f1 (simplified codebase accordingly)

- iOS frameworks are now added properly instead of changing OTHER_LDFLAGS

- Fixed Xcode compiler warnings

= Aug 16, 2024 (v1.8.1) =

- On Android 33+, it's now possible to preserve access to the picked images after the app is restarted but it isn't recommended (see the relevant FAQ entry: https://github.com/yasirkula/UnityNativeGallery?tab=readme-ov-file#faq)

= Mar 9, 2024 (v1.8.0) =

- Fixed rare "No such proxy method" error for native callback functions

= Jan 18, 2024 (v1.7.9) =

- Fixed RequestPermissionAsync not working on iOS

= Dec 9, 2023 (v1.7.8) =

- Fixed permission not being asked in an edge case on Android (it's strongly recommended to use RequestPermissionAsync)

- Fixed build error if PhotosUI framework was added explicitly on iOS

= Nov 15, 2023 (v1.7.7) =

- Fixed crash when using LoadImageAtPathAsync on newer Unity versions

- Potential fix for IllegalStateException on Android

= Oct 28, 2023 (v1.7.6) =

- Removed the new READ_MEDIA permissions: https://support.google.com/googleplay/android-developer/answer/13986130

- Photo Library Usage Description doesn't override Xcode setting if it's empty

= Jul 13, 2023 (v1.7.4) =

- Added async variants of RequestPermission function that don't freeze the app unnecessarily

= Jul 12, 2023 (v1.7.3) =

- No permission will be asked on Android 14+ devices because partial media access permissions are confusing for the end-user

= Mar 24, 2023 (v1.7.2) =

- Bugfix for LoadImageAtPathAsync and GetVideoThumbnailAsync

= Dec 10, 2022 (v1.7.1) =

- Fixed Denied permission issue on Android 13 and later

- Potential fix for saved images not appearing in Gallery immediately on some Android devices

= Sep 23, 2022 (v1.7.0) =

- Added asynchronous LoadImageAtPathAsync and GetVideoThumbnailAsync functions (requires 2018.4 or later)

= Jan 15, 2022 =

- Fixed crashes on at least some Android devices while picking files

= Oct 29, 2021 =

- Fixed "null" path issue on Android 11 MIUI devices

- When a large image/video is picked and it needs to be copied to the app's cache directory, a progressbar will be displayed instead of freezing the screen until the copy operation is completed

= Sep 21, 2021 =

- Fixed GetVideoProperties returning wrong 'rotation' in some languages

= Jul 5, 2021 =

- Moved iOS build post-processor settings to 'Project Settings/yasirkula/Native Gallery'

= Apr 13, 2021 =

- Embedded proguard.txt file to AAR library which should get rid of ClassNotFoundExceptions automatically

= Jan 19, 2021 =

- Updated FAQ

= Jan 6, 2021 =

- Added android:requestLegacyExternalStorage="true" to AndroidManifest to fix the mysterious UnauthorizedAccessException on Android 10

- Bugfix for a very rare crash on iOS

= Dec 9, 2020 =

- Fixed iOS Project Builder build errors

- Added Editor support for GetImageFromGallery, GetVideoFromGallery, GetAudioFromGallery and GetMixedMediaFromGallery (a file dialog will show up)

= Oct 6, 2020 =

- Added iOS 14 support. However, due to the new "Selected Photos" permission, saving images/videos to a custom album is no longer supported on iOS 14+. Images/videos will simply be saved to the default Photos album instead

- Added support for picking multiple images/videos on iOS 14+

- On iOS 11+, no permission dialog will be shown when picking images/videos from Photos

- On Android 29+, no permission dialog will be shown when saving images/videos to Gallery

- Saving images/videos was sometimes failing on Android 29+ after saving 32 images/videos; fixed

Special thanks to Maryam Saeed for helping me with this update!

= Aug 12, 2020 =

- Added GetMediaTypeOfFile function that returns the media type of a file: Image, Video, Audio or neither of these (if media type can't be determined). Can be useful for GetMixedMediaFromGallery

= Aug 9, 2020 =

- Added GetMixedMediaFromGallery function to pick images/videos/audios at the same time

- Added GetAudioFromGallery function to pick audio files (works on Android only)

- MediaSaveCallback now returns the filepath of the saved image/video on Android (see the documentation)

- Potential bugfix for rare UnauthorizedAccessExceptions

= Jul 10, 2020 =

- Added NativeGallery.GetVideoThumbnail function

= Apr 9, 2020 =

- NativeGallery tries to preserve the file extension while picking multiple images on Android

- GetImageFromGallery now uses UIImagePickerControllerImageURL to copy the original image on iOS 11 and later

= Mar 03, 2020 =

- Fixed GetVideoFromGallery issue on iOS 13 when using an old version of Xcode

- (iOS) MINIMUM_TARGET_8_OR_ABOVE is now always true for Unity 2018.1 and later

= Jan 14, 2020 =

- Fixed a crash when picking images/videos on iOS13+

- Fixed a rare NullPointerException on Android

= Dec 22, 2019 =

- Fixed picked image file not having an extension on iOS 13

= Nov 10, 2019 =

- Fixed saved images sometimes having wrong orientation on Samsung devices

- A few bugfixes

= Oct 15, 2019 =

- Fixed LoadImageAtPath sometimes not loading GIF and HEIC images correctly

- Added preferGetContent to native Android code to prefer ACTION_GET_CONTENT over ACTION_PICK when picking media (its value must be set to true via AndroidJavaClass)

= Oct 10, 2019 =

IMPORTANT: don't use "{0}" in filenameFormatted anymore, NativeGallery will now always ensure a unique filename.

- When picking images on iOS, NativeGallery attempts to copy the original image instead of encoding the picked image as PNG. This way, it is possible to pick e.g. GIF images and preserve the image's EXIF metadata

- Fixed issue with picking videos on iOS 13+

- Fixed scoped storage issues on Android 10

- Fixed iOS build error on Unity 2019.3

- Popup on iPads should now be centered properly most of the time

- Videos picked from Photos are now processed faster on iOS 11+

- SaveImageToGallery/SaveVideoToGallery are no longer emulated on Editor (a file is not saved), a message is logged to the console instead

- Added experimental Audio functions to NativeGallery. They may work on only Android and are not officially supported. You need to change their visibility from private to public in order to use them

= Jul 20, 2019 =

- Bugfix for freeze when requesting permissions on Android (Unity 2019)

= Feb 24, 2019 =

- Bugfix for SaveImageToGallery not working for non-readable textures on some Unity versions

= Jan 31, 2019 =

- Fixed main thread error on Development builds

= Jan 2, 2019 =

- Possible bugfix for app freezing indefinitely

- Now only READ_EXTERNAL_STORAGE permission is needed to fetch media from Gallery on Android

- Photos app now shows the album name correctly

- Added support for saving non-readable textures to the Gallery

Native Gallery for Android & iOS