升級 Flutter

無論你關注的是哪個 Flutter 釋出渠道，都可以使用 flutter 命令來升級你的 Flutter SDK 或應用所依賴的包。

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

$ flutter upgrade

該命令會獲取你當前 Flutter 渠道中可用的最新版 Flutter SDK。

如果你使用的是 stable（穩定）渠道，但想要更新版本的 Flutter SDK，請先使用 flutter channel beta 切換到 beta 渠道，然後執行 flutter upgrade。

我們針對已知的破壞性變更釋出了遷移指南。

我們會將有關這些變更的公告發送至 Flutter 公告郵件列表。

為避免未來版本的 Flutter 導致你的程式碼出現問題，請考慮將你的測試用例提交至我們的測試登錄檔。

Flutter 有兩個主要的釋出渠道：stable 和 beta。

我們建議新使用者和用於生產環境的應用使用 stable 渠道。團隊大約每三個月更新一次此渠道。該渠道偶爾會針對嚴重或影響重大的問題接收熱修復補丁。

Flutter 團隊外掛和包的持續整合測試包含針對最新 stable 版本的測試。

stable 分支的最新文件位於：https://api.flutter.dev

beta 渠道包含最新的穩定釋出版本。這是我們經過大量測試的最新 Flutter 版本。該渠道已透過我們所有的公共測試，並通過了使用 Flutter 的 Google 產品測試套件的驗證，並經過了貢獻者提供的私有測試套件的審查。beta 渠道會定期接收熱修復補丁，以解決新發現的重要問題。

beta 渠道與 stable 渠道本質上相同，但更新頻率為每月一次而非每季度一次。事實上，當 stable 渠道更新時，它會被更新為最新的 beta 釋出版本。

我們目前還有一個其他渠道，即 main（此前稱為 master）。為 Flutter 做貢獻的人員使用此渠道。

此渠道的測試程度不及 beta 和 stable 渠道。

我們不建議使用此渠道，因為它更有可能包含嚴重的迴歸問題。

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\<使用者名稱>\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

   此命令需要管理員許可權。