升级 Flutter

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

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

flutter upgrade

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

如果您使用的是**稳定版**渠道并想要更近期的 Flutter SDK 版本，请使用 flutter channel beta 切换到**测试版**渠道，然后运行 flutter upgrade。

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

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

为了避免将来版本的 Flutter 造成中断，请考虑将您的测试提交到我们的测试注册表。

Flutter 有两个发布渠道：**稳定版**和**测试版**。

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

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

**稳定版**分支的最新文档位于：https://api.flutterdart.cn

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

**测试版**渠道与**稳定版**渠道基本相同，但每月更新而不是每季度更新。实际上，当**稳定版**渠道更新时，它会更新到最新的**测试版**版本。

我们目前还有另一个渠道，**main**（以前称为**master**）。为 Flutter 做出贡献的人员使用此渠道。

此渠道的测试不如**测试版**和**稳定版**渠道彻底。

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

**main**分支的最新文档位于：https://api.flutterdart.cn

要查看您当前的渠道，请使用以下命令

flutter channel

要更改为另一个渠道，请使用 flutter channel <channel-name>。更改渠道后，请使用 flutter upgrade 下载该渠道的最新 Flutter SDK 和相关软件包。例如

flutter channel beta
flutter upgrade

切换到特定 Flutter 版本

1. 在Flutter SDK 存档中找到您所需的**Flutter 版本**。

2. 导航到 Flutter SDK

   cd /path/to/flutter

3. 使用 git checkout 切换到您所需的**Flutter 版本**

   git checkout <Flutter version>

如果您修改了 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

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面上次更新于 2024-09-25。 查看源代码 或 报告问题.