Testar e depurar o app

Recomendamos que você crie seu app de fulfillment local usando as etapas descritas anteriormente e, em seguida, teste a integração da 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 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. Teste o controle do dispositivo.

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

  4. Modifique e compile o código do TypeScript. Depois, repita essas etapas.

Ao repetir esse processo de compilação e teste, você pode ver as mudanças em ação de forma rápida e fácil para detectar e depurar problemas no código.

Testar o controle do dispositivo

No console da ação, você precisa especificar o URL do app da Web, que veicula o HTML carregado no dispositivo Google Home ou Google Nest durante o fulfillment local.

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

Chrome

  1. Abra seu projeto de casa inteligente no Console do Actions.
  2. Na navegação à esquerda, clique em Ações.
  3. Em Configurar o SDK local do Google Home (opcional) > Insira seu URL de teste para o Chrome, especifique o URL do servidor de desenvolvimento que veicula o HTML que executa seu app de fulfillment local.
  4. Clique em Salvar. Pode levar até 30 minutos para o Google propagar as 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 a característica OnOff, você poderá dizer "Ok Google, acenda as luzes".

Node.js

  1. Abra seu projeto de casa inteligente no Console do Actions.
  2. Na navegação à esquerda, clique em Ações.
  3. Em Configurar o SDK local do Google Home (opcional) > Insira o URL de teste para o Node, especifique o URL do servidor de desenvolvimento que exibe o JavaScript que executa seu app de fulfillment local.
  4. Clique em Salvar. Pode levar até 30 minutos para o Google propagar as 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 a característica OnOff, você poderá dizer "Ok Google, acenda as luzes".

Para mais detalhes sobre qual ambiente de execução é usado pelo dispositivo, consulte Dispositivos com suporte.

.

Como depurar do 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 seu URL de desenvolvimento no console como um URL acessível pelo dispositivo Google Home ou Google Nest (na rede local ou pela Internet);
  • A 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 Console do Actions e no dispositivo Google Home ou Google Nest.
  • Você atualizou a resposta SYNC no seu fulfillment da nuvem. 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 seu 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 inserindo: chrome://inspect#devices. Uma lista de dispositivos vai aparecer 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 de inspeção azul abaixo do HTML para iniciar o Chrome DevTools. Alterne para a guia Console. A plataforma local do Home exibe a versão do seu app e do SDK local no registro do console. Se você vir o registro, isso significa que o Google carregou seu app com sucesso 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 inserindo: 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.
  6. Digite DEVICE_IP_ADDRESS:9222 na lista e clique em Concluído.
  7. Clique no link azul de inspeção abaixo do script para iniciar o Chrome DevTools. Alterne para a guia Console. A plataforma local do Home exibe a versão do seu app e do SDK local no registro do console. Se você vir o registro, isso significa que o Google carregou seu app com sucesso e pode se conectar a ele. Caso contrário, reinicie o dispositivo Google Home ou Google Nest.

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

Dicas de depuração

Algumas coisas adicionais a serem consideradas durante a depuração incluem:

  • Não vincule vários dispositivos Google Home ou Google Nest à conta de teste na mesma rede local. Não será possível controlar qual dispositivo Google Home ou Google Nest é segmentado com os comandos de fulfillment local.
  • Atualize 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, o que pode ser necessário para acionar novamente as intents da plataforma (como IDENTIFY) no app de fulfillment local. Para redefinir a plataforma local do Home, reinicie o dispositivo Google Home ou Google Nest.
  • Verifique se o app JavaScript carrega sem erros. Para isso, verifique a seção do console da página do DevTools. Se houver um problema, você verá uma mensagem como esta: 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 gerenciadores.
  • Evite manter o estado global na memória. Consulte Ciclo de vida do aplicativo.
  • Os erros gerados pelo app de fulfillment local vão aparecer nos registros de erros do projeto.

Preparar e lançar para produção

Para iniciar 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 seu app no diretório dist:
    project-directory/
    └── dist
     ├── web
     │    └── bundle.js
     └── node
          └── bundle.js
    
  2. No console, faça upload do seu app JavaScript clicando em Desenvolver > Ações. Na seção Configurar o SDK local do Home, clique em Fazer upload de arquivos JavaScript.
    Figura 3: upload do app JavaScript.
  3. Na caixa de diálogo Fazer upload de arquivos, faça o upload dos arquivos de pacote que você gerou anteriormente. Faça upload das duas versões dos arquivos do pacote (nó e Web) para que a ação seja configurada para funcionar corretamente em todos os ambientes de execução compatíveis com o fulfillment local.
    1. Faça upload do JavaScript segmentado para Node.js: faça upload do arquivo bundle.js do diretório dist/node.
    2. Faça upload do JavaScript segmentado pelo Chrome (navegador): faça upload do arquivo bundle.js do diretório dist/web.
  4. Teste a ação em um dispositivo com Google Assistente para verificar se ela se comporta como esperado em um ambiente de produção. Para saber mais, consulte Testar e compartilhar a ação de casa inteligente.
  5. Quando estiver tudo certo com a forma como a ação funciona, envie-a ao Google para implantação na produção, seguindo as instruções em Iniciar ação de casa inteligente. Isso inclui a conclusão das etapas de solicitação de autoteste e certificação.