NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #320 most downloaded on pub.dev
Darwin (iOS and macOS) implementation of the file_picker plugin, supporting native file picking, saving, and directory selection.
Latest stable
2.5.2
Last release today
21 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 25 of 25 stable releases
Nothing withdrawn
no release was ever pulled
3 months old
25 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
android_file_picker logs every failure that getDirectoryPath turns into null ( #2361 ).
android_file_picker logs every failure that getDirectoryPath turns into null (#2361).
saveFile() on iOS leaving its temporary export file behind after a save, a cancel or a failure. It is now deleted when the request ends, since the destination holds its own copy. #2356Release file_picker 13.3.3 with the latest platform fixes
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
clearTemporaryFiles() on iOS deleting everything in the app's temporary directory, including the files of the app and of other plugins. It now only removes the plugin's own flutter_file_picker folder. Copies made by earlier versions sit outside it, so they are left for iOS to clean up. #2322onFileLoading updates when another pick ended first, such as one from a second macOS window. It now also gets done when a pick is cancelled or fails. #2321lengthSync() returning null for an empty file, and length() reading it again to find its size. A size that cannot be read is now left out instead of reported as 0. #2313Added the FlutterFramework dependency to Package.swift, which Swift Package Manager builds warn about and future Flutter versions will require. It was
FlutterFramework dependency to Package.swift, which Swift Package Manager builds warn about and future Flutter versions will require. It was lost when the Darwin code moved into this package. #2308FlutterFramework to plugins.Fixed onFileSaving staying on picking when saving fails, and an error of the status stream escaping as an uncaught error.
onFileSaving staying on picking when saving fails, and an error of the status stream escaping as an uncaught error.Fixed iOS pickers getting stuck in multiple_request when the picker is swiped away while still appearing. #2291
multiple_request when the picker is swiped away while still appearing. #2291On macOS, FilePickerDarwin(viewId:) attaches the pickers to that Flutter view's window, and fails with window_not_found when that window is closed or
FilePickerDarwin(viewId:) attaches the pickers to that Flutter view's window, and fails with window_not_found when that window is closed or hidden.On macOS, the pickers now open in the window the user is in, and still open when no window is visible instead of completing with null. #2277
null. #2277The load_failed error on iOS now lists in its details why each picked item could not be loaded. #2274
load_failed error on iOS now lists in its details why each picked item could not be loaded. #2274Fixed picking a Live Photo on iOS copying its paired video too and leaving it in the temporary directory. Only the still image is loaded now. #2260
.rtfd, returning an image from inside it. #2259Fixed a pick on iOS where none of the picked items could be loaded completing with an empty list, as if the user had cancelled. It now throws a Platfo
PlatformException with the load_failed code. #2248Added DarwinPlatformFile.assetIdentifier for media picked from the iOS photo library, and support for DarwinOptions(copyMedia: false) to skip the copy
DarwinPlatformFile.assetIdentifier for media picked from the iOS photo library, and support for DarwinOptions(copyMedia: false) to skip the copy. #2245Merge pull request #2242 from vicajilau/feat/darwin-ordered-selection…
Merge pull request #2242 from vicajilau/feat/darwin-ordered-selection…
DarwinOptions.orderedSelection. Setting it to false restores swipe to select in the iOS photo library picker, which ordered selection disables. #2241Merge pull request #2244 from vicajilau/fix/ios-partial-swipe-cancels…
Merge pull request #2244 from vicajilau/fix/ios-partial-swipe-cancels…
iOS: Fixes iOS ViewController which is nil when UIWindow.rootViewController have changed. (#525). Thank you @devcxm.
Fixed saveFile() on macOS appending a second, lowercased extension to file names with a custom extension, such as j.nme2mbAllpreset. #2238
saveFile() on macOS appending a second, lowercased extension to file names with a custom extension, such as j.nme2mbAllpreset. #2238The dbus dependency was raised to ^0.8.0 in the previous commit but the package itself was never versioned, so it never got its own changelog entry or
The dbus dependency was raised to ^0.8.0 in the previous commit but the package itself was never versioned, so it never got its own changelog entry or publishable version.
initialDirectory having no effect on macOS and iOS for pickFile(), pickFiles(), and getDirectoryPath(). #2216Desktop (Go): Fixed desktop plugin implementation. Thank you @DenchikBY. (#382)
Merge branch 'main' of https://github.com/vicajilau/flutter_file_picker
Merge branch 'main' of https://github.com/vicajilau/flutter_file_picker
copyToTemporaryDirectory derived its destination from the source's file name alone, which is not unique — photos edited in the Photos app are exported under a fixed name, and Live Photos arrive as .pvt packages. Those copies run concurrently, so colliding names raced: one item would remove the file another was still copying, both copyItem calls then threw and both items were dropped by the compactMap over the resolved results. When every item lost the race the picker called back with nil, reaching Dart as an empty list — indistinguishable from the user cancelling. Each item is now copied into its own freshly created subdirectory.iOS: Fixes an issue that could result in a crash when selecting a media item twice. (#518)
The CHANGELOG already listed a 13.1.0 entry for the UIScene support added in #2214 , but the package version was left at 13.0.0, which was already pub
The CHANGELOG already listed a 13.1.0 entry for the UIScene support added in #2214, but the package version was left at 13.0.0, which was already published.
Adds withReadStream that allows bigger files to be streamed read into a Stream<List<int>>. Thanks @redsolver.
BREAKING CHANGE: PlatformFile.length() now returns Future instead of Future . Returns null when the length could not be determined (e.g. a failed disk…
PlatformFile.length() now returns Future<int?> instead of Future<int>. Returns null when the length could not be determined (e.g. a failed disk read), instead of 0, matching lengthSync(). #2197withData on iOS, dead since the Dart facade stopped forwarding it (file_picker 12.0.0). Picked files are no longer eagerly read into memory on the platform side; PlatformFile.readAsBytes() already reads lazily on demand. #2202Breaking Changes
FilePicker.platform.pickFiles() and extract the files from FilePickerResult;File instances from dart:io and dart:html required stubbing and bloated code, it's no longer available as helper method so you'll have to instanciate a File with the picked paths;New features
FilePicker.platform.pickFiles() with desired parameters which will return a FilePickerResult with a List<PlatformFile> containing the picked data;FilePickerResult and PlatformFile classes with helper getters;withData that allows file data to be immediately available on memory as Uint8List (part of PlatformFile instance). This is particularly helpful on web or if you are going to upload to somehwere else;Removed
getFilePath(), getMultiFilePath(), getFile() and getMultiFile() are no longer availble in favor o pickFiles();Each platform package (android_file_picker, file_picker_darwin, file_picker_linux, windows_file_picker, file_picker_web) had no banner at all. Added o
Each platform package (android_file_picker, file_picker_darwin,
file_picker_linux, windows_file_picker, file_picker_web) had no banner at
all. Added one for each, reusing the root banner's style (gradient, floating
file cards, title) with a platform specific subtitle, a single platform pill
instead of the six way row, and a translucent watermark icon.
The Android, Apple, Tux and Chrome watermarks are traced from the official
marks rather than approximated by hand:
Windows uses a generic four pane grid instead of the Microsoft flag.
DarwinOptions.acceptLabel, letting callers set the confirm button text (NSOpenPanel.prompt) on macOS for pickFile()/pickFiles(). Has no effect on iOS, UIDocumentPickerViewController has no equivalent there. #1861Breaking change: Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires any Android apps using this plugin to also migrate if they're using the original support library.
melos list returns packages alphabetically, so prepare would tag android_file_picker before the platform interface it depends on. Each tag starts its
melos list returns packages alphabetically, so prepare would tag
android_file_picker before the platform interface it depends on. Each
tag starts its own independent publish run, so that package would reach
pub.dev asking for an interface version that is not published yet.
melos publish sorts by the dependency graph internally, which is why
the dry run always looked right, but the tagging never did. It now takes
the order from melos list --graph and only tags a package once
everything it depends on has been tagged.
On the release this repository is about to cut, that turns
android_file_picker, file_picker, file_picker_darwin, file_picker_linux,
file_picker_platform_interface, file_picker_web, windows_file_picker
into
file_picker_platform_interface, android_file_picker, file_picker_darwin,
file_picker_linux, windows_file_picker, file_picker_web, file_picker
which is the order melos publishes in.
PlatformFile.lengthSync(), returning the length iOS/macOS already reports for a picked file synchronously, without doing any I/O.Breaking changes
FileType.PDF was removed since now it can be used along with custom file types by using the FileType.CUSTOM and providing the file extension (e.g. PDF, SVG, ZIP, etc.).FileType.CAPTURE is now FileType.CAMERANew features
FileType.CUSTOMBug fixes and updates
file_pickerMerge pull request #2182 from miguelpruivo/docs/darwin-asset-represen…
Merge pull request #2182 from miguelpruivo/docs/darwin-asset-represen…
skipEntitlementsChecks() now overrides the new FilePickerPlatform.skipEntitlementsChecks() hook instead of being called through a type test on FilePickerPlatform.instance. No behavior change on iOS or macOS.DarwinOptions.assetRepresentationMode support on iOS, mapped to PHPickerConfiguration.preferredAssetRepresentationMode. Requesting current or compatible lets large HEVC, HDR, or slow-motion videos skip the transcoding automatic (the default) would otherwise require. Non-automatic modes require compressionQuality to be 0.Merge pull request #2172 from miguelpruivo/fix/publish-workflow-pat-a…
Merge pull request #2172 from miguelpruivo/fix/publish-workflow-pat-a…
PrivacyInfo.xcprivacy was never being bundled by Swift Package Manager, because SwiftPM resolves resource paths relative to the target's own directory. #2175Merge pull request #2168 from miguelpruivo/fix/publish-workflow-oidc-…
Merge pull request #2168 from miguelpruivo/fix/publish-workflow-oidc-…
FileSystemException/OSError: Is a directory) when picking a Live Photo from the iOS gallery. Live Photos are saved by iOS as .pvt packages (directories), which loadFileRepresentation(forTypeIdentifier: UTType.item...) returned as-is; the still image contained in the package is now extracted instead.getDirectoryPath, pickFiles, pickFileAndDirectoryPaths, and saveFile on macOS defaulting to the sandbox container's Data folder instead of the user's real home directory when no initialDirectory is provided and the app has App Sandbox enabled.NSSavePanel.isExtensionHidden..app, .fcpbundle) not being selectable as files on macOS file pickers, a regression since 8.2.0. NSOpenPanel.treatsFilePackagesAsDirectories is now explicitly set to false so these are presented as selectable files, matching Finder and other native apps.saveFile on macOS never enforcing an extension on the destination file when the user cleared it from the suggested name. allowedExtensions is not forwarded to saveFile yet, so the dialog now falls back to the extension of the suggested file name.saveFile returning a scheme-less, percent-encoded Uri on macOS instead of a proper file:// Uri, unlike Windows and Linux.FilePickerDarwin.skipEntitlementsChecks(), letting non-sandboxed macOS apps opt out of the App Sandbox entitlement checks performed before showing a dialog. This was previously only reachable through a deprecated, no-op method on FilePicker in the root package.pickFiles, pickFileAndDirectoryPaths, getDirectoryPath, or saveFile. The entitlement check now runs on a background queue before the dialog is created, instead of blocking the main thread synchronously.Fixed pickFileAndDirectoryPaths never returning directories on iOS and macOS. It now calls the native combined file and directory picker instead of si
pickFileAndDirectoryPaths never returning directories on iOS and macOS. It now calls the native combined file and directory picker instead of silently falling back to file only selection.MissingPluginException on macOS by registering the event channel stream handler.any, image, video, audio, media, custom, dir, save).saveFile on macOS not writing the provided file bytes to the chosen location.UTType file type filtering for macOS file dialogs.Initial release of iOS and macOS implementation package for file_picker.
file_picker.