version_migration 2.0.10 copy "version_migration: ^2.0.10" to clipboard
version_migration: ^2.0.10 copied to clipboard

Manages functions of code that need to run once on version updates in Flutter apps.

VersionMigration #

Codemagic build status

This a translation of the library MTMigration ( to a Dart Package.

Manages functions of code that need to run once on version updates in Flutter apps. This could be anything from data normalization routines, "What's New In This Version" screens, or bug fixes.

Installation #

Add in pubspec:

version_migration: ^2.0.10

Usage #

If you need a function that runs every time your application version changes, pass that function to the applicationUpdate method.

VersionMigration.applicationUpdate(() {

If the function is specific to a version, use migrateToVersion and VersionMigration will ensure that the function is only ever run once for that version.

VesionMigration.migrateToVersion("1.1", () {

Because VersionMigration inspects your actual version number and keeps track of the last migration, it will migrate all un-migrated functions inbetween. For example, let's say you had the following migrations:

VersionMigration.migrateToVersion("0.9", () {
    // Some 0.9 stuff

VersionMigration.migrateToVersion("1.0", () {
    // Some 1.0 stuff

If a user was at version 0.8, skipped 0.9, and upgraded to 1.0, then both the 0.9 and 1.0 functions would run.

For debugging/testing purposes, you can call reset to clear out the last migration VersionMigration remembered, causing all migrations to run from the beginning:


Notes #

VersionMigration assumes version numbers are incremented in a logical way, i.e. 1.0.1 -> 1.0.2, 1.1 -> 1.2, etc.

Version numbers that are past the version specified in your app will not be run. For example, if your pubspec file specifies 1.2 as the app's version number, and you attempt to migrate to 1.3, the migration will not run.

Contributing #

This library does not handle some more intricate migration situations, if you come across intricate use cases from your own app, please add it and submit a pull request. Be sure to add test cases.

pub points


unverified uploader

Manages functions of code that need to run once on version updates in Flutter apps.

Repository (GitHub)
View/report issues


API reference


BSD-3-Clause (LICENSE)


file, flutter, package_info_plus, platform, shared_preferences


Packages that depend on version_migration