Testar e depurar o app

Recomendamos que você crie seu app de atendimento local usando as etapas descritas anteriormente e teste a integração de casa inteligente no seu próprio ambiente de hospedagem seguindo estas etapas:

  1. No seu próprio ambiente de hospedagem, disponibilize a página HTML que executa o app de fulfillment local. O snippet a seguir mostra um exemplo de um arquivo HTML estático que executa o app de fulfillment 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. Testar o controle do dispositivo.

  3. Depurar no Chrome. Use pontos de interrupção e registros para resolver problemas na integração.

  4. Modifique e compile o código TypeScript e repita estas etapas.

Repetindo esse processo de build e teste, você pode conferir as mudanças em ação rapidamente para ajudar a depurar problemas no código.

Testar o controle do dispositivo

No Google Home Developer Console, é necessário especificar o URL do seu app da Web, que serve o HTML carregado no dispositivo Google Home ou Google Nest durante a execução local.

Para testar o controle do dispositivo com fulfillment local, siga estas etapas:

Chrome

  1. Na página Configuração e configuração da integração entre nuvens no Google Home Developer Console, role a tela até Fulfillment local e ative a configuração.
  2. Em URLs de teste > URL de teste para o Chrome, especifique o URL do servidor de desenvolvimento que serve o HTML que executa seu app de atendimento local.
  3. Clique em Salvar. Pode levar até 30 minutos para que o Google faça a propagação das mudanças no console.
  4. Reinicie o dispositivo Google Home ou Google Nest de teste.
  5. Emita um comando para o dispositivo inteligente. Por exemplo, se o dispositivo implementar o recurso OnOff, você poderá dizer "Ok Google, acenda as luzes".

Node.js

  1. Na página Configuração e configuração do Google Home Developer Console, role a tela até Processamento local e ative a configuração.
  2. Em URLs de teste > URL de teste para o nó, especifique o URL do servidor de desenvolvimento que serve o JavaScript que executa seu app de fulfillment local.
  3. Clique em Salvar. Pode levar até 30 minutos para que o Google faça a propagação das mudanças no console.
  4. Reinicie o dispositivo Google Home ou Google Nest de teste.
  5. Emita um comando para o dispositivo inteligente. Por exemplo, se o dispositivo implementar o recurso OnOff, você poderá dizer "Ok Google, acenda as luzes".

Para mais detalhes sobre qual ambiente de execução é usado pelo seu dispositivo, consulte Dispositivos compatíveis.

Depurar no Chrome

É possível depurar seu app de fulfillment local usando o Chrome DevTools. Antes de depurar, verifique se o ambiente está configurado corretamente:

Para conectar o app de fulfillment local ao depurador do Chrome DevTools, siga estas etapas:

Chrome

  1. Na máquina de desenvolvimento local, instale e inicie o navegador Google Chrome.
  2. No campo de endereço do navegador Chrome, inicie o inspetor do Chrome digitando: chrome://inspect#devices. Você vai encontrar uma lista de dispositivos na página, e seu arquivo HTML vai aparecer abaixo do nome do dispositivo Google Home ou Google Nest de teste.
  3. Clique no link azul "Inspecionar" abaixo do HTML para iniciar o Chrome DevTools. Alterne para a guia Console. A plataforma Local Home gera a versão do app e do SDK do Local Home no log do console. Se o registro aparecer, significa que o Google carregou seu app e pode se conectar a ele. Caso contrário, reinicie o dispositivo Google Home ou Google Nest.
    4. Figura 1: app de fulfillment local em chrome://inspect.

Node.js

  1. Na máquina de desenvolvimento local, instale e inicie o navegador Google Chrome.
  2. Determine o endereço IP local do dispositivo de teste.
  3. No campo de endereço do navegador Chrome, inicie o inspetor do Chrome digitando: chrome://inspect#devices.
  4. Selecione Configurar para abrir as Configurações de descoberta de destino.
    5. Figura 2: configurações de descoberta de destino em chrome://inspect.
  5. Insira DEVICE_IP_ADDRESS:9222 na lista e clique em Concluído.
  6. Clique no link azul "Inspecionar" abaixo do script para iniciar as Ferramentas para desenvolvedores do Chrome. Alterne para a guia Console. A plataforma Local Home gera a versão do app e do SDK do Local Home no log do console. Se o registro aparecer, significa que o Google carregou seu app e pode se conectar a ele. Caso contrário, reinicie o dispositivo Google Home ou Google Nest.

Para mais detalhes sobre qual ambiente de execução é usado pelo seu dispositivo, consulte Dispositivos compatíveis.

Dicas de depuração

Algumas outras coisas a serem consideradas durante a depuração:

  • Não vincule vários dispositivos Google Home ou Google Nest à sua conta de teste na mesma rede local. Não é possível controlar qual dispositivo Google Home ou Google Nest é direcionado com os comandos de fulfillment local.
  • Atualize a página nas Ferramentas para desenvolvedores do Chrome para recarregar o contêiner do app de fulfillment local com o código mais recente do URL de desenvolvimento. Isso não redefine a plataforma Local Home, que pode ser necessária para acionar novamente as intents da plataforma (como IDENTIFY) no app de atendimento local. Para redefinir a plataforma Local Home, reinicie o dispositivo Google Home ou Google Nest.
  • Verifique se o app JavaScript carrega sem erros. Para fazer isso, verifique a seção do console na página do DevTools. Se houver um problema, uma mensagem como esta vai aparecer: "Uncaught TypeError: Cannot read property 'open' of null".
  • O verificationId da resposta IDENTIFY precisa corresponder a um dos otherDeviceIds da resposta SYNC.
  • Para o gerenciador EXECUTE, verifique se os comandos HTTP, TCP ou UDP podem ser recebidos pelo dispositivo e funcionar conforme o esperado.
  • Retorne um Promise dos processadores.
  • Evite manter o estado global na memória. Consulte Ciclo de vida do aplicativo.
  • Os erros gerados pelo app de atendimento local vão aparecer nos registros de erro do projeto.

Preparar e lançar para produção

Quando estiver tudo pronto para lançar a ação de casa inteligente, siga estas etapas:

  1. Abra um terminal. No diretório do projeto, execute o comando npm run build. Esse comando gera os seguintes pacotes JavaScript para o app no diretório dist: 
    project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
  2. Na página Configuração e configuração do Google Home Developer Console, role até Fulfillment local e ative a configuração.
  3. Usando os botões Upload JavaScript, faça upload dos arquivos de pacote que você gerou anteriormente.
    Figura 3: fazer upload do app JavaScript.
    Faça upload das duas versões dos arquivos de pacote (Node, Web) para que a ação seja configurada para funcionar corretamente em todos os ambientes de execução com suporte a fulfillment local.
    1. Faça upload do seu JavaScript com segmentação para Node.js: faça upload do arquivo bundle.js no diretório dist/node.
    2. Faça upload do seu JavaScript para segmentação do Chrome (navegador): faça upload do arquivo bundle.js do diretório dist/web.
  4. Teste a ação em um dispositivo com o Google Assistente para verificar se ela se comporta como esperado em um ambiente de produção. Para saber mais, consulte Testar e compartilhar sua ação de casa inteligente.
  5. Quando estiver satisfeito com o funcionamento da ação, envie-a ao Google para implantação em produção seguindo as instruções em Lançar sua ação de casa inteligente. Isso inclui concluir as etapas de autoteste e solicitação de certificação.
Anterior
Implementar o app de fulfillment local