Google Home UI Automator

案件    裝置 SDK

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 手機

1. 在 Android 上開啟使用者偵錯模式 電話。 請參閱「啟用開發人員選項」，瞭解如何開啟偵錯設定。
2. 將 Android 手機連接到電腦。

Google Home 應用程式

1. 在 Android 手機上安裝「GHA」。 確認 GHA 的版本為 3.10.1.6 以上版本。
2. 在 GHA 中登入 Google 帳戶。

安裝 Google Home UI Automator

您可以透過兩種方式安裝 Google Home UI Automator、PyPI 或從來源安裝 再也不是件繁重乏味的工作建議您使用 PyPI 進行安裝。

PyPI (建議)

pip install google-home-ui-automator

透過原始碼建構

如要從原始碼開始建構，請在終端機中按照下列步驟操作：

1. 複製這個存放區：

   git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
   

2. 前往複製的存放區：

   cd ui-automator
   

3. 執行下列指令：

   pip install .
   

委託 Matter 裝置

如要強制執行 Matter 裝置，請輸入下列指令：

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME

輸入值	說明	範例
DEVICE_NAME	已選取 Matter 部裝置。	m5stack
PAIRING_CODE	「Matter」裝置的配對碼。	34970112332
ROOM_NAME	已指派的房間。	Office

停用 Matter 裝置

如要停用 Matter 裝置，請輸入下列指令：

ui-automator --decommission DEVICE_NAME

輸入值	說明	範例
DEVICE_NAME	在 GHA 上顯示佣金的 Matter 裝置名稱。	m5stack

執行回歸測試

如要執行迴歸測試，請輸入下列程式碼。必須加上旗標 --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]

迴歸測試僅支援調用和停用週期。 根據預設，系統會執行迴歸測試，直到使用者使用鍵盤停止 在整個過程中 相關資訊與洞察也能儲存至知識庫

如要取得更深入的測試結果，您可以新增下列內容：

值	輸入值	說明	範例
--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，請完成我們的 意見回饋表單。

回報問題

使用問題追蹤工具回報遇到的問題。