Google Home UI Automator peut vous aider à automatiser votre Google Home app (GHA) pour mettre en service, mettre hors service Matter ou exécuter une régression sur votre commission.
Conditions préalables
Pour utiliser Google Home UI Automator, préparez les éléments suivants :
Python 3
Il est recommandé d'utiliser l'environnement Python 3 pour exécuter le script.
Google Home UI Automator nécessite Python 3.11
ou version ultérieure.
Téléphone Android
- Activez le mode Débogage utilisateur sur votre téléphone Android. Consultez Activer les options pour les développeurs pour activer le paramètre de débogage.
- Connectez votre téléphone Android à votre ordinateur.
Application Google Home
- Installez GHA sur votre téléphone Android.
Assurez-vous que la version de GHA est
3.1.1.14
et3.24.1.4
. - Connectez-vous à votre compte Google dans GHA.
Installer Google Home UI Automator
Il existe deux façons d'installer Google Home UI Automator : via PyPI ou à partir du code source. Nous vous recommandons d'utiliser PyPI pour l'installation.
PyPI (recommandé)
pip install google-home-ui-automator
Compiler à partir du code source
Pour créer à partir d'un code source, procédez comme suit dans votre terminal :
Clonez ce dépôt :
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
Accédez au dépôt cloné :
cd ui-automator
Exécutez la commande suivante :
pip install .
Mettre en service un appareil Matter
Pour mettre en service un appareil Matter, saisissez la commande suivante :
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
Valeur d'entrée | Description | Exemple |
---|---|---|
DEVICE_NAME |
Appareil Matter sélectionné. | m5stack |
PAIRING_CODE |
Code d'association de votre appareil Matter. | 34970112332 |
ROOM_NAME |
Salle attribuée. | Office |
Mettre hors service un appareil Matter
Pour mettre hors service un appareil Matter, saisissez la commande suivante :
ui-automator --decommission DEVICE_NAME
Valeur d'entrée | Description | Exemple |
---|---|---|
DEVICE_NAME |
Indique le nom de l'appareil Matter mis en service sur GHA. | m5stack |
Exécuter un test de régression
Pour exécuter un test de régression, saisissez le code suivant. Vous devez inclure l'indicateur
--regtest
et --commission
pour exécuter le test de régression.
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]
Le test de régression ne prend en charge que le cycle de mise en service et de mise hors service. Par défaut, le test de régression s'exécute jusqu'à ce que les utilisateurs utilisent le clavier pour arrêter le processus.
Vous pouvez ajouter les éléments suivants pour obtenir des résultats de test plus détaillés :
Valeur | Valeur d'entrée | Description | Exemple |
---|---|---|---|
--repeat |
REPEAT_TIMES |
Exécutez un test de régression avec une durée limitée et de manière répétée. | 5 |
--hub |
HUB_VERSION |
Version du hub pour contrôler les appareils sur GHA. | 15.20221210.3.1 |
--dut |
Appareil testé. | ||
MODEL |
Modèle de l'appareil. | X123123 |
|
TYPE |
Type d'appareil | LIGHT |
|
PROTOCOL |
Protocole de l'appareil. | MATTER |
|
--fw |
DEVICE_FIRMWARE |
Micrologiciel de l'appareil. | 2.2.0 |
Commentaires
Pour nous faire part de vos idées ou de vos commentaires sur la façon d'améliorer votre expérience avec la Google Home UI Automator, suivez notre Formulaire de commentaires.
Signaler des problèmes
Signalez les problèmes rencontrés à l'aide de l'outil de suivi des problèmes.