Solución de problemas

App de ejemplo

Si tienes problemas cuando usas las APIs de Home, puedes recopilar registros para depurar aún más. Para recopilar registros del dispositivo móvil, se requiere Xcode. Si necesitas asistencia de Google, recopila los registros del dispositivo iOS y del concentrador, y abre un ticket en el sistema de seguimiento de problemas con la información y los registros pertinentes asociados.

Cómo recopilar registros de iOS

Tu dispositivo móvil debe estar conectado a tu máquina local para todos los pasos que involucren Xcode.

Los registros de la app y del SDK se muestran y se pueden recopilar directamente en la consola de Xcode. Cuando tu dispositivo móvil está conectado a tu máquina local y ejecutas la aplicación a través de Xcode, la consola captura y transmite automáticamente los registros de salida estándar (stdout) y error estándar (stderr) tanto de la capa de la aplicación como del SDK de Home integrado. Esto proporciona una forma sencilla de supervisar los procesos de inicialización en tiempo real, las interacciones con la API y los eventos del SDK durante el desarrollo y la depuración.

Cómo recopilar registros de extensiones desde Xcode

Si tienes problemas cuando usas las APIs de Home, puedes recopilar registros para depurar aún más.

1. En Xcode, ve a Debug en la barra de menú superior y haz clic en Attach to Process by PID or Name.

   

2. En PID o nombre del proceso, selecciona MatterExtension y haz clic en Adjuntar.

   

3. Verás el mensaje Waiting to attach to MatterAddDeviceExtension on iPhone si haces clic en la esquina superior derecha.

   

4. Haz clic en la pestaña y selecciona MatterAddExtension.

   

5. La consola registrará el registro de la extensión.

Sherlog: Seguimiento de eventos en varias pilas

Sherlog es un servicio de seguimiento en tiempo real que proporciona una vista integral de las interacciones entre la infraestructura de Google y los servicios en la nube de los socios.

Requisito previo: El seguimiento requiere el uso de una cuenta compartida y coordinada por Google (p.ej., una cuenta de demostración o registrada en GReg).

Propósito principal: Depurar defectos funcionales y problemas de integración de nube a nube (C2C) (p.ej., errores de vinculación de cuentas o estados incorrectos del dispositivo) sin necesidad de cambiar el código de producción.

Capacidades: Proporciona gráficos de llamadas a RPC completos, cargas útiles de solicitudes y respuestas, y metadatos para las intents de SYNC, EXECUTE, QUERY y vinculación de cuentas.

Registros del dispositivo central de Fuchsia

Con este método, puedes recopilar registros de los siguientes hubs de Fuchsia: * Google Nest Hub (2ª gen.) * Google Nest Hub Max

Para habilitar un centro para la recuperación de registros locales, haz lo siguiente:

1. Envía un correo electrónico con el número de serie y el modelo de tus dispositivos a tu administrador técnico de cuentas (TAM) de Google. Se encuentran en letras pequeñas debajo del dispositivo.
2. Una vez que se te incluya en la lista de entidades permitidas, debes habilitar la función. Para ello, sigue estos pasos:
   • En el centro, haz lo siguiente:
     1. Desliza el dedo hacia abajo desde la parte superior de la pantalla.
     2. Presiona el ícono de Configuración settings.
     3. Busca la versión de Fuchsia: En un Nest Hub (2ª gen.), ve a Información del dispositivo > Información técnica > Versión de Fuchsia.
     4. Presiona "Versión de Fuchsia" 7 veces. Esto habilitará las opciones para desarrolladores
     5. Volver al menú de nivel superior
     6. Presiona "Opciones para desarrolladores".
     7. Presiona "Registro de socios".
   • La función estará habilitada durante 24 horas. Después, vuelve a habilitar la función de registro a partir del paso 5.
3. Obtén la dirección IP de tu concentrador:
   • Desde la unidad central, si tiene pantalla, haz lo siguiente:
     1. Desliza el dedo hacia abajo desde la parte superior de la pantalla.
     2. Presiona el ícono de Configuración settings.
     3. Encuentra la dirección IP del dispositivo: En un Nest Hub (2ª gen.), ve a Información del dispositivo > Información técnica > Dirección IP.
   • En la app de Google Home (GHA) en tu teléfono, haz lo siguiente:
   • Presiona el dispositivo para que aparezca la página de detalles.
   • Presiona el ícono de Configuración settings para abrir la página de configuración.
   • Busca la dirección IP del dispositivo: Ve a Información del dispositivo > Información técnica > Dirección IP.
