Mit Google Home UI Automator können Sie die Google Home app (GHA) automatisieren, um Matter in Betrieb zu nehmen, außer Betrieb zu nehmen oder einen Regressionstest für Ihre Provision durchzuführen.
Voraussetzungen
Damit Sie Google Home UI Automator verwenden können, benötigen Sie Folgendes:
Python 3
Es wird empfohlen, zum Ausführen des Skripts die Python 3-Umgebung zu verwenden.
Für Google Home UI Automator ist Python 3.11
oder höher erforderlich.
Android-Smartphone
- Aktivieren Sie den Modus Nutzer-Debugging auf Ihrem Android-Smartphone. Informationen zum Aktivieren der Debugging-Einstellung finden Sie unter Entwickleroptionen 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.
UI-Automator für Google Home installieren
Es gibt zwei Möglichkeiten, Google Home UI Automator über PyPI oder über Quellcode zu installieren. Wir empfehlen die Installation mit PyPI.
PyPI (empfohlen)
pip install google-home-ui-automator
Aus Quellcode erstellen
Führen Sie die folgenden Schritte in Ihrem Terminal 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 |
Der Name des in Betrieb genommenen Matter-Geräts am GHA wird angezeigt. | m5stack |
Regressionstest ausführen
Geben Sie den folgenden Code ein, um einen Regressionstest auszuführen. Sie müssen das Flag --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]
Der Regressionstest unterstützt nur den Zyklus für die Inbetriebnahme und Außerbetriebnahme. Der Regressionstest wird standardmäßig so lange ausgeführt, bis Nutzer ihn über die Tastatur beenden.
Für detailliertere Testergebnisse können Sie Folgendes hinzufügen:
Wert | Eingabewert | Beschreibung | Beispiel |
---|---|---|---|
--repeat |
REPEAT_TIMES |
Führen Sie einen Regressionstest zu bestimmten Zeiten und wiederholten Malen durch. | 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 |
Gerätefirmware. | 2.2.0 |
Feedback
Wenn Sie uns Feedback geben oder uns mitteilen möchten, wie wir Ihre Erfahrung mit Google Home UI Automator verbessern können, füllen Sie bitte unser Feedbackformular aus.
Probleme melden
Melden Sie Probleme mit der Problemverfolgung.