Google Home UI Automator kann Ihnen dabei helfen, Ihre Google Home app (GHA) zu automatisieren, um Matter in Betrieb zu nehmen, außer Betrieb zu nehmen oder einen Regressionstest für Ihre Inbetriebnahme auszuführen.
Voraussetzungen
Wenn Sie Google Home UI Automator verwenden möchten, benötigen Sie Folgendes:
Python 3
Es wird empfohlen, das Script in einer Python 3-Umgebung auszuführen.
Google Home UI Automator erfordert Python 3.11 oder höher.
Android-Smartphone
- Aktiviere auf deinem Android-Smartphone den Nutzer-Debugging-Modus. Informationen zum Aktivieren der Debugging-Einstellung finden Sie unter Entwickleroptionen aktivieren.
- Verbinde dein Android-Smartphone mit deinem Computer.
Google Home App
- Installiere GHA auf deinem Android-Smartphone.
Prüfen Sie, ob die Version von GHA
3.1.1.14und3.32.126.2ist. - Melden Sie sich in GHA in Ihrem Google-Konto an.
Google Home UI Automator installieren
Es gibt zwei Möglichkeiten, Google Home UI Automator zu installieren: über PyPI oder aus dem Quellcode. Wir empfehlen die Installation mit PyPI.
PyPI (empfohlen)
pip install google-home-ui-automator
Aus Quellcode erstellen
So erstellen Sie ein Build aus einem Quellcode:
Klonen Sie dieses Repository:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automatorWechseln Sie zum geklonten Repository:
cd ui-automatorFühren Sie dazu diesen Befehl aus:
pip install .
Matter-Gerät in Betrieb nehmen
Geben Sie den folgenden Befehl ein, um ein Matter-Gerät in Betrieb zu nehmen:
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
| Eingabewert | Beschreibung | Beispiel |
|---|---|---|
DEVICE_NAME |
Matter Gerät ausgewählt. | m5stack |
PAIRING_CODE |
Kopplungscode deines Matter-Geräts. | 34970112332 |
ROOM_NAME |
Zugewiesener Raum. | Office |
GOOGLE_ACCOUNT |
Konto, das in GHA verwendet werden soll. | test@gmail.com |
Matter-Gerät außer Betrieb nehmen
Geben Sie den folgenden Befehl ein, um ein Matter-Gerät außer Betrieb zu nehmen:
ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
| Eingabewert | Beschreibung | Beispiel |
|---|---|---|
DEVICE_NAME |
Zeigt den Namen des in Betrieb genommenen Matter-Geräts auf GHA an. | m5stack |
GOOGLE_ACCOUNT |
Konto, das in GHA verwendet werden soll. | test@gmail.com |
Regressionstest ausführen
Geben Sie den folgenden Code ein, um einen Regressionstest auszuführen. Sie müssen die Flags --regtest und --commission angeben, um den Regressionstest auszuführen.
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]
| Eingabewert | Beschreibung | Beispiel |
|---|---|---|
DEVICE_NAME |
Matter Gerät ausgewählt. | m5stack |
PAIRING_CODE |
Kopplungscode deines Matter-Geräts. | 34970112332 |
ROOM_NAME |
Zugewiesener Raum. | Office |
GOOGLE_ACCOUNT |
Konto, das in GHA verwendet werden soll. | test@gmail.com |
Der Regressionstest unterstützt nur den Inbetriebnahme- und Außerbetriebnahmezyklus. Standardmäßig wird der Regressionstest so lange ausgeführt, bis Nutzer den Vorgang über die Tastatur beenden.
Sie können Folgendes hinzufügen, um detailliertere Testergebnisse zu erhalten:
| Wert | Eingabewert | Beschreibung | Beispiel |
|---|---|---|---|
--repeat |
REPEAT_TIMES |
Führen Sie Regressionstests in begrenzter Anzahl und wiederholt aus. | 5 |
--hub |
HUB_VERSION |
Hub-Version zum Steuern von Geräten in der Google Home App. | 15.20221210.3.1 |
--dut |
Zu testendes Gerät. | ||
MODEL |
Gerätemodell | X123123 |
|
TYPE |
Gerätetyp | LIGHT |
|
PROTOCOL |
Geräteprotokoll. | MATTER |
|
--fw |
DEVICE_FIRMWARE |
Firmware des Geräts. | 2.2.0 |
Feedback
Wenn Sie uns Ihre Meinung oder Ihr Feedback dazu mitteilen möchten, wie wir die Google Home UI Automator verbessern können, füllen Sie bitte unser Feedbackformular aus.
Probleme melden
Melden Sie aufgetretene Probleme über den Issue Tracker.