UI Automator de Google Home

Litige    SDK de l'appareil

Google Home UI Automator peut vous aider à automatiser votre Google Home app (GHA) mettre en service, mettre hors service Matter ou exécuter une régression sur votre commission.

Cette illustration montre comment associer un appareil Matter à Google Home.

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 une version ultérieure.

Téléphone Android

  1. 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.
  2. Connectez votre téléphone Android à votre ordinateur.

Application Google Home

  1. Installez GHA sur votre téléphone Android. Assurez-vous que la version de GHA est 3.10.1.6 ou ultérieure.
  2. Connectez-vous à votre compte Google dans GHA.

Installer Google Home UI Automator

Deux options s'offrent à vous pour installer Google Home UI Automator, PyPI ou une source du code source. Nous vous recommandons d'utiliser PyPI pour l'installation.

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 :

  1. Clonez ce dépôt:

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

  2. Accédez au dépôt cloné :

    cd ui-automator

  3. 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 Matter appareil sélectionné. m5stack
PAIRING_CODE Code d'association de votre appareil Matter. 34970112332
ROOM_NAME Salle attribuée. Office

Cette figure montre comment associer un appareil Matter à Google Home

Désactiver un appareil Matter

Pour mettre un appareil Matter hors service, 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
Cette illustration montre les icônes permettant d'envoyer des commentaires et de signaler des problèmes. problèmes dans Google Home Playground.

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 s'arrêtent tout au long du processus.

Vous pouvez ajouter les éléments suivants pour obtenir des résultats de test plus approfondis:

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 Hub permettant de 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

Cette figure montre le résumé du test de régression

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.