升级 Flutter

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

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

$ flutter upgrade

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

如果您使用的是 稳定 通道，并且想要更新版本的 Flutter SDK，请使用 flutter channel beta 切换到 Beta 通道，然后运行 flutter upgrade。

我们发布 迁移指南，用于已知的不兼容变更。

我们通过 Flutter 公告邮件列表 发送有关这些变更的通知。

为了避免因未来版本的 Flutter 而出现问题，请考虑将您的测试提交到我们的 测试注册表。

Flutter 有两个发布通道：稳定 和 Beta。

我们建议新用户和生产应用程序发布使用 稳定 通道。团队大约每三个月更新此通道。该通道可能会收到偶尔的热修复，以解决严重或高影响的问题。

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

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

Beta 通道具有最新的稳定版本。这是我们经过全面测试的最新版本的 Flutter。此通道已通过所有公共测试，已针对使用 Flutter 的 Google 产品测试套件进行验证，并已由 贡献的私有测试套件 审核。Beta 通道会定期收到热修复，以解决新发现的重要问题。

Beta 通道本质上与 稳定 通道相同，但每月更新一次，而不是每季度更新一次。实际上，当 稳定 通道更新时，它会更新到最新的 Beta 版本。

我们目前还有另一个通道，即 main（以前称为 master）。为 Flutter 贡献 的人使用此通道。

此通道的测试不如 Beta 和 稳定 通道全面。

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

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

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

$ 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
   

   content_copy

3. 使用 git checkout 切换到您想要的 Flutter 版本

   $ git checkout <Flutter version>
   

   content_copy

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

在 Windows 上运行 flutter upgrade 时，您可能会遇到如下错误

error: unable to create file ...: Filename too long

这是因为 Flutter SDK 中某个文件的路径超过了 Windows 上的默认最大路径长度限制。

要解决此问题，请考虑将 Flutter SDK 安装在较短的路径上。 例如，将 Flutter 安装在 C:\Flutter 而不是像 C:\Users\<user name>\Documents\flutter 这样较长的路径上。

否则，请执行以下操作

1. 在 Git 中启用长路径支持

   $ git config --system core.longpaths true
   

   content_copy

   如果该命令因权限错误而失败，请尝试以管理员身份运行您的终端。

2. 在 Windows 中启用长路径

   New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
   

   content_copy

   此命令需要管理员权限。