Google Home Developer Console fournit une page de test sur laquelle vous pouvez configurer et exécuter des tests sur votre intégration Matter à l'aide de Google Home Test Suite. Test Suite est une application distincte intégrée à Developer Console, qui gère tous les tests d'intégration.
Afin d'être testés, les appareils associés à l'ID de fournisseur et à l'ID produit de l'intégration doivent être mis en service et disponibles dans Google Home app (GHA) pour le compte utilisé avec Developer Console. Pour en savoir plus, consultez Associer un appareil Matter.
Le Test Suite peut être exécuté sur un ensemble d'appareils appartenant à une configuration de projet Matter spécifique. Il est très important d'exécuter Test Suite sur vos intégrations pour vous assurer que tout fonctionne correctement.
Sur la page Test, les intégrations Matter terminées et prêtes à être testées sont répertoriées dans Prêt à être testé.
Les intégrations Matter qui ont été testées sont listées dans la section Tested (Test).
Type de forfait de test
Il existe deux types de forfaits de test:
Les plans de test de développement sont utilisés pour tester le contrôle des appareils à l'aide de Matter. Ils sont modifiables, mais ne peuvent pas être envoyés pour la certification Matter.
Les plans de test de la certification sont spécifiquement destinés à la certification Matter et ne sont pas modifiables. Si vous sélectionnez cette option, une nouvelle version de votre intégration Matter sera créée.
Versions d'Integration
Lorsque vous créez un plan de test pour la certification, une nouvelle version de l'intégration est créée. Cette version numérotée est répertoriée dans toutes les listes d'intégration dans le Developer Console, à partir de l'onglet "Test".
De nouvelles versions ne sont jamais créées à partir d'autres versions numérotées. Par exemple, le premier plan de test que vous créez pour une intégration crée la version v.1 pour cette intégration. Si vous créez un autre plan de test, la version v.2 sera créée pour cette intégration, mais cette version ne sera pas basée sur la version v.1. Au lieu de cela, cette version est basée sur l'instance sans version de l'intégration, comme l'était la v.1.
La version N/A d'une intégration représente l'instance sans version de l'intégration, qui est gérée dans l'onglet Develop (Développer).
En d'autres termes, sur Matter > Test dans Developer Console:
- Si vous cliquez sur Tester pour afficher la version N/A de l'intégration, une nouvelle version est créée. Le numéro de version sera supérieur d'un an à celui des versions numérotées existantes.
- S'il n'existe aucune version numérotée, la version v.1 est créée.
- Si la version v.1 existe, la version v.2 est créée. Si la version v.2 existe, la version v.3 est créée, et ainsi de suite.
- Si vous cliquez sur Tester pour une version numérotée de l'intégration (par exemple, v.1), aucune version n'est v.1. À la place, la version v.1 est testée à nouveau.
Pour en savoir plus, consultez la page Gestion des versions pour l'intégration.
Créer un plan de test
Les versions d'intégration sont un instantané d'une intégration sans version. Cela signifie que lorsque vous créez un plan de test pour la certification, et donc une version d'intégration, toutes les métadonnées associées à cette intégration doivent être les informations que vous souhaitez utiliser pour l'intégration lancée.
Avant de créer un plan de test pour la certification, assurez-vous d'avoir:
- Créer un profil d'entreprise
- Saisissez l'ID du fournisseur (VID) de production pour l'intégration.
- Configurer la configuration et le branding :
Si vous n'avez pas suivi toutes ces étapes pour votre intégration, une version d'intégration créée pour les tests de certification ne peut pas être certifiée. Vous devrez créer une autre version, ce qui implique de répéter les étapes de test, de test sur le terrain et de certification.
Vous devrez également créer une nouvelle version et recommencer depuis le début si vous souhaitez mettre à jour votre branding avant qu'une version d'intégration ne soit certifiée.
Pour créer un plan de test:
Accéder à la console développeur
Dans la liste des projets, cliquez sur Ouvrir à côté du projet avec lequel vous souhaitez travailler.
Dans le menu de navigation à gauche de la page, accédez à Matter > Test.
Cliquez sur Tester pour afficher la version N/A de l'intégration que vous souhaitez tester. Cette action crée une nouvelle version d'intégration.
Sélectionnez un type de test : Test de développement ou Test de certification.
- Sélectionnez Test de certification si vous préparez une certification dans l'écosystème Google.
- Impossible d'utiliser un test de développement pour la certification.
Cliquez sur Tester. Si le message d'erreur Aucun appareil trouvé s'affiche, cela signifie qu'un appareil n'a pas encore été mis en service dans l'écosystème. Consultez la section Résoudre les problèmes d'association pour en savoir plus.
Sur l'écran Configure your test (Configurer votre test), attribuez un nom à votre test et sélectionnez les appareils à tester dans la liste.
Cliquez sur le bouton Suivant: Plan de test.
Sur la page Créer un plan de test, dans la section Suites de tests, sélectionnez les suites de tests que vous souhaitez exécuter.
Si vous souhaitez quitter Test Suite, cliquez sur Return to Developer Center.
Exécuter le plan de test
Dans Test Suite, sur la page Créer un plan de test, cliquez sur Exécuter le test. La page Environnement de test s'affiche, avec l'état et les journaux de tous les tests.
Les résultats des tests s'affichent une fois qu'ils sont terminés. L'état de chaque exécution de la suite de tests s'affiche à côté (Réussi, Échec).
Le volet Journaux affiche l'état de chaque exécution de test.
Pour tester de nouveau un plan de test à partir de la page Environnement de test, cliquez sur Retester en haut de l'écran une fois l'exécution du test terminée.
Une fois l'opération terminée:
- Cliquez sur OK pour accéder à la page Historique des tests.
- Cliquez sur Envoyer pour envoyer les résultats du test de certification.
Afficher et interpréter les résultats de votre test
Sur la page Historique des tests de la Test Suite, vous pouvez consulter les résultats des tests précédents d'un plan de développement ou d'un plan de test de certification non soumis en cliquant sur Tester de nouveau pour le plan de test souhaité dans la section Plans de test. Vous êtes redirigé vers la page Environnement de test, qui affiche les résultats de ce test.
Pour un plan de certification envoyé, cliquez sur Résultats dans la section Enregistré pour la certification afin d'afficher le rapport sur les résultats du test.
Les résultats des tests sont également accessibles pour une version d'intégration à partir de l'onglet Test dans Developer Console. Cliquez sur Afficher pour afficher l'historique des tests de l'une des versions d'intégration listées sur cette page pour accéder à la page Historique des tests dans le Test Suite.
États de la console
Les états suivants de la console peuvent se présenter pendant la phase de test:
| Section | État | Description | Exigence | Et ensuite ? |
|---|---|---|---|---|
| Prêt pour les tests | Prêt | Cette version de integration est prête à être testée. | N/A | Testez cette version de integration. |
| Testé | Prêt | Cette version de integration a été testée et peut être soumise à une phase de test ou de certification. |
La version a été testée et enregistrée. Tous les scénarios de test ayant échoué incluent des raisons pour lesquelles Google doit les examiner. |
Effectuez un nouveau test, si vous le souhaitez. |
Dépannage
L'appareil commandé n'apparaît pas dans la suite de tests
Si vous avez associé un appareil avec un ID de fournisseur (VID) et un ID produit (PID) de test, mais qu'il ne s'affiche pas lorsque vous tentez de tester l'appareil avec la suite de tests dans Developer Console, cela est probablement dû à l'utilisation de la même combinaison VID et PID de test dans plusieurs intégrations.
Pour résoudre le problème, supprimez tous les appareils de test de Developer Console et associez à nouveau l'appareil que vous souhaitez tester.
Pour vérifier que vous avez associé l'appareil approprié, vous pouvez définir les informations du fabricant et du modèle (valeurs CHIP_DEVICE_CONFIG_DEVICE_*) de l'appareil sur des valeurs uniques dans votre micrologiciel de test.
Pour en savoir plus, consultez la section Informations sur l'appareil.
Vérifiez le VID/PID de votre appareil
Si vous souhaitez commencer à développer votre intégration avec Google, vous devez créer un projet et une intégration dans la console Google Home.
La valeur VID/PID utilisée pour le balisage doit correspondre au VID/PID saisi dans votre projet Developer Console.
- Les ID vidéo
0xFFF1:0xFFF4sont réservés aux tests. Ils peuvent être utilisés pour les tests de base de mise en service et de contrôle, mais pas lors des phases de développement suivantes :
À l'aide d'une application d'ingénierie Bluetooth telle que nRF Connect for Mobile, vous pouvez afficher le VID/PID de l'appareil de balisage dans le champ Données du service.
Dans cette capture d'écran de la version Android de nRF Connect, vous verrez que le VID/PID est indiqué comme 5A23FFFE à partir du quatrième octet du champ Données du service. Cela indique un VID de 5A23 et un PID de FFFE, tous deux au format Little Endian.
L'application BLE affiche les valeurs en half-endian,mais les valeurs VID/PID que vous saisissez dans votre projet Developer Console sont en big endian.
Vérifiez que les valeurs et le format corrects ont été saisis dans votre projet Actions Console en fonction des informations affichées par le détection Bluetooth.
Pour les valeurs de la capture d'écran de l'exemple, le VID et le PID dans Developer Console seront respectivement 235A et FEFF.