ADB: conceptos básicos de Android Debug Bridge y comandos populares

Qué es ADB y para qué sirve

Android Debug Bridge (ADB) es una aplicación cliente-servidor compuesta por tres componentes: un cliente (se ejecuta en el ordenador), un servidor (proceso en segundo plano en el ordenador) y un demonio adbd (se ejecuta en el propio dispositivo Android). Cuando un desarrollador o ingeniero conecta un teléfono inteligente al PC, ADB crea un canal de comunicación fiable a través del cual se pueden transmitir comandos, archivos y datos.

Los principales casos de uso de ADB incluyen la depuración de aplicaciones en un dispositivo real sin necesidad de publicar un APK en una tienda, la extracción de registros para el análisis de errores, la automatización de pruebas, la copia de seguridad de datos, el flasheo de imágenes de recovery y la obtención de acceso root. Incluso si no escribes código, ADB puede ser útil para extraer capturas de pantalla de aplicaciones, grabar una guía en vídeo desde la pantalla del teléfono o recuperar un dispositivo tras una actualización de firmware fallida.

El soporte de ADB está integrado en todas las compilaciones oficiales de Android a partir de la versión 2.1 (API 7). Requiere que la opción Depuración USB esté activada en los ajustes de desarrollador. A partir de Android 4.2, el dispositivo solicita confirmación en la primera conexión: debes permitir la depuración para el ordenador específico mediante su clave RSA.

Instalación de ADB en el ordenador

Para Windows — descarga Platform Tools desde el sitio web oficial de Google Developers, extrae el archivo en la carpeta C:\adb y añade esta ruta a la variable de entorno PATH. Tras reiniciar la terminal, el comando adb estará disponible globalmente.

Para macOS — la forma más sencilla es instalar ADB mediante el gestor de paquetes Homebrew: ejecuta brew install android-platform-tools. Todas las dependencias se resolverán automáticamente.

Para Linux — en distribuciones basadas en Debian / Ubuntu: sudo apt install adb. Tras la instalación, añade el usuario al grupo plugdev: sudo usermod -aG plugdev $USER y vuelve a iniciar sesión para que ADB pueda acceder a los dispositivos USB.

Verifica la instalación con el comando adb version. Si la salida muestra el número de versión de Android Debug Bridge, la herramienta está lista para usar.

Conexión del dispositivo y comandos básicos

Primera conexión siempre comienza con el comando adb devices. Muestra una lista de los dispositivos conectados y su estado. Si el dispositivo aparece como unauthorized, desbloquea la pantalla y confirma la depuración en el teléfono.

adb devices
List of devices attached
emulator-5554   device
0123456789ABCD  device

Instalación de una aplicación — una de las operaciones más frecuentes. Basta con indicar la ruta al archivo APK:

adb install C:\apps\myapp.apk

Si la aplicación ya está instalada pero hay que reemplazarla con una versión actualizada, añade el indicador -r (replace):

adb install -r C:\apps\myapp-v2.apk

Desinstalación de una aplicación se realiza por nombre de paquete:

adb uninstall com.example.myapp

Copia de archivos — adb pull extrae un archivo del dispositivo al ordenador, adb push sube un archivo al dispositivo:

adb pull /sdcard/DCIM/screenshot.png .
adb push myfile.txt /sdcard/Documents/

Shell interactivo — el comando adb shell abre la shell de comandos del dispositivo. Dentro de ella se pueden ejecutar comandos estándar de Linux: ls, ps, top, dumpsys, pm, am y otros.

adb shell
tissot_sprout:/ $ ls -la /sdcard/
tissot_sprout:/ $ ps | grep com.android.chrome

Inicio de una actividad a través de ADB permite abrir cualquier aplicación o pantalla sin buscar el icono manualmente:

adb shell am start -n com.android.chrome/com.google.android.apps.chrome.Main

Trabajo con registros: Logcat

Logcat es el sistema de registro de Android que recoge mensajes de aplicaciones, servicios del sistema y el kernel. La herramienta es indispensable para la depuración: los registros ayudan a entender por qué falló una aplicación, qué método provocó una excepción o cuánto tarda una operación concreta.

Un inicio simple sin filtros — adb logcat. El flujo de registros es infinito; pulsa Ctrl+C para detenerlo. Para filtrar mensajes por etiqueta, usa el parámetro -s:

adb logcat -s MainActivity:V

