Cómo ejecutar apps en un dispositivo de hardware

Cuando compilas una app de Android, es importante probar siempre la app en un dispositivo real antes de lanzarla. En esta página, se describe cómo configurar el entorno de desarrollo y un dispositivo Android para prueba y depuración a través de una conexión Android Debug Bridge (adb).

Cómo configurar un dispositivo para desarrollo

Antes de comenzar a depurar en tu dispositivo, decide si quieres conectarlo con un cable USB o Wi-Fi. A continuación, sigue estos pasos:

  1. En el dispositivo, abre la app de Configuración, selecciona Opciones para desarrolladores y, luego, habilita depuración por USB (si corresponde).

  2. Configura el sistema para que detecte el dispositivo.

    • Sistema operativo Chrome: No se requiere ninguna configuración adicional.
    • macOS: No se requiere ninguna configuración adicional.
    • Ubuntu Linux: Hay dos cosas que se deben configurar correctamente: una es que cada usuario que quiera usar adb debe estar en el grupo plugdev y la otra es que el sistema tenga instaladas reglas udev que cubran el dispositivo.

      Grupo plugdev: Si ves un mensaje de error que indica que no estás en el grupo plugdev, deberás agregarte:

      sudo usermod -aG plugdev $LOGNAME
      

      Ten en cuenta que los grupos solo se actualizan cuando accedes, por lo que tendrás que salir para que este cambio surta efecto. Cuando vuelvas a acceder, podrás usar id para verificar que ahora estés en el grupo plugdev.

      Reglas udev: El paquete android-sdk-platform-tools-common contiene un conjunto predeterminado de reglas de udev para dispositivos Android mantenido por la comunidad. Para instalarlo:

      apt-get install android-sdk-platform-tools-common
      
    • Windows: Instala un controlador USB para adb (si corresponde). Si necesitas una guía de instalación y vínculos a controladores de OEM, consulta el documento Cómo instalar controladores USB de OEM.

Cómo conectarse a tu dispositivo mediante USB

Cuando esté todo listo y el dispositivo esté conectado mediante USB, haz clic en Run  en Android Studio para compilar y ejecutar la app en el dispositivo.

También puedes usar adb para ejecutar comandos, de la siguiente manera:

  • Verifica que el dispositivo esté conectado; para ello, ejecuta el comando adb devices desde el directorio android_sdk/platform-tools/. Si está conectado, verás el dispositivo en la lista.
  • Ejecuta cualquier comando de adb con la marca -d para dirigirte al dispositivo.

Cómo conectarte a tu dispositivo mediante Wi-Fi

Android 11 (y las versiones posteriores) admiten la implementación y depuración de tu app de forma inalámbrica desde tu estación de trabajo mediante Android Debug Bridge (adb). Por ejemplo, puedes implementar tu app depurable en varios dispositivos remotos sin conectar físicamente tu dispositivo a través de USB y lidiar con problemas comunes de conexión USB, como la instalación de controladores.

Para usar la depuración inalámbrica, debes sincronizar tu dispositivo con tu estación de trabajo mediante un código de vinculación. Para comenzar, completa los siguientes pasos:

  1. Asegúrate de que la estación de trabajo y el dispositivo estén conectados a la misma red inalámbrica.
  2. Asegúrate de que el dispositivo ejecute Android 11 o una versión posterior. Para obtener más información, consulta Cómo verificar y actualizar la versión de Android.
  3. Asegúrate de tener Android Studio Bumblebee Canary. Puedes descargarlo aquí.
  4. En tu estación de trabajo, actualiza a la versión más reciente de las Herramientas de la plataforma del SDK.

Para conectarte a tu dispositivo, sigue estos pasos:

  1. Abre Android Studio y selecciona Pair Devices Using Wi-Fi en el menú desplegable de configuraciones de ejecución.
    Menú desplegable de configuraciones de ejecución
    Figura 1: Menú desplegable de configuraciones de ejecución

    Aparecerá la ventana Pair devices over Wi-Fi, como se muestra a continuación.
    Captura de pantalla de la ventana emergente para vincular dispositivos mediante Wi-Fi
    Figura 2: Ventana emergente para vincular dispositivos mediante código QR o código de vinculación.
  2. Habilita las opciones para desarrolladores en tu dispositivo.
  3. Habilita la depuración por Wi-Fi en tu dispositivo.
    Captura de pantalla de un teléfono Pixel que muestra el parámetro de configuración de sistemas de depuración inalámbrica.
    Figura 3: Captura de pantalla del parámetro de configuración de depuración inalámbrica en un teléfono Google Pixel.
  4. Presiona Wireless debugging y vincula tu dispositivo:
    1. Para vincular tu dispositivo con un código QR, selecciona Pair device with QR code y escanea el código QR que obtuviste anteriormente.
    2. Para vincular tu dispositivo con un código de vinculación, selecciona Pair device with pairing code en la ventana Pair devices over Wi-Fi. En el dispositivo, selecciona Pair using pairing code y toma nota del código PIN de seis dígitos. Una vez que el dispositivo aparezca en la ventana Pair devices over Wi-Fi, puedes seleccionar Pair y, luego, ingresar el código PIN de seis dígitos que se muestra en el dispositivo.
      Captura de pantalla del ingreso del código PIN de ejemplo
      Figura 4: Ejemplo del ingreso de código PIN de seis dígitos
  5. Una vez vinculado, puedes intentar implementar tu app en el dispositivo.

    Si deseas olvidar este dispositivo de la estación de trabajo o vincular uno diferente, navega a Wireless debugging en tu dispositivo, presiona el nombre de la estación de trabajo en Paired devices y, por último, selecciona Forget.

