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.10.1.6
以上版本。 - 在「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
輸入值 | 說明 | 範例 |
---|---|---|
DEVICE_NAME |
已選取 Matter 部裝置。 | m5stack |
PAIRING_CODE |
「Matter」裝置的配對碼。 | 34970112332 |
ROOM_NAME |
已指派的房間。 | Office |
停用 Matter 裝置
如要停用 Matter 裝置,請輸入下列指令:
ui-automator --decommission DEVICE_NAME
輸入值 | 說明 | 範例 |
---|---|---|
DEVICE_NAME |
在 GHA 上顯示佣金的 Matter 裝置名稱。 | m5stack |
![這張圖片顯示在 Google Home Playground 中,用於提供意見和回報問題的圖示。](https://developers.home.google.com/static/tools/images/ui-automator-decommission.png?authuser=7&hl=zh-tw)
執行迴歸測試
如要執行迴歸測試,請輸入下列程式碼。您必須加入 --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 使用體驗提供意見或意見,請填寫意見回饋表單。
回報問題
使用 Issue Tracker 回報問題。