Cómo instalar ADB en Windows, macOS y Linux

Una guía paso a paso para comenzar con la herramienta Android Debug Bridge.

enlaces rápidos

  • ¿Qué es el puente de depuración de Android (ADB)?
  • ¿Cómo funciona ADB?
  • Cómo configurar ADB
  • Ejemplos de comandos ADB
  • ¿Qué más puedo hacer con ADB?

Solo se puede acceder a varias funciones del sistema operativo Android a través de rutas y métodos que están ocultos para el usuario promedio. Estos generalmente se han hecho con la ayuda de algunos comandos de la línea de comandos Android Debug Bridge (ADB), una herramienta que ofrece Google para que los desarrolladores depuren varias partes de sus aplicaciones o del sistema, pero que podemos usar para todo tipo de tareas ordenadas y ocultas trucos. Un requisito previo para estos trucos es instalar ADB en su computadora. Entonces, en esta guía, le mostraremos cómo instalar ADB en Windows, macOS y Linux en pasos rápidos y fáciles de seguir.

¿Qué es el puente de depuración de Android (ADB)?

La estructura interna de Android Debug Bridge (ADB) se basa en la arquitectura clásica cliente-servidor. Hay tres componentes que conforman todo el proceso.

  1. El cliente, es decir, la PC/Mac/Chromebook que ha conectado a su dispositivo Android. Estamos enviando comandos a nuestro dispositivo desde el ordenador a través del cable USB o de forma inalámbrica.
  2. Un demonio (conocido como "adbd") que ejecuta comandos en un dispositivo. El daemon se ejecuta como un proceso en segundo plano en cada dispositivo.
  3. Un servidor que gestiona la comunicación entre el cliente y el daemon. El servidor se ejecuta como un proceso en segundo plano en la computadora.

¿Cómo funciona ADB?

Debido a que hay tres piezas que componen ADB (el cliente, el demonio y el servidor), esto requiere que ciertas piezas estén en funcionamiento en primer lugar. Si acaba de arrancar la computadora (y no la tiene configurada para iniciar el daemon en el arranque), entonces necesitará que se esté ejecutando antes de que se pueda enviar cualquier comunicación al Android de destino dispositivo. Verá el siguiente mensaje en el símbolo del sistema o terminal, que verificará que el demonio se esté ejecutando.

Si el daemon no se está ejecutando, iniciará el proceso y le indicará en qué puerto TCP local se inició. Una vez que se haya iniciado ese servicio ADB, continuará escuchando ese puerto específico para los comandos que ha enviado el cliente ADB. Luego establecerá conexiones a todos los dispositivos en ejecución que estén conectados a la computadora (incluidos los emuladores). Este es el momento en que recibirá la solicitud de autorización en el dispositivo Android si la computadora no ha sido autorizada en el pasado.

Cómo configurar ADB

Nota: configurar ADB en la computadora es solo la mitad de la ecuación, ya que también deberá hacer algunas cosas en el teléfono inteligente o tableta para aceptar los comandos de ADB.

Configuración del teléfono

  1. Lanzar el Ajustes aplicación en su teléfono.
  2. Toque en el Acerca del teléfono opción generalmente cerca de la parte inferior de la lista.
    • Dependiendo de la piel del OEM, el Acerca del teléfono página puede llamarse de otra manera o enterrada en algún otro lugar en el Ajustes aplicación en su dispositivo.
  3. Luego toque el Número de compilación opción siete veces para habilitar el modo de desarrollador. Verá un mensaje de brindis cuando haya terminado.
  4. Ahora regrese a la pantalla principal de Configuración y debería ver una nueva Opciones de desarrollador menú al que puede acceder. En los teléfonos Google Pixel y algunos otros dispositivos, es posible que deba navegar hasta Ajustes > Sistema para encontrar el Opciones de desarrollador menú.
  5. Entra allí y habilita el depuración USB opción.
  6. Ha terminado parcialmente con el proceso de configuración del teléfono. A continuación, deberá desplazarse hacia abajo y seguir el resto de las instrucciones para su sistema operativo en particular.

