Upgrading Flutter
No matter which one of the Flutter release channels
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 pub
commands.
To get all the dependencies listed in the pubspec.yaml
file,
without unnecessary updates, use the get
command:
$ flutter pub get
To update to the latest compatible versions of
all the dependencies listed in the pubspec.yaml
file,
use the upgrade
command:
$ flutter pub upgrade
Keeping informed
We publish breaking change announcements to the Flutter announcements mailing list. You can also ask questions on the Flutter dev mailing list. Aside from subscribing to receive announcements, we’d love to hear from you!
Selecting a specific version
If you have a specific version of Flutter that you’d like to switch to,
you can use the flutter version
command:
$ flutter version v1.9.1+hotfix.3
To pin packages to specific versions, specify their versions explicitly in the
pubspec.yaml
file. For more details on the format of this file, see the
pubspec.yaml documentation on dart.dev.