升级 Flutter

无论您关注哪个 Flutter 发布频道,您都可以使用 flutter 命令来升级您的 Flutter SDK 或您的应用程序所依赖的软件包。

升级 Flutter SDK

要更新 Flutter SDK,请使用 flutter upgrade 命令

$ flutter upgrade

此命令获取您当前 Flutter 频道上可用的最新版本的 Flutter SDK。

如果您正在使用稳定频道并希望获得更新版本的 Flutter SDK,请使用 flutter channel beta 切换到测试版频道,然后运行 flutter upgrade

保持了解

我们为已知的重大更改发布了迁移指南

我们向Flutter 公告邮件列表发送有关这些更改的公告。

为了避免因未来版本的 Flutter 而中断,请考虑将您的测试提交到我们的测试注册表

切换 Flutter 频道

Flutter 有两个发布渠道:稳定版测试版

稳定版渠道

我们建议新用户和生产应用版本使用稳定版渠道。团队大约每三个月更新此渠道。该渠道可能会收到针对严重或高影响问题的偶尔热修复。

Flutter 团队插件和软件包的持续集成包括针对最新稳定版版本进行测试。

稳定版分支的最新文档位于:https://api.flutter.dev

测试版渠道

测试版渠道具有最新的稳定版。这是我们经过大量测试的最新版本的 Flutter。此渠道已通过我们所有的公开测试,已针对使用 Flutter 的 Google 产品的测试套件进行了验证,并且已针对贡献的私有测试套件进行了审查。测试版渠道会定期收到热修复,以解决新发现的重要问题。

测试版渠道本质上与稳定版渠道相同,但每月更新一次,而不是每季度更新一次。事实上,当稳定版渠道更新时,它会更新到最新的测试版版本。

其他渠道

我们目前还有另一个渠道,主版本为 Flutter 做出贡献的人使用此渠道。

此渠道没有测试版稳定版渠道测试得那么彻底。

我们不建议使用此渠道,因为它更有可能包含严重回归。

主版本分支的最新文档位于:https://main-api.flutter.dev

更改渠道

要查看当前渠道,请使用以下命令

$ flutter channel

要更改到另一个渠道,请使用flutter channel <channel-name>。更改渠道后,请使用flutter upgrade下载该渠道的最新 Flutter SDK 和依赖包。例如

$ flutter channel beta
$ flutter upgrade

升级软件包

如果您修改了 pubspec.yaml 文件,或者您只想更新应用所依赖的软件包(而不是软件包和 Flutter 本身),那么请使用 flutter pub 命令之一。

要更新 pubspec.yaml 文件中列出的所有依赖项的最新兼容版本,请使用 upgrade 命令

$ flutter pub upgrade

要更新 pubspec.yaml 文件中列出的所有依赖项的最新可能版本,请使用 upgrade --major-versions 命令

$ flutter pub upgrade --major-versions

这还会自动更新 pubspec.yaml 文件中的约束。

要识别过时的软件包依赖项并获得有关如何更新它们的建议,请使用 outdated 命令。有关详细信息,请参阅 Dart pub outdated 文档

$ flutter pub outdated