Niveles de severidad del registro (de más detallado a crítico): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). La combinación de una etiqueta y un nivel permite resaltar solo los mensajes necesarios.

Para limpiar el búfer acumulado antes de una prueba:

adb logcat -c

Y para guardar los registros en un archivo:

adb logcat -d > app_logs.txt

El indicador -d (dump) muestra el búfer actual y finaliza sin bloquear la terminal. Esto es útil para scripts de automatización.

Capturas de pantalla, grabación y comandos de diagnóstico útiles

Captura de pantalla se realiza con el comando adb shell screencap. El resultado se guarda en un archivo que luego se recupera mediante adb pull:

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

Se pueden combinar ambas operaciones en una sola línea mediante sustitución y tuberías. En la práctica, esto acelera la creación de documentación e informes de pruebas.

Grabación de pantalla está disponible en Android 4.4+ (API 19). La duración de grabación predeterminada es de 180 segundos, la tasa de bits es de 4 Mbps. El comando principal:

adb shell screenrecord /sdcard/demo.mp4

Pulsa Ctrl+C para detener la grabación. La resolución del vídeo coincide con la resolución de la pantalla del dispositivo pero no supera 1080p. Para cambiar la tasa de bits, especifica --bit-rate:

adb shell screenrecord --bit-rate 8000000 /sdcard/demo.mp4

Comandos de diagnóstico: adb shell dumpsys muestra el estado de todos los servicios del sistema. Para obtener solo información de la batería:

adb shell dumpsys battery

La lista de paquetes instalados se puede obtener mediante Package Manager:

adb shell pm list packages

Restablecer los ajustes de una aplicación (equivalente a borrar datos en ajustes):

adb shell pm clear com.example.myapp

Funcionalidades avanzadas de ADB

Depuración Wi-Fi elimina la necesidad de mantener el dispositivo conectado por USB. Asegúrate de que el ordenador y el dispositivo estén en la misma red. Primero ejecuta adb tcpip 5555, desconecta el USB, luego conéctate por IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Si se desconoce la dirección IP del dispositivo, averíguala mediante adb shell ip addr show wlan0 antes de desconectar el cable.

Copia de seguridad de una aplicación o de todo el sistema se puede realizar sin root:

adb backup -apk -shared -all -system -f mybackup.ab

Restauración desde una copia de seguridad:

adb restore mybackup.ab

Emulación de entrada — el comando adb shell input permite simular toques, deslizamientos, pulsaciones de teclas y entrada de texto. Esta es la base para la automatización de pruebas de UI sin frameworks adicionales:

adb shell input tap 500 1000
adb shell input swipe 300 500 800 500
adb shell input text "Hello, ADB!"

Reinicio en diferentes modos:

adb reboot          # normal reboot
adb reboot recovery # recovery mode
adb reboot bootloader # bootloader (fastboot)

El modo fastboot proporciona acceso para flashear imágenes, desbloquear el bootloader e instalar recovery personalizado.

Trabajo con varios dispositivos

Cuando hay varios dispositivos o emuladores conectados simultáneamente, ADB requiere un número de serie específico. El comando adb devices muestra todos los dispositivos conectados con sus números de serie.

Para dirigir un comando a un dispositivo concreto usa el indicador -s:

adb -s 0123456789ABCD install myapp.apk

Si solo hay un dispositivo, se puede omitir el indicador. Sin embargo, en un entorno de CI donde se ejecutan varios emuladores simultáneamente, es obligatorio especificar el número de serie.

Matar el servidor ADB — si un dispositivo deja de detectarse o da un error, reiniciar el servidor ayuda:

adb kill-server
adb start-server

Después de eso ejecuta adb devices — el servidor se reiniciará y redirigirá las solicitudes a los demonios de los dispositivos.

Comandos principales de ADB: tabla de referencia

Conclusión

ADB (Android Debug Bridge) es una herramienta fundamental para cualquiera que trabaje con Android a nivel profesional. Desde la instalación básica de aplicaciones hasta la automatización compleja de pruebas y la recuperación de dispositivos — ADB cubre prácticamente cualquier escenario de interacción entre el ordenador y un teléfono inteligente o tableta.

Al dominar los comandos descritos en este artículo, podrás gestionar con confianza un dispositivo Android a través del terminal, analizar registros, tomar capturas de pantalla para documentación, realizar copias de seguridad y acelerar el proceso de desarrollo. La práctica regular y el estudio de la salida de adb help te convertirán en un usuario experimentado de esta potente herramienta.