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電話。 請參閱「啟用開發人員選項」，開啟偵錯設定。
- 將您的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 上控制裝置的中樞裝置版本。 | 15.20221210.3.1 |
--dut |
受測裝置。 | ||
MODEL |
裝置型號。 | X123123 |
|
TYPE |
裝置類型。 | LIGHT |
|
PROTOCOL |
裝置通訊協定。 | MATTER |
|
--fw |
DEVICE_FIRMWARE |
裝置韌體。 | 2.2.0 |
意見回饋
如要提交有關如何提升 Google Home UI Automator 使用體驗的想法或意見回饋，請填寫意見回饋表單。
回報問題
使用問題追蹤工具回報遇到的問題。