隨著 Flutter 的不斷發展,我們提供了一個工具來幫助您清理程式碼庫中已棄用的 API。該工具作為 Flutter 的一部分提供,並建議您可能需要對程式碼進行的更改。該工具可從命令列使用,並且還整合到了 Android Studio 和 Visual Studio Code 的 IDE 外掛中。

應用單個修復

#

您可以使用任何支援的 IDE 一次應用一個修復。

IntelliJ and Android Studio

#

當分析器檢測到已棄用的 API 時,程式碼行上會出現一個燈泡。單擊燈泡將顯示建議的修復,該修復會將該程式碼更新為新的 API。單擊建議的修復將執行更新。

Screenshot showing suggested change in IntelliJ
IntelliJ 中的一個快速修復示例

VS Code

#

當分析器檢測到已棄用的 API 時,它會顯示一個錯誤。您可以執行以下任何操作:

  • 將滑鼠懸停在錯誤上,然後單擊 Quick Fix(快速修復)連結。這將顯示一個僅包含修復的過濾列表。

  • 將游標放在有錯誤的的程式碼中,然後單擊出現的燈泡圖示。這將顯示所有操作的列表,包括重構。

  • 將游標放在有錯誤的的程式碼中,然後按快捷鍵(macOS 上為 Command+.,其他系統上為 Control+.)。這將顯示所有操作的列表,包括重構。

Screenshot showing suggested change in VS Code
VS Code 中的程式碼操作示例

應用專案範圍的修復

#

dart fix 解碼 Flutter

要檢視或應用對整個專案的更改,您可以使用命令列工具 dart fix

此工具有兩個選項:

  • 要檢視所有可用更改的完整列表,請執行以下命令:

    dart fix --dry-run
  • 要批次應用所有更改,請執行以下命令:

    dart fix --apply

有關 Flutter 棄用的更多資訊,請參閱 Deprecation lifetime in Flutter(Flutter 中的棄用生命週期),這是 Flutter Medium 出版物上的一篇免費文章。