Google Home UI Automator può aiutarti ad automatizzare il Google Home app (GHA) e ottenere la commissione, a ritirare Matter o a eseguire un test di regressione sulla tua commissione.
Prerequisiti
Per utilizzare Google Home UI Automator, tieni a portata di mano quanto segue:
Python 3
È consigliabile utilizzare l'ambiente Python 3 per eseguire lo script.
Google Home UI Automator richiede Python 3.11
o versioni successive.
Smartphone Android
- Attiva la modalità Debug utente sul tuo telefono Android. Vedi Attiva Opzioni sviluppatore per attivare l'impostazione di debug.
- Collega il tuo smartphone Android al computer.
App Google Home
- Installa GHA sul tuo smartphone Android.
Assicurati che la versione di GHA sia
3.10.1.6
o successiva. - Accedi al tuo Account Google in GHA.
Installa l'Automator UI di Google Home
Esistono due modi per installare Google Home UI Automator, PyPI o da un codice sorgente. Ti consigliamo di eseguire l'installazione con PyPI.
PyPI (consigliato)
pip install google-home-ui-automator
Crea da codice sorgente
Per creare da un codice sorgente, segui questi passaggi nel tuo terminale:
Clona questo repository:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
Passa al repository clonato:
cd ui-automator
Esegui questo comando:
pip install .
Messa in servizio di un dispositivo Matter
Per mettere in servizio un dispositivo Matter, inserisci il seguente comando:
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Valore di input | Descrizione | Esempio |
---|---|---|
DEVICE_NAME |
Matter dispositivo selezionato. | m5stack |
PAIRING_CODE |
Codice di accoppiamento del dispositivo Matter. | 34970112332 |
ROOM_NAME |
Stanza assegnata. | Office |
Disattivazione di un dispositivo Matter
Per ritirare un dispositivo Matter, inserisci il seguente comando:
ui-automator --decommission DEVICE_NAME
Valore di input | Descrizione | Esempio |
---|---|---|
DEVICE_NAME |
Mostra il nome del dispositivo Matter commissionato su GHA. | m5stack |
Esecuzione di un test di regressione
Per eseguire un test di regressione, inserisci il codice seguente. Devi includere il flag
--regtest
e --commission
per eseguire il test di regressione.
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]
Il test di regressione supporta solo il ciclo di messa in servizio e dismissione. Per impostazione predefinita, il test di regressione viene eseguito finché gli utenti non utilizzano la tastiera per interrompere il processo.
Per risultati di test più approfonditi, puoi aggiungere quanto segue:
Valore | Valore di input | Descrizione | Esempio |
---|---|---|---|
--repeat |
REPEAT_TIMES |
Esegui il test di regressione in tempi limitati e ripetuti. | 5 |
--hub |
HUB_VERSION |
Versione hub per il controllo di dispositivi su GHA. | 15.20221210.3.1 |
--dut |
Dispositivo in corso di test. | ||
MODEL |
Modello del dispositivo. | X123123 |
|
TYPE |
Tipo di dispositivo. | LIGHT |
|
PROTOCOL |
Protocollo del dispositivo. | MATTER |
|
--fw |
DEVICE_FIRMWARE |
Firmware del dispositivo. | 2.2.0 |
Feedback
Per inviare la tua opinione o feedback su come migliorare la tua esperienza con Google Home UI Automator, compila il nostro modulo di feedback.
Segnalare i problemi
Segnala i problemi riscontrati utilizzando Issue Tracker.