Rechtsangelegenheit Geräte-SDK
Google Home UI Automator kann Ihnen helfen, Ihr Google Home app (GHA)-Konto zu automatisieren um Matter in Betrieb zu nehmen, außer Betrieb zu nehmen oder eine Regression durchzuführen einen Test für Ihre Provision durchzufü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
- Aktivieren Sie auf Ihrem Android den Modus Fehlerbehebung für Nutzer. Smartphone. Informationen zum Aktivieren der Debugging-Einstellung finden Sie unter Entwickleroptionen aktivieren.
- Verbinden Sie Ihr Android-Smartphone mit Ihrem Computer.
Google Home App
- Installieren Sie GHA auf Ihrem Android.
Achten Sie darauf, dass die Version von GHA
3.1.1.14
und3.24.1.4
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 zu installieren: über PyPI oder über den Quellcode. Wir empfehlen die Installation über 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:
Klonen Sie dieses Repository:
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 setzen
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 auf GHA. | m5stack |
Regressionstest ausführen
Geben Sie den folgenden Code ein, um einen Regressionstest auszuführen. Sie müssen das Flag hinzufügen
--regtest
und --commission
, 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. 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 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 |
Gerätefirmware. | 2.2.0 |
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 mithilfe des Problemverfolgung