NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #457 most downloaded on pub.dev
Flutter plugin for Firebase Cloud Storage, a powerful, simple, and cost-effective object storage service for Android and iOS.
Last release 17 days ago
14 Sep 2026
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
226 releases · first in 2017
Update a dependency to the latest release.
Packages with breaking changes:
Tasks.call() API from android. (#8421). (461bba5a)Packages with breaking changes:
Packages with other changes:
cloud_firestore_odm - v1.0.0-dev.13cloud_firestore_odm_generator - v1.0.0-dev.13firebase_analytics - v9.1.6firebase_auth - v3.3.15firebase_core - v1.15.0firebase_dynamic_links - v4.2.0firebase_dynamic_links_platform_interface - v0.2.3firebase_messaging_platform_interface - v3.3.0flutterfire_ui - v0.4.0+3firebase_crashlytics - v2.6.3firebase_in_app_messaging_platform_interface - v0.2.1+4firebase_in_app_messaging - v0.6.0+12firebase_crashlytics_platform_interface - v3.2.4firebase_remote_config - v2.0.5firebase_remote_config_web - v1.0.10firebase_auth_web - v3.3.13firebase_database_web - v0.2.0+11firebase_auth_platform_interface - v6.2.4firebase_remote_config_platform_interface - v1.1.4firebase_database - v9.0.12firebase_database_platform_interface - v0.2.1+4cloud_firestore - v3.1.13cloud_firestore_platform_interface - v5.5.4cloud_firestore_web - v2.6.13firebase_app_installations_web - v0.1.0+11firebase_app_installations - v0.1.0+11firebase_analytics_platform_interface - v3.1.4firebase_analytics_web - v0.4.0+11firebase_app_installations_platform_interface - v0.1.1+4firebase_messaging - v11.2.14firebase_messaging_web - v2.2.12firebase_ml_model_downloader_platform_interface - v0.1.1+4firebase_ml_model_downloader - v0.1.0+11firebase_app_check_platform_interface - v0.0.4+4cloud_functions_web - v4.2.12firebase_app_check - v0.0.6+10cloud_functions_platform_interface - v5.1.4cloud_functions - v3.2.13firebase_app_check_web - v0.0.5+10firebase_storage_platform_interface - v4.1.4firebase_storage_web - v3.2.13firebase_storage - v10.2.13firebase_performance_platform_interface - v0.1.1+4firebase_performance_web - v0.1.0+10firebase_performance - v0.8.0+10Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_crashlytics - v2.6.3firebase_in_app_messaging_platform_interface - v0.2.1+4firebase_in_app_messaging - v0.6.0+12firebase_crashlytics_platform_interface - v3.2.4firebase_remote_config - v2.0.5firebase_remote_config_web - v1.0.10firebase_auth_web - v3.3.13firebase_database_web - v0.2.0+11firebase_auth_platform_interface - v6.2.4firebase_remote_config_platform_interface - v1.1.4firebase_database - v9.0.12firebase_database_platform_interface - v0.2.1+4cloud_firestore - v3.1.13cloud_firestore_platform_interface - v5.5.4cloud_firestore_web - v2.6.13firebase_app_installations_web - v0.1.0+11firebase_app_installations - v0.1.0+11firebase_analytics_platform_interface - v3.1.4firebase_analytics_web - v0.4.0+11firebase_app_installations_platform_interface - v0.1.1+4firebase_messaging - v11.2.14firebase_messaging_web - v2.2.12firebase_ml_model_downloader_platform_interface - v0.1.1+4firebase_ml_model_downloader - v0.1.0+11firebase_app_check_platform_interface - v0.0.4+4cloud_functions_web - v4.2.12firebase_app_check - v0.0.6+10cloud_functions_platform_interface - v5.1.4cloud_functions - v3.2.13firebase_app_check_web - v0.0.5+10firebase_storage_platform_interface - v4.1.4firebase_storage_web - v3.2.13firebase_storage - v10.2.13firebase_performance_platform_interface - v0.1.1+4firebase_performance_web - v0.1.0+10firebase_performance - v0.8.0+10One column per quarter.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: Fix UploadTask.cancel() so that it completes when called. (#8417).
UploadTask.cancel() so that it completes when called. (#8417). (19ee62c3)Update a dependency to the latest release.
FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184).
Update a dependency to the latest release.
FIX(database,apple): ensure platform channel is invoked on main thread (#11650).
Update a dependency to the latest release.
FIX: bump Android compileSdkVersion to 31 (#7726).
compileSdkVersion to 31 (#7726).Packages with breaking changes:
unnecessary_import analyzer issues introduced with Flutter 2.8.Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
flutterfire_ui - v0.2.0+2Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FEAT: update dependency constraints to sdk: '>=2.18.0 <4.0.0' flutter: '>=3.3.0' (#10946).
FEAT: bump dart sdk constraint to 2.18 (#10618).
FirebaseApp instances from Dart (#6549).Update a dependency to the latest release.
FIX: cache the result of event.snapshot to be able to compare the value (#9899).
TARGET_OS_OSX (#7116).FIX: remove https port number from downloadUrl for iOS (#7097).
downloadUrl for iOS (#7097).FIX: fix localhost url parsing for Storage Emulator (#7003).
REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711).
Update a dependency to the latest release.
FIX: reinstate deprecated emulator apis (#6626).
BREAKING FEAT: Firebase iOS SDK version: 10.0.0 (#9708).
Note: This release has breaking changes.
mappedHost instead of host (#6539).Bump platform interface a major version due to pigeon dependency update
Bump platform interface a major version due to pigeon dependency update
REFACTOR: move all packages to workspace (#18182). (6cdfcb10)
FIX: update core, auth and app-check logic so internal resources on method channels are properly disposed (#18268). (a0de4ed8)
FEAT(auth,android): add revokeAccessToken support for Android (#18206) (#18207). (7e0a2227)
Note: This release has breaking changes.
Update a dependency to the latest release.
FIX: refFromUrl parse url (#6353).
REFACTOR(core,android): migrate native implementation to Kotlin (#18570).
FEAT(appcheck): rCE provider api update (#18505).
useEmulator (#5936).FIX(firestore,android): clean up Android transaction listeners on completion (#18475).
FIX: secondary storage buckets now work as expected on Web (#5863).
DOCS(cloud_firestore): Remove Incorrect API Documentation (#18423).
FIX: improve refFromURL http regex (#5682).
Update a dependency to the latest release.
REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
List values would error on transaction result (#7001).Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.7.0cloud_firestore_platform_interface - v8.0.4cloud_firestore_web - v5.7.0cloud_functions_platform_interface - v6.0.4firebase_ai - v3.14.0firebase_auth - v6.5.5firebase_core - v4.12.0cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Update a dependency to the latest release.
REFACTOR: Migrate Firebase Storage to nnbd (#4753).
Bump platform interface a major version due to pigeon dependency update
Note: This release has breaking changes.
Bump platform interface a major version due to pigeon dependency update
FIX(crashlytics,android): fix an issue with deobfuscating flavored builds (#18085).
com.android.tools.build & 'com.google.gms:google-services versions (#4269).FEAT(analytics,iOS): add support for logTransaction (#17995).
FIX(firestore,macos): add Nonull decorator to PigeonParser to remove warnings when building (#12930).
BREAKING FEAT(firestore): remove deprecated functions (#17559).
FEAT: bump compileSdkVersion to 29 (#3975).
CHORE: delete package_config.json (#3744).
FIX: if custom metadata value returns null put value as empty string.
…on-going tasks easier. There are a number of breaking changes & features with this overhaul:
As part of our on-going work for #2582 this is our Firebase Storage rework changes.
Overall, Firebase Storage has been heavily reworked to bring it inline with the federated plugin setup along with adding new features, documentation and many more unit and end-to-end tests (tested on Android, iOS & MacOS).
FirebaseStorage
FirebaseStorage.instanceFor or FirebaseStorage.instance instead.getReferenceFromUrl() is deprecated in favor of calling ref() with a path.getMaxOperationRetryTimeMillis() is deprecated in favor of the getter maxOperationRetryTime.getMaxUploadRetryTimeMillis() is deprecated in favor of the getter maxUploadRetryTime.getMaxDownloadRetryTimeMillis() is deprecated in favor of the getter maxDownloadRetryTime.setMaxOperationRetryTimeMillis() is deprecated in favor of setMaxUploadRetryTime().setMaxUploadRetryTimeMillis() is deprecated in favor of setMaxUploadRetryTime().setMaxDownloadRetryTimeMillis() is deprecated in favor of setMaxDownloadRetryTime().ref() creates a new Reference at the bucket root, whereas an optional path (ref('/foo/bar.png')) can be used to create a Reference pointing at a specific location.refFromURL, which accepts a Google Storage (gs://) or HTTP URL and returns a Reference synchronously.Reference
StorageReference has been renamed to Reference.getParent() is deprecated in favor of .parent.getRoot() is deprecated in favor of .root.getStorage() is deprecated in favor of .storage.getBucket() is deprecated in favor of .bucket.getPath() is deprecated in favor of .fullPath.getName() is deprecated in favor of .name.list(options).
ListOptions API (see below).listAll().putString() has been added to accept a string value, of type Base64, Base64Url, a Data URL or raw strings.
Content-Type metadata if not already set.getData() does not require a maxSize, it can now be called with a default of 10mb.NEW ListOptions
list() method accepts a ListOptions instance with the following arguments:
maxResults: limits the number of results returned from a call. Defaults to 1000.pageToken: a page token returned from a ListResult - used if there are more items to query.NEW ListResult
ListResult class has been added, which is returned from a call to list() or listAll(). It exposes the following properties:
items (List<Reference>): Returns the list of reference objects at the current reference location.prefixes (List<Reference>): Returns the list of reference sub-folders at the current reference location.nextPageToken (String): Returns a string (or null) if a next page during a list() call exists.Tasks
StorageUploadTask has been renamed to UploadTask (extends Task).StorageDownloadTask has been renamed to DownloadTask (extends Task).StorageTaskEvent has been removed (see below).StorageTaskSnapshot has been renamed to TaskSnapshot.pause(), cancel() and resume() are now Futures which return a boolean value to represent whether the status update was successful.
void methods but still carried out an asynchronous tasks, potentially leading to uncaught exceptions.isCanceled, isComplete, isInProgress, isPaused and isSuccessful have now been removed. Instead, you should subscribe to the stream (for paused/progress/complete/error events) or the task Future for task completion/errors.TaskSnapshot now provides the latest TaskState via task.snapshot.state.events stream (now snapshotEvents) previously returned a StorageTaskEvent, containing a StorageTaskEventType and StorageTaskSnapshot Instead, the stream now returns a TaskSnapshot which includes the state.FirebaseException instead of a new event.events stream is deprecated in favor of snapshotEvents.lastSnapshot is deprecated in favor of snapshot.The new Tasks API matches the Web SDK API, for example:
UploadTask task = FirebaseStorage.instance.ref('/notes.text').putString('My notes!');
// Optional
task.snapshotEvents.listen((TaskSnapshot snapshot) {
print('Snapshot state: ${snapshot.state}'); // paused, running, complete
print('Progress: ${snapshot.totalBytes / snapshot.bytesTransferred}');
}, onError: (Object e) {
print(e); // FirebaseException
});
// Optional
task
.then((TaskSnapshot snapshot) {
print('Upload complete!');
})
.catchError((Object e) {
print(e); // FirebaseException
});
Subscribing to Stream updates and/or the tasks delegating Future is optional - if you require progress updates on your task use the Stream, otherwise the Future will resolve once its complete. Using both together is also supported.
FIX(firestore,web): ensure streams are removed on "hot restart" (#12913).
BREAKING REFACTOR(firebaseai): Removed deprecated Imagen methods and types due to Imagen models being shut down (#18577).
firebase_core.firebase_core.firebase_core.Nothing published for this version
Update lower bound of dart dependency to 2.0.0.
REFACTOR: fix all unnecessary_import analyzer issues introduced with Flutter 2.8.
unnecessary_import analyzer issues introduced with Flutter 2.8.cloud_firestore_odm_generator - v1.0.0-dev.5DOCS: update firestore dartpad example.
FIX(auth,windows): fix a crash that could happen when using sendEmailVerification or sendPasswordResetEmail (#12946).
FEAT: bump Firebase JS SDK to 12.2.1 (#17678).
StorageFileDownloadTask and added propagation of errors to the Future returned by the writeToFile method in StorageReference.FIX: improve reason field handling in recordError (#10264).
author: field from pubspec.yamlREFACTOR: upgrade project to remove warnings from Flutter 3.7 (#10344).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v2.5.4cloud_functions - v3.0.5firebase_analytics - v8.3.4firebase_auth - v3.1.4firebase_core - v1.8.0firebase_crashlytics - v2.2.4firebase_database - v8.0.1firebase_dynamic_links - v2.0.11firebase_in_app_messaging - v0.5.0+11firebase_messaging - v10.0.9firebase_performance - v0.7.1+2firebase_remote_config - v0.11.0+2firebase_storage - v10.0.6Packages with dependency updates only:
firebase_crashlytics_platform_interface - v3.1.4firebase_auth_web - v3.1.3firebase_auth_platform_interface - v6.1.2firebase_remote_config_platform_interface - v0.3.0+7firebase_database_web - v0.1.0+1firebase_database_platform_interface - v0.1.0+1cloud_firestore_web - v2.4.4firebase_messaging_web - v2.0.7cloud_firestore_platform_interface - v5.4.3firebase_messaging_platform_interface - v3.0.7firebase_app_check_platform_interface - v0.0.1+7firebase_app_check - v0.0.2+3firebase_app_check_web - v0.0.1+7cloud_functions_web - v4.0.14cloud_functions_platform_interface - v5.0.12firebase_performance_platform_interface - v0.0.1+5firebase_storage_web - v3.0.4firebase_storage_platform_interface - v4.0.4Your coding agent can read these notes before it upgrades. Set up the MCP server →