Mit Google Home UI Automator können Sie Ihre Google Home app (GHA) für die Inbetriebnahme oder Außerbetriebnahme Matter automatisieren oder einen Regressionstest für Ihre Provision ausführen.
Voraussetzungen
Wenn Sie Google Home UI Automator verwenden möchten, benötigen Sie Folgendes:
Python 3
Es wird empfohlen, das Skript in einer Python 3-Umgebung auszuführen.
Google Home UI Automator erfordert Python 3.11
oder höher.
Android-Smartphone
- Aktivieren Sie auf Ihrem Android-Smartphone den Modus Nutzer-Debugging. Unter Entwickleroptionen aktivieren erfahren Sie, wie Sie die Debugging-Einstellung aktivieren.
- Verbinden Sie Ihr Android-Smartphone mit Ihrem Computer.
Google Home App
- Installiere GHA auf deinem Android-Smartphone.
Achten Sie darauf, dass die GHA-Version
3.10.1.6
oder höher ist. - Melden Sie sich in GHA in Ihrem Google-Konto an.
Google Home UI Automator installieren
Es gibt zwei Möglichkeiten, Google Home UI Automator, PyPI oder aus dem Quellcode zu installieren. Wir empfehlen die Installation mit PyPI.
PyPI (empfohlen)
pip install google-home-ui-automator
Aus Quellcode erstellen
Führen Sie in Ihrem Terminal die folgenden Schritte aus, um einen Build aus einem Quellcode zu erstellen:
Dieses Repository klonen:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
Wechseln Sie zum geklonten Repository:
cd ui-automator
Fü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
Eingabewert | Beschreibung | Beispiel |
---|---|---|
DEVICE_NAME |
Matter Gerät ausgewählt. | m5stack |
PAIRING_CODE |
Kopplungscode deines Matter-Geräts. | 34970112332 |
ROOM_NAME |
Zugewiesener Raum. | Office |
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
Eingabewert | Beschreibung | Beispiel |
---|---|---|
DEVICE_NAME |
Zeigt den Namen des in Betrieb genommenen Matter-Geräts am GHA an. | m5stack |
![Diese Abbildung zeigt die Symbole zum Geben von Feedback und Melden von Problemen in Google Home Playground.](https://developers.home.google.com/static/tools/images/ui-automator-decommission.png?authuser=3&hl=de)
Regressionstest ausführen
Geben Sie den folgenden Code ein, um einen Regressionstest auszuführen. Sie müssen die Flags --regtest
und --commission
einfügen, 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]
Der Regressionstest unterstützt nur den Inbetriebnahme- und Außerbetriebszyklus. Der Regressionstest wird standardmäßig so lange ausgeführt, bis Nutzer den Prozess über die Tastatur anhalten.
Sie können Folgendes hinzufügen, um detailliertere Testergebnisse zu erhalten:
Wert | Eingabewert | Beschreibung | Beispiel |
---|---|---|---|
--repeat |
REPEAT_TIMES |
Führen Sie den Regressionstest in einer bestimmten Zeit und zu mehreren Wiederholungen aus. | 5 |
--hub |
HUB_VERSION |
Hub-Version zum Steuern von Geräten in der GHA. | 15.20221210.3.1 |
--dut |
Gerät wird getestet. | ||
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 Verbesserungsvorschläge für Google Home UI Automator senden möchten, füllen Sie bitte unser Feedbackformular aus.
Probleme melden
Melden Sie aufgetretene Probleme mithilfe der Problemverfolgung.