file_picker_web

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).

• Implemented PlatformFile.lengthSync(), returning the browser's File.size (or the loaded bytes' length) synchronously, without doing any I/O.

• Tightened the file_picker_platform_interface lower bound to ^3.2.0. This package's pickFile()/pickFiles() signatures reference DarwinOptions, added in that version, so resolving against an older one would fail to compile.

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)

• Fixed the window focus listener used to detect a cancelled picker dialog never being removed after use. removeEventListener was passed a freshly created .toJS function object on every call, which never matches the one originally passed to addEventListener, so the listener leaked on window on every pickFiles/pickFile call. The JS function references are now cached and reused for both add and remove.

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.

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).

Breaking Changes

• Unifies all platforms (IO, Web and Desktop) in a single plugin (file_picker) that can be used seamlessly across all. Both file_picker_interface and file_picker_web are no longer mantained from now on.
• You'll now have to use FilePicker.platform.pickFiles() and extract the files from FilePickerResult;
• Because platforms are unified and mixing 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

• Simplified usage, now you only need to use FilePicker.platform.pickFiles() with desired parameters which will return a FilePickerResult with a List<PlatformFile> containing the picked data;
• Added classes FilePickerResult and PlatformFile classes with helper getters;
• On Android all picked files are scoped cached which should result in most of files being available. Caching process is only made once, so once done, the picked instance should be the same;
• On iOS picking audio now supports multiple and cloud picks;
• Added parameter 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;
• Major refactor with some clean-up and improvements;

Removed

• Single methods such as getFilePath(), getMultiFilePath(), getFile() and getMultiFile() are no longer availble in favor o pickFiles();

• Minor update of README file.

• Adds comments for public API

• Version 1.0 release.
• Adds support for ANY and VIDEO files.
• Fixes an issue where permissions were recursively asked on Android.
• Fixes an issue where some paths from document files couldn't be loaded with Android 8.0.
• Updates README file to match changes.
• General refactor & cleanup.