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.

Testa il controllo dei dispositivi

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 il fulfillment locale, segui questi passaggi:

Chrome

  1. Nella pagina Configurazione dell'integrazione cloud-to-cloud nella Google Home Developer Console, scorri fino a Fulfillment locale e attiva l'impostazione.
  2. In URL di test > URL di test per Chrome, specifica l'URL del server di sviluppo che fornisce l'HTML che esegue l'app di fulfillment locale.
  3. Fai clic su Salva. La propagazione delle modifiche alla console da parte di Google potrebbe richiedere fino a 30 minuti.
  4. Riavvia il dispositivo Google Home o Google Nest di test.
  5. Dai un comando allo smart device. Ad esempio, se il tuo dispositivo implementa il tratto OnOff, puoi dire "Hey Google, accendi le luci".

Node.js

  1. Nella pagina Configurazione della Google Home Developer Console, scorri fino a Fulfillment locale e attiva l'impostazione.
  2. In URL di test > URL di test per Node, specifica l'URL del server di sviluppo che fornisce il codice JavaScript che esegue l'app di fulfillment locale.
  3. Fai clic su Salva. La propagazione delle modifiche alla console da parte di Google potrebbe richiedere fino a 30 minuti.
  4. Riavvia il dispositivo Google Home o Google Nest di test.
  5. Dai un comando allo smart device. Ad esempio, se il tuo dispositivo implementa il tratto OnOff, puoi dire "Hey Google, accendi le luci".

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:

Per connettere l'app di fulfillment 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 l'inspector 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 prova.
  3. Fai clic sul link blu Ispeziona sotto il codice 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. App di fulfillment locale elencata in Target remoto in Chrome Inspect
    Figura 1: app di fulfillment 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 l'inspector di Chrome inserendo: chrome://inspect#devices.
  4. Seleziona Configura… per aprire le Impostazioni di rilevamento target.
  5. Finestra di dialogo delle impostazioni di rilevamento dei target in Chrome Inspect
    Figura 2: impostazioni di rilevamento dei target in chrome://inspect.
  6. Inserisci DEVICE_IP_ADDRESS:9222 nell'elenco e fai clic su Fine.
  7. Fai clic sul link blu Ispeziona 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, 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, vedrai un messaggio simile al seguente: "Uncaught TypeError: Cannot read property 'open' of null".
  • Il verificationId della risposta IDENTIFY deve corrispondere a uno dei 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 di Google Home Developer Console, scorri fino a Fulfillment locale e attiva l'impostazione.
  3. Utilizzando i pulsanti Carica JavaScript, carica i file bundle che hai generato in precedenza.
    Pulsanti per caricare i bundle JavaScript per Node.js e Chrome nella console
    Figura 3: carica la tua 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 dal fulfillment locale.
    1. Carica il file JavaScript compatibile con Node.js: carica il file bundle.js dalla directory dist/node.
    2. Carica il file JavaScript compatibile con 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.