Compartir vía


Configura un dispositivo Android para depuración

Aunque el emulador de Android es una excelente manera de desarrollar y probar rápidamente la aplicación, querrá probar las aplicaciones en un dispositivo Android real. Para ejecutarse en un dispositivo, deberá habilitar el modo de desarrollador en el dispositivo y conectarlo al equipo. Para obtener más información, consulte Ejecutar aplicaciones en un dispositivo de hardware en developer.android.com.

Importante

Los pasos de este artículo se escriben de forma genérica para trabajar en tantos dispositivos como sea posible. Si no encuentra esta configuración en el dispositivo, consulte la documentación del fabricante del dispositivo.

Habilitación del modo de desarrollador en el dispositivo

Un dispositivo debe habilitar el modo desarrollador para implementar y probar una aplicación Android. El modo de desarrollador está habilitado siguiendo estos pasos:

  1. Vaya a la pantalla de configuración de .
  2. Seleccione Acerca del teléfono.
  3. Pulse número de compilación siete veces hasta que ¡Ahora eres desarrollador! sea visible.

En función de la interfaz de usuario que esté ejecutando tu dispositivo, la opción Acerca del teléfono puede encontrarse en una ubicación diferente. Consulte la documentación de su dispositivo si no encuentra Acerca del teléfono.

pantalla de Opciones de desarrollador en Android.

Habilitar la depuración USB

Después de habilitar el modo de desarrollador en el dispositivo, habilite la depuración USB siguiendo estos pasos:

  1. Vaya a la pantalla de configuración .
  2. Seleccione Opciones de desarrollador.
  3. Active la opción depuración USB.

En función de la interfaz de usuario que ejecute el dispositivo, la opción depuración USB puede estar en otra ubicación. Consulte la documentación del dispositivo si no encuentra depuración USB.

Conexión del dispositivo al equipo

El último paso es conectar el dispositivo al equipo. La manera más fácil y confiable es hacerlo a través de USB.

Recibirá un mensaje en su dispositivo para confiar en el equipo si no lo ha utilizado para la depuración antes. También puede marcar Permitir siempre desde este equipo para evitar que se muestre este mensaje cada vez que conecte el dispositivo.

mensaje de confianza de Android desde el ordenador para usar la depuración USB.

Si el equipo no reconoce el dispositivo cuando está conectado, intente instalar un controlador para el dispositivo. Consulte la documentación de soporte técnico del fabricante del dispositivo. También puede intentar instalar Google USB Driver a través del Administrador de Android SDK:

Android SKD Manager con el controlador de dispositivo USB de Google seleccionado.

Activa la depuración de WiFi

Es posible depurar un dispositivo Android a través de WiFi, sin mantener el dispositivo conectado físicamente al equipo. Esta técnica requiere más esfuerzo, pero podría ser útil cuando el dispositivo está demasiado lejos del equipo para permanecer constantemente conectado a través de un cable.

Conexión a través de WiFi

De forma predeterminada, el puente de depuración de Android (adb) está configurado para comunicarse con un dispositivo Android a través de USB. Es posible volver a configurarlo para usar TCP/IP en lugar de USB. Para ello, tanto el dispositivo como el equipo deben estar en la misma red WiFi.

Nota

El controlador USB de Google es necesario para realizar depuración adb en Windows con dispositivos de Google. Para obtener más información, consulte Obtener el controlador USB de Google en developer.android.com. Los controladores de Windows para todos los demás dispositivos los proporciona el fabricante de hardware correspondiente. Para obtener más información, consulte Instalación de controladores USB OEM en developer.android.com.

Primero, habilite la depuración inalámbrica en su dispositivo Android:

  1. Siga los pasos descritos en la sección Habilitar el modo de desarrollador en el dispositivo.
  2. Siga los pasos descritos en la sección Habilitar depuración USB.
  3. Vaya a la pantalla de configuración .
  4. Seleccione opciones de desarrollador.
  5. Activa la opción depuración inalámbrica.

En función de la interfaz de usuario que ejecute su dispositivo, la opción de depuración inalámbrica puede estar en una ubicación diferente. Consulte la documentación del dispositivo si no encuentra depuración inalámbrica.

A continuación, use adb para conectarse al dispositivo, primero a través de una conexión USB:

  1. Determine la dirección IP del dispositivo Android. Una manera de averiguar la dirección IP es buscar en Configuración > Red & Internet > Wi-Fi, pulse en la red WiFi a la que está conectado el dispositivo y, a continuación, pulse en Advanced. Se abrirá una lista desplegable que muestra información sobre la conexión de red, similar a la que se muestra en la captura de pantalla siguiente:

    pantalla de estado de Android con dirección IP.

    En algunas versiones de Android, la dirección IP no aparecerá en la lista, pero se puede encontrar en Configuración, > Acerca del teléfono, > Estado.

  2. En Visual Studio, abra el símbolo del sistema de Adb de Android seleccionando la opción de menú: Herramientas de >Android>símbolo del sistema de Adb de Android....

  3. En el símbolo del sistema, use el comando adb tcpip para indicar al dispositivo que escuche las conexiones TCP/IP en el puerto 5555.

    adb tcpip 5555
    
  4. Desconecte el cable USB del dispositivo.

  5. Conéctese a la dirección IP del dispositivo con el puerto 5555:

    adb connect 192.168.1.28:5555
    

    Cuando este comando finaliza, el dispositivo Android está conectado al equipo a través de WiFi.

    Cuando haya terminado de depurar a través de WiFi, puede restablecer ADB de nuevo al modo USB con el siguiente comando:

    adb usb
    

    Para ver los dispositivos conectados al equipo, use el comando adb devices:

    adb devices
    

Configura las opciones de desarrollador en el dispositivo

La aplicación Configuración en Android incluye una pantalla denominada Opciones para desarrolladores donde puede configurar comportamientos del sistema que le ayuden a generar perfiles y depurar el rendimiento de la aplicación. Para obtener más información, consulte Configuración de opciones de desarrollador en dispositivos en developer.android.com.

Depurar una aplicación en un dispositivo Android

Para depurar una aplicación en un dispositivo Android:

  1. Conecte el dispositivo a la máquina y selecciónelo como destino de depuración en Visual Studio o Visual Studio Code.
  2. Ejecute la aplicación.

Para obtener información sobre cómo seleccionar un destino de depuración en Visual Studio, consulte Crea tu primera aplicación. Para obtener información sobre cómo seleccionar un destino de depuración en Visual Studio Code, consulte Crea tu primera aplicación.