Compartir vía


Configurar el dispositivo para el desarrollo

En este artículo se explica cómo configurar un dispositivo Android y conectarlo a un equipo de modo que el dispositivo pueda usarse para ejecutar y depurar aplicaciones de Xamarin.Android.

Después de realizar las pruebas en un emulador de Android, querrá ver y probar la ejecución de sus aplicaciones en un dispositivo Android. Tendrá que habilitar la depuración y conectar el dispositivo al equipo.

Cada uno de estos pasos se tratará con más detalle en las secciones siguientes.

Habilitar la depuración en el dispositivo

Un dispositivo debe tener la depuración habilitada para probar una aplicación de Android. De manera predeterminada, se han ocultado las opciones para desarrolladores en Android a partir de la versión 4.2, y su habilitación puede variar en función de la versión de Android.

Android 9.0+

En las versiones de Android 9.0 y superiores, debe seguir estos pasos para habilitar la depuración:

  1. Vaya a la pantalla Configuración.
  2. Seleccione Sobre el teléfono.
  3. Pulse Número de compilación 7 veces hasta que aparezca el mensaje ¡Ahora es un desarrollador!

Android 8.0 y Android 8.1

  1. Vaya a la pantalla Configuración.
  2. Seleccione Sistema.
  3. Seleccione Sobre el teléfono.
  4. Pulse Número de compilación 7 veces hasta que aparezca el mensaje ¡Ahora es un desarrollador!

Android 7.1 y versiones inferiores

  1. Vaya a la pantalla Configuración.
  2. Seleccione Sobre el teléfono.
  3. Pulse Número de compilación 7 veces hasta que aparezca el mensaje ¡Ahora es un desarrollador!

Developer options screen on Android 9.0

Comprobación de que está habilitada la depuración USB

Después de habilitar el modo de desarrollador en el dispositivo, debe asegurarse de que está habilitada la depuración USB en el dispositivo. Esto también varía en función de la versión de Android.

Android 9.0+

Vaya a Configuración > Sistema > Opciones avanzadas > Opciones del desarrollador y habilite Depuración USB.

Android 8.0 y Android 8.1

Vaya a Configuración > Sistema > Opciones del desarrollador y habilite Depuración USB.

Android 7.1 y versiones inferiores

Vaya a Configuración > Opciones del desarrollador y habilite Depuración USB.

Una vez que la pestaña Opciones del desarrollador está disponible en Ajustes > Sistema, ábrala para mostrar las opciones del desarrollador:

Developer options screen on Android

Desde aquí puede habilitar las opciones del desarrollador, como la depuración de USB y el modo Permanecer activo.

Conexión del dispositivo al equipo

El paso final consiste en conectar el dispositivo al equipo. La manera más sencilla y confiable es hacerlo a través de USB.

Recibirá un mensaje para confiar en el equipo en el dispositivo si no lo ha utilizado antes para depuración. También puede activar Permitir siempre desde este ordenador para evitar que le salga este aviso cada vez que conecte el dispositivo.

Google USB

Selección del dispositivo de destino para la depuración

Si el dispositivo de destino de Visual Studio para la depuración no es al que acaba de conectarse, selecciónelo en la lista desplegable de la barra de herramientas Estándar (Ver > Barras de herramientas > Estándar).

Conexión alternativa a través de Wi-Fi

Es posible conectar un dispositivo Android a un equipo a través de Wi-Fi, sin usar un cable USB. Esta técnica requiere más esfuerzo, pero debería ser útil si el dispositivo está demasiado alejado del equipo como para estar conectado constantemente mediante cable.

Conectar a través de Wi-Fi

