Upgrading Flutter
No matter which Flutter release channel you follow, you can use the flutter
command to upgrade your Flutter SDK and the packages that your app depends on.
One-time setup
For the flutter
command to work correctly, your app’s pubspec.yaml
file must require the Flutter SDK. For example, the following snippet specifies that the flutter
and flutter_test
packages require the Flutter SDK:
name: hello_world
dependencies:
flutter:
sdk: flutter
dev_dependencies:
flutter_test:
sdk: flutter
Upgrading the Flutter SDK and packages
To update both the Flutter SDK and the packages that your app depends on, use the flutter upgrade
command from the root of your app (the same directory that contains the pubspec.yaml
file):
$ flutter upgrade
This command first gets the most recent version of the Flutter SDK that’s available on your Flutter channel. Then this command updates each package that your app depends on to the most recent compatible version.
If you want an even more recent version of the Flutter SDK, switch to a less stable Flutter channel and then run flutter upgrade
.
Switching Flutter channels
Flutter has four release channels: stable, beta, dev, and master. We recommend using the stable channel unless you need a more recent release.
To view your current channel, use the following command:
$ flutter channel
To change to another channel, use flutter channel <channel-name>
. Once you’ve changed your channel, use flutter upgrade
to download the Flutter SDK and dependent packages. For example:
$ flutter channel dev
$ flutter upgrade
Upgrading packages only
If you’ve modified your pubspec.yaml
file or you want to update only the packages that your app depends upon (instead of both the packages and Flutter itself), then use one of the flutter packages
commands.
To get all the dependencies listed in the pubspec.yaml
file, without unnecessary updates, use the get
command:
$ flutter packages get
To update to the latest compatible versions of all the dependencies listed in the pubspec.yaml
file, use the upgrade
command:
$ flutter packages upgrade
Keeping informed
We publish breaking change announcements to our mailing list. We strongly recommend that you subscribe to get announcements from us. Plus, we’d love to hear from you!