v8 brings major performance & stability improvements, along with support for Isar v3.1 and 'flutter_map' v4.
Some migrations are necessary for a small number of users. These migrations are listed below, theoretically in decreasing number of affected users.
The underlying storage structure is directly compatible with v7, and so migration for that is not required.
The fmtc_plus_sharing
module is required to use the import/export functionality.
See the #fmtc_plus_sharing-installation-and-setup instructions to add this module.
Return type is now ImportResult
This contains both the real store name (may be different to the filename) and whether the import was successful.
Collision handlers are now called with an additional argument The filename and real store name are now both passed to the collision handler. See #collision-conflict-resolution.
FMTCInitialisationException
's fields have changed to be more useful in debugging initialisation issues, both internally and externally. If processing these issues manually, you'll need to migrate. See the in-code documentation for more information.
HttpClient
UsageFMTC now supports HTTP/2, through 'http_plus'! HTTP/2 support is enabled by default, with a fallback to HTTP/1.1 (both with a timeout of 5 seconds).
In many of the places where HttpClient
s where previously accepted as arguments, BaseClient
subtypes are now required. To continue using a custom HttpClient
, wrap it with an IOClient
.