adb - manual de referencia, opciones, ejemplos de comandos


NOMBRE

adb - Puente de depuración de Android

SINOPSIS

adb [-d|-e|-s serialNumber] command

DESCRIPCIÓN

ADVERTENCIA: este manual puede estar desactualizado, consulte la documentación oficial.

Android Debug Bridge (adb) es una herramienta de línea de comandos versátil que le permite comunicarse con una instancia de emulador o un dispositivo conectado con Android. Es un programa cliente-servidor que incluye tres componentes:

  • Un cliente, que envía comandos. El cliente se ejecuta en su máquina de desarrollo. Puede invocar a un cliente desde un shell emitiendo un comando adb. Otras herramientas de Android, como DDMS, también crean clientes adb.

  • Un demonio, que ejecuta comandos en un dispositivo. El daemon se ejecuta como un proceso en segundo plano en cada emulador o instancia de dispositivo.

  • Un servidor, que gestiona la comunicación entre el cliente y el daemon. El servidor se ejecuta como un proceso en segundo plano en su máquina de desarrollo.

Si solo hay un emulador ejecutándose o solo un dispositivo conectado, el comando adb se envía a ese dispositivo de manera predeterminada. Si se están ejecutando varios emuladores y/o hay varios dispositivos conectados, debe usar la opción -d, -e o -s para especifique el dispositivo de destino al que se debe dirigir el comando.

OPCIONES

-a

Indica a adb que escuche en todas las interfaces para una conexión.

-d

Dirige el comando al único dispositivo USB conectado. Devuelve un error si hay más de un dispositivo USB presente.

-e

Dirige el comando al único emulador en ejecución. Devuelve un error si se está ejecutando más de un emulador.

-s specific device

Dirige el comando al dispositivo o emulador con el número de serie o calificador proporcionado. Anula la variable de entorno ANDROID_SERIAL.

-p product name or path

Nombre de producto simple como antes, o una ruta relativa/absoluta al directorio de salida de un producto como salida/objetivo/producto/antes. Si no se especifica -p, se utiliza la variable de entorno ANDROID_PRODUCT_OUT, que debe ser una ruta absoluta.

-H

Nombre del host del servidor adb (predeterminado: localhost)

-P

Puerto del servidor adb (predeterminado: 5037)

COMANDOS

adb devices [-l]

Enumere todos los dispositivos conectados. -l también enumerará los calificadores de dispositivos.

adb connect host[:port]

Conéctese a un dispositivo a través de TCP/IP. El puerto 5555 se utiliza de forma predeterminada si no se especifica ningún número de puerto.

adb disconnect [host[:port]]

Desconéctese de un dispositivo TCP/IP. El puerto 5555 se utiliza de forma predeterminada si no se especifica ningún número de puerto. El uso de este comando sin argumentos adicionales lo desconectará de todos los dispositivos TCP/IP conectados.

Comandos de dispositivo

adb push local... remote

Copie el archivo/directorio al dispositivo.

adb pull [-a] remote [local]

Copie el archivo/directorio del dispositivo. -a significa copia de marca de tiempo y modo.

adb sync [-l] [directory]

Copie host->dispositivo solo si ha cambiado. -l significa enumerar pero no copiar.

Si no se especifica directorio, /sistema, /proveedor (si está presente), /oem (si está presente) y las particiones /data se actualizarán.

Si es sistema, proveedor, oem o datos, solo se actualiza la partición correspondiente.

adb shell [-e escape] [-n] [-T|-t] [-x] [command]

Ejecute el comando de shell remoto (shell interactivo si no se da ningún comando)

  • -e: elige el carácter de escape o ninguno; predeterminado ~

  • -n: no leer desde stdin

  • -T: deshabilitar la asignación de PTY

  • -t: Forzar asignación de PTY

  • -x: deshabilita los códigos de salida remota y la separación stdout/stderr

adb emu command

Ejecutar el comando de la consola del emulador

adb logcat [filter-spec]

Ver registro del dispositivo.

adb forward --list

Enumere todas las conexiones de socket directo. El formato es una lista de líneas con el siguiente formato: serial " " local " " remoto ""

adb forward local remote

Conexiones de enchufe delantero.

Las especificaciones delanteras son una de:

  • tcp:puerto

  • resumen local:nombre de socket de dominio unix

  • localreservado:nombre de socket de dominio unix

  • sistema de archivos local:nombre de socket de dominio unix

  • dev:nombre del dispositivo del personaje

  • jdwp:procesar pid (solo remoto)

adb forward --no-rebind local remote

Igual que "adb reenviar local remoto", pero falla si local ya está reenviado

adb forward --remove local

Eliminar una conexión de socket directa específica.

adb forward --remove-all

Retire todas las conexiones de enchufe delanteras.

adb reverse --list

Enumere todas las conexiones de socket inverso del dispositivo.

adb reverse remote local

Conexiones de enchufe inversas.

Las especificaciones inversas son una de:

  • tcp:puerto

  • resumen local:nombre de socket de dominio unix

  • localreservado:nombre de socket de dominio unix

  • sistema de archivos local:nombre de socket de dominio unix

adb reverse --no-rebind remote local

Igual que 'adb reverse remote local' pero falla si remote ya está invertido.

adb reverse --remove remote

Eliminar una conexión de socket invertida específica.

adb reverse --remove-all

Retire todas las conexiones de enchufe invertidas del dispositivo.

adb jdwp

Enumere los PID de los procesos que alojan un transporte JDWP.

adb install [-lrtsdg] file

