Cómo depurar una app de Wear OS

Para depurar tu app de Wear OS, conecta la máquina de desarrollo a un reloj mediante Wi-Fi o Bluetooth. De manera alternativa, si el reloj tiene un puerto USB, conéctate a través de USB.

Cómo habilitar las opciones para desarrolladores en tu reloj

Antes de realizar la depuración en tu reloj, debes habilitar 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 > Información.
  3. Desplázate hasta Número de compilación y presiónalo siete veces.
  4. Aparecerá un cuadro de diálogo 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.

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 (por ejemplo, 192.168.1.100). La necesitarás para el próximo paso, así que anótala.

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. Por ejemplo, si la dirección IP es 192.168.1.100, el comando adb de conexión y su respuesta se verán de la siguiente manera (un número de puerto, 5555, se agrega a la dirección):

    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 comandos adb al reloj mediante el parámetro "-s" y especifica la dirección IP del reloj, incluido 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. Verifica que las opciones para desarrolladores estén habilitadas en el teléfono. Para ello, abre el menú Configuración del teléfono, selecciona Acerca del teléfono y haz clic en el número de compilación siete veces.

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/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 app 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á un mensaje de estado debajo de la opción. El aspecto resultante será el siguiente:
    Host: disconnected
    Target: connected
    

En este punto, la máquina de desarrollo (el host) no tiene comunicación con el reloj (el destino). Por lo tanto, 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. Usa el mismo puerto en ambos comandos (en este ejemplo, el puerto es 4444).

  3. Una vez que escribas el comando de conexión, mira el reloj. Se te solicitará que confirmes la Depuración ADB.
  4. En el teléfono, comprueba la pantalla de estado en la app complementaria de Wear OS. Debería verse de la siguiente manera:
    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 asignaste (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 un proyecto de GitHub (herramienta de Android para Mac) a fin de 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.