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. Ambos elementos deben estar conectados a la misma red inalámbrica. Para conectarte a tu dispositivo, sigue estos pasos:

Cuadro de diálogo de vinculación de adb inalámbrico
  1. En tu estación de trabajo, actualiza a la versión más reciente de las Herramientas de la plataforma del SDK.
  2. Habilita la opción depuración inalámbrica en Opciones para desarrolladores.
  3. En el cuadro de diálogo que pregunta ¿Quieres permitir la depuración inalámbrica en esta red?, haz clic en Permitir.
  4. Selecciona Vincular dispositivo mediante código de vinculación. Toma nota del código de vinculación, la dirección IP y el número de puerto que se muestran en el dispositivo (consulta la imagen).
  5. En tu estación de trabajo, abre una terminal y navega hasta android_sdk/platform-tools.
  6. Ejecuta adb pair ipaddr:port. Usa la dirección IP y el número de puerto del paso 3.
  7. Cuando se te pregunte, ingresa el código de vinculación que recibiste en el paso 4. Debería aparecer un mensaje para confirmar que se vinculó correctamente tu dispositivo.

    Enter pairing code: 482924
    Successfully paired to 192.168.1.130:37099 [guid=adb-235XY]
    
  8. Solo para Linux o Microsoft Windows: Ejecuta adb connect ipaddr:port. Usa la dirección IP y el puerto que se indican en Depuración inalámbrica (consulta la imagen que aparece a continuación).

    número de puerto y dirección IP del adb inalámbrico

Cómo solucionar problemas de conexión del dispositivo 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 > Connection Assistant.

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 adb.

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.