Google Home Developer Console fournit une page 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.
Pour être testés, les appareils associés à l'ID de fournisseur et à l'ID de 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 votre ou 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 listées dans la section Prêt à tester.
Les intégrations Matter qui ont été testées sont listées dans la section Testées.
Types de plans de test
Il existe deux types de plans de test:
Les plans de test de développement permettent de tester les appareils de contrôle à l'aide de Matter. Vous pouvez les modifier, mais vous ne pouvez pas les envoyer pour certification Matter.
Les plans de test de 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.
Utilisez le Test Suite dans le Developer Console pour envoyer les résultats des tests à des fins de certification. Si vous souhaitez exécuter Test Suite à des fins de test pendant le développement, consultez la page Google Home Test Suite pour la version autonome.
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 listée dans toutes les listes d'intégration dans Developer Console à partir de l'onglet "Test".
Les 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 elle ne sera pas basée sur la version v.1. Au lieu de cela, cette version est basée sur l'instance non versionnée de l'intégration, comme l'était la v.1.
La version N/A d'une intégration représente l'instance non versionnée de l'intégration, qui est gérée dans l'onglet Développer.
En d'autres termes, sur Matter > Test dans Developer Console:
- Si vous cliquez sur Test pour la version N/A de l'intégration, une nouvelle version est créée. Le numéro de version sera supérieur de un à celui des versions numérotées existantes.
- Si aucune version numérotée n'existe, 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 Test pour une version numérotée de l'intégration (par exemple, v.1), une nouvelle version n'est pas créée. À la place, la version v.1 est testée à nouveau.
Pour en savoir plus, consultez la section Gestion des versions des intégrations.
Créer un plan de test
Les versions d'intégration sont un instantané d'une intégration non versionnée. 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 effectué les opérations suivantes:
- Créer un profil d'entreprise
- Vous avez saisi l'ID de fournisseur (VID) de production pour l'intégration.
- Configurez la configuration et le branding.
Si vous n'avez pas effectué 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 nouvelle version, ce qui implique de refaire les étapes de test, d'essai sur le terrain et de certification.
Vous devrez également créer une nouvelle version et recommencer 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 de développement
- Dans la liste des projets, cliquez sur Ouvrir à côté du projet avec lequel vous souhaitez travailler.
- Dans le menu de navigation situé à gauche de la page, accédez à Matter > Test.
- Cliquez sur Test pour la version N/A de l'intégration que vous souhaitez tester. Cette action crée une nouvelle version de l'intégration.
- Sélectionnez un type de test (Test de développement ou Test de certification), puis cliquez sur Test.
- Sélectionnez Test de certification si vous vous préparez à passer une certification dans l'écosystème Google.
- Un test de développement ne peut pas être utilisé pour la certification.
Sur l'écran Configurer votre test, attribuez un nom à votre test, puis cliquez sur Associer automatiquement l'appareil pour sélectionner un appareil à associer.
- Pour les appareils Android:
1. Make sure you installed GHA to your phone. 1. Connect your phone with a USB cable to the host machine. 1. You must [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging) The `APK` `com.chip.interop.moblysnippet` will automatically download and install. 1. Once your phone is connected, enter the **Pairing code** and **Device name** to auto-pair your device.- Pour les appareils iOS: vous devez associer manuellement votre appareil. Pour savoir comment procéder, consultez la section Application Google Home.
- Si vous possédez déjà un appareil, vous devrez peut-être le dissocier et l'associer à nouveau ou associer un nouvel appareil.
Cliquez sur le bouton Étape suivante: 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 la fenêtre Test Suite, cliquez sur Retour au 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 les tests terminés. L'état de chaque exécution de la suite de tests s'affiche à côté (Passé, Échec).
Le volet Journaux affiche l'état de chaque exécution de test.
Pour réexécuter un plan de test depuis la page Environnement de test, cliquez sur Réexécuter en haut de la page une fois l'exécution du test terminée.
Une fois terminé:
- Cliquez sur OK pour accéder à la page Historique des tests.
- Cliquez sur Envoyer pour envoyer les résultats des tests pour certification.
Afficher et interpréter les résultats de vos tests
Sur la page Historique des tests de Test Suite, vous pouvez consulter les résultats de test précédents d'un plan de développement ou d'un plan de test de certification non envoyé en cliquant sur Retester pour le plan de test souhaité dans la section Plans de test. Vous êtes alors 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 pour afficher le rapport sur les résultats des tests.
Vous pouvez également accéder aux résultats des tests d'une version d'intégration depuis l'onglet Test de Developer Console. Cliquez sur Afficher pour accéder à l'historique des tests de toute version d'intégration listée sur cette page. Vous serez alors redirigé vers la page Historique des tests dans Test Suite.
États de la console
Les états de la console suivants sont rencontrés lors de la phase de test:
| Section | État | Description | Exigence | Étapes suivantes |
|---|---|---|---|---|
| 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 la integration a été testée et peut être envoyée pour un essai sur le terrain ou une certification. |
La version a été testée et enregistrée. Tous les scénarios de test échoués incluent des justifications que Google peut examiner. |
Répétez le test, si vous le souhaitez. |
Tester de nouveau
Certification
Si vous devez repasser les tests de certification, vous devez associer votre appareil après avoir commencé les tests.
Développement
Si vous devez effectuer un nouveau test pour le développement, vous pouvez utiliser l'appareil existant sans l'associer à nouveau.
Dépannage
L'appareil mis en service n'apparaît pas dans la suite de test
Si vous avez associé un appareil à un ID fournisseur (VID) et un ID produit (PID) de test, mais qu'il ne s'affiche pas lorsque vous essayez de tester l'appareil avec la suite de test dans Developer Console, cela est probablement dû à l'utilisation de la même combinaison VID et PID de test pour 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é le bon appareil, vous pouvez définir les informations sur le fabricant et le 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érifier 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 de votre appareil doit correspondre à celle saisie dans votre projet Developer Console.
- Les VID
0xFFF1à0xFFF4sont réservés aux tests. Ils peuvent être utilisés pour les tests de mise en service et de contrôle de base, 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 voir le VID/PID de l'appareil de balisage dans le champ Service Data (Données de service).
Dans cette capture d'écran de la version Android de nRF Connect, vous pouvez voir que le VID/PID est listé comme 5A23FFFE à partir du quatrième octet du champ Service Data (Données de 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 ordre petit endian,mais les valeurs VID/PID que vous saisissez dans votre projet Developer Console sont en ordre grand endian.
Vérifiez que les valeurs et le format appropriés ont été saisis dans votre projet Actions Console en fonction de ce que le sniffeur Bluetooth affiche.
Pour les valeurs de l'exemple de capture d'écran, les valeurs VID et PID dans Developer Console sont respectivement 235A et FEFF.