4. Para recuperar los registros del concentrador, deberás realizar una solicitud HTTP GET al concentrador desde una computadora que esté en la misma red Wi-Fi.
   • Ten en cuenta el puerto y la ruta de acceso del endpoint:

     curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
     

   • La conexión solo se puede mantener abierta durante un minuto, pero los datos recuperados del búfer suelen incluir eventos de los últimos 20 a 30 minutos.
     • Lo ideal es extraer los registros con este método inmediatamente después de completar un procedimiento de prueba para garantizar que el búfer contenga contenido pertinente para la prueba (similar a los informes de errores de Android).

Automatizaciones

Detección de bordes

Las automatizaciones del ecosistema de Google Home incluyen la detección de bordes, que es una lógica que verifica que un activador solo se active cuando hay un cambio de estado real, a diferencia de una actualización de estado que simplemente repite el estado anterior del dispositivo.

Por ejemplo, si encender una luz es un activador, la detección de bordes verifica que el activador solo se active si el dispositivo de luz pasa de apagado a encendido, en lugar de encendido a encendido (sin cambios).

La automatización no se comporta como se espera

Después de tener en cuenta la detección de bordes, si una automatización no se comporta como se espera, haz lo siguiente:

1. Verifica cada dispositivo para asegurarte de que funcione correctamente independientemente de la automatización.

2. Consulta el gráfico de automatización para comparar tu automatización con el DSL de automatización y revelar cualquier suposición potencialmente incorrecta de tu parte.

3. Observa el estado del dispositivo en la app de Google Home durante la ejecución de tu automatización.

4. Verifica que todos los dispositivos a los que hace referencia la automatización estén presentes en la estructura donde esperas que estén. Borrar un dispositivo del que depende una automatización puede tener consecuencias no deseadas. Consulta Impacto de la eliminación de dispositivos en las automatizaciones.

La automatización se ejecuta cuando no debería hacerlo

Si tu automatización se ejecuta cuando no debería, examina los criterios del activador. Es posible que sea necesario agregar lógica adicional para asegurarse de que un cambio de estado se capture solo una vez y active la automatización solo una vez.

La automatización no se compila

Asegúrate de que tu app contenga todas las importaciones necesarias, incluida cada clase correspondiente a los diferentes tipos de nodos, así como los rasgos a los que haces referencia.

La creación de la automatización no pasa la validación

Si la creación de la automatización no pasa la validación, un mensaje de advertencia o error proporciona información sobre el problema. Para obtener más información, consulta la referencia de ValidationIssueType.

OAuth

Si ya tienes un cliente de OAuth

Si ya tienes un cliente de OAuth verificado para una app publicada, puedes usar tu cliente de OAuth existente para probar las APIs de Home.

No es necesario registrar Google Home Developer Console para probar y usar las APIs de Home. Sin embargo, seguirás necesitando un registro de Developer Console aprobado para publicar tu app, incluso si tienes un cliente de OAuth verificado de otra integración.

Se aplican las siguientes consideraciones:

• Hay un límite de 100 usuarios cuando se usa un cliente de OAuth existente. Para obtener información sobre cómo agregar usuarios de prueba, consultaGenera el ID de cliente de OAuth. Independientemente de la verificación de OAuth, las APIs de Home imponen un límite de 100 usuarios que pueden otorgar permisos a tu aplicación. Esta limitación se levanta cuando se completa el registro de Developer Console.

• Developer Consoleregistro se debe enviar para su aprobación cuando esté todo listo para restringir las concesiones de tipos de dispositivos a través de OAuth en preparación para actualizar tu app con las APIs de Home.

En el caso de las apps de Google Cloud que aún no se verificaron con OAuth, los usuarios no pueden completar el flujo de OAuth hasta que se complete la verificación. Los intentos de otorgar permisos fallarán y arrojarán el siguiente error:

Access blocked: <Project Name> has not completed the Google verification process.