Cómo ejecutar apps en un dispositivo de hardware

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Siempre prueba tu app para Android en un dispositivo real antes de lanzarla a los usuarios. 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 conectarte al dispositivo 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.
    • 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.
    • Ubuntu Linux: Configura lo siguiente:

      • Cada usuario que quiera usar adb debe estar en el grupo plugdev. Si ves un mensaje de error que indica que no estás en el grupo plugdev, agrégate a él con el siguiente comando:
      sudo usermod -aG plugdev $LOGNAME
      

      Los grupos solo se actualizan cuando accedes, por lo que debes salir de tu cuenta para que se aplique este cambio. Cuando vuelvas a acceder, podrás usar id para verificar que estés en el grupo plugdev.

      • El sistema debe tener instaladas reglas de udev que cubran el dispositivo. El paquete android-sdk-platform-tools-common contiene un conjunto predeterminado de reglas de udev mantenido por la comunidad para dispositivos Android. Para instalarlo, usa el siguiente comando:
      apt-get install android-sdk-platform-tools-common
      

Cómo conectarte 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 tu 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, lee Cómo consultar y actualizar tu versión de Android.
  3. Asegúrate de tener Android Studio Dolphin instalado. Descarga esta versión 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ú de configuraciones de ejecución.

    Aparecerá el diálogo Pair devices over Wi-Fi, como se muestra en la Figura 2.
    Captura de pantalla de la ventana emergente para vincular dispositivos mediante Wi-Fi
    Figura 2. Diálogo 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: La configuración de Depuración inalámbrica en un teléfono Google Pixel.
  4. Presiona Depuración inalámbrica y vincula tu dispositivo:
    1. Para vincular tu dispositivo con un código QR, selecciona Vincular dispositivo mediante código QR y escanea el código QR que se muestra en la Figura 2.
    2. Para vincular tu dispositivo con un código de vinculación, selecciona Vincular dispositivo con un código de vinculación del diálogo . En tu dispositivo, selecciona Pair using pairing code. Aparecerá un código de seis dígitos. Una vez que el dispositivo aparezca en la ventana Pair devices over Wi-Fi, ingresa el código de seis dígitos que se muestra en el dispositivo y selecciona Vincular.
      Captura de pantalla de un ejemplo de entrada de código de vinculación
      Figura 4: Ejemplo de entrada de código de vinculación de seis dígitos.
  5. Después de la sincronización, puedes intentar implementar tu app en el dispositivo.

Si deseas vincular un dispositivo diferente u olvidar este dispositivo en la estación de trabajo, sigue estos pasos:

  1. Ve a Depuración inalámbrica en tu dispositivo.
  2. Presiona el nombre de tu estación de trabajo en Dispositivos vinculados.
  3. Selecciona Olvidar.

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 una nuevo escaneo de 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: 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 siguiente sección.

Cómo resolver los problemas de conexión USB

Si el asistente de conexión no detecta el dispositivo mediante USB, prueba los siguientes pasos para solucionar el problema:

Cómo comprobar que Android Studio se conecte 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 dispositivos.
  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:
    • Si no se puede conectar Android Studio al emulador, descarga las herramientas de la plataforma de SDK más recientes y vuelve a intentarlo.
    • Si se inicia correctamente el emulador, verifica el cable USB como se describe en la siguiente sección.

Cómo comprobar 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. Consulta Cómo comprobar si el dispositivo está configurado para desarrollo, como se describe en la siguiente sección.

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.

Cómo comprobar 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 esto no resuelve el problema, comunícate con la 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:

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:

  • 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.
  • 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 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 no se pueden ejecutar la depuración por USB ni otros comandos de adb, a menos que puedas desbloquear el dispositivo y aceptar el contenido del diálogo.