适用于 VS Code 的 Google Home 扩展程序

Matter    云到云    Local Home SDK

Google Home Extension for Visual Studio Code 是专为 Google Home Platform 开发者设计和创建的。借助此扩展程序,您可以访问 Google Assistant Simulator, Google Cloud Logging、Home Graph Viewer 和其他工具,从而简化您的 Matter 和智能家居开发流程。

适用于 VS Code 的 Google Home 扩展程序

Google Home Extension 功能

Google 助理模拟器

如需测试智能家居设备是否能与 Google Home 生态系统正常搭配使用,您可以随时与 Assistant Simulator互动,而无需 离开 VS Code。

Assistant Simulator 使您可以通过输入查询轻松控制设备,例如 “打开灯”。在 VS Code 中,Assistant Simulator 会根据您的命令以文本消息的形式做出响应,例如 "好的,正在打开灯" 。如需了解详情,请参阅 使用 Google 助理模拟器

批量话语

如需像自动机一样测试 Google Home 集成,您可以运行话语脚本,向 Google 助理模拟器 发送批量话语。如需了解详情,请参阅 运行批量话语

Matter 日志记录工具

Matter 日志记录工具可以收集与 Matter 调试相关的所有日志,包括 Google Home app (GHA) 日志和 Google Play 服务(GMS Core)日志。您可以在 VS Code 中查看日志,并使用过滤条件和关键字搜索功能。您可以下载日志,其中包含其他调试信息(例如 Android和应用版本),并将其发送给 Google 以报告 问题。

Google Home 扩展程序 Matter 日志记录

Cloud Logging

Cloud Logging 提供调试信息和关键指标,让您深入了解 Action 的使用情况。为了简化开发,Google Home Extension 会显示 实时 Google Cloud Logging 消息,在 问题排查期间紧挨着您的代码。如需了解详情,请参阅查看 Cloud Logging

Home Graph Viewer

Home Graph Viewer 现在可以直接在 Google Home Extension 中使用,以便您在 您的 Home Graph 中验证设备状态。如需了解详情,请参阅 查看 Home Graph 和运行测试

安装 Google Home Extension for VS Code

如需安装 Google Home Extension,请在 VS Code 中按照以下步骤操作:

  1. 点击活动栏 中的 Extensions 图标。
  2. 搜索 google home,然后点击安装

    Google Home 扩展服务市场

您还可以直接从 VS Code Marketplace下载 Google Home Extension

下载 Google Home Extension

设置 Google Home Extension for VS Code

安装 Google Home Extension 并重新加载 VS Code 后,您需要先登录并选择项目,然后才能使用 Assistant Simulator 和查看 Cloud Logging。

使用 Google 账号登录并选择云项目

您可以从 Google Home Extension 登录开发者账号, 授权 VS Code 代表您与 Google 服务通信。

  1. 点击活动栏 中的 Google Home 图标,打开 Google Home Extension

    Google Home 扩展程序图标
  2. 点击使用 Google 账号登录 ,在浏览器中启动登录视图。

    VS Code Google 登录
  3. 选择与智能家居设备关联的账号。

  4. 使用 Google 账号登录 授权页面上,点击允许

  5. 系统会打开一个浏览器标签页,并显示打开 Visual Studio Code 对话框。点击打开 Visual Studio Code 以继续。

    打开 VS Code 对话框
  6. 系统会将您重定向到 VS Code,您需要在此授予权限,以允许 Google Home Extension 打开 URI。点击打开 以完成登录流程。

    允许 Google Home 扩展程序打开 URI
  7. 登录后,Google Home Extension 会加载您的项目。完成后,点击选择项目

    选择项目
  8. 在随即显示的搜索并选择项目 下拉窗口中,选择您的智能家居项目。

安装 Android 调试桥 (ADB) 工具

如需在 Matter 日志在 Android 手机上查看,您需要安装 ADB:

  1. 在计算机上安装 ADB。
  2. 在 Android 手机上开启开发者选项和 USB 调试

安装 Matter 设备 SoC 工具

