file_picker

Desktop (macOS)

Fixes the issue of picking filenames that contain a comma followed by a space (#890).

iOS

Improves error handling when device can't fetch files due to low storage space (#885).

iOS

Fixed an issue that was creating a crash when media in PHPickerViewController in iOs was tapped several times very fast, we check that _result is not empty to avoid the crash. No Github issue created.

Android

Removes <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> permission from the platform implementation Manifest since may not be required for some applications and devs can manually add it to their own application if needed (#864).

Android

Reverts Android READ_EXTERNAL_STORAGE permission removal.

Android

Fixes an issue where onFileLoading would be called while picking directories (#863).

Adds the identifier property to the PlatformFile which references the original file identifier for both iOS & Android (#804).

Desktop (macOS)

Fixes the issue that users could not pick .app files on macOS because FilePicker tried to determine the file size of .app files. On macOS, these special kind of files are actually Unix directories in a special format (read more on StackExchange). Now, if a file is picked, which is actually a directory, then the file size will be zero. (#856)

Web

• Fixes an issue that would prevent the call to return when both withReadStream and allowMultiple were set. (#843).
• Addresses an issue in the example app.

Android

Addresses an issue where multiple media files couldn't be picked in some 3rd party explorers (#846). Thank you @innim98.

iOS

Fixes an issue where Live Photos were being picked as .pvt packages (since iOS 15). From now on, if allowCompression is set to true, Live Photos will automatically be converted to static JPEG pictures. (#835)

Desktop (Linux)

Fixes the issue that on Linux the file type filter FileType.any did not allow the selection of files without file extension. (#836)

iOS

Fixes an issue that would result in picker being dismissed by pulling down the modal sheet without an event. (#828)

Web

Addresses an issue when comparing files on Web would result in an error due to path not being accessible. (#822)

Extends API by new function saveFiles() for opening a save-file dialog as requested in #799. This feature is only supported on desktop platforms (Linux, macOS, and Windows).

Makes the path getter nullable to match with its property (#823).

Desktop (Windows)

Fixes custom extension filter. Thank you @jgoyvaerts.

General

Overrides equality and toString for platform_file and file_picker_result for better comparison different results. Thank you @Nolence.

iOS

• Changes the presentation type of the picker from UIModalPresentationCurrentContext to UIModalPresentationAutomatic (#813).

Web

• Fixes regression of #746.
• Updates exception text when trying to access path on Web. Thank you @maxzod.

Desktop support added for all platforms (MacOS, Linux & Windows) (#271)

From now on, you'll be able to use file_picker with all your platforms, a big thanks to @philenius, which made this possible and allowed the flutter_file_picker_desktop to be merged with this one.

Have in mind that because of platforms differences, that the following API methods aren't available to use on Desktop:

• The onFileLoading() isn't necessary, hence, FilePickerStatus won't change, since it hasn't any effect on those;
• clearTemporaryFiles() isn't necessary since those files aren't created - the platforms will always use a reference to the original file;
• There is a new optional parameter dialogTitle which can be used to set the title of the modal dialog when picking the files;

Web

Adds onFileLoading() to Web. (#766).

Android

• Addresses an issue where an invalid custom file extension wouldn't throw an error when it should. Thank you @Jahn08.
• Fixes getDirectoryPath() #745. Thank you @tomm1e.

Web

• Removes analysis_options.yaml from the plugin and fixes the Don't import implementation files from another package warning (#746).

Android

• Addresses an issue where bytes might be missing after first picking when withData is set to true. (#616).

Desktop (GO)

• Patches README import path. (Thank you @voynichteru)

General

• name and size properties are now non-nullable types.

Docs

• Updates README;
• Updates API docs;

Example

• Updates Android example app to V2;

Android

• Removes deprecated call warnings;

Other

• Adds analysis_options.yaml with linter rule to surpress warnings from generated_plugin_registrant.

• Fixes #725.

Android

• Use MediaStore Opener (which goes through the gallery) instead of default explorer. (Thank you @tmthecoder).

Web

• Add event when canceling the picker. (Thank you @letranloc).

Other

• Updates example app to null safety.

Adds null safety support (#510).

iOS

• Fixes an issue where a crash could happen when picking a lot of media files in low memory devices (#606).
• Updates preferredAssetRepresentationMode. Thank you @nrikiji.

• Addresses an issue on iOS 14 and later where events onFileLoading events weren't being provided (#577).

iOS & Android: Updates size property from PlatformFile to be in bytes instead of kb.

• Web: Updates size property from PlatformFile to be in bytes instead of kb;
• Applies minor refactor to example app. Thank you @Abhishek01039;

iOS: Fixes iOS ViewController which is nil when UIWindow.rootViewController have changed. (#525). Thank you @devcxm.

Android: Updates file name handling method. (#487)

Desktop (Go): Fixed desktop plugin implementation. Thank you @DenchikBY. (#382)

iOS: Fixes an issue that could result in a crash when selecting a media item twice. (#518)

Adds withReadStream that allows bigger files to be streamed read into a Stream<List<int>>. Thanks @redsolver.

Updates extension helper getter to use the name property instead of path, since the latest isn't available on the Web, hence, the extension wouldn't be as well. Thank you @markgrancapal.

Android:

• Fixes an issue that could result in some files not being properly retrieved due to special characters on their names. (#472)
• Fixes a NPE that could happen with some devices. (#482)

iOS: Fixes FileType.audio exports to support ipod-library content (non DRM protected). From now on, a cached asset (m4a) will be exported from the selected music file in the Music app, so it can later be used. Fixes (#441).

Adds missing extension to name property of PlatformFile. (#444)

Android: Updates package visibility to fully support Android 11 (SDK 30 and later). (#440)

Note: If you have build issues from now on because <queries> aren't recognized, you'll need to update your build.gradle to use one of the following patched versions.

Minor fix on CHANGELOG regarding version 2.0.9.

Fixes an issue on iOS 14, where canceling with swipe gestures, could result in cancel event not being dispatched. (#431).

• iOS: Updates media picker to launch in app context (instead of modal).
• Minor update to README file.

Fixes #425 and updates iOS to use NSDocumentDirectory on iOS 12 or lower. Thanks @allanwolski.

iOS: Fixes iOS 14 media picker (image & video) (#405, #407).

Android: Fixes #402.

Desktop (Go): Fixes directory pick on Linux.

Android: Fixes out of memory issue on some devices when picking big files.

Web: Adds mobile Safari support and other minor improvements. iOS: Adds conditional import for backwards compatibility with Xcode 11.

iOS: Fixes conditional import for backwards compatibility with Xcode 11.

Fixes multi-pick example on README.

iOS: Updates picker to use new PHPickerController for both single and multi media (image/video) picks (iOS 14 and above only).

Fixes README screenshots.

iOS: Addresses an issue that could prevent users from viewing picked media elements (pictures/videos) from gallery on iOS 14.