Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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 iniciar la depuración en el dispositivo, debes hacer lo siguiente:

  1. En el dispositivo, abre la app de Configuración, selecciona Opciones para desarrolladores y luego habilita Depuración por USB.

  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 necesitas una guía de instalación y vínculos a las unidades de OEM, consulta el documento Cómo instalar controladores USB de OEM.

Conéctalo al dispositivo

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