|
adb - Android Debug Bridge
SYNOPSIS
adb [-d|-e|-s serialNumber] command
[Описание]
ПРЕДУПРЕЖДЕНИЕ: это руководство может быть устаревшим, обратитесь к официальной документации [1].
Android Debug Bridge (adb) это продвинутая утилита командной строки, которая позволяет взаимодействовать с экземпляром эмулятора или подключенным Android-устройством(1). Это программа клиента и сервера, включающая 3 компонента:
• Клиент, который отправляет команды. Клиент запускается на машине разработчика. Вы можете запустить клиент в шелле с помощью команды adb command. Другие утилиты Android, такие как DDMS, также создают клиентов adb.
• Демон (daemon), который запускает команды на устройстве. Демон работает как фоновый процесс на каждом эмуляторе или экземпляре устройства.
• Сервер, который управляет коммуникацией между клиентом и демоном. Сервер работает как фоновый процесс на вашей машине разработчика.
Примечание (1): adb часто используется с многими встраиваемыми устройствами на основе Linux, например с платами разработчика LuckFox Pico [2].
Если на хосте разработчика запущен только один эмулятор, или к нему подключено только одно отлаживаемое устройство, то команда adb по умолчанию соединяется с этим устройством. Если запущено несколько эмуляторов и/или отлаживаемых устройств, то необходимо указывать опцию -d, -e или -s, чтобы указать конкретное целевое устройство, которому предназначена команда.
[Опции]
-a Направляет adb прослушивать все интерфейсы для соединения.
-d Направляет команду только подключенному устройству USB. Возвратит ошибку, если присутствует больше одного USB-устройства.
-e Направляет команду только запущенному эмулятору. Возвратит ошибку, если запущено больше одного эмулятора.
-s определенное_устройство
Направляет команду на устройство или эмулятор с указанным серийным номером или квалификатором. Отменяет действие переменной окружения ANDROID_SERIAL.
-p product_name или path
Просто название продукта, или относительный/абсолютный путь до выходной директории продукта наподобие out/target/product/sooner. Если -p не указан, то используется переменная окружения ANDROID_PRODUCT_OUT, которая должна быть абсолютным путем.
-H Имя хоста adb-сервера (default: localhost)
-P Порт adb-сервера (default: 5037)
[Команды]
adb devices [-l]
Выдаст список всех подключенных устройств. -l будет также выводить список квалификаторов устройства.
adb connect host[:port]
Подлючится к устройству через TCP/IP. По умолчанию используется порт 5555, если номер порта не указан.
adb disconnect [host[:port]]
Отключится от устройства TCP/IP. По умолчанию используется порт 5555, если номер порта не указан. Использование этой команды без дополнительных аргументов приведет к отключению от всех подключенных по TCP/IP устройств.
Команды устройства:
adb push local... remote
Копирует файл/директорию на устройство.
adb pull [-a] remote [local]
Копирует файл/директорию с устройства. -a означает компировать также метку времени и режим доступа.
adb sync [-l] [directory]
Копирует host -> device только если есть изменения. -l означает вывести список, но не копировать.
Если directory не указана, то будут обновлены разделы /system, /vendor (если присутствует), /oem (если присутствует) и /data.
Если это system, vendor, oem или data, то обновится только соответствующий раздел.
adb shell [-e escape] [-n] [-T|-t] [-x] [command]
Запустит удаленный шелл команд - интерактивный шелл, т. е. терминал с командной строкой на отлаживаемом устройстве, где пользователь может впоследствии вводить и выполнять команды.
• -e: выберет символ выхода (escape character), или none; default ~
• -n: не читать из stdin
• -T: запретить выделение PTY
• -t: принудительно выделить PTY
• -x: запретить remote exit codes и разделение stdout/stderr
adb emu command
Запустит команду command консоли эмулятора.
adb logcat [filter-spec]
Просмотр лога устройства.
adb forward --list
Выведет список всех перенаправленных (forward socket) соединений. Формат списка строк: serial " " local " " remote ""
adb forward local remote
Перенаправит соединения socket.
Спецификация перенаправления это одно из следующего:
• tcp:port
• localabstract:unix domain socket name
• localreserved:unix domain socket name
• localfilesystem:unix domain socket name
• dev:character device name
• jdwp:process pid (remote only)
adb forward --no-rebind local remote
То же самое, что и "adb forward local remote", но потерпит неудачу, если local уже перенаправлен.
adb forward --remove local
Удалит определенное соединение forward socket.
adb forward --remove-all
Удалит все forward socket соединения.
adb reverse --list
Выведет список всех обратных соединений (reverse socket connections) из устройства.
adb reverse remote local
Reverse socket connections.
Спецификация reverse это одно из следующего:
• tcp:port
• localabstract:unix domain socket name
• localreserved:unix domain socket name
• localfilesystem:unix domain socket name
adb reverse --no-rebind remote local
То же самое, что и 'adb reverse remote local', но потерпит неудачу, если remote уже реверсировано.
adb reverse --remove remote
Удалит определенное reversed socket connection.
adb reverse --remove-all
Удалит все reversed socket connections из устройства.
adb jdwp
Выведет список идентификаторов процессов (PID), подключенных через транспорт JDWP.
adb install [-lrtsdg] file
Вытолкнет этот файл пакета в устройство и установит его.
• -l: перенаправить блокировку приложения (forward lock application).
• -r: заменить существующее приложение.
• -t: позволить тестовые пакеты.
• -s: установить приложение на sdcard.
• -d: позволить downgrade кода версии (только для отлаживаемых пакетов).
• -g: предоставить все runtime разрешения.
adb install-multiple [-lrtsdpg] file...
Вытолкнет эти файлы пакета на устройство и установит их.
• -l: перенаправить блокировку приложения (forward lock application).
• -r: заменить существующее приложение.
• -t: позволить тестовые пакеты.
• -s: установить приложение на sdcard.
• -d: позволить downgrade кода версии (только для отлаживаемых пакетов).
• -p: частичная установка приложения.
• -g: предоставить все runtime разрешения.
adb uninstall [-k] package
Удалит этот пакет приложения из устройства. -k означает сохранить (keep) директории данных и кэша.
adb bugreport [zipfile]
Возвратит всю информацию из устройства, которая должна быть включена в багрепорт.
adb backup [-f file] [-apk|-noapk] [-obb|-noobb] [-shared|-noshared] [-all] [-system|-nosystem] [packages...]
Запишет архив данных устройства в файл. Если опция -f не предоставлена, то данные запишутся в файл backup.ab текущей директории.
-apk | -noapk разрешит/запретит backup самих .apk в архиве; по умолчанию noapk.
-obb | -noobb разрешит/запретит backup любых установленных apk expansion (aka .obb) файлов, связанных с каждым приложением; по умолчанию noobb.
-shared | -noshared разрешит/запретит backup содержимого shared storage / SD card устройства; по умолчанию noshared.
-all означает backup всех установленных приложений.
-system | -nosystem переключит -all автоматически включать системные приложения; по умолчанию системные приложения включены.
packages... это список приложений для backup. Если переданы флаги -all или -shared, то список package не обязателен. Приложения, явно указанные в командной строке, будут включены даже если -nosystem укажет их опустить.
adb restore file
Восстановит содержимое устройства из архивного backup-файла.
adb disable-verity
Запретит проверку dm-verity на сборках USERDEBUG.
adb enable-verity
Повторно разрешит проверку dm-verity на сборках USERDEBUG.
adb keygen file
Генерирует adb public/private ключ. Ключ private сохраняется в файл file, а ключ public сохраняется в файл file.pub. Любые существующие файлы будут перезаписаны.
adb help
Выведет сообщение подсказки.
adb version
Покажет номер версии.
Команды для использования в скриптах:
adb wait-for-[-transport]-state
Ожидать устройство в указанном состоянии: device, recovery, sideload или bootloader. Здесь transport: usb, local или any (default = any)
adb start-server
Убедиться в том, что запущен сервер.
adb kill-server
Прибить сервер, если он работает.
adb get-state
Напечатает: offline | bootloader | device
adb get-serialno
Напечатает серийный номер.
adb get-devpath
Напечатает путь до устройства.
adb remount
Перемонтирует разделы устройства /system, /vendor (если присутствует) и /oem (если присутствует) на read-write.
adb reboot [bootloader|recovery]
Перезагрузит устройство, опционально в загрузчик (bootloader) или программу восстановления (recovery program).
adb reboot sideload
Перезагрузит устройство в sideload-режим программы восстановления (требуется adb root).
adb reboot sideload-auto-reboot
Перезагрузка в sideload mode, затем перезагрузка автоматически после sideload, независимо от результата.
adb sideload file
Sideloads указанного пакета.
adb root
Перезапустит демона adbd daemon с привилегиями root.
adb unroot
Перезапустит демона adbd daemon без привилегий root.
adb usb
Перезапустит демона adbd на прослушивание USB.
adb tcpip port
Перезапустит демона adbd на прослушивание TCP по указанному порту.
Работа с сетью:
adb ppp tty [parameters]
Запустит PPP через USB.
parameters: например defaultroute debug dump local notty usepeerdns
Замечание: вы не должны автоматически запускать PPP соединение. tty ссылается на tty для потока PPP. Например dev:/dev/omap_csmi_tty1
Внутренняя отладка:
adb reconnect
Прибить текущее соединение со стороны хоста для повторного подключения.
adb reconnect device
Прибить текущее соединение от устройства для повторного подключения.
[Переменные окружения]
ADB_TRACE
Печатать отладочную информацию. Это список с разделителем запятой следующих значений 1 или all, adb, sockets, packets, rwx, usb, sync, sysdeps, transport, jdwp
ANDROID_SERIAL
Серийный номер устройства, к которому надо подключаться. Если -s указана, то она имеет приоритет над этой переменной.
ANDROID_LOG_TAGS
Когда используется с опцией logcat, то печатаются только эти debug tags.
См. также https://developer.android.com/tools/help/adb.html
[Ссылки]
1. Android Debug Bridge (adb) site:developer.android.com.
2. LuckFox FAQ. |
