UI-Automator für Google Home

Matter    Device SDK

Mit Google Home UI Automator können Sie die Inbetriebnahme und Deaktivierung von Google Home app (GHA) automatisieren oder einen Regressionstest für Ihre Kommission ausführen.Matter

Auf dieser Abbildung wird gezeigt, wie Sie ein Matter-Gerät mit Google Home koppeln.

Voraussetzungen

Für die Verwendung von Google Home UI Automator benötigen Sie Folgendes:

Python 3

Es wird empfohlen, das Script in einer Python 3-Umgebung auszuführen. Für Google Home UI Automator ist Python 3.11 oder höher erforderlich.

Android-Smartphone

  1. Aktivieren Sie auf Ihrem Android den Modus Nutzer-Debugging. Entwickleroptionen aktivieren
  2. Verbinden Sie Ihr Android mit dem Computer.

Google Home App

  1. Installieren Sie GHA auf Ihrem Android. Die Version von GHA muss 3.1.1.14 und 3.25.1.4 sein.
  2. 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 über den Quellcode. Wir empfehlen die Installation über PyPI.

pip install google-home-ui-automator

Aus Quellcode erstellen

So erstellen Sie ein Build aus einem Quellcode:

  1. Klonen Sie dieses Repository:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator

  2. Wechseln Sie zum geklonten Repository:

    cd ui-automator

  3. 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 Ausgewähltes Matter-Gerät m5stack
PAIRING_CODE Kopplungscode Ihres Matter-Geräts 34970112332
ROOM_NAME Zugewiesener Raum. Office

Auf dieser Abbildung wird gezeigt, wie Sie ein Matter-Gerät mit Google Home koppeln.

Matter-Gerät außer Betrieb setzen

Geben Sie den folgenden Befehl ein, um ein Matter-Gerät außer Betrieb zu setzen:

ui-automator --decommission DEVICE_NAME
Eingabewert Beschreibung Beispiel
DEVICE_NAME Der Name des in Betrieb genommenen Matter-Geräts auf GHA. m5stack
Auf dieser Abbildung sind die Symbole zu sehen, mit denen Sie Feedback geben und Probleme in Google Home Playground melden können.

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]

Der Regressionstest unterstützt nur den Zyklus der Inbetriebnahme und Außerbetriebnahme. 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 und wiederholter Weise durch. 5
--hub HUB_VERSION Hub-Version zur Steuerung von Geräten über die Google Home App. 15.20221210.3.1
--dut Testgerät.
MODEL Gerätemodell X123123
TYPE Gerätetyp LIGHT
PROTOCOL Geräteprotokoll MATTER
--fw DEVICE_FIRMWARE Gerätefirmware 2.2.0

Diese Abbildung zeigt die Zusammenfassung des Regressionstests.

Feedback

Wenn du uns deine Meinung oder Feedback dazu geben möchtest, wie wir die Google Home UI Automator verbessern können, fülle bitte dieses Formular aus.

Probleme melden

Melden Sie Probleme über die Problemverfolgung.