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 電話。 デバッグ設定をオンにするには、開発者向けオプションを有効にするをご覧ください。
- 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 またはソース コードからインストールする 2 つの方法があります。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の改善方法についてご意見やフィードバックをお寄せいただくには、 フィードバック フォームにご記入ください。
問題を報告する
発生した問題は、 Issue Tracker を使用して報告してください。