升级你的 Flutter 版本

不管你使用的是哪个 Flutter 发布渠道，你都可以使用 flutter 命令来升级你的 Flutter SDK 或者你的应用所依赖的 packages。

如果要升级 Flutter SDK 的话，请使用 flutter upgrade 命令：

flutter upgrade

这个命令首先获取你的 Flutter 渠道可用的最新的 Flutter SDK 版本。接着这个命令更新你 app 依赖的每一个 package，到最新的兼容版本。

如果你使用的是 stable 渠道，并且想要一个更新的 Flutter SDK 版本，可以使用 flutter channel beta 命令切换到 beta 渠道，然后再运行 flutter upgrade 命令。

我们会发布 迁移指南 来告知你已知的破坏性变更。

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

为了避免你的应用被未来的 Flutter 版本破坏，可以考虑将你的测试提交到我们的 测试注册表。

Flutter 有两个发布渠道：stable 和 beta。

我们推荐新用户和生产环境使用 stable 渠道。 Flutter 团队会每三个月更新一次这个渠道。这个渠道可能会偶尔收到高优先级或者高影响力问题的热修复。

Flutter 团队的插件和 packages 的持续集成包括针对最新的 stable 版本的测试。

stable 分支的最新文档在：https://api.flutter-io.cn。

beta 渠道有最新的稳定版本。这是我们最近测试过的 Flutter 版本。这个渠道已经通过了我们所有的公开测试，已经通过了使用 Flutter 的 Google 产品的测试套件的验证，并且已经通过了 贡献的私有测试套件 的审核。 beta 渠道会定期收到热修复来解决新发现的重要问题。

beta 渠道本质上和 stable 渠道是一样的，只是更新频率是每月一次，而不是每季度一次。实际上，当 stable 渠道更新时，它会更新到最新的 beta 版本。

我们目前还有一个渠道，main（以前是 master）。 所有的 Flutter 贡献者 都会将代码交到这个渠道。

这个渠道没有 beta 和 stable 渠道测试得那么彻底。

我们不推荐使用这个渠道，因为它更有可能包含严重的退化问题。

main 分支的最新文档在：https://main-api.flutter-io.cn。

要查看你当前使用的哪个渠道，使用下面的命令：

flutter channel

要切换到其它渠道，使用 flutter channel <channel-name>。当你切换了渠道以后，使用 flutter upgrade 下载 Flutter SDK 和依赖的 packages。例如：

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 文件，或者想仅更新项目依赖的 packages，而不是同时更新 packages 和 Flutter SDK，可以选择使用下面提到的 flutter pub 命令。

为了把 pubspec.yaml 文件里列出的所有依赖更新到 最新的兼容版本 ，可以使用使用 upgrade 命令：

flutter pub upgrade

为了把 pubspec.yaml 文件里列出的所有依赖更新到 最新的版本 ，可以使用使用 upgrade --major-versions 命令：

flutter pub upgrade --major-versions

这个命令也会自动更新 pubspec.yaml 文件中的约束条件。

如果需要自动判断那些过时了的 package 依赖以及获取更新建议，现在你可以使用 outdated 命令。更多相关的信息，请参考 Dart 文档中关于 pub outdated 的说明。

flutter pub outdated

除非另有说明，本文档之所提及适用于 Flutter 的最新稳定版本，本页面最后更新时间: 2024-11-02。 查看文档源码 或者 为本页面内容提出建议。