Testare l'app ed eseguirne il debug

Ti consigliamo di creare l'app di evasione locale seguendo i passaggi descritti in precedenza, quindi di testare l'integrazione della 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 evasione locale. Lo snippet seguente mostra un esempio di file HTML statico che esegue l'app di evasione 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. Testa il controllo dei dispositivi.

  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, poi ripeti questi passaggi.

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

Testare il controllo dei dispositivi

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

Per testare il controllo dei dispositivi con l'evasione locale:

Chrome

  1. Nella pagina Configurazione dell'integrazione cloud-to-cloud in Google Home Developer Console, scorri fino a Evasione locale e attiva l'impostazione.
  2. In URL di test > URL di test per Chrome, specifica l'URL del server di sviluppo che pubblica l'HTML che esegue l'app di evasione locale.
  3. Fai clic su Salva. Potrebbero essere necessari fino a 30 minuti prima che Google propaghi le modifiche alla console.
  4. Riavvia il dispositivo di test Google Home o Google Nest.
  5. Emettere un comando allo smart device. Ad esempio, se il tuo dispositivo implementa il tratto OnOff, potresti dire "Hey Google, accendi le luci".

Node.js

  1. Nella pagina Configurazione di Google Home Developer Console, scorri fino a Evasione locale e attiva l'impostazione.
  2. In URL di test > URL di test per Node, specifica l'URL del server di sviluppo che gestisce il codice JavaScript che esegue l'app di evasione locale.
  3. Fai clic su Salva. Potrebbero essere necessari fino a 30 minuti prima che Google propaghi le modifiche alla console.
  4. Riavvia il dispositivo di test Google Home o Google Nest.
  5. Emettere un comando allo smart device. Ad esempio, se il tuo dispositivo implementa il tratto OnOff, potresti dire "Hey Google, accendi le luci".

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

Eseguire il debug da Chrome

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

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

Chrome

  1. Nella macchina di sviluppo locale, installa e avvia il browser Google Chrome.
  2. Nel campo dell'indirizzo del browser Chrome, avvia lo strumento di ispezione di Chrome inserendo: chrome://inspect#devices. Dovresti visualizzare un elenco di dispositivi nella pagina e il tuo file HTML dovrebbe essere elencato sotto il nome del tuo dispositivo Google Home o Google Nest di test.
  3. Fai clic sul link blu Ispeziona sotto l'HTML per avviare Chrome DevTools. Passa alla scheda Console. La piattaforma Local Home restituisce la versione dell'app e la versione dell'SDK Local Home nel log della console. Se vedi il log, significa che Google ha caricato correttamente la tua app ed è in grado di connettersi. In caso contrario, riavvia il dispositivo Google Home o Google Nest.
    4. Figura 1: app di evasione locale in chrome://inspect.

Node.js

  1. Nella macchina di sviluppo locale, installa e avvia il browser Google Chrome.
  2. Determina l'indirizzo IP locale del dispositivo di test.
  3. Nel campo dell'indirizzo del browser Chrome, avvia lo strumento di ispezione di Chrome inserendo: chrome://inspect#devices.
  4. Seleziona Configura… per aprire le impostazioni di rilevamento dei target.
    5. Figura 2: Impostazioni di rilevamento dei target in chrome://inspect.
  5. Inserisci DEVICE_IP_ADDRESS:9222 nell'elenco e fai clic su Fine.
  6. Fai clic sul link blu Esamina sotto lo script per avviare Chrome DevTools. Passa alla scheda Console. La piattaforma Local Home restituisce la versione dell'app e la versione dell'SDK Local Home nel log della console. Se vedi il log, significa che Google ha caricato correttamente la tua app ed è in grado di connettersi. In caso contrario, riavvia il dispositivo Google Home o Google Nest.

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

Suggerimenti per il debug

Ecco alcune cose aggiuntive da tenere a mente 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 Google Nest è il target con i comandi di evasione locale.
  • Aggiorna la pagina in Chrome DevTools per ricaricare il contenitore dell'app di evasione 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 riattivare gli intent della piattaforma (ad esempio IDENTIFY) nell'app di evasione 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. In caso di problemi, vedrai un messaggio come questo: "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 evasione locale verranno visualizzati nei log degli errori del progetto.

Preparare ed eseguire il 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 di Google Home Developer Console, scorri fino a Evasione locale e attiva l'impostazione.
  3. Utilizzando i pulsanti Carica JavaScript, carica i file del bundle che hai generato in precedenza.
    Figura 3: carica l'app JavaScript.
    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 dall'evasione locale.
    1. Carica il targeting JavaScript Node.js: carica il file bundle.js dalla directory dist/node.
    2. Carica il targeting JavaScript 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 saperne di più, consulta Testare e condividere l'Azione per la smart home.
  5. Quando sei soddisfatto del funzionamento della tua azione, inviala a Google per l'implementazione in produzione seguendo le istruzioni riportate in Avviare l'azione per la smart home. Ciò include il completamento dei passaggi del test autonomo e della richiesta di certificazione.
Indietro
Implementa l'app per l'evasione degli ordini locale