测试和调试
目录
为了改善开发者体验,Docker Desktop 提供了一套工具来帮助您测试和调试您的扩展。
打开 Chrome 开发者工具
要在您选择 **Extensions** 选项卡时为您的扩展打开 Chrome 开发者工具,请运行
$ docker extension dev debug <name-of-your-extensions>
后续每次点击扩展选项卡也会打开 Chrome 开发者工具。要停止此行为,请运行
$ docker extension dev reset <name-of-your-extensions>
部署扩展后,也可以使用 Konami Code 的变体从 UI 扩展部分打开 Chrome 开发者工具。选择 **Extensions** 选项卡,然后按下按键序列 `上、上、下、下、左、右、左、右、p、d、t`。
开发 UI 时的热重载
在 UI 开发期间,使用热重载来测试您的更改而无需重建整个扩展会很有帮助。为此,您可以配置 Docker Desktop 从开发服务器加载您的 UI,例如 Vite 在调用 `npm start` 时启动的服务器。
假设您的应用程序在默认端口上运行,请启动您的 UI 应用程序,然后运行
$ cd ui
$ npm run dev
这将启动一个监听端口 3000 的开发服务器。
您现在可以告诉 Docker Desktop 将此作为前端源。在另一个终端中运行
$ docker extension dev ui-source <name-of-your-extensions> https://:3000
关闭并重新打开 Docker Desktop 仪表板,然后转到您的扩展。前端代码的所有更改都会立即可见。
完成后,您可以将扩展配置重置为原始设置。如果您使用 `docker extension dev debug
$ docker extension dev reset <name-of-your-extensions>
显示扩展容器
如果您的扩展由一个或多个作为容器在 Docker Desktop VM 中运行的服务组成,您可以从 Docker Desktop 中的仪表板轻松访问它们。
- 在 Docker Desktop 中,导航到 **Settings**。
- 在 **Extensions** 选项卡下,选择 **Show Docker Desktop Extensions system containers** 选项。您现在可以查看您的扩展容器及其日志。
清理
要删除扩展,请运行
$ docker extension rm <name-of-your-extension>
接下来做什么
- 构建一个高级前端扩展。
- 了解有关扩展架构的更多信息。
- 探索我们的设计原则。
- 查看我们的UI 样式指南。
- 了解如何为您的扩展设置 CI。