Google Home UI Automator 可帮助您自动执行 Google Home app (GHA) 的操作，以便调试、取消调试 Matter 设备，或对调试过程运行回归 测试。
前提条件
如需使用 Google Home UI Automator，请准备好以下内容：
Python 3
建议使用 Python 3 环境运行脚本。
Google Home UI Automator 需要 Python 3.11 或更高版本。
Android 手机
- 在 Android phone. 上开启用户调试 模式。如需开启调试设置，请参阅启用开发者选项。
- 将您的 Android 手机连接到计算机。
Google Home 应用
- 在 Android 手机上安装 GHA。
确保 GHA 的版本为
3.1.1.14和3.32.126.2。 - 在 GHA 中登录您的 Google 账号。
安装 Google Home UI Automator
您可以通过两种方式安装 Google Home UI Automator：PyPI 或源代码 。我们建议使用 PyPI 进行安装。
PyPI（推荐）
pip install google-home-ui-automator
从源代码构建
如需从源代码构建，请在终端中按以下步骤操作：
克隆此代码库：
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator导航到克隆的代码库：
cd ui-automator运行以下命令：
pip install .
调试 Matter 设备
如需调试 Matter 设备，请输入以下命令：
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
| 输入值 | 说明 | 示例 |
|---|---|---|
DEVICE_NAME |
所选 Matter 设备。 | m5stack |
PAIRING_CODE |
您的 Matter 设备的配对码。 | 34970112332 |
ROOM_NAME |
分配的房间。 | Office |
GOOGLE_ACCOUNT |
要在 GHA 中使用的账号。 | test@gmail.com |
退役 Matter 设备
如需将 Matter 设备退役，请输入以下命令：
ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
| 输入值 | 说明 | 示例 |
|---|---|---|
DEVICE_NAME |
在 GHA 上显示已调试的 Matter 设备的名称。 | m5stack |
GOOGLE_ACCOUNT |
要在 GHA 中使用的账号。 | test@gmail.com |
运行回归测试
如需运行回归测试，请输入以下代码。您必须添加 --regtest 和 --commission 标志才能运行回归测试。
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE] [--google_account GOOGLE_ACCOUNT]
| 输入值 | 说明 | 示例 |
|---|---|---|
DEVICE_NAME |
所选 Matter 设备。 | m5stack |
PAIRING_CODE |
您的 Matter 设备的配对码。 | 34970112332 |
ROOM_NAME |
分配的房间。 | Office |
GOOGLE_ACCOUNT |
要在 GHA 中使用的账号。 | test@gmail.com |
回归测试仅支持调试和取消调试周期。 默认情况下，回归测试将一直运行，直到用户使用键盘停止该过程。
您可以添加以下内容，以获取更深入的测试结果：
| 值 | 输入值 | 说明 | 示例 |
|---|---|---|---|
--repeat |
REPEAT_TIMES |
在有限的时间内运行回归测试，并重复运行。 | 5 |
--hub |
HUB_VERSION |
用于在 GHA 上控制设备的 Hub 版本。 | 15.20221210.3.1 |
--dut |
被测设备。 | ||
MODEL |
设备型号。 | X123123 |
|
TYPE |
设备类型。 | LIGHT |
|
PROTOCOL |
设备协议。 | MATTER |
|
--fw |
DEVICE_FIRMWARE |
设备固件。 | 2.2.0 |
反馈
如需提交您对如何改进 Google Home UI Automator使用体验的想法或反馈，请填写我们的 反馈表单。
报告问题
使用 问题跟踪器报告遇到的问题。