De forma predeterminada, Android Debug Bridge (ADB) está configurado para comunicarse con un dispositivo Android a través de USB. Es posible volver a configurarlo para que use TCP/IP en lugar de USB. Para ello, tanto el dispositivo como el equipo deben estar en la misma red Wi-Fi. Para configurar el entorno para depurar mediante Wi-Fi, realice los siguientes pasos desde la línea de comandos:

  1. Determine la dirección IP del dispositivo Android. Una manera de averiguar la dirección IP es mirar en Ajustes > Redes e Internet > Wi-Fi, después, pulsar la red Wi-Fi a la que está conectado el dispositivo y luego pulsar en Opciones avanzadas. Se abrirá una lista desplegable con información sobre la conexión de red, parecida a la que se muestra en la siguiente captura de pantalla:

    IP address

    En algunas versiones de Android, la dirección IP no aparecerá ahí, pero se puede encontrar en Ajustes > >Sobre el teléfono > Estado.

  2. Conecte el dispositivo Android al equipo a través de USB.

  3. Después, reinicie ADB de modo que use TCP en el puerto 5555. En un símbolo del sistema, escriba el siguiente comando:

    adb tcpip 5555
    

    Después de emitir este comando, el equipo no podrá escuchar los dispositivos que están conectados a través de USB.

  4. Desconecte el cable USB que conecta el dispositivo al equipo.

  5. Configure ADB para que se conecte al dispositivo Android en el puerto que se especificó en el paso 1 anterior:

    adb connect 192.168.1.28:5555
    

    Una vez que se finalice este comando, el dispositivo Android se conecta al equipo a través de Wi-Fi.

    Cuando termine la depuración a través de Wi-Fi, puede restablecer ADB al modo USB con el comando siguiente:

    adb usb
    

    Es posible solicitarle a ADB que enumere los dispositivos que están conectados al equipo. Independientemente de cómo estén conectados los dispositivos, puede emitir el comando siguiente en el símbolo del sistema para ver qué está conectado:

    adb devices
    

Solución de problemas

En algunos casos, es posible que el dispositivo no se pueda conectar al equipo. Si es así, quizá le interesaría comprobar que están instalados los controladores USB.

Instalar controladores USB

Este paso no es necesario para macOS; basta con que conecte el dispositivo al equipo Mac con un cable USB.

Puede que sea necesario instalar algunos controladores adicionales para que un equipo Windows reconozca un dispositivo Android conectado mediante USB.

Nota:

Estos son los pasos necesarios para configurar un dispositivo Google Nexus y se proporcionan a modo de referencia. Los pasos correspondientes a su dispositivo específico pueden variar, pero seguirán un patrón similar. Si tiene problemas, busque su dispositivo en Internet.

Ejecute la aplicación android.bat en el directorio [ruta de instalación de Android SDK]\tools. De forma predeterminada, el instalador de Xamarin.Android colocará el SDK de Android en la siguiente ubicación de un equipo de Windows:

C:\Users\[username]\AppData\Local\Android\android-sdk

Descargar los controladores USB

Los dispositivos Google Nexus (a excepción de Galaxy Nexus) requieren el controlador USB de Google. El controlador para Galaxy Nexus está distribuido por Samsung. Todos los demás dispositivos Android deben usar el controlador USB de su fabricante correspondiente.

Para instalar el paquete del controlador USB de Google, inicie Android SDK Manager y expanda la carpeta Extras, como se ve en la captura de pantalla siguiente:

Google USB driver selected

Active el cuadro del controlador USB de Google y haga clic en el botón Aplicar cambios. Los archivos del controlador se descargan en la siguiente ubicación:

[Android SDK install path]\extras\google\usb\_driver

La ruta de acceso predeterminada para efectuar una instalación de Xamarin.Android es la siguiente:

C:\Users\[username]\AppData\Local\Android\android-sdk\extras\google\usb_driver

Instalar el controlador USB

Una vez que haya descargado los controladores USB, deberá instalarlos. Para instalar los controladores en Windows 7:

  1. Conecte el dispositivo al equipo con un cable USB.

  2. Haga clic con el botón derecho en el equipo desde el escritorio o el Explorador de Windows y seleccione Administrar.

  3. En el panel izquierdo, seleccione Devices (Dispositivos).

  4. Busque y expanda Otros dispositivos en el panel derecho.

  5. Haga clic con el botón derecho en el nombre del dispositivo y seleccione Actualizar software de controlador. Se iniciará el Asistente para actualización de hardware.

  6. Seleccione Buscar software de controlador en el equipo y haga clic en Siguiente.

  7. Haga clic en Examinar y busque la carpeta del controlador USB (el controlador USB de Google se encuentra en [ruta de instalación de Android SDK]\extras\google\usb_driver).

  8. Haga clic en Siguiente para instalar el controlador.

Resumen

En este artículo se ha descrito cómo configurar un dispositivo Android para el desarrollo mediante la habilitación de la depuración en el dispositivo. Además, también se ha explicado cómo conectar el dispositivo a un equipo a través de USB o Wi-Fi.