Tester et déboguer votre application

Nous vous recommandons de créer votre application de traitement local en suivant les étapes décrites précédemment, puis de tester votre intégration de maison connectée dans votre propre environnement d'hébergement en procédant comme suit :

1. Dans votre propre environnement d'hébergement, diffusez la page HTML qui exécute votre application de traitement local. L'extrait de code suivant montre un exemple de fichier HTML statique qui exécute votre application de traitement local.

   <html>
     <head>
       <!-- Local Home SDK -->
       <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
       <!-- Local app under development -->
       <script src="local_execution.js"></script>
     </head>
   
   </html>

2. Testez le contrôle de l'appareil.

3. Déboguer depuis Chrome Utilisez des points d'arrêt et des journaux pour résoudre les problèmes liés à votre intégration.

4. Modifiez et compilez votre code TypeScript, puis répétez ces étapes.

En répétant ce processus de compilation et de test, vous pouvez voir rapidement vos modifications en action pour vous aider à déboguer les problèmes liés à votre code.

Contrôle des appareils de test

Dans le Google Home Developer Console, vous devez spécifier l'URL de votre application Web, qui diffuse le code HTML chargé sur l'appareil Google Home ou Google Nest lors de l'exécution locale.

Pour tester le contrôle des appareils avec le traitement local, procédez comme suit :

Pour en savoir plus sur l'environnement d'exécution utilisé par votre appareil, consultez Appareils compatibles.

.

Déboguer depuis Chrome

Vous pouvez déboguer votre application de traitement local à l'aide des outils pour les développeurs Chrome. Avant de pouvoir déboguer, assurez-vous que votre environnement est correctement configuré :

• Vous avez défini votre URL de développement dans la console sur une URL accessible par l'appareil Google Home ou Google Nest (sur le réseau local ou via Internet).
• Votre machine est connectée au même réseau local que l'appareil Google Home ou Google Nest que vous testez.
• Votre réseau ne bloque pas les paquets entre les appareils.
• Vous êtes connecté avec le même compte Google sur l'Google Home Developer Console et sur l'appareil Google Home ou Google Nest.
• Vous avez mis à jour la réponse SYNC dans votre fulfillment cloud. Elle doit renvoyer au moins une valeur valide dans le champ otherDeviceIds.
• Vous avez saisi les informations de configuration d'analyse correctes dans le fichier Google Home Developer Console.

Pour connecter votre application de traitement en local aux Outils pour les développeurs Chrome, procédez comme suit :

Pour en savoir plus sur l'environnement d'exécution utilisé par votre appareil, consultez Appareils compatibles.

Conseils de débogage

Voici quelques points supplémentaires à prendre en compte lors du débogage :

• N'associez pas plusieurs appareils Google Home ou Google Nest à votre compte de test sur le même réseau local. Vous ne pourrez pas contrôler l'appareil Google Home ou Google Nest ciblé par les commandes de traitement local.
• Actualisez la page dans les Outils pour les développeurs Chrome pour actualiser le conteneur de votre application de traitement local avec le dernier code de votre URL de développement. Cela ne réinitialise pas la plate-forme Local Home, ce qui peut être nécessaire pour redéclencher les intents de la plate-forme (comme IDENTIFY) dans votre application de traitement local. Pour réinitialiser la plate-forme Local Home, redémarrez votre appareil Google Home ou Google Nest.
• Vérifiez que votre application JavaScript se charge sans erreur. Pour ce faire, consultez la section "Console" de la page "Outils de développement". En cas de problème, un message de ce type s'affiche : "Uncaught TypeError: Cannot read property 'open' of null."
• La valeur verificationId de la réponse IDENTIFY doit correspondre à l'une des valeurs otherDeviceIds de la réponse SYNC.
• Pour le gestionnaire EXECUTE, assurez-vous que vos commandes HTTP, TCP ou UDP peuvent être reçues par votre appareil et qu'elles fonctionnent comme prévu.
• Veillez à renvoyer un Promise à partir des gestionnaires.
• Évitez de conserver l'état global en mémoire. Consultez Cycle de vie de l'application.
• Les erreurs générées par votre application de traitement en local s'afficheront dans les journaux d'erreurs de votre projet.

Préparer et lancer en production

Lorsque vous êtes prêt à lancer votre action pour la maison connectée, procédez comme suit :

1. Ouvrez un terminal. Dans le répertoire de votre projet, exécutez la commande npm run build. Cette commande génère les bundles JavaScript suivants pour votre application dans le répertoire dist :

   project-directory/
   └── dist
    ├── web
    │    └── bundle.js
    └── node
         └── bundle.js
   

2. Sur la page Configuration de la Google Home Developer Console, faites défiler la page jusqu'à Traitement local et activez le paramètre.
3. À l'aide des boutons Importer un fichier JavaScript, importez les fichiers de bundle que vous avez générés précédemment.

   

   Veillez à importer les deux versions des fichiers de bundle (Node, Web) afin que votre action soit configurée pour fonctionner correctement dans tous les environnements d'exécution compatibles avec l'exécution locale.
   1. Importez votre code JavaScript ciblant Node.js : importez le fichier bundle.js à partir du répertoire dist/node.
   2. Importez votre code JavaScript ciblant Chrome (navigateur) : importez le fichier bundle.js à partir du répertoire dist/web.
4. Testez votre action sur un appareil avec Assistant Google intégré pour vérifier qu'elle se comporte comme prévu dans un environnement de production. Pour en savoir plus, consultez Tester et partager votre action pour la maison connectée.
5. Lorsque vous êtes satisfait du fonctionnement de votre action, envoyez-la à Google pour un déploiement en production en suivant les instructions de la section Lancer votre action pour la maison connectée. Cela inclut les étapes de test automatique et de demande de certification.