Cómo solucionar problemas de conexión del dispositivo

Si el dispositivo no se conecta a Android Studio, prueba lo siguiente para resolver el problema.

Cómo solucionar problemas con el asistente de conexión

El asistente de conexión proporciona instrucciones detalladas para ayudarte a configurar y usar un dispositivo mediante la conexión de adb.

Para iniciar el asistente, selecciona Tools > Troubleshoot Device Connections.

El asistente de conexión proporciona instrucciones, controles en contexto y una lista de dispositivos conectados en una serie de páginas del panel Assistant. Usa los botones Next y Previous, ubicados en la parte inferior del panel Assistant, para trabajar en las páginas según sea necesario:

  • Conectar el dispositivo mediante USB: En primer lugar, el asistente de conexión te solicita que conectes el dispositivo mediante USB y proporciona el botón Rescan USB devices, que permite iniciar un nuevo análisis para los dispositivos conectados.
  • Habilitar la depuración por USB: El asistente de conexión te indicará luego cómo habilitar la depuración por USB en las opciones para desarrolladores del dispositivo.
  • Reiniciar el servidor de adb: Por último, si aún no se muestra el dispositivo en la lista de dispositivos disponibles, puedes usar el botón Restart ADB server ubicado en la última página del asistente de conexión. Al reiniciar el servidor de adb, se realiza un nuevo análisis en busca de dispositivos. Si aún no se muestra el dispositivo en la lista de dispositivos disponibles, prueba con los pasos de solución de problemas de la próxima sección de esta página.

Cómo resolver los problemas de conexión USB

Si el asistente de conexión no detecta el dispositivo mediante USB, puedes probar los siguientes pasos para resolver el problema:

Comprueba que se pueda conectar Android Studio a Android Emulator

Para comprobar si el problema se debe a un error de conexión entre Android Studio y Android Emulator, sigue estos pasos:

  1. Abre el Administrador de AVD.
  2. Crea un AVD nuevo si aún no tienes uno.
  3. Ejecuta el emulador con el AVD.
  4. Realiza alguna de las siguientes acciones:

Comprueba el cable USB

Para comprobar si el problema se debe a un cable USB defectuoso, sigue los pasos que se indican en esta sección.

Si tienes otro cable USB:

  1. Conecta el dispositivo con el cable secundario.
  2. Comprueba si el Asistente de conexión ahora puede detectar el dispositivo.
  3. Si no lo hace, prueba con el cable principal de nuevo.
  4. Si aún no se detecta, entonces el problema está relacionado con el dispositivo. Comprueba si el dispositivo está configurado para desarrollo.

Si no tienes otro cable USB, pero tienes otro dispositivo Android:

  1. Conecta el dispositivo secundario a la computadora.
  2. Si el asistente de conexión puede detectar el dispositivo secundario, entonces el problema está relacionado con el dispositivo principal. Comprueba si el dispositivo está configurado para desarrollo.

    Si no se detecta el dispositivo secundario, es posible que el problema esté relacionado con el cable USB.

Comprueba si el dispositivo está configurado para desarrollo

Para comprobar si el problema se debe a la configuración del dispositivo, sigue estos pasos:

  1. Sigue los pasos de la sección Cómo configurar un dispositivo para desarrollo.
  2. Si eso no resuelve el problema, comunícate con el servicio de asistencia al cliente del OEM del dispositivo para obtener ayuda. Dile al representante que el dispositivo no se conecta a Android Studio mediante ABD.

Cómo resolver problemas de conexión inalámbrica

Si tienes problemas para conectarte al dispositivo de forma inalámbrica, puedes probar los siguientes pasos para solucionarlos.

Cómo comprobar si la estación de trabajo y el dispositivo cumplen con los requisitos previos

Para cumplir con los requisitos previos de depuración inalámbrica, asegúrate de lo siguiente:

  1. La estación de trabajo y el dispositivo están conectados a la misma red inalámbrica.
  2. Tu dispositivo ejecuta Android 11 o una versión posterior. Para obtener más información, consulta Cómo verificar y actualizar la versión de Android.
  3. Tener Android Studio Bumblebee. Puedes descargarlo aquí.
  4. Tener la última versión de las Herramientas de la plataforma del SDK en la estación de trabajo.

Cómo comprobar otros problemas conocidos

En la siguiente lista, se enumeran los problemas conocidos actuales con la depuración inalámbrica de Android Studio y se indica cómo resolverlos.

  1. La red Wi-Fi no se conecta: Es posible que algunas redes Wi-Fi, como las corporativas, bloqueen conexiones p2p y no te permitan conectarte mediante Wi-Fi. Intenta conectarte con un cable o mediante otra red Wi-Fi.
  2. A veces, la conexión de ADB mediante Wi-Fi se desactiva automáticamente: Esto puede ocurrir si el dispositivo cambia de red Wi-Fi o se desconecta de ella.

Clave de seguridad de RSA

Cuando conectas a la computadora un dispositivo con Android 4.2.2 (nivel de API 17) o una versión posterior, en el sistema se muestra un cuadro de diálogo en el que se solicita aceptar una clave RSA para realizar la depuración a través de esa computadora. Este mecanismo de seguridad protege los dispositivos del usuario porque garantiza que la depuración por USB y otros comandos de adb no puedan ejecutarse, a menos que desbloquees el dispositivo y aceptes el contenido del diálogo.