Empuje este archivo de paquete al dispositivo e instálelo.

  • -l: aplicación de bloqueo hacia adelante.

  • -r: reemplaza la aplicación existente.

  • -t: Permitir paquetes de prueba.

  • -s: Instalar la aplicación en la tarjeta SD.

  • -d: permitir la degradación del código de la versión (solo paquetes depurables).

  • -g: Otorga todos los permisos de tiempo de ejecución.

adb install-multiple [-lrtsdpg] file...

Empuje este archivo de paquete al dispositivo e instálelo.

  • -l: aplicación de bloqueo hacia adelante.

  • -r: reemplaza la aplicación existente.

  • -t: Permitir paquetes de prueba.

  • -s: Instalar la aplicación en la tarjeta SD.

  • -d: permitir la degradación del código de la versión (solo paquetes depurables).

  • -p: instalación parcial de la aplicación.

  • -g: Otorga todos los permisos de tiempo de ejecución.

adb uninstall [-k] package

Elimina este paquete de aplicaciones del dispositivo. -k significa mantener los directorios de datos y caché.

adb bugreport [zipfile]

Devuelva toda la información del dispositivo que debería incluirse en un informe de errores.

adb backup [-f file] [-apk|-noapk] [-obb|-noobb] [-shared|-noshared] [-all] [-system|-nosystem] [packages...]

Escriba un archivo de los datos del dispositivo en archivo. Si no se proporciona la opción -f, los datos se escriben en backup.ab en el directorio actual.

-apk | -noapk habilitar/deshabilitar la copia de seguridad de los .apks mismos en el archivo; el valor predeterminado es noapk.

-obb | -noobb habilita/deshabilita la copia de seguridad de cualquier archivo de expansión apk instalado (también conocido como .obb) asociado con cada aplicación; el valor predeterminado es noobb.

-compartido | -noshared habilitar/deshabilitar la copia de seguridad del contenido de la tarjeta SD/almacenamiento compartido del dispositivo; el valor predeterminado es noshared.

-all significa hacer una copia de seguridad de todas las aplicaciones instaladas.

-sistema | -nosystem alterna si -all incluye automáticamente las aplicaciones del sistema; el valor predeterminado es incluir aplicaciones del sistema.

paquetes... es la lista de aplicaciones de las que se realizará una copia de seguridad. Si se pasan las marcas -all o -shared, la lista de paquetes es opcional. Las aplicaciones proporcionadas explícitamente en la línea de comando se incluirán incluso si -nosystem normalmente haría que se omitan.

adb restore file

Restaure el contenido del dispositivo desde el archivo de copia de seguridad archivo.

adb disable-verity

Deshabilite la verificación de dm-verity en las compilaciones USERDEBUG.

adb enable-verity

Vuelva a habilitar la comprobación de dm-verity en las compilaciones USERDEBUG.

adb keygen file

Generar clave pública/privada adb. La clave privada se almacena en archivo y la clave pública se almacena en archivo.pub. Se sobrescriben todos los archivos existentes.

adb help

Mostrar mensaje de ayuda.

adb version

Mostrar número de versión.

secuencias de comandos

adb wait-for-[-transport]-state

Espere a que el dispositivo esté en el estado dado: dispositivo, recuperación, carga lateral o cargador de arranque. transporte es: usb, local o cualquiera (predeterminado=cualquiera)

adb start-server

Asegúrese de que haya un servidor en ejecución.

adb kill-server

Elimine el servidor si se está ejecutando.

adb get-state

Impresiones: sin conexión | cargador de arranque | dispositivo

adb get-serialno

Imprime: número de serie.

adb get-devpath

Imprime: ruta del dispositivo.

adb remount

Vuelve a montar las particiones /system, /vendor (si está presente) y /oem (si está presente) en el dispositivo de lectura y escritura.

adb reboot [bootloader|recovery]

Reinicia el dispositivo, opcionalmente en el gestor de arranque o el programa de recuperación.

adb reboot sideload

Reinicia el dispositivo en el modo de carga lateral en el programa de recuperación (se requiere adb root).

adb reboot sideload-auto-reboot

Se reinicia en el modo de prueba, luego se reinicia automáticamente después de la prueba, independientemente del resultado.

adb sideload file

Carga lateralmente el paquete dado.

adb root

Reinicia el demonio adbd con permisos de root.

adb unroot

Reinicia el demonio adbd sin permisos de root.

adb usb

Reinicia el demonio adbd escuchando en USB.

adb tcpip port

Reinicia el demonio adbd escuchando en TCP en el puerto especificado.

Redes

adb ppp tty [parameters]

Ejecute PPP a través de USB.

parámetros: Ej. defaultroute debug dump local notty usepeerdns

Nota: no debe iniciar automáticamente una conexión PPP. tty se refiere al tty para flujo PPP. P.ej. dev:/dev/omap_csmi_tty1

Depuración interna

adb reconnect

Elimine la conexión actual del lado del host y haga que se vuelva a conectar.

adb reconnect device

Elimina la conexión actual desde el lado del dispositivo y haz que se vuelva a conectar.

VARIABLES DE ENTORNO

ADB_TRACE

Imprimir información de depuración. Una lista separada por comas de los siguientes valores 1 o todos, adb, sockets, paquetes, rwx, usb, sincronización, sysdeps, transporte, jdwp

ANDROID_SERIAL

El número de serie al que conectarse. -s tiene prioridad sobre esto si se da.

ANDROID_LOG_TAGS

Cuando se usa con la opción logcat, solo se imprimen estas etiquetas de depuración.

VER TAMBIÉN

https://developer.android.com/tools/help/adb.html

AUTORES

El proyecto de código abierto de Android.