# Flutter fix

> 使用 Flutter Fix 帮助你的应用跟进最新的 API 用法。



As Flutter continues to evolve, we provide a tool to help you clean up
deprecated APIs from your codebase. The tool ships as part of Flutter, and
suggests changes that you might want to make to your code. The tool is available
from the command line, and is also integrated into the IDE plugins for Android
Studio and Visual Studio Code.

随着 Flutter 的不断发展，我们提供了一个工具以帮助从代码库中清理已弃用的 API。
该工具作为 Flutter 产品的一部分被提供，也会向你建议可能希望对代码进行的更改。
该工具可通过命令行进行调用，
也集成到了 Android Studio 和 Visual Studio Code 的 IDE 插件中。

:::tip

These automated updates are called _quick-fixes_ in IntelliJ and Android
Studio, and _code actions_ in VS Code.

这种自动更新的功能在 IntelliJ 和 Android Studio 中被称为 **quick-fixes**，
在 VS Code 中被称为 **code actions**。

:::

## Applying individual fixes

## 应用单个修复

You can use any supported IDE
to apply a single fix at a time.

你可以使用支持此功能的 IDE 逐个应用修复。

### IntelliJ and Android Studio

### IntelliJ 和 Android Studio

When the analyzer detects a deprecated API,
a light bulb appears on that line of code.
Clicking the light bulb displays the suggested fix
that updates that code to the new API.
Clicking the suggested fix performs the update.

当 analyzer 检测到已弃用的 API 时，该行代码上会出现一个灯泡状的图标。
点击灯泡图标会显示将代码更新为新 API 的修复建议。
点击建议的修复会执行 API 更新操作。

![Screenshot showing suggested change in IntelliJ](/assets/images/docs/development/tools/flutter-fix-suggestion-intellij.png)<br>
A sample quick-fix in IntelliJ

在 IntelliJ 中使用 quick-fix 的一个案例。

### VS Code

When the analyzer detects a deprecated API,
it presents an error.
You can do any of the following:

当 analyzer 检测到已弃用的 API 时，
它会提供一个报错信息。
你可以执行以下任一操作：

* Hover over the error and then click the
  **Quick Fix** link.
  This presents a filtered list showing
  _only_ fixes.

  将鼠标悬停在报错的位置处，然后点击 **Quick Fix** 选项。
  此操作将只显示修复代码的选项。

* Put the caret in the code with the error and click
  the light bulb icon that appears.
  This shows a list of all actions, including
  refactors.

  将光标放在出现错误提示的代码中，然后点击出现的灯泡图标。
  此操作会显示包括重构在内所有可执行操作的列表。

* Put the caret in the code with the error and
  press the shortcut
  (**Command+.** on macOS, **Control+.** elsewhere)
  This shows a list of all actions, including
  refactors.

  将光标放在出现错误提示的代码中，然后按快捷键
  （mac 上是 **Command+.**，其他平台是 **Control+.** ）。
  此操作会显示包括重构在内所有可执行操作的列表。

![Screenshot showing suggested change in VS Code](/assets/images/docs/development/tools/flutter-fix-suggestion-vscode.png)<br>
A sample code action in VS Code

在 VS Code 中使用 code action 的一个案例。

## Applying project-wide fixes

## 对整个工程应用修复

[dart fix Decoding Flutter][]

To see or apply changes to an entire project,
you can use the command-line tool, [`dart fix`][].

你可以使用命令行工具 [`dart fix`][] 来查看或应用整个项目的更改。

This tool has two options:

此工具有两个可用选项：

* To see a full list of available changes, run
  the following command:

  若要查看可用更改的完整列表，请执行以下命令:

  ```console
  $ dart fix --dry-run
  ```

* To apply all changes in bulk, run the
  following command:

  若要批量应用所有更改，请执行以下命令:

  ```console
  $ dart fix --apply
  ```

For more information on Flutter deprecations,
read [Deprecation lifetime in Flutter][] on the Flutter blog.

更多有关 Flutter 废弃 API 的详细信息，请查看 Flutter 博客上的
[Flutter 废弃 API 的周期][Deprecation lifetime in Flutter] 文章。


[Deprecation lifetime in Flutter]: https://blog.flutter.dev/deprecation-lifetime-in-flutter-e4d76ee738ad
[`dart fix`]: https://dart.cn/tools/dart-fix
[dart fix Decoding Flutter]: https://www.youtube.com/watch?v=OBIuSrg_Quo