Testare l'app ed eseguirne il debug

Ti consigliamo di creare l'app di evasione degli ordini locale seguendo i passaggi descritti in precedenza, quindi di testare l'integrazione della casa intelligente nel tuo ambiente di hosting seguendo i passaggi che seguono:

  1. Nel tuo ambiente di hosting, pubblica la pagina HTML che esegue la tua app di evasione degli ordini locale. Lo snippet seguente mostra un esempio di file HTML statico che esegue la tua app di evasione degli ordini 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 del dispositivo.

  3. 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 questa procedura di compilazione e test, puoi vedere le modifiche in azione rapidamente e più facilmente rilevare e eseguire il debug dei problemi relativi al codice.

Testare il controllo del dispositivo

Nella console di azione, devi specificare l'URL della tua app web, che serve il codice HTML caricato sul dispositivo Google Home o Google Nest durante l'evasione locale.

Per testare il controllo del dispositivo con l'evasione locale:

Chrome

  1. Apri il progetto per la smart home nella console Actions.
  2. Nel menu di navigazione a sinistra, fai clic su Azioni.
  3. In Configura l'SDK Home locale (facoltativo) > Inserisci l'URL di test per Chrome, specifica l'URL del server di sviluppo che serve il codice HTML che esegue l'app di evasione degli ordini locale.
  4. Fai clic su Salva. Potrebbero essere necessari fino a 30 minuti prima che Google propaghi le modifiche alla console.
  5. Riavvia il dispositivo Google Home o Google Nest di prova.
  6. Dai un comando al tuo smart device. Ad esempio, se il tuo dispositivo implementa la caratteristica OnOff, puoi dire "Hey Google, accendi le luci".

Node.js

  1. Apri il progetto per la smart home nella console Actions.
  2. Nel menu di navigazione a sinistra, fai clic su Azioni.
  3. In Configura l'SDK della casa locale (facoltativo) > Inserisci l'URL di test per il nodo, specifica l'URL del server di sviluppo che pubblica il codice JavaScript che esegue l'app di distribuzione locale.
  4. Fai clic su Salva. Potrebbero essere necessari fino a 30 minuti prima che Google propaghi le modifiche alla console.
  5. Riavvia il dispositivo Google Home o Google Nest di prova.
  6. Dai un comando al tuo smart device. Ad esempio, se il tuo dispositivo implementa la caratteristica OnOff, puoi dire "Hey Google, accendi le luci".

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

Eseguire il debug da Chrome

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

  • Hai impostato l'URL di sviluppo nella console su un URL raggiungibile dal dispositivo Google Home o Google Nest (nella rete locale o tramite internet),
  • Il computer è connesso alla stessa rete di area locale 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 alla console Actions e sul dispositivo Google Home o Google Nest.
  • Hai aggiornato la risposta SYNC nel cloud fulfillment. Deve restituire almeno un valore valido nel campo otherDeviceIds.
  • Hai inserito le informazioni corrette sulla configurazione della scansione nella console di Actions.

Per connettere l'app di distribuzione 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. Nella pagina dovrebbe essere visualizzato un elenco di dispositivi e il file HTML dovrebbe essere elencato sotto il nome del dispositivo Google Home o Google Nest di prova.
  3. Fai clic sul link di ispezione blu sotto il codice HTML per avviare Chrome DevTools. Passa alla scheda Console. La piattaforma Local Home genera 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 degli ordini 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 tuo 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 di ispezione blu 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 la tua app correttamente e può connettersi all'app. In caso contrario, riavvia il dispositivo Google Home o Google Nest.

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

Suggerimenti di debug

Ecco alcuni aspetti aggiuntivi da tenere presenti durante il debug:

  • Non collegare più dispositivi Google Home o Google Nest al tuo account di prova sulla stessa rete locale. Non potrai controllare quale dispositivo Google Home o Google Nest viene scelto come target con i comandi di evasione degli ordini locali.
  • Aggiorna la pagina in Chrome DevTools per ricaricare il container dell'app di distribuzione locale con il codice più recente dell'URL di sviluppo. Questa operazione non reimposta la piattaforma Home locale, cosa che potrebbe essere necessario per riattivare gli intent della piattaforma (ad esempio IDENTIFY) nella tua app di distribuzione locale. Per reimpostare la piattaforma Home locale, 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, verrà visualizzato un messaggio simile al seguente: Uncaught TypeError: Cannot read property ‘open’ of null.
  • verificationId della risposta IDENTIFY deve corrispondere a uno dei otherDeviceIds della risposta SYNC.
  • Per l'handler EXECUTE, assicurati che i comandi HTTP, TCP o UDP possano essere ricevuti dal dispositivo e funzionino come previsto.
  • Assicurati di restituire un Promise dagli handler.
  • Evita di mantenere lo stato globale in memoria. Consulta Ciclo di vita dell'applicazione.
  • Gli errori generati dall'app di evasione degli ordini 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 console, carica l'app JavaScript facendo clic su Sviluppa > Azioni. Nella sezione Configura SDK Home locale, fai clic su Carica file JavaScript.
    Figura 3: carica l'app JavaScript.
  3. Nella finestra di dialogo Carica file, carica i file del pacchetto che hai generato in precedenza. Assicurati di caricare entrambe le versioni dei file del bundle (Node, web) in modo che l'azione sia configurata per funzionare correttamente in tutti gli ambienti di runtime supportati dal completamento locale.
    1. Carica il tuo Node.js di targeting JavaScript: carica il file bundle.js dalla directory dist/node.
    2. Carica il file JavaScript indirizzato a 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 funzioni come previsto in un ambiente di produzione. Per scoprire di più, vedi Testare e condividere l'azione per la smart home.
  5. Quando il funzionamento dell'azione ti soddisfa, inviala a Google per il deployment in produzione seguendo le istruzioni riportate in Lanciare l'azione per la smart home. Ciò include il completamento dei passaggi dell'autotest e della richiesta di certificazione.
Indietro
Implementa l'app per l'evasione degli ordini locale