Android Debug Bridge ( adb
) — это универсальный инструмент командной строки, позволяющий взаимодействовать с устройством. Команда adb
облегчает выполнение различных действий с устройством, таких как установка и отладка приложений. adb
предоставляет доступ к оболочке Unix, которую вы можете использовать для запуска различных команд на устройстве. Это клиент-серверная программа, включающая в себя три компонента:
- Клиент , который отправляет команды. Клиент работает на вашей машине разработки. Вы можете вызвать клиента из терминала командной строки, введя команду
adb
. - Демон (adbd) , который запускает команды на устройстве. Демон работает как фоновый процесс на каждом устройстве.
- Сервер , который управляет связью между клиентом и демоном. Сервер работает как фоновый процесс на вашей машине разработки.
adb
включен в пакет инструментов платформы Android SDK. Загрузите этот пакет с помощью SDK Manager , который установит его по адресу android_sdk /platform-tools/
. Если вам нужен автономный пакет инструментов платформы Android SDK, загрузите его здесь .
Информацию о подключении устройства для использования через adb
, в том числе о том, как использовать Помощник по подключению для устранения распространенных проблем, см. в разделе Запуск приложений на аппаратном устройстве .
Как работает адб
Когда вы запускаете клиент adb
, клиент сначала проверяет, запущен ли уже процесс сервера adb
. Если его нет, он запускает серверный процесс. Когда сервер запускается, он подключается к локальному TCP-порту 5037 и прослушивает команды, отправленные от клиентов adb
.
Примечание. Все клиенты adb
используют порт 5037 для связи с сервером adb
.
Затем сервер устанавливает соединения со всеми работающими устройствами. Он находит эмуляторы путем сканирования портов с нечетными номерами в диапазоне от 5555 до 5585, который используется первыми 16 эмуляторами. Когда сервер находит демон adb
(adbd), он устанавливает соединение с этим портом.
Каждый эмулятор использует пару последовательных портов — порт с четным номером для консольных подключений и порт с нечетным номером для подключений adb
. Например:
Эмулятор 1, консоль: 5554
Эмулятор 1, adb
: 5555
Эмулятор 2, консоль: 5556
Эмулятор 2, adb
: 5557
и так далее.
Как показано, эмулятор, подключенный к adb
через порт 5555, аналогичен эмулятору, консоль которого прослушивает порт 5554.
После того, как сервер настроил соединения со всеми устройствами, вы можете использовать команды adb
для доступа к этим устройствам. Поскольку сервер управляет подключениями к устройствам и обрабатывает команды от нескольких клиентов adb
, вы можете управлять любым устройством с любого клиента или из сценария.
Включите отладку adb на вашем устройстве
Чтобы использовать adb с устройством, подключенным через USB, необходимо включить отладку по USB в настройках системы устройства в разделе «Параметры разработчика» . В Android 4.2 (уровень API 17) и более поздних версиях экран параметров разработчика по умолчанию скрыт. Чтобы сделать его видимым, включите параметры разработчика.
Теперь вы можете подключить свое устройство через USB. Вы можете убедиться, что ваше устройство подключено, запустив adb devices
из каталога android_sdk /platform-tools/
. Если оно подключено, вы увидите имя устройства в списке «устройство».
Примечание. При подключении устройства под управлением Android 4.2.2 (уровень API 17) или выше система отображает диалоговое окно с вопросом, принять ли ключ RSA, позволяющий отладку через этот компьютер. Этот механизм безопасности защищает пользовательские устройства, поскольку он гарантирует, что отладка USB и другие команды adb не могут быть выполнены, если вы не сможете разблокировать устройство и подтвердить диалог.
Дополнительные сведения о подключении к устройству через USB см. в статье Запуск приложений на аппаратном устройстве .
Подключитесь к устройству через Wi-Fi
Примечание. Приведенные ниже инструкции не применимы к устройствам Wear под управлением Android 11 (уровень API 30). Дополнительную информацию см. в руководстве по отладке приложения Wear OS .
Android 11 (уровень API 30) и более поздние версии поддерживают развертывание и отладку приложения по беспроводной сети с рабочей станции с помощью Android Debug Bridge (adb). Например, вы можете развернуть отлаживаемое приложение на нескольких удаленных устройствах без необходимости физического подключения устройства через USB. Это избавляет от необходимости решать распространенные проблемы с подключением USB, например установку драйверов.
Прежде чем начать использовать беспроводную отладку, выполните следующие действия:
Убедитесь, что ваша рабочая станция и устройство подключены к одной беспроводной сети.
Убедитесь, что ваше устройство работает под управлением Android 11 (уровень API 30) или более поздней версии для телефона или Android 13 (уровень API 33) или более поздней версии для телевизора и WearOS. Дополнительную информацию см. в разделе Проверка и обновление версии Android .
Если вы используете IDE, убедитесь, что у вас установлена последняя версия Android Studio. Вы можете скачать его здесь .
На своей рабочей станции обновите SDK Platform Tools до последней версии.
Чтобы использовать беспроводную отладку, необходимо выполнить сопряжение устройства с рабочей станцией с помощью QR-кода или кода сопряжения. Ваша рабочая станция и устройство должны быть подключены к одной беспроводной сети. Чтобы подключиться к вашему устройству, выполните следующие действия:
Включите параметры разработчика на вашем устройстве.
Откройте Android Studio и выберите «Подключить устройства с помощью Wi-Fi» в меню настроек запуска.
Рисунок 1. Меню запуска настроек.Появится окно «Сопряжение устройств через Wi-Fi» , как показано на рисунке 2.
Рис. 2. Всплывающее окно для сопряжения устройств с помощью QR-кода или кода сопряжения.На своем устройстве нажмите «Беспроводная отладка» и выполните сопряжение устройства:
Рис. 3. Снимок экрана с настройками отладки беспроводной сети на телефоне Google Pixel.Чтобы выполнить сопряжение устройства с помощью QR-кода, выберите «Сопряжение устройства с QR-кодом» и отсканируйте QR-код, полученный во всплывающем окне «Сопряжение устройств через Wi-Fi», показанном на рисунке 2.
Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» во всплывающем окне «Сопряжение устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» и запишите предоставленный шестизначный код. Как только ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , вы можете выбрать «Сопряжение» и ввести шестизначный код, показанный на вашем устройстве.
Рисунок 4. Пример ввода шестизначного кода.
После сопряжения вашего устройства вы можете попытаться развернуть приложение на своем устройстве.
Чтобы выполнить сопряжение другого устройства или забыть текущее устройство на рабочей станции, перейдите к разделу «Беспроводная отладка» на своем устройстве. Коснитесь имени своей рабочей станции в разделе «Сопряженные устройства» и выберите «Забыть» .
Если вы хотите быстро включать и выключать беспроводную отладку, вы можете использовать плитки разработчика быстрых настроек для беспроводной отладки , которые находятся в разделе «Параметры разработчика» > «Плитки разработчика быстрых настроек» .
Рис. 5. Параметр «Плитки разработчика быстрых настроек» позволяет быстро включать и отключать беспроводную отладку.
Подключение Wi-Fi с помощью командной строки
Альтернативно, чтобы подключиться к устройству с помощью командной строки без Android Studio, выполните следующие действия:
Включите параметры разработчика на своем устройстве, как описано ранее.
Включите беспроводную отладку на своем устройстве, как описано ранее.
На рабочей станции откройте окно терминала и перейдите к
android_sdk/platform-tools
.Найдите свой IP-адрес, номер порта и код сопряжения, выбрав «Сопряжение устройства с кодом сопряжения» . Запишите IP-адрес, номер порта и код сопряжения, отображаемые на устройстве.
На терминале вашей рабочей станции запустите
adb pair ipaddr:port
. Используйте IP-адрес и номер порта, указанные выше.При появлении запроса введите код сопряжения, как показано ниже.
Рисунок 6. Сообщение указывает на то, что ваше устройство успешно сопряжено.
Решение проблем с беспроводным подключением
Если у вас возникли проблемы с беспроводным подключением к вашему устройству, попробуйте выполнить следующие действия по устранению неполадок, чтобы решить эту проблему.
Проверьте, соответствуют ли ваша рабочая станция и устройство предварительным требованиям.
Убедитесь, что рабочая станция и устройство соответствуют предварительным требованиям, перечисленным в начале этого раздела .
Проверьте наличие других известных проблем
Ниже приведен список текущих известных проблем с беспроводной отладкой (с помощью adb или Android Studio) и способы их решения:
Wi-Fi не подключается . Защищенные сети Wi-Fi, например корпоративные сети Wi-Fi, могут блокировать p2p-соединения и не позволять вам подключаться через Wi-Fi. Попробуйте подключиться с помощью кабеля или другой (не корпоративной) сети Wi-Fi. Беспроводное соединение с использованием
adb connect ip : port
через TCP/IP (после первоначального USB-соединения) является еще одним вариантом, если можно использовать некорпоративную сеть.adb
over Wi-Fi иногда автоматически отключается : это может произойти, если устройство переключает сети Wi-Fi или отключается от сети. Чтобы устранить проблему, повторно подключитесь к сети.Устройство не подключается после успешного сопряжения :
adb
использует mDNS для обнаружения и автоматического подключения к сопряженным устройствам. Если ваша сеть или конфигурация устройства не поддерживает mDNS или отключила его, вам необходимо вручную подключиться к устройству с помощьюadb connect ip : port
.
Подключитесь к устройству по беспроводной сети после первоначального подключения USB (только вариант доступен на Android 10 и более ранних версиях)
Примечание. Этот рабочий процесс применим также к Android 11 (и более поздним версиям), но с оговоркой, что он также предполагает *начальное* соединение через физический USB.
Примечание. Следующие инструкции не применимы к устройствам Wear под управлением Android 10 (уровень API 29) или ниже. Дополнительную информацию см. в руководстве по отладке приложения Wear OS .
adb
обычно обменивается данными с устройством через USB, но вы также можете использовать adb
через Wi-Fi. Чтобы подключить устройство под управлением Android 10 (уровень API 29) или ниже, выполните следующие начальные шаги через USB:
- Подключите свое устройство Android и хост-компьютер
adb
к общей сети Wi-Fi. - Подключите устройство к главному компьютеру с помощью USB-кабеля.
- Настройте целевое устройство на прослушивание соединения TCP/IP через порт 5555:
adb tcpip 5555
- Отсоедините USB-кабель от целевого устройства.
- Найдите IP-адрес устройства Android. Например, на устройстве Nexus IP-адрес можно найти в меню «Настройки» > «О планшете» (или «О телефоне» ) > «Состояние» > «IP-адрес» .
- Подключитесь к устройству по его IP-адресу:
adb connect device_ip_address:5555
- Убедитесь, что ваш главный компьютер подключен к целевому устройству:
$ adb devices List of devices attached device_ip_address:5555 device
Примечание. Помните, что не все точки доступа подходят. Возможно, вам придется использовать точку доступа, брандмауэр которой правильно настроен для поддержки adb
.
Теперь ваше устройство подключено к adb
.
Если соединение adb
с вашим устройством потеряно:
- Убедитесь, что ваш хост по-прежнему подключен к той же сети Wi-Fi, что и ваше устройство Android.
- Повторно подключитесь, снова выполнив шаг
adb connect
. - Если это не сработает, перезагрузите хост
adb
:adb kill-server
Затем начните все сначала.
Запрос устройств
Прежде чем вводить команды adb
, полезно знать, какие экземпляры устройств подключены к серверу adb
. Сгенерируйте список подключенных устройств с помощью команды devices
:
adb devices -l
В ответ adb
печатает следующую информацию о состоянии для каждого устройства:
- Серийный номер:
adb
создает строку для уникальной идентификации устройства по номеру порта. Вот пример серийного номера:emulator-5554
- Состояние: состояние подключения устройства может быть одним из следующих:
-
offline
: устройство не подключено кadb
или не отвечает. -
device
: устройство подключено к серверуadb
. Обратите внимание, что это состояние не означает, что система Android полностью загружена и работает, поскольку устройство подключается кadb
, пока система еще загружается. После загрузки это нормальное рабочее состояние устройства. -
no device
: устройство не подключено.
-
- Описание: Если вы включите опцию
-l
, командаdevices
сообщит вам, что это за устройство. Эта информация полезна, если у вас подключено несколько устройств, чтобы вы могли отличить их друг от друга.
В следующем примере показана команда devices
и ее выходные данные. Работают три устройства. Первые две строки в списке — это эмуляторы, а третья строка — аппаратное устройство, подключаемое к компьютеру.
$ adb devices List of devices attached emulator-5556 device product:sdk_google_phone_x86_64 model:Android_SDK_built_for_x86_64 device:generic_x86_64 emulator-5554 device product:sdk_google_phone_x86 model:Android_SDK_built_for_x86 device:generic_x86 0a388e93 device usb:1-1 product:razor model:Nexus_7 device:flo
Эмулятора нет в списке
Команда adb devices
имеет последовательность команд в крайнем случае, из-за которой запущенные эмуляторы не отображаются в выходных данных adb devices
даже если эмуляторы видны на вашем рабочем столе. Это происходит, когда выполняются все следующие условия:
- Сервер
adb
не работает. - Вы используете команду
emulator
с опцией-port
или-ports
со значением порта с нечетным номером от 5554 до 5584. - Выбранный вами порт с нечетным номером не занят, поэтому подключение к порту можно выполнить по указанному номеру порта — или, если он занят, эмулятор переключается на другой порт, соответствующий требованиям пункта 2.
- Вы запускаете сервер
adb
после запуска эмулятора.
Один из способов избежать этой ситуации — позволить эмулятору выбирать собственные порты и запускать не более 16 эмуляторов одновременно. Другой способ — всегда запускать сервер adb
перед использованием команды emulator
, как описано в следующих примерах.
Пример 1. В следующей последовательности команд команда adb devices
запускает сервер adb
, но список устройств не отображается.
Остановите сервер adb
и введите следующие команды в указанном порядке. В качестве имени AVD укажите допустимое имя AVD из вашей системы. Чтобы получить список имен AVD, введите emulator -list-avds
. Команда emulator
находится в каталоге android_sdk /tools
.
$ adb kill-server $ emulator -avd Nexus_6_API_25 -port 5555 $ adb devices List of devices attached * daemon not running. starting it now on port 5037 * * daemon started successfully *
Пример 2. В следующей последовательности команд adb devices
отображают список устройств, поскольку сервер adb
был запущен первым.
Чтобы увидеть эмулятор в выводе adb devices
, остановите сервер adb
, а затем запустите его снова после использования команды emulator
и перед использованием команды adb devices
, как показано ниже:
$ adb kill-server $ emulator -avd Nexus_6_API_25 -port 5557 $ adb start-server $ adb devices List of devices attached emulator-5557 device
Дополнительные сведения о параметрах командной строки эмулятора см. в разделе Параметры запуска командной строки .
Отправка команд на определенное устройство
Если запущено несколько устройств, вы должны указать целевое устройство при вводе команды adb
. Чтобы указать цель, выполните следующие действия:
- Используйте команду
devices
, чтобы получить серийный номер цели. - Получив серийный номер, используйте опцию
-s
с командамиadb
, чтобы указать серийный номер.- Если вы собираетесь вводить много команд
adb
, вы можете вместо этого установить переменную среды$ANDROID_SERIAL
, чтобы она содержала серийный номер. - Если вы используете и
-s
, и$ANDROID_SERIAL
,-s
переопределяет$ANDROID_SERIAL
.
- Если вы собираетесь вводить много команд
В следующем примере получается список подключенных устройств, а затем серийный номер одного из устройств используется для установки helloWorld.apk
на это устройство:
$ adb devices List of devices attached emulator-5554 device emulator-5555 device 0.0.0.0:6520 device # To install on emulator-5555 $ adb -s emulator-5555 install helloWorld.apk # To install on 0.0.0.0:6520 $ adb -s 0.0.0.0:6520 install helloWorld.apk
Примечание. Если вы вводите команду без указания целевого устройства, когда доступно несколько устройств, adb
отображает ошибку «adb: более одного устройства/эмулятора».
Если у вас есть несколько доступных устройств, но только одно из них является эмулятором, используйте опцию -e
для отправки команд эмулятору. Если имеется несколько устройств, но подключено только одно аппаратное устройство, используйте опцию -d
для отправки команд аппаратному устройству.
Установить приложение
Вы можете использовать adb
для установки APK на эмулятор или подключенное устройство с помощью команды install
:
adb install path_to_apk
Вы должны использовать опцию -t
с командой install
при установке тестового APK. Для получения дополнительной информации см. -t
.
Чтобы установить несколько APK, используйте install-multiple
. Это полезно, если вы загружаете все APK-файлы своего приложения для определенного устройства из Play Console и хотите установить их на эмулятор или физическое устройство.
Дополнительные сведения о том, как создать APK-файл, который можно установить на экземпляре эмулятора или устройства, см. в разделе Создание и запуск приложения .
Примечание. Если вы используете Android Studio, вам не нужно напрямую использовать adb
для установки приложения на эмулятор или устройство. Вместо этого Android Studio самостоятельно упаковывает и устанавливает приложение.
Настроить переадресацию портов
Используйте команду forward
, чтобы настроить переадресацию произвольных портов, которая перенаправляет запросы с определенного порта хоста на другой порт устройства. В следующем примере настраивается переадресация порта хоста 6100 на порт устройства 7100:
adb forward tcp:6100 tcp:7100
В следующем примере настраивается переадресация порта хоста 6100 на local:logd:
adb forward tcp:6100 local:logd
Это может быть полезно, если вы пытаетесь определить, что отправляется на определенный порт устройства. Все полученные данные будут записаны в демон системного журналирования и отображены в журналах устройства.
Копирование файлов на устройство и с него
Используйте команды pull
и push
для копирования файлов на устройство и с него. В отличие от команды install
, которая копирует APK-файл только в определенное место, команды pull
и push
позволяют копировать произвольные каталоги и файлы в любое место на устройстве.
Чтобы скопировать файл или каталог и его подкаталоги с устройства, выполните следующие действия:
adb pull remote local
Чтобы скопировать файл или каталог и его подкаталоги на устройство, выполните следующие действия:
adb push local remote
Замените local
и remote
путями к целевым файлам/каталогу на вашем компьютере разработки (локальном) и на устройстве (удаленном). Например:
adb push myfile.txt /sdcard/myfile.txt
Остановить сервер adb
В некоторых случаях вам может потребоваться завершить процесс сервера adb
, а затем перезапустить его, чтобы решить проблему. Например, это может произойти, если adb
не отвечает на команду.
Чтобы остановить сервер adb
, используйте команду adb kill-server
. Затем вы можете перезапустить сервер, введя любую другую команду adb
.
Выдать команды adb
Выполняйте команды adb
из командной строки на вашем компьютере разработки или из сценария, используя следующее:
adb [-d | -e | -s serial_number] command
Если запущен только один эмулятор или подключено только одно устройство, команда adb
по умолчанию отправляется на это устройство. Если запущено несколько эмуляторов и/или подключено несколько устройств, вам необходимо использовать опцию -d
, -e
или -s
чтобы указать целевое устройство, на которое должна быть направлена команда.
Вы можете просмотреть подробный список всех поддерживаемых команд adb
используя следующую команду:
adb --help
Выдавать команды оболочки
Вы можете использовать команду shell
для подачи команд устройства через adb
или для запуска интерактивной оболочки. Чтобы выполнить одну команду, используйте команду shell
следующим образом:
adb [-d |-e | -s serial_number] shell shell_command
Чтобы запустить интерактивную оболочку на устройстве, используйте команду shell
следующим образом:
adb [-d | -e | -s serial_number] shell
Чтобы выйти из интерактивной оболочки, нажмите Control+D
или введите exit
.
Android предоставляет большинство обычных инструментов командной строки Unix. Чтобы просмотреть список доступных инструментов, используйте следующую команду:
adb shell ls /system/bin
Справка доступна для большинства команд через аргумент --help
. Многие команды оболочки предоставляются toybox . Общая справка, применимая ко всем командам toybox, доступна через toybox --help
.
В инструментах платформы Android версии 23 и выше adb
обрабатывает аргументы так же, как команда ssh(1)
. Это изменение устранило множество проблем с внедрением команд и позволяет безопасно выполнять команды, содержащие метасимволы оболочки, такие как adb install Let\'sGo.apk
. Это изменение означает, что интерпретация любой команды, содержащей метасимволы оболочки, также изменилась.
Например, adb shell setprop key ' value '
теперь является ошибкой, поскольку одинарные кавычки ( '
) поглощаются локальной оболочкой, и устройство видит adb shell setprop key value
. Чтобы команда работала, заключите в кавычки дважды: один раз для локальной оболочки и один раз для удаленной оболочки, как вы делаете это с ssh(1)
. Например, adb shell setprop key ' value '
.
См. также инструмент командной строки Logcat , который полезен для мониторинга системного журнала.
Менеджер активности звонков
В оболочке adb
вы можете подавать команды с помощью инструмента диспетчера активности ( am
) для выполнения различных системных действий, таких как запуск действия, принудительная остановка процесса, трансляция намерения, изменение свойств экрана устройства и многое другое.
В оболочке синтаксис am
следующий:
am command
Вы также можете выполнить команду диспетчера активности непосредственно из adb
, не входя в удаленную оболочку. Например:
adb shell am start -a android.intent.action.VIEW
Таблица 1. Доступные команды диспетчера активности
Команда | Описание |
---|---|
start [ options ] intent | Запустите Activity , указанное intent .См. Спецификацию аргументов намерения . Варианты:
|
startservice [ options ] intent | Запустите Service , указанную в intent .См. Спецификацию аргументов намерения . Варианты:
|
force-stop package | Принудительно остановите все, что связано с package . |
kill [ options ] package | Завершите все процессы, связанные с package . Эта команда убивает только те процессы, которые безопасно завершить и которые не повлияют на работу пользователя.Варианты:
|
kill-all | Убейте все фоновые процессы. |
broadcast [ options ] intent | Выдать намерение трансляции. См. Спецификацию аргументов намерения . Варианты:
|
instrument [ options ] component | Начните мониторинг с помощью экземпляра Instrumentation . Обычно целевой component имеет форму test_package / runner_class .Варианты:
|
profile start process file | Запустите профилировщик process , запишите результаты в file . |
profile stop process | Остановить профайлер в process . |
dumpheap [ options ] process file | Дамп кучи process , запись в file .Варианты:
|
set-debug-app [ options ] package | Установите package приложения для отладки.Варианты:
|
clear-debug-app | Очистите предыдущий набор пакета для отладки с помощью set-debug-app . |
monitor [ options ] | Начните отслеживать сбои или ошибки ANR. Варианты:
|
screen-compat {on | off} package | Режим совместимости экрана управления package . |
display-size [reset | width x height ] | Переопределить размер дисплея устройства. Эта команда полезна для тестирования вашего приложения на экранах разных размеров, имитируя маленькое разрешение экрана на устройстве с большим экраном, и наоборот. Пример: |
display-density dpi | Переопределить плотность отображения устройства. Эта команда полезна для тестирования вашего приложения на экране с различной плотностью экрана, имитируя среду экрана с высокой плотностью экрана с использованием экрана с низкой плотностью, и наоборот. Пример: |
to-uri intent | Распечатайте данную спецификацию намерения как URI. |
to-intent-uri intent | Распечатайте данную спецификацию намерения как intent: URI. |
Спецификация аргументов намерения
Для команд диспетчера действий, которые принимают аргумент intent
, вы можете указать намерение с помощью следующих параметров:
Позвоните пакетному менеджеру ( pm
)
В оболочке adb
вы можете отправлять команды с помощью инструмента диспетчера пакетов ( pm
) для выполнения действий и запросов к пакетам приложений, установленным на устройстве.
В оболочке синтаксис pm
:
pm command
Вы также можете выполнить команду менеджера пакетов непосредственно из adb
, не входя в удаленную оболочку. Например:
adb shell pm uninstall com.example.MyApp
Таблица 2. Доступные команды менеджера пакетов
Команда | Описание |
---|---|
list packages [ options ] filter | Распечатайте все пакеты, при необходимости только те, имя пакета которых содержит текст в filter .Параметры:
|
list permission-groups | Распечатайте все известные группы разрешений. |
list permissions [ options ] group | Распечатайте все известные разрешения, при необходимости только те, которые находятся в group .Параметры:
|
list instrumentation [ options ] | Перечислите все тестовые пакеты. Параметры:
|
list features | Распечатайте все характеристики системы. |
list libraries | Распечатайте все библиотеки, поддерживаемые текущим устройством. |
list users | Распечатайте всех пользователей в системе. |
path package | Выведите путь к APK данного package . |
install [ options ] path | Установите пакет, указанный по path , в систему.Параметры:
|
uninstall [ options ] package | Удаляет пакет из системы. Параметры:
|
clear package | Удалить все данные, связанные с пакетом. |
enable package_or_component | Включите данный пакет или компонент (записанный как «пакет/класс»). |
disable package_or_component | Отключите данный пакет или компонент (записанный как «пакет/класс»). |
disable-user [ options ] package_or_component | Параметры:
|
grant package_name permission | Предоставьте разрешение приложению. На устройствах под управлением Android 6.0 (уровень API 23) и выше разрешением может быть любое разрешение, объявленное в манифесте приложения. На устройствах под управлением Android 5.1 (уровень API 22) и ниже должно быть дополнительное разрешение, определенное приложением. |
revoke package_name permission | Отозвать разрешение у приложения. На устройствах под управлением Android 6.0 (уровень API 23) и выше разрешением может быть любое разрешение, объявленное в манифесте приложения. На устройствах под управлением Android 5.1 (уровень API 22) и ниже должно быть дополнительное разрешение, определенное приложением. |
set-install-location location | Измените место установки по умолчанию. Значения местоположения:
Примечание. Это предназначено только для отладки. Использование этого может привести к сбою приложений и другому нежелательному поведению. |
get-install-location | Возвращает текущее место установки. Возвращаемые значения:
|
set-permission-enforced permission [true | false] | Укажите, следует ли применять данное разрешение. |
trim-caches desired_free_space | Обрезать файлы кэша, чтобы достичь заданного свободного места. |
create-user user_name | Создайте нового пользователя с заданным user_name и распечатайте новый идентификатор пользователя. |
remove-user user_id | Удалить пользователя с заданным user_id , удалив все данные, связанные с этим пользователем. |
get-max-users | Распечатайте максимальное количество пользователей, поддерживаемых устройством. |
get-app-links [ options ] [ package ] | Распечатайте состояние проверки домена для данного package или для всех пакетов, если ни один не указан. Коды штатов определяются следующим образом:
Варианты:
|
reset-app-links [ options ] [ package ] | Сбросить состояние проверки домена для данного пакета или для всех пакетов, если ни один не указан.
Варианты:
|
verify-app-links [ --re-verify ] [ package ] | Отправьте запрос на проверку для данного package или для всех пакетов, если ни один не указан. Отправляется только в том случае, если пакет ранее не записал ответ.
|
set-app-links [--package package ] state domains | Вручную установите состояние домена для пакета. Чтобы это работало, домен должен быть объявлен пакетом как autoVerify. Эта команда не будет сообщать об ошибке для доменов, которые невозможно применить.
|
set-app-links-user-selection --user user_id [--package package ] enabled domains | Вручную установите состояние выбора пользователя хоста для пакета. Чтобы это работало, домен должен быть объявлен пакетом. Эта команда не будет сообщать об ошибке для доменов, которые не удалось применить.
|
set-app-links-user-selection --user user_id [--package package ] enabled domains | Вручную установите состояние выбора пользователя хоста для пакета. Домен должен быть объявлен пакетом для работы. Эта команда не будет сообщать об отказе для доменов, которые не могут быть применены.
|
set-app-links-allowed --user user_id [--package package ] allowed | Переключите автоматическую настройку обработки ссылок для пакета.
|
get-app-link-owners --user user_id [--package package ] domains | Распечатайте владельцев для определенного домена для данного пользователя в порядке с низким и высоким приоритетом.
|
Позвоните в Device Policy Manager ( dpm
)
Чтобы помочь вам разработать и протестировать приложения для управления устройствами, выпустите команды в инструмент Device Policy Manager ( dpm
). Используйте инструмент для управления приложением Active Admin или изменить данные о состоянии политики на устройстве.
Находясь в оболочке, синтаксис dpm
:
dpm command
Вы также можете выпустить команду диспетчера политики устройства непосредственно из adb
без ввода удаленной оболочки:
adb shell dpm command
Таблица 3. Доступные команды диспетчера политики устройства
Команда | Описание |
---|---|
set-active-admin [ options ] component | Устанавливает component как активный администратор. Варианты:
|
set-profile-owner [ options ] component | Установите component как Active Admin и его пакет в качестве владельца профиля для существующего пользователя. Варианты:
|
set-device-owner [ options ] component | Установите component как Active Admin и его пакет в качестве владельца устройства. Варианты:
|
remove-active-admin [ options ] component | Отключить активного администратора. Приложение должно объявить android:testOnly в манифесте. Эта команда также удаляет владельцев устройств и профилей.Варианты:
|
clear-freeze-period-record | Очистите запись устройства ранее установленных периодов замораживания для обновлений System OTA. Это полезно, чтобы избежать ограничений планирования устройств при разработке приложений, которые управляют периодами замораживания. См. Управление обновлениями системы . Поддерживается на устройствах под управлением Android 9.0 (уровень API 28) и выше. |
force-network-logs | Заставьте систему подготовить любые существующие сетевые журналы, готовые к поиску DPC. Если доступны журналы подключения или DNS, DPC получает обратный вызов onNetworkLogsAvailable() . Смотрите регистрацию сетевой активности .Эта команда ограничена скоростью. Поддерживается на устройствах под управлением Android 9.0 (уровень API 28) и выше. |
force-security-logs | Заставьте систему сделать любые существующие журналы безопасности доступными для DPC. Если доступны журналы, DPC получает обратный вызов onSecurityLogsAvailable() . См .Эта команда ограничена скоростью. Поддерживается на устройствах под управлением Android 9.0 (уровень API 28) и выше. |
Сделать снимок экрана
Команда screencap
представляет собой утилиту оболочки для снимка экрана дисплея устройства.
Находясь в оболочке, синтаксис screencap
:
screencap filename
Чтобы использовать screencap
из командной строки, введите следующее:
adb shell screencap /sdcard/screen.png
Вот пример сеанса экрана, используя оболочку adb
для захвата скриншота и команды pull
для загрузки файла с устройства:
$ adb shell shell@ $ screencap /sdcard/screen.png shell@ $ exit $ adb pull /sdcard/screen.png
Записать видео
Команда screenrecord
представляет собой утилиту оболочки для записи отображения устройств, работающих на Android 4.4 (API -уровне 19) и выше. Утилита записывает активность экрана в файл MPEG-4. Вы можете использовать этот файл для создания рекламных или обучающих видео или для отладки и тестирования.
В оболочке используйте следующий синтаксис:
screenrecord [options] filename
Чтобы использовать screenrecord
из командной строки, введите следующее:
adb shell screenrecord /sdcard/demo.mp4
Остановите запись экрана, нажав Control+C. В противном случае запись автоматически останавливается через три минуты или ограничение по времени, установленное --time-limit
.
Чтобы начать запись экрана вашего устройства, запустите команду screenrecord
, чтобы записать видео. Затем запустите команду pull
, чтобы загрузить видео с устройства на хост -компьютер. Вот пример сеанса записи:
$ adb shell shell@ $ screenrecord --verbose /sdcard/demo.mp4 (press Control + C to stop) shell@ $ exit $ adb pull /sdcard/demo.mp4
Утилита screenrecord
может записаться при любом поддерживаемом разрешении и скорости битов, которые вы запрашиваете, сохраняя при этом соотношение сторон отображения устройства. Утилита записывает в собственном разрешении и ориентации дисплея по умолчанию, максимальной длиной три минуты.
Ограничения утилиты screenrecord
:
- Аудио не записывается с помощью видеофайла.
- Видеозапись недоступна для устройств, работающих на ОС Wear.
- Некоторые устройства не смогут записать в своем родном разрешении дисплея. Если вы столкнетесь с проблемами с записи экрана, попробуйте использовать более низкое разрешение экрана.
- Вращение экрана во время записи не поддерживается. Если экран действительно вращается во время записи, часть экрана отключается при записи.
Таблица 4. Параметры screenrecord
Параметры | Описание |
---|---|
--help | Отображать синтаксис и параметры команды |
--size width x height | Установите размер видео: 1280x720 . Значение по умолчанию - это нативное разрешение дисплея устройства (если поддерживается), 1280x720, если нет. Для достижения наилучших результатов используйте размер, поддерживаемый Enderband Video Coding (AVC). |
--bit-rate rate | Установите скорость бита видео для видео, в мегабитах в секунду. Значение по умолчанию составляет 20 Мбит / с. Вы можете увеличить скорость битов для улучшения качества видео, но это приводит к более крупным файлам фильмов. В следующем примере устанавливает скорость бита записи на 6 Мбит / с: screenrecord --bit-rate 6000000 /sdcard/demo.mp4 |
--time-limit time | Установите максимальное время записи, в считанные секунды. По умолчанию и максимальное значение составляет 180 (3 минуты). |
--rotate | Поверните выход на 90 градусов. Эта функция экспериментальная. |
--verbose | Отображать информацию журнала на экране командной строки. Если вы не установите эту опцию, утилита не отображает никакой информации при запуске. |
Читать профили искусства для приложений
Начиная с Android 7.0 (уровень API 24), среда выполнения Android (ART) собирает профили выполнения для установленных приложений, которые используются для оптимизации производительности приложений. Изучите собранные профили, чтобы понять, какие методы часто выполняются и какие классы используются во время запуска приложения.
ПРИМЕЧАНИЕ. Можно получить имя файла профиля выполнения, только если у вас есть корневой доступ к файловой системе, например, на эмулятор.
Чтобы создать текстовую форму информации о профиле, используйте следующую команду:
adb shell cmd package dump-profiles package
Чтобы получить произведенный файл, используйте:
adb pull /data/misc/profman/package.prof.txt
Сбросить тестовые устройства
Если вы тестируете свое приложение на нескольких тестовых устройствах, может быть полезно сбросить ваше устройство между тестами, например, для удаления пользовательских данных и сброса тестовой среды. Вы можете выполнить сброс застройки тестового устройства с помощью Android 10 (API уровня 29) или выше, используя команду ADB testharness
adb
, как показано:
adb shell cmd testharness enable
При восстановлении устройства с помощью testharness
устройство автоматически поддерживает ключ RSA, который позволяет отлаживать через текущую рабочую станцию в постоянном месте. То есть после сброса устройства рабочая станция может продолжать отладку и выдавать команды adb
на устройство, не зарегистрируя новый ключ.
Кроме того, чтобы помочь сделать его проще и безопасным для продолжения тестирования вашего приложения, используя testharness
для восстановления устройства, также изменяет следующие настройки устройства:
- Устройство устанавливает определенные настройки системы, чтобы не отображаться начальные мастерства настроек устройства. То есть устройство входит в состояние, из которого вы можете быстро установить, отлаживать и проверить свое приложение.
- Настройки:
- Отключает экран блокировки.
- Отключает аварийные оповещения.
- Отключает Auto-Sync для учетных записей.
- Отключает автоматические обновления системы.
- Другой:
- Отключает заранее установленные приложения безопасности.
Если ваше приложение необходимо обнаружить и адаптироваться к настройкам по умолчанию команды testharness
, используйте ActivityManager.isRunningInUserTestHarness()
.
Склайт
sqlite3
Запускает программу командной строки sqlite
для изучения баз данных SQLite. Он включает в себя такие команды SQL CREATE
как .dump
для печати содержимого таблицы и .schema
Вы также можете выполнить команды SQLite из командной строки, как показано:
$ adb -s emulator-5554 shell $ sqlite3 /data/data/com.example.app/databases/rssitems.db SQLite version 3.3.12 Enter ".help" for instructions
ПРИМЕЧАНИЕ. Доступ к базе данных SQLITE можно получить только в том случае, если у вас есть корневой доступ к файловой системе, например, на эмуляторе.
Для получения дополнительной информации см. Документацию командной строки sqlite3
.
ADB USB Backends
Сервер ADB может взаимодействовать со стеком USB через две бэкэнды. Он может использовать нативную бэкэнд ОС (Windows, Linux или MacOS), либо может использовать бэкэнд libusb
. Некоторые функции, такие как attach
, detach
и обнаружение скорости USB, доступны только при использовании бэкэнда libusb
.
Вы можете выбрать бэкэнд, используя переменную среды ADB_LIBUSB
. Если он не установлен, ADB использует бэкэнд по умолчанию. Поведение по умолчанию варьируется среди ОС. Начиная с ADB V34 , бэкэнд liubusb
используется по умолчанию во всех ОС, кроме Windows, где собственный бэкэнд используется по умолчанию. Если установлен ADB_LIBUSB
, он определяет, используется ли нативный бэкэнд или libusb
. См. Страницу руководства ADB для получения дополнительной информации о переменных среды ADB.
ADB MDNS Backends
ADB может использовать протокол многоадресной DNS для автоматического подключения сервера и устройств. Сервер ADB поставляется с двумя бэкендами, Bonjour (Mdnsresponder Apple) и OpenScreen.
Бэкэнд Bonjour нуждается в демон, чтобы работать на хост -машине. На встроенном демоне MacOS Apple всегда работает, но в Windows и Linux пользователь должен убедиться, что демон mdnsd
работает. Если adb mdns check
возвращает ошибку, вполне вероятно, что ADB использует бэкэнд Bonjour, но не работает Daemon Bonjour.
Бэкэнд OpenScreen не нуждается в демона для работы на машине. Поддержка бэкэнда OpenScreen на MacOS начинается на ADB V35. Windows и Linux поддерживаются ADB V34.
По умолчанию ADB использует Bonjour Backend. Это поведение может быть изменено с использованием переменной среды ADB_MDNS_OPENSCREEN
(установите на 1
или 0
). Смотрите страницу «Руководство по ADB» для получения дополнительной информации.