跳转至正文

DevTools 扩展

学习如何使用和构建 DevTools 扩展。

什么是 DevTools 扩展?

#

DevTools extensions(DevTools 扩展)是由第三方包提供的开发者工具,与 DevTools 工具套件紧密集成。扩展作为 pub 包的一部分分发,并在用户调试应用时动态加载到 DevTools 中。

使用 DevTools 扩展

#

如果你的应用依赖提供 DevTools 扩展的包,打开 DevTools 时扩展会自动显示在新标签页中。

配置扩展启用状态

#

首次加载前你需要手动启用扩展。启用前请确认扩展来自你信任的来源。

首次打开扩展时,你会看到启用扩展的提示:

Screenshot of extension enablement prompt

你可以随时在 DevTools Extensions(扩展)对话框中修改该设置:

Screenshot of DevTools Extensions dialog button

Screenshot of extension enablement dialog

扩展启用状态存储在用户项目根目录的 devtools_options.yaml 文件中(类似于 analysis_options.yaml)。

yaml
description: This file stores settings for Dart & Flutter DevTools.
documentation: https://docs.flutter.dev/tools/devtools/extensions#configure-extension-enablement-states
extensions:
  - provider: true
  - shared_preferences: true
  - foo: false

该文件存储 DevTools 的按项目(或可选的按用户)设置。

如果该文件 已纳入源代码管理,则指定选项会按项目配置。这意味着拉取项目源码并在其上工作的所有人使用相同设置。

如果该文件 未纳入源代码管理,例如在 .gitignore 中加入 devtools_options.yaml,则指定选项会按用户分别配置。由于每位用户或贡献者在此情况下使用本地的 devtools_options.yaml 副本,指定选项可能在贡献者之间有所不同。

构建 DevTools 扩展

#

有关如何构建 DevTools 扩展的深入指南,请访问 Build custom tooling in Flutter and Dart DevTools(在 Flutter 与 Dart DevTools 中构建自定义工具)

你也可以观看以下视频:

Watch on YouTube in a new tab: "Building DevTools extensions | Flutter Build Show"