utopia_save_file

Description:

utopia save file

utopia_save_file #
Unified and correct implementation of file saving.
General behavior #

Try to infer the MIME type and filename, if not already provided (inference not supported in fromBytes
and fromByteStream). Fail with SaveFileMetadataException if not possible.
Check if filename has an extension matching the MIME type; if not, act according to the extensionBehavior
parameter (by default, replacing the original extension).
Trigger the save. Wait until completion and provide the result if possible. Meanwhile, try to offload as
much of the actual work from the Dart thread as possible.

See fromX methods' documentation for more details.
Platform-specific considerations #
Android #
On Android, launches system "files" app and allows user to select the destination and filename.
User can cancel the operation, in such case the fromX methods will complete with SaveFileResultCancelled.
Uses Intent.ACTION_CREATE_DOCUMENT
and ContentResolver.openInputStream
under the hood.
No WRITE_EXTERNAL_STORAGE permission
needed.
name parameter is only a suggestion, user can change it during saving.
iOS #
On iOS, saves to application documents directory, but files will be visible in system "Files" app (due to
the UIFileSharingEnabled property)
Does not require any user interaction, so fromX methods will always return true.
Configuration
Add to Info.plist:
<key>NSAllowsArbitraryLoads</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>
<key>UIFileSharingEnabled</key>
<true/>
copied to clipboard
Web #
On Web uses a fake a element with the download
attribute to trigger the download, which then happens completely outside the app.
This causes the fromX methods to complete immediately with true (even if users later cancels the
download).