Cómo depurar una app de Wear OS

A fin de depurar tu app para Wear OS en un reloj físico, conecta la máquina de desarrollo al reloj con una conexión Wi-Fi o Bluetooth. De manera alternativa, si el reloj tiene un puerto USB, conéctate a través de USB.

También puedes probar flujos de trabajo que abarquen varios dispositivos, como un reloj y un teléfono, si tu app requiere esta compatibilidad. Si quieres obtener más información para configurar una conexión para pruebas, visita Cómo conectar un reloj a un teléfono.

Nota: Si no tienes un reloj físico, también puedes probar y ejecutar tu app en un emulador en Android Studio.

Cómo actualizar a la versión más reciente de Wear OS

Para verificar que tu app se comporte como se espera en el software más reciente, comprueba que el dispositivo de prueba ejecute la versión más actualizada de Wear OS que admita tu dispositivo.

Para ello, sigue estos pasos:

  1. Conecta el dispositivo a una red Wi-Fi.
  2. Comienza a cargar el dispositivo.
  3. Espera a que la batería del dispositivo se cargue al 50% o más.

  4. En el dispositivo de prueba, ve a Configuración > Sistema > Actualizaciones del sistema.

    Si hay una actualización del sistema disponible, se descargará y se instalará en tu dispositivo de prueba.

Cómo instalar una versión específica de Wear OS (opcional)

Si el caso de prueba de tu app depende de una versión específica de Wear OS, puedes escribir una imagen de software en la memoria flash de relojes compatibles con una conexión de datos USB. Por ejemplo, puedes escribir en la memoria flash una imagen de fábrica o una imagen OTA completa en el Google Pixel Watch 2.

Cómo habilitar las opciones para desarrolladores en tu reloj

Antes de realizar la depuración en tu reloj, habilita las opciones para desarrolladores. Solo necesitas hacerlo una vez, ya que estas permanecerán habilitadas hasta que las inhabilites. A fin de habilitar las opciones para desarrolladores, haz lo siguiente:

  1. Abre la Configuración del reloj.
  2. Presiona Sistema > Acerca de > Versiones.
  3. Presiona Número de compilación siete veces.
  4. Aparecerá un mensaje en el que se confirmará que ahora eres desarrollador.

Cómo depurar por Wi-Fi

Antes de comenzar, habilita las opciones para desarrolladores en el reloj como se describió anteriormente.

Cómo conectar el reloj a una red Wi-Fi

  1. Abre la Configuración del reloj.
  2. Presiona Conectividad > Wi-Fi.
  3. Elige una red y, si corresponde, ingresa la contraseña.

    Nota: El reloj y la máquina de desarrollo deben estar conectados a la misma red. No todos los puntos de acceso pueden usarse. Es posible que debas utilizar un punto de acceso cuyo firewall esté configurado correctamente para admitir adb.

Cómo habilitar la depuración por Wi-Fi

  1. Abre la Configuración del reloj.
  2. Presiona Opciones para desarrolladores > Depurar mediante Wi-Fi.
  3. Después de un momento, la pantalla mostrará la dirección IP del reloj, como 192.168.1.100. Anótala porque la necesitarás para el siguiente paso.

Cómo sincronizar el depurador con el reloj

  1. En tu dispositivo Wear OS, busca las opciones de depuración inalámbrica en la configuración del sistema. Selecciona Vincular dispositivo nuevo.
  2. Anota el código de vinculación de Wi-Fi y la dirección IP y el puerto.
  3. En una ventana de la terminal de la máquina de desarrollo, ingresa el siguiente comando: 
    adb pair IP_ADDRESS:PORT
  4. Cuando se te solicite, ingresa el código de vinculación de Wi-Fi del paso 2. En la terminal, se mostrará un mensaje si la vinculación se realizó correctamente. A continuación, se muestra un ejemplo: 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
Después de la vinculación, la computadora host aparecerá en la lista de Dispositivos vinculados de la pantalla Depuración inalámbrica del dispositivo Wear OS.

Cómo conectar el depurador al reloj

  1. Conecta el reloj y la máquina de desarrollo a la misma red.

  2. Conecta el depurador al reloj mediante la dirección IP del reloj y un número de puerto. Por ejemplo, si la dirección IP es 192.168.1.100 y el número de puerto es 5555, el comando adb connect y su respuesta se ven de la siguiente manera: 

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