如需查看 Matter 设备的调试日志,请执行以下操作:

  1. 大多数设备 SoC 会导出串行端口,例如 Linux 上的 /dev/ttyUSBx 或 MacOS 上的 /dev/tty.SLAB_USBtoUART/dev/tty.usbserial。LogViewer 可以直接从设备读取日志。
  2. 某些 SoC 类型(例如 NXPSilicon Labs)可能需要安装外部 工具(例如 JLink)。如需了解详情,请参阅 支持的设备

使用 Google Home Extension for VS Code

查看开发者资源

HELP AND FEEDBACK 下,点击 Get Started & Resources 以打开 Resources 页面,您可以在其中找到有关使用 Google Home 生态系统进行开发的实用信息。

Google Home 生态系统资源

使用 Google 助理模拟器

如需在 VS Code 中打开 Assistant Simulator,请点击 边栏 中的 GOOGLE 助理 模拟器 。在消息 框中,输入查询,然后按 Enter

您可以查看 Assistant Simulator 响应,并点击 查询后的按钮以 重新发送 查询。

使用 Google 助理模拟器

运行批量话语

将鼠标悬停在 GOOGLE 助理模拟器 菜单栏上,然后从以下选项中进行选择以设置脚本:

  • 点击 以打开 现有话语脚本。

  • 点击 以将 历史记录保存到 *.utterance 脚本中。

    批量话语菜单图标

如需开始发送批量话语,请从以下选项中进行选择:

  • 点击 以从 下拉窗口中选择话语脚本。
  • 直接打开 *.utterance 文件,然后点击

    批量话语运行图标

查看 Cloud Logging

QUICK ACCESS 下,点击 Cloud Logs 以打开 Cloud Logs 页面,您可以在其中找到属于所选项目的日志。

使用 Cloud Logging

用户可以根据严重程度和时间范围过滤日志。

按严重程度和时间过滤日志

默认情况下,日志限制为 50 行。如果用户想要查看更多日志,请向下滚动到底部,然后点击更多 以查看更多日志。

查看更多日志

查看 Home Graph 和运行测试

QUICK ACCESS 下,点击 Home Graph Viewer 以打开 Home Graph Viewer 面板,您可以在其中找到属于所选项目的设备。您还可以点击运行测试 以运行设备测试。

Home Graph Viewer

这会在浏览器中启动测试套件,其中已选择您的设备并准备好进行测试。点击开始 ,然后等待测试结果。

Google Home 测试套件

所有测试完成后,您可以查看测试详情并查看日志。

测试结果

使用 Google Home Extension 进行 Matter 调试

Android 日志记录

MATTER LOGGING TOOLS 下,点击 Android Logs 以 打开 Android Logs 页面,选择要连接的 Android 手机,然后开始显示 日志。

Android 日志记录

Android 手机连接后,您将能够逐行查看日志。请注意,日志经过过滤,这意味着仅显示与 GHA Google Play services Matter模块 相关的日志。您还可以设置严重程度 以过滤日志,或在日志中搜索 关键字。

Android 日志记录(已过滤)

Matter 设备日志记录

MATTER LOGGING TOOLS 下,点击 Device Logs 以打开 Resources 页面, 首先选择 SoC Type

Matter 设备日志记录

接下来,选择 Matter Device

Matter 设备日志记录选择设备

然后,您可以从设备获取所有设备日志,并使用严重程度搜索 等过滤条件来查找您感兴趣的信息。

Matter 设备过滤日志记录

下载所有 Matter 日志

QUICK ACCESS 下,点击 Download Logs 以打开 Download Logs 对话框,选择要下载的日志,然后按 OK

下载事宜日志

选择要下载日志的文件夹,然后点击保存

Matter 日志保存

然后,日志将保存到目标文件夹中:

诉讼或调查日志目标文件夹

解压保存的 zip 文件,它将显示设备信息和日志文件。

Matter 日志 ZIP 文件

设备信息文件将包含调试问题所需的所有版本信息。

Matter 日志调试

发送反馈

如需提交您对如何改进开发 体验(使用 Google Home Extension)的想法或反馈,请从以下选项中进行选择:

  • HELP AND FEEDBACK 面板上,点击 Give Feedback 以向我们提供建议。
  • HELP AND FEEDBACK 面板上,点击 Report Issue 以报告 您在使用 Google Home Extension 时发现的任何问题
“发送反馈”图标
  • 我们还在 Resources 页面上提供了反馈图标。