Cómo configurar ADB en Microsoft Windows

  1. Descargar el Archivo ZIP de Android SDK Platform Tools para Windows.
  2. Extraiga el contenido de este archivo ZIP en una carpeta de fácil acceso (como C:\platform-tools).
  3. Abierto Explorador de archivos y navegue hasta donde extrajo el contenido de este archivo ZIP.
  4. Abra una instancia de Símbolo del sistema/Terminal desde el mismo directorio que este binario ADB. Esto se puede hacer manteniendo presionada la tecla Mayús y haciendo clic derecho dentro de la carpeta y luego haciendo clic en Abrir ventana de comandos aquí o Abra la ventana de PowerShell aquí. Los usuarios de Windows 11 deberían ver Abrir en Terminal en el menú contextual del botón derecho sin siquiera presionar el botón Shift en el teclado.
  5. Conecte su teléfono inteligente o tableta a su computadora con un cable USB. Cambie el modo USB al modo "transferencia de archivos (MTP)". Algunos OEM pueden o no requerir esto, pero es mejor dejarlo en este modo para compatibilidad general.
  6. En la ventana del símbolo del sistema/terminal, ingrese el siguiente comando para iniciar el demonio ADB: dispositivos adb
  7. En la pantalla de su teléfono, debería ver un mensaje para permitir o denegar el acceso a la depuración de USB. Naturalmente, querrá otorgar acceso a la depuración de USB cuando se le solicite (y toque la casilla de verificación Permitir siempre si no desea volver a ver ese aviso).
  8. Finalmente, vuelva a ingresar el comando del paso 6. Si todo fue exitoso, ahora debería ver el número de serie de su dispositivo en el símbolo del sistema (o en la ventana de PowerShell).

¡Ahora puede ejecutar cualquier comando ADB en su dispositivo! ¡Ahora ve y comienza a modificar tu teléfono siguiendo nuestra extensa lista de tutoriales!

Cómo configurar ADB en macOS

  1. Descargar el Archivo ZIP de Android SDK Platform Tools para macOS.
  2. Extraiga el ZIP a una ubicación de fácil acceso (como el escritorio, por ejemplo).
  3. Terminal abierta.
  4. Para buscar la carpeta en la que extrajo ADB, ingrese el siguiente comando: cd /ruta/a/extraído/carpeta/
    • Por ejemplo, puede colocar los contenidos en su escritorio: cd /Usuarios/XDA/Escritorio/plataforma-herramientas/
  5. Conecta tu dispositivo a tu Mac con un cable USB compatible. Cambie el modo de conexión USB al modo "transferencia de archivos (MTP)". Esto no siempre es necesario para todos los dispositivos, pero es mejor dejarlo en este modo para que no tenga ningún problema.
  6. Una vez que la Terminal esté en la misma carpeta en la que se encuentran sus herramientas ADB, puede ejecutar el siguiente comando para iniciar el demonio ADB: ./dispositivos adb
  7. En su dispositivo, verá un Permitir la depuración USB inmediato. Permitir la conexión.
  8. Finalmente, vuelva a ingresar el comando del paso 7. Si todo fue exitoso, ahora debería ver el número de serie de su dispositivo en la ventana Terminal de macOS.

¡Felicidades! ¡Ahora puede ejecutar cualquier comando ADB en su dispositivo! Ahora ve y comienza a modificar tu teléfono.

Si bien la guía anterior ciertamente funcionará, los usuarios veteranos de macOS también pueden optar por instalar ADB en sus Mac usando un administrador de paquetes no oficial como Cerveza casera o MacPorts. De esa manera, no tiene que actualizar manualmente los archivos binarios.

Cómo configurar ADB en Linux

  1. Descargar el Archivo ZIP de Android SDK Platform Tools para Linux.
  2. Extraiga el ZIP a una ubicación de fácil acceso (como el escritorio, por ejemplo).
  3. Abra una ventana de Terminal.
  4. Introduzca el siguiente comando: cd /ruta/a/extraído/carpeta/
  5. Esto cambiará el directorio a donde extrajo los archivos ADB.
    • Ejemplo: cd /home/XDA/Escritorio/plataforma-herramientas/
  6. Conecte su dispositivo a su máquina Linux con su cable USB. Cambie el modo de conexión al modo "transferencia de archivos (MTP)". Esto no siempre es necesario para todos los dispositivos, pero se recomienda para que no tenga ningún problema.
  7. Una vez que la Terminal esté en la misma carpeta en la que se encuentran sus herramientas ADB, puede ejecutar el siguiente comando para iniciar el demonio ADB: ./dispositivos adb
  8. De vuelta en su teléfono inteligente o tableta, verá un mensaje que le pedirá que permita la depuración de USB. Adelante, concédelo.
  9. Finalmente, vuelva a ingresar el comando del paso 8. Si todo fue exitoso, ahora debería ver el número de serie de su dispositivo en la salida de la ventana Terminal.

¡Felicitaciones! ¡Ahora puede ejecutar cualquier comando ADB en su dispositivo!

Los usuarios de Linux deben saber que existe una forma más fácil de instalar ADB en sus computadoras. La guía anterior sin duda funcionará para usted, pero aquellos que poseen un Debian/Ubuntu convencional o La distribución de Linux basada en Fedora/SUSE puede omitir los pasos 1 y 2 de la guía anterior y usar uno de los siguientes comandos:

  • Los usuarios de Linux basados ​​en Debian/Ubuntu pueden escribir el siguiente comando para instalar ADB:
    sudo apt-conseguir instalar android-sdk-plataforma-herramientas
  • Los usuarios de Linux basados ​​en Fedora/SUSE pueden escribir el siguiente comando para instalar ADB:
    sudo dnf instalar herramientas android

Sin embargo, siempre es mejor optar por el último binario de la versión de Android SDK Platform Tools, ya que los paquetes específicos de distribución a menudo contienen compilaciones obsoletas.

Caso especial: cómo configurar ADB en el subsistema de Windows para Linux y ChromeOS

Subsistema de Windows para Linux (WSL) ofrece a los usuarios de Windows una manera perfecta de ejecutar aplicaciones de Linux. Sin embargo, el entorno todavía tiene que ofrecer acceso completo al hardware USB. Como consecuencia, ADB bajo WSL no puede acceder a su dispositivo Android, incluso si lo instala de la manera mencionada anteriormente. No obstante, existe una solución oficial, que utiliza el código abierto usbipd-ganar proyecto. Para saber más, echa un vistazo a nuestro tutorial sobre cómo configurar el paso de USB en WSL.

Para ChromeOS, debe activar el entorno de desarrollo de Linux incorporado primero. Por defecto, le ofrece una instancia de Debian. A continuación, puede configurar fácilmente ADB siguiendo los pasos mencionados anteriormente.

Solo para cubrir todas nuestras bases aquí, es posible que los usuarios deban poner un ./ frente a los comandos ADB que enumeramos en futuros tutoriales, especialmente cuando utilizan los archivos binarios extraídos directamente del ZIP de herramientas de plataforma proporcionado por Google. Esto es algo que cualquier usuario de *nix (o usuario de Windows que ejecute PowerShell/Terminal) probablemente sabrá, pero nuevamente, queremos como tanta gente como sea posible para entender cómo hacer estos ajustes para Android sin importar cuánto de su sistema operativo saber.

Opcional: Cómo configurar ADB en su navegador

El protocolo ADB se puede implementar utilizando la API WebUSB para controlar teléfonos Android directamente desde navegadores web. Sin embargo, otro WebADB, también conocido como ya-webadb, es uno de esos proyectos que permite a los usuarios realizar la mayor parte de la funcionalidad proporcionada por ADB directamente desde el navegador web sin instalar ningún binario o controlador. Todo lo que necesita es un navegador web que admita la API WebUSB (como Google Chrome, Microsoft Edge o Firefox) y estará listo para comenzar.

Opcional: Cómo usar ADB a través de Wi-Fi

Android 11 y las ediciones superiores admiten de forma nativa la conexión ADB a través de Wi-Fi. Esto elimina la necesidad de lidiar con problemas comunes de conexión USB y pasos adicionales como Instalación del controlador OEM de Android en Windows

Para configurar la depuración inalámbrica, haga lo siguiente:

  1. Asegúrese de que su PC/Mac y el teléfono estén conectados a la misma red inalámbrica.
  2. En tu teléfono, ve a Opciones de desarrollador bajo Ajustes y habilitar Depuración inalámbrica. Sobre el ¿Permitir la depuración inalámbrica en esta red? ventana emergente, seleccione Permitir.
  3. Toque en el Depuración inalámbrica opción y seleccione Emparejar dispositivo con código de emparejamiento.
  4. Tome nota del código de emparejamiento, la dirección IP y el número de puerto que se muestran en la pantalla del teléfono.
  5. En su PC/Mac, ejecute el siguiente comando:
    adbparDirección IP:Puerto
    Utilice la dirección IP y el número de puerto del paso 4.
  6. Cuando se le solicite, ingrese el código de emparejamiento que recibió en el paso 4. Un mensaje debería indicar que su dispositivo se ha emparejado correctamente.
  7. A continuación, ejecute el siguiente comando en la ventana de terminal de la PC/Mac:
    adbconectarDirección IP:Puerto
    mira el dirección IP y puerto sección bajo Depuración inalámbrica en el paso 3 para la dirección IP y el puerto.
  8. Si todo va bien, debería ver un mensaje como el siguiente:
    conectadoa 192.168.68.100:37173
  9. Ahora está listo para escribir cualquier comando de shell ADB que desee.

Ejemplos de comandos ADB

Para comprobar si ha instalado correctamente ADB, conecte su dispositivo a su PC/Mac con su cable USB y ejecute el dispositivos adb comando como se describe arriba. Debería mostrar su dispositivo en la ventana del símbolo del sistema/PowerShell/Terminal. Si obtiene un resultado diferente, le recomendamos comenzar de nuevo con los pasos.

Como se mencionó anteriormente, puede usar ADB para hacer todo tipo de cosas en un dispositivo Android. Algunos de estos comandos están integrados directamente en el binario ADB y deberían funcionar en todos los dispositivos. También puede abrir lo que se conoce como ADB Shell que le permitirá ejecutar comandos directamente en el dispositivo. Los comandos que se ejecutan directamente en el dispositivo pueden variar de un dispositivo a otro (ya que los OEM pueden eliminar acceder a ciertos, y también modificar el comportamiento de ADB) y puede variar de una versión de Android a la siguiente como Bueno.

A continuación, encontrará una lista de comandos de ejemplo que puede ejecutar en su dispositivo:

  • Imprima una lista de dispositivos conectados: dispositivos adb
  • Matar el servidor ADB: adb matar-servidor
  • Instalar una aplicación: instalación adb
  • Configurar el reenvío de puertos: adb reenviar tcp: 6100 tcp: 7100
  • Copie un archivo/directorio desde el dispositivo: tirar adb
  • Copie un archivo/directorio al dispositivo: empujar adb
  • Inicie un shell ADB: shell adb

Prima

Para aquellos que quieran llevar esto un paso más allá, pueden seguir este nuevo tutorial que preparamos y que los guiará. cómo configurar ADB para que pueda usar el comando desde cualquier directorio en un escritorio de Windows o Linux.

¿Qué más puedo hacer con ADB?

A continuación hay una lista de tutoriales de XDA para varios dispositivos que detallan muchas aplicaciones de comandos ADB para modificar configuraciones ocultas, personalizar funciones OEM o interfaces de usuario, ¡y mucho más!

  • Cómo iniciar en modo de recuperación usando combinaciones de botones, ADB y aplicaciones raíz
  • Cómo desinstalar bloatware de operador/OEM sin acceso de root
  • Cómo desbloquear tu teléfono (y más) sin conectarlo a una PC
  • Cómo descargar aplicaciones en Android TV: instalación de APK y métodos de carga lateral de ADB explicados en pasos fáciles de seguir.
  • Recupere los mosaicos de configuración rápida de Wi-Fi y datos móviles en Android 12 y superior
  • Controla tu Smartphone Android desde tu PC gratis con scrcpy
  • Cómo emparejar relojes Android Wear con teléfonos nuevos sin restablecer los valores de fábrica

Esto es sólo la punta del iceberg. No olvides revisar nuestros comandos ADB para cada tutorial de usuario avanzado ¡para conocer más consejos y trucos útiles para usar ADB!