Testare l'app ed eseguirne il debug

Ti consigliamo di creare l'app di fulfillment locale seguendo i passaggi descritti in precedenza, quindi di testare l'integrazione per la smart home nel tuo ambiente di hosting seguendo questi passaggi:

1. Nel tuo ambiente di hosting, pubblica la pagina HTML che esegue l'app di fulfillment locale. Lo snippet seguente mostra un esempio di file HTML statico che esegue l'app di fulfillment locale.

   <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. Controllo dei dispositivi di test.

3. Esegui il debug da Chrome. Utilizza i punti di interruzione e i log per risolvere i problemi di integrazione.

4. Modifica e compila il codice TypeScript, quindi ripeti questi passaggi.

Ripetendo questo processo di creazione e test, puoi vedere rapidamente le modifiche in azione per eseguire il debug dei problemi con il codice.

Controllo dei dispositivi di test

Nel Google Home Developer Console, devi specificare l'URL della tua app web, che fornisce l'HTML caricato sul dispositivo Google Home o Google Nest durante l'evasione locale.

Per testare il controllo dei dispositivi con l'evadere i comandi in locale, segui questi passaggi:

Per maggiori dettagli sul runtime utilizzato dal tuo dispositivo, consulta Dispositivi supportati.

Esegui il debug da Chrome

Puoi eseguire il debug dell'app di fulfillment locale utilizzando Chrome DevTools. Prima di eseguire il debug, assicurati che l'ambiente sia configurato correttamente:

• Hai impostato l'URL di sviluppo nella console su un URL raggiungibile dal dispositivo Google Home o Google Nest (tramite la local area network o internet).
• La tua macchina è connessa alla stessa local area network del dispositivo Google Home o Google Nest che stai testando.
• La tua rete non blocca i pacchetti tra i dispositivi.
• Hai eseguito l'accesso con lo stesso Account Google su Google Home Developer Console e sul dispositivo Google Home o Google Nest.
• Hai aggiornato la risposta SYNC nel tuo fulfillment cloud. Dovrebbe restituire almeno un valore valido nel campo otherDeviceIds.
• Hai inserito le informazioni di configurazione dell'analisi corrette in Google Home Developer Console.

Per connettere l'app di fulfillment locale al debugger di Chrome DevTools, segui questi passaggi:

Per maggiori dettagli sul runtime utilizzato dal tuo dispositivo, consulta Dispositivi supportati.

Suggerimenti di debug

Ecco alcuni aspetti aggiuntivi da tenere presente durante il debug:

• Non collegare più dispositivi Google Home o Google Nest al tuo account di test sulla stessa rete locale. Non potrai controllare quale dispositivo Google Home o dispositivo Google Nest è il target dei comandi di fulfillment locale.
• Aggiorna la pagina in Chrome DevTools per ricaricare il container dell'app di fulfillment locale con il codice più recente dell'URL di sviluppo. In questo modo non viene reimpostata la piattaforma Local Home, il che potrebbe essere necessario per attivare nuovamente gli intent della piattaforma (come IDENTIFY) nell'app di fulfillment locale. Per reimpostare la piattaforma Local Home, riavvia il dispositivo Google Home o Google Nest.
• Verifica che l'app JavaScript venga caricata senza errori. Per farlo, controlla la sezione della console della pagina DevTools. Se si verifica un problema, verrà visualizzato un messaggio simile al seguente: "Uncaught TypeError: Cannot read property 'open' of null".
• Il valore verificationId della risposta IDENTIFY deve corrispondere a uno dei valori otherDeviceIds della risposta SYNC.
• Per il gestore EXECUTE, assicurati che i comandi HTTP, TCP o UDP possano essere ricevuti dal dispositivo e funzionino come previsto.
• Assicurati di restituire un Promise dai gestori.
• Evita di mantenere lo stato globale in memoria. Vedi Ciclo di vita dell'applicazione.
• Gli errori generati dall'app di fulfillment locale verranno visualizzati nei log degli errori del progetto.

Preparazione e lancio in produzione

Quando è tutto pronto per lanciare l'Azione per la smart home, segui questi passaggi:

1. Apri un terminale. Nella directory del progetto, esegui il comando npm run build. Questo comando genera i seguenti bundle JavaScript per la tua app nella directory dist:

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

2. Nella pagina Configurazione della Google Home Developer Console, scorri fino a Fulfillment locale e attiva l'impostazione.
3. Utilizzando i pulsanti Carica JavaScript, carica i file del bundle che hai generato in precedenza.

   

   Assicurati di caricare entrambe le versioni dei file bundle (Node, Web) in modo che l'Azione sia configurata per funzionare correttamente in tutti gli ambienti di runtime supportati dal fulfillment locale.
   1. Carica il Node.js di targeting JavaScript: carica il file bundle.js dalla directory dist/node.
   2. Carica il file JavaScript per il targeting di Chrome (browser): carica il file bundle.js dalla directory dist/web.
4. Testa l'Azione su un dispositivo con l'assistente integrato per verificare che si comporti come previsto in un ambiente di produzione. Per scoprire di più, consulta Testa e condividi l'Azione per la smart home.
5. Quando l'Azione funziona come previsto, inviala a Google per il deployment in produzione seguendo le istruzioni riportate in Lancia l'Azione per la smart home. Ciò include il completamento dei passaggi di diagnostica automatica e richiesta di certificazione.