Cómo probar y depurar tu app

Te recomendamos que compiles tu app de entrega local con los pasos que se describen antes y, luego, probar la integración de tu casa inteligente en tu propio entorno de hosting siguiendo estos pasos:

  1. En tu entorno de hosting, publica la página HTML que ejecuta la app de entrega local. En el siguiente fragmento, se muestra un ejemplo de un archivo HTML estático que ejecuta tu app de entrega 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. Prueba el control de dispositivos.

  3. Cómo depurar desde Chrome. Usa puntos de interrupción y registros para solucionar problemas de integración.

  4. Modifica y compila tu código de TypeScript y, luego, repite estos pasos.

Al repetir este proceso de compilación y prueba, puedes ver tus cambios en acción detectar y depurar errores con tu código de manera más rápida y fácil.

Control de dispositivos de prueba

En la Consola de Actions, debes especificar la URL de tu app web, publica el código HTML que se carga en el dispositivo Google Home o Google Nest durante la entrega local.

Para probar el control de dispositivos con entrega local, sigue estos pasos:

Chrome

  1. Abre tu proyecto de casa inteligente en la Consola de Actions.
  2. En el panel de navegación de la izquierda, haz clic en Acciones.
  3. En Configura el SDK de Local Home (opcional) > Ingresa tu URL de prueba para Chrome y especifica el servidor de desarrollo. URL que publica el HTML que ejecuta tu app de entrega local.
  4. Haz clic en Guardar. Google puede tardar hasta 30 minutos propagar los cambios de la consola.
  5. Reinicia el dispositivo Google Home o Google Nest de prueba.
  6. Emite un comando a tu dispositivo inteligente. Por ejemplo, si tu dispositivo implementa la característica OnOff, puedes decir: "Hey Google, enciende las luces".

Node.js

  1. Abre tu proyecto de casa inteligente en la Consola de Actions.
  2. En el panel de navegación de la izquierda, haz clic en Acciones.
  3. En Configura el SDK de Local Home (opcional) > Ingresa tu URL de prueba para Node y especifica el servidor de desarrollo. URL que publica el JavaScript que ejecuta tu app de entrega local.
  4. Haz clic en Guardar. Google puede tardar hasta 30 minutos propagar los cambios de la consola.
  5. Reinicia el dispositivo Google Home o Google Nest de prueba.
  6. Emite un comando a tu dispositivo inteligente. Por ejemplo, si tu dispositivo implementa la característica OnOff, puedes decir: "Hey Google, enciende las luces".

Para obtener más información sobre el entorno de ejecución que usa tu dispositivo, consulta Aplicaciones compatibles dispositivos.

Depuración desde Chrome

Puedes depurar tu app de entrega local con Chrome Herramientas para desarrolladores. Antes de realizar la depuración, asegúrate de que que tu entorno esté configurado correctamente:

  • Configuraste tu URL de desarrollo en la consola como una URL a la que puede acceder el dispositivo Google Home o Google Nest (ya sea en la red de área local o a través de Internet)
  • La máquina está conectada a la misma red de área local que Dispositivo Google Home o Google Nest que estás probando.
  • Tu red no bloquea paquetes entre dispositivos.
  • Accediste con la misma Cuenta de Google en la Consola de Actions. en el dispositivo Google Home o Google Nest.
  • Actualizaste la respuesta de SYNC en tu nube. la entrega de datos. Debería mostrar al menos un valor válido en el campo otherDeviceIds.
  • Ingresaste la configuración de análisis correcta información en la Consola de Actions.

Para conectar tu app de entrega local al depurador de Herramientas para desarrolladores de Chrome, haz lo siguiente: sigue estos pasos:

Chrome

  1. En tu máquina de desarrollo local, instala y, luego, inicia el archivo Navegador Google Chrome.
  2. Inicia el inspector de Chrome en el campo de dirección del navegador Chrome. ingresando: chrome://inspect#devices. Deberías ver una lista de dispositivos en la página, y el archivo HTML debería aparecer debajo del nombre de la prueba dispositivo Google Home o Google Nest.
  3. Haz clic en el vínculo azul de inspección debajo de tu código HTML para iniciar las Herramientas para desarrolladores de Chrome. Cambia a la pestaña Consola. La plataforma de Local Home genera la versión de tu app y el SDK de Local Home. en el registro de la consola. Si ves el registro, significa que Google tiene cargaron correctamente tu app y puedes conectarte a ella. De lo contrario, reinicia el dispositivo Google Home o Google Nest.
  4. Figura 1: App de entrega local en chrome://inspect.