El reloj ya estará conectado al depurador y podrás iniciar la depuración. Envía los comandos de adb al reloj con la marca -s y especifica la dirección IP del reloj y el número de puerto:

adb -s 192.168.1.100:5555 <command>

Si no usas el emulador y solo tienes un dispositivo conectado para la depuración, no necesitas especificar la dirección:

adb <command>

Cómo depurar por Bluetooth

Nota: La depuración por Bluetooth solo funciona con relojes vinculados con Android que ejecutan Wear OS 2.

Antes de comenzar, vincula el reloj y el teléfono, y habilita las opciones para desarrolladores en el reloj como se describió anteriormente. Comprueba que las opciones para desarrolladores estén habilitadas en el teléfono. Para ello, abre el menú de Configuración y busca Opciones para desarrolladores. Si es necesario, habilita las opciones para desarrolladores en el teléfono.

Cómo habilitar la depuración por USB en el teléfono

  1. Abre el menú de Configuración del teléfono.
  2. Selecciona Opciones para desarrolladores y habilita la Depuración por USB.

Cómo habilitar la depuración por ADB o Bluetooth en el reloj

  1. Abre el menú de Configuración del reloj.
  2. Desplázate hasta Opciones para desarrolladores.
  3. Confirma que la Depuración por ADB esté habilitada.
  4. Habilita la Depuración por Bluetooth.

Cómo habilitar la depuración por Bluetooth en el teléfono

  1. En el teléfono, abre la aplicación complementaria de Wear OS.
  2. Desplázate hasta Configuración avanzada y presiona para ver las opciones de Configuración avanzada.
  3. Habilita la Depuración por Bluetooth. Aparecerá el siguiente mensaje de estado debajo de la opción. 
    Host: disconnected
Target: connected

En este punto, la máquina de desarrollo (el host) no tiene comunicación con el reloj (el destino). Debes completar el vínculo.

Nota: Solo puedes realizar la depuración con un dispositivo a la vez. Si tienes varios relojes vinculados, la depuración por Bluetooth solo se habilitará con el dispositivo seleccionado en la pantalla principal.

Cómo conectar el depurador al reloj

En este paso final, usarás todos los elementos: el depurador, el teléfono y el reloj.

  1. Conecta el teléfono a tu máquina de desarrollo mediante un cable USB.
  2. Ejecuta estos dos comandos en el depurador: 
    adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444

    Nota: Debes usar la dirección IP 127.0.0.1. Usa cualquier puerto disponible en tu máquina de desarrollo y el mismo puerto en ambos comandos (en este ejemplo, el puerto es 4444).

  3. Después de ingresar el comando de conexión, el reloj te pedirá que confirmes que permites la Depuración por ADB.
  4. En el teléfono, comprueba la pantalla de estado en la aplicación complementaria de Wear OS para ver lo siguiente: 
    Host: connected
Target: connected

    5. El reloj ya estará conectado al depurador y podrás iniciar la depuración.

Cuando depuras un reloj mediante Bluetooth, adb siempre usa la dirección IP 127.0.0.1 y el puerto que asignes (en este ejemplo, el puerto es 4444). Todos los comandos adb usan el siguiente formato:

adb -s 127.0.0.1:4444 <command>

Si no usas el emulador y solo tienes un dispositivo conectado para la depuración, no necesitas especificar la dirección:

adb <command>

Cómo usar la grabación de pantalla para Wear OS

Si desarrollas tu app en macOS, puedes usar el proyecto de GitHub (herramienta de Android para Mac) para grabar un video desde tu dispositivo Wear OS.

También puedes grabar un video desde tu dispositivo Wear OS mediante estos pasos:

  1. Graba fotogramas sin procesar en el reloj:
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Copia el archivo sin procesar en tu máquina de desarrollo:
    adb pull /sdcard/video.raw video.raw
  3. Usa ffmpeg para convertir el archivo sin procesar a MP4:
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Nota: Consulta el sitio web de FFmpeg para obtener instrucciones de instalación y descarga.