SuperAPI AI 工具集

debugging-devtools-extensions

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:按该工作流在本地测试与调试 Flutter DevTools 扩展。

主要能力与用法:

  1. 本地桩扩展模式(无需服务器):以独立 Web 模式运行 DevTools(flutter run -d chrome)时默认不启动 devtools_server 后端。要无后端测试扩展,打开 packages/devtools_app/lib/src/shared/development_helpers.dart,设置 const _debugDevToolsExtensions = true;。警告:切勿把该值提交到 git,仓库单元测试 development_helpers_test.dart 会强制其为 false。启用桩模式会注册模拟扩展 foo_ext(package:foo)、bar_ext(package:bar)、provider_ext(package:provider)。
  2. 自动启动与浏览器导航:在 packages/devtools_app 中以固定端口启动 DevTools:flutter run -d chrome --web-port=52941;再用系统命令直接打开目标 URL,macOS:open "http://localhost:52941/foo_ext?embedMode=one",Linux:xdg-open "...",Windows:start "..."。
  3. 连接最终用户目标应用:在 packages/devtools_extensions/example/app_that_uses_foo 中运行示例应用:cd packages/devtools_extensions/example/app_that_uses_foo 后 flutter run -d chrome;请用户复制终端输出的 VM Service URI(如 ws://127.0.0.1:8181/xxx=/ws),再以 uri 参数打开浏览器,如 open "http://localhost:52941/foo_ext?embedMode=one&uri=<VM_SERVICE_URI>"。
  4. 人工交互:连接目标应用时由用户提供 VM Service URI;由代理启动 DevTools 并执行对应系统命令自动打开浏览器;最后请用户目视检查浏览器窗口,确认扩展 UI 或行为是否符合预期。

限制:未提供自动截图或自动断言能力,视觉验证需人工完成;桩模式标志不可提交;其余平台与版本信息暂未提供。