Node.js

  1. En tu máquina de desarrollo local, instala y, luego, inicia el archivo Navegador Google Chrome.
  2. Determina la dirección IP local de tu dispositivo de prueba.
  3. Inicia el inspector de Chrome en el campo de dirección del navegador Chrome. ingresando: chrome://inspect#devices.
  4. Selecciona Configurar... para abrir la Configuración de descubrimiento de objetivos.
  5. Figura 2: Configuración de descubrimiento de objetivos en chrome://inspect.
  6. Ingresa DEVICE_IP_ADDRESS:9222 en la lista. Haz clic en Listo.
  7. Haz clic en el vínculo de inspección azul debajo de tu secuencia de comandos para iniciar las Herramientas para desarrolladores de Chrome. Cambia a la pestaña Consola. La plataforma de Local Home genera la versión de tu app y el SDK de Local Home. en el registro de la consola. Si ves el registro, significa que Google tiene cargaron correctamente tu app y puedes conectarte a ella. De lo contrario, reinicia el dispositivo Google Home o Google Nest.

Para obtener más información sobre el entorno de ejecución que usa tu dispositivo, consulta Aplicaciones compatibles Dispositivos.

Sugerencias de depuración

Estos son algunos aspectos adicionales que debes tener en cuenta durante la depuración:

  • No vincules varios dispositivos Google Home o Google Nest a tu cuenta de prueba en el mismo red local. No podrás controlar a qué dispositivo Google Home o Google Nest se orienta con los comandos de entrega local.
  • Actualiza la página en Herramientas para desarrolladores de Chrome para volver a cargar el contenedor de la app de entrega local. con el código más reciente de tu URL de desarrollo. Esto no restablece el La plataforma de Local Home, que puede ser necesaria para volver a activar los intents de plataforma (como IDENTIFY) en tu app de entrega local. Para restablecer la plataforma de Local Home, reinicia tu dispositivo Google Home o Google Nest.
  • Verifica que la app de JavaScript se cargue sin errores. Para ello, verifica en la sección de la consola de la página de Herramientas para desarrolladores. Si hay algún problema, verás un mensaje como este: Uncaught TypeError: Cannot read property ‘open’ of null.
  • El verificationId de la respuesta de IDENTIFY debe coincidir con uno de los otherDeviceIds de la respuesta de SYNC.
  • Para el controlador EXECUTE, asegúrate de que los comandos HTTP, TCP o UDP se puedan recibidos por el dispositivo y funcionen como se espera.
  • Asegúrate de mostrar un Promise de los controladores.
  • Evita mantener el estado global en la memoria. Consulta Ciclo de vida de la aplicación.
  • Los errores que arroja tu app de entrega local aparecerán en tu proyecto registros de errores.

Preparación y lanzamiento para producción

Cuando tengas todo listo para iniciar la Acción de tu casa inteligente, sigue estos pasos:

  1. Abre una terminal. En el directorio de tu proyecto, ejecuta el comando npm run build. Este comando genera los siguientes paquetes de JavaScript para tu app dentro de la dist:
    project-directory/
    └── dist
     ├── web
     │    └── bundle.js
     └── node
          └── bundle.js
    
  2. En la consola, sube tu app de JavaScript haciendo clic en Develop > Actions. En la sección Configura el SDK de Local Home, haz clic en Subir. Archivos JavaScript
    Figura 3: Sube tu app de JavaScript.
  3. En el cuadro de diálogo Subir archivos, sube los archivos de paquete que creaste anteriormente. de red. Asegúrate de subir ambas versiones de los archivos de paquete (Node y Web) de modo que tu acción esté configurada para funcionar correctamente en todos los entornos de ejecución entornos compatibles con la entrega local.
    1. Sube tu JavaScript orientado a Node.js: Sube el bundle.js. del directorio dist/node.
    2. Subir tu JavaScript orientado a Chrome (navegador): sube el archivo bundle.js del directorio dist/web.
  4. Prueba tu Acción en un dispositivo compatible con el Asistente para verificar que se comporte como se espera en un entorno de producción. Para obtener más información, consulta Prueba y comparte la Acción de tu casa inteligente.
  5. Cuando estés conforme con el funcionamiento de tu Acción, envíala a Google para implementación de producción siguiendo las instrucciones de Lanza tu Acción de casa inteligente. Esta incluye completar los pasos de la autoprueba y la solicitud de certificación.