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 el BAD?
  • Cómo configurar el BAD
  • Ejemplos de comandos ADB
  • ¿Qué más puedo hacer con ADB?

Sólo 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. Generalmente, estos se han realizado con la ayuda de algunos comandos de línea de comandos de 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 componen todo el proceso.

  1. El cliente, es decir, el PC/Mac/Chromebook que tienes conectado a tu 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 demonio se ejecuta como un proceso en segundo plano en cada dispositivo.
  3. Un servidor que gestiona la comunicación entre el cliente y el demonio. El servidor se ejecuta como un proceso en segundo plano en la computadora.

¿Cómo funciona el BAD?

Debido a que hay tres partes que componen ADB (el cliente, el demonio y el servidor), esto requiere que ciertas partes estén en funcionamiento en primer lugar. Si recién inició la computadora (y no la tiene configurada para iniciar el demonio al iniciar), entonces necesitarás que esté ejecutándose 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 en la terminal, que verificará que el demonio se esté ejecutando.

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

Cómo configurar el BAD

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

Configuración del teléfono

  1. Inicie el Ajustes aplicación en su teléfono.
  2. Toque en el Acerca del teléfono opción generalmente cerca del final de la lista.
    • Dependiendo de la piel OEM, el Acerca del teléfono La página puede tener otro nombre o estar enterrada en algún otro lugar del Ajustes aplicación en su dispositivo.
  3. Luego toque el Número de compilación opción siete veces para habilitar el modo 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 puedes acceder. En los teléfonos Google Pixel y algunos otros dispositivos, es posible que tengas que 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 herramientas de plataforma SDK de Android 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 Abra la ventana de comando 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 fabricantes de equipos originales pueden requerir esto o no, pero es mejor dejarlo en este modo para lograr compatibilidad general.
  6. En la ventana Símbolo del sistema/Terminal, ingrese el siguiente comando para iniciar el demonio ADB: adb devices
  7. En la pantalla de su teléfono, debería ver un mensaje para permitir o denegar el acceso a la depuración USB. Naturalmente, querrá otorgar acceso a la depuración USB cuando se le solicite (y toque la casilla de verificación permitir siempre si no desea volver a ver ese mensaje nunca más).
  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 continúa 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 herramientas de plataforma SDK de Android 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 /path/to/extracted/folder/
    • Por ejemplo, puedes colocar el contenido en tu escritorio: cd /Users/XDA/Desktop/platform-tools/
  5. Conecte su dispositivo a su 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 no tener 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: ./adb devices
  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 continúa 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 Puertos Mac. De esa manera, no tendrás que actualizar manualmente los archivos binarios.

Cómo configurar ADB en Linux

  1. Descargar el Archivo ZIP de herramientas de plataforma SDK de Android 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. Ingrese el siguiente comando: cd /path/to/extracted/folder/
  5. Esto cambiará el directorio donde extrajo los archivos ADB.
    • Ejemplo: cd /home/XDA/Desktop/platform-tools/
  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 no tener 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: ./adb devices
  8. De vuelta en su teléfono inteligente o tableta, verá un mensaje que le pedirá que permita la depuración 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 sencilla de instalar ADB en sus computadoras. La guía anterior ciertamente funcionará para usted, pero aquellos que poseen un sistema Debian/Ubuntu 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-get install android-sdk-platform-tools
  • Los usuarios de Linux basados ​​en Fedora/SUSE pueden escribir el siguiente comando para instalar ADB:
    sudo dnf install android-tools

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

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 antes mencionada. No obstante, existe una solución alternativa oficial, que utiliza el código abierto usbipd-win proyecto. Para saber más, echa un vistazo a nuestro tutorial sobre cómo configurar el paso a través de USB en WSL.

Para ChromeOS, necesitas active el entorno de desarrollo de Linux integrado primero. Por defecto, te ofrece una instancia de Debian. Luego puede configurar ADB fácilmente siguiendo los pasos mencionados anteriormente.

Sólo para cubrir todas nuestras bases aquí, es posible que los usuarios necesiten poner un ./ delante de 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 que que la mayor cantidad de personas posible entiendan cómo hacer estos ajustes para Android sin importar cuánto de su sistema operativo utilice. 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. Otro WebADB más, 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 listo.

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

Android 11 y 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. Toca 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:
    adbpairIP_Address:Port
    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 PC/Mac:
    adbconnectIP_Address:Port
    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ías ver un mensaje como el siguiente:
    connectedto 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 ADB correctamente, conecte su dispositivo a su PC/Mac con su cable USB y ejecute el adb devices comando como se describe arriba. Debería mostrar su dispositivo listado en la ventana Símbolo del sistema/PowerShell/Terminal. Si obtiene un resultado diferente, le recomendamos comenzar de nuevo con los pasos.

Como se mencionó anteriormente, puedes 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 según Bueno.

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

  • Imprima una lista de dispositivos conectados: adb devices
  • Mata el servidor ADB: adb kill-server
  • Instalar una aplicación: adb install
  • Configurar el reenvío de puertos: adb forward tcp: 6100 tcp: 7100
  • Copie un archivo/directorio del dispositivo: adb pull
  • Copie un archivo/directorio al dispositivo: adb push
  • Inicie un shell ADB: adb shell

Prima

Para aquellos que quieran ir un paso más allá, pueden seguir este nuevo tutorial que hemos preparado y que les 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 se muestra una lista de tutoriales de XDA para varios dispositivos que detallan muchas aplicaciones de los 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 conectarte a una PC
  • Cómo descargar aplicaciones en Android TV: ¡Los métodos de instalación de APK y ADB Sideload se explican 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 versiones posteriores
  • 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!