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 e detectar e depurar problemas com seu código com mais facilidade.

Testar o controle do dispositivo

No Action console, é necessário especificar o URL do seu app da Web, que serve o HTML carregado no dispositivo Google Home ou Google Nest durante o fulfillment local.

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

Chrome

  1. Abra o projeto da casa inteligente no console das Actions.
  2. No painel de navegação à esquerda, clique em Ações.
  3. Em Configurar o SDK local do Google Home (opcional) > Digite o URL de teste do Chrome, especifique o URL do servidor de desenvolvimento que serve o HTML que executa seu app de fulfillment local.
  4. Clique em Salvar. Pode levar até 30 minutos para que o Google faça a propagação das mudanças no console.
  5. Reinicie o dispositivo Google Home ou Google Nest de teste.
  6. 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. Abra o projeto da casa inteligente no console das Actions.
  2. No painel de navegação à esquerda, clique em Ações.
  3. Em Configurar o SDK local da casa (opcional) > Digite o URL de teste para o nó, especifique o URL do servidor de desenvolvimento que serve o JavaScript que executa seu app de fulfillment local.
  4. Clique em Salvar. Pode levar até 30 minutos para que o Google faça a propagação das mudanças no console.
  5. Reinicie o dispositivo Google Home ou Google Nest de teste.
  6. 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:

  • Você definiu o URL de desenvolvimento no console para um URL acessível pelo dispositivo Google Home ou Google Nest (na rede local ou pela Internet).
  • Sua máquina está conectada à mesma rede local do dispositivo Google Home ou Google Nest que você está testando.
  • Sua rede não bloqueia pacotes entre dispositivos.
  • Você fez login com a mesma Conta do Google no Actions Console e no dispositivo Google Home ou Google Nest.
  • Você atualizou a resposta SYNC no fulfillment na nuvem. Ele precisa retornar pelo menos um valor válido no campo otherDeviceIds.
  • Você inseriu as informações de configuração de verificação corretas no console do Actions.

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 o 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 a versão do SDK do Local Home no registro 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 mostra a versão do app e do SDK do Local Home no registro 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 considerar 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.
  • Refresque a página no Chrome DevTools 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 da página do DevTools. Se houver um problema, uma mensagem como esta será exibida: 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 erros 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. No console, faça upload do app JavaScript clicando em Develop > Actions. Na seção Configurar o SDK do Google Home, clique em Fazer upload de arquivos JavaScript.
    Figura 3: faça o upload do app JavaScript.
  3. Na caixa de diálogo Upload files, faça upload dos arquivos de pacote gerados anteriormente. Faça o upload das duas versões dos arquivos de pacote (Node e Web) para que a ação seja configurada para funcionar corretamente em todos os ambientes de execução compatíveis com a entrega 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