To v3.0.0
This update brings major breaking changes for all users.
For a full list of changes, please see the full CHANGELOG, and make use of the old and new API reference.
Application Migration
Please refer to the sections below for information on how to migrate your application. This will contain the changes that most users may need to make, but not all changes.
This version requires a minimum of Flutter 3.3.0. Use flutter upgrade
to update to this version.
Plugin Migration
Unfortunately, migrating plugins that implement custom layers is more difficult than just renaming in many cases. In good news, the new system requires no complex registration, and will simplify your code.
Previously, state was updated through a StreamBuilder
. Since v3, state is updated using setState
. This means your tile layer is now just a widget, for all intents and purposes, and anything you put in build will automatically be rebuilt when the map state changes.
For more information, see Creating New Layers.
To migrate, place any StreamBuilder
implementation with the below code snippet, and the latest map state will automatically get passed down.
@override
Widget build(BuildContext context) {
final mapState = FlutterMapState.maybeOf(context)!;
// Use `mapState` as necessary, for example `mapState.zoom`
}
Your plugin may also now be able to be a StatelessWidget
, which may increase performance and simplify your code!
In addition to that change:
Last updated
Was this helpful?