Мост отладки Android (adb)

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-кода или кода сопряжения. Ваша рабочая станция и устройство должны быть подключены к одной беспроводной сети. Чтобы подключиться к вашему устройству, выполните следующие действия:

1. Включите параметры разработчика на вашем устройстве.

2. Откройте Android Studio и выберите «Подключить устройства с помощью Wi-Fi» в меню настроек запуска.

   

   Рисунок 1. Меню запуска настроек.

   Появится окно «Сопряжение устройств через Wi-Fi» , как показано на рисунке 2.

   

   Рис. 2. Всплывающее окно для сопряжения устройств с помощью QR-кода или кода сопряжения.

3. На своем устройстве нажмите «Беспроводная отладка» и выполните сопряжение устройства:

   

   Рис. 3. Снимок экрана с настройками отладки беспроводной сети на телефоне Google Pixel.

   1. Чтобы выполнить сопряжение устройства с помощью QR-кода, выберите «Сопряжение устройства с QR-кодом» и отсканируйте QR-код, полученный во всплывающем окне «Сопряжение устройств через Wi-Fi», показанном на рисунке 2.

   2. Чтобы выполнить сопряжение устройства с помощью кода сопряжения, выберите «Сопряжение устройства с кодом сопряжения» во всплывающем окне «Сопряжение устройств через Wi-Fi» . На своем устройстве выберите «Подключиться с помощью кода сопряжения» и запишите предоставленный шестизначный код. Как только ваше устройство появится в окне «Сопряжение устройств через Wi-Fi» , вы можете выбрать «Сопряжение» и ввести шестизначный код, показанный на вашем устройстве.

      

      Рисунок 4. Пример ввода шестизначного кода.

4. После сопряжения вашего устройства вы можете попытаться развернуть приложение на своем устройстве.

   Чтобы подключить другое устройство или забыть текущее устройство на рабочей станции, перейдите к разделу «Беспроводная отладка» на своем устройстве. Коснитесь имени своей рабочей станции в разделе «Сопряженные устройства» и выберите «Забыть» .

5. Если вы хотите быстро включать и выключать беспроводную отладку, вы можете использовать плитки разработчика быстрых настроек для беспроводной отладки , которые находятся в разделе «Параметры разработчика» > «Плитки разработчика быстрых настроек» .

   

   Рис. 5. Параметр «Плитки разработчика быстрых настроек» позволяет быстро включать и выключать беспроводную отладку.

Подключение Wi-Fi с помощью командной строки

Альтернативно, чтобы подключиться к устройству с помощью командной строки без Android Studio, выполните следующие действия:

1. Включите параметры разработчика на своем устройстве, как описано ранее.

2. Включите беспроводную отладку на своем устройстве, как описано ранее.

3. На рабочей станции откройте окно терминала и перейдите к android_sdk/platform-tools .

4. Найдите свой IP-адрес, номер порта и код сопряжения, выбрав «Сопряжение устройства с кодом сопряжения» . Запишите IP-адрес, номер порта и код сопряжения, отображаемые на устройстве.

5. На терминале вашей рабочей станции запустите adb pair ipaddr:port . Используйте IP-адрес и номер порта, указанные выше.

6. При появлении запроса введите код сопряжения, как показано ниже.

   

   Рисунок 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:

1. Подключите свое устройство Android и хост-компьютер adb к общей сети Wi-Fi.

Примечание. Помните, что не все точки доступа подходят. Возможно, вам придется использовать точку доступа, брандмауэр которой правильно настроен для поддержки adb .

2. Подключите устройство к главному компьютеру с помощью USB-кабеля.
3. Настройте целевое устройство на прослушивание соединения TCP/IP через порт 5555:

   adb tcpip 5555
   

4. Отсоедините USB-кабель от целевого устройства.
5. Найдите IP-адрес устройства Android. Например, на устройстве Nexus IP-адрес можно найти в меню «Настройки» > «О планшете» (или «О телефоне» ) > «Статус» > «IP-адрес» .
6. Подключитесь к устройству по его IP-адресу:

   adb connect device_ip_address:5555
   

7. Убедитесь, что ваш главный компьютер подключен к целевому устройству:

   $ adb devices
   List of devices attached
   device_ip_address:5555 device
   

Теперь ваше устройство подключено к 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 . Чтобы указать цель, выполните следующие действия:

1. Используйте команду devices , чтобы получить серийный номер цели.
2. Получив серийный номер, используйте опцию -s с командами adb , чтобы указать серийный номер.
   1. Если вы собираетесь вводить много команд adb , вы можете вместо этого установить переменную среды $ANDROID_SERIAL , чтобы она содержала серийный номер.
   2. Если вы используете и -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 ' two words ' теперь является ошибкой, поскольку кавычки проглатываются локальной оболочкой, и устройство видит adb shell setprop key two words . Чтобы команда работала, дважды заключите кавычки: один раз для локальной оболочки и один раз для удаленной оболочки, как вы делаете это с ssh(1) . Например, adb shell setprop key "' two words '" работает, поскольку локальная оболочка принимает внешний уровень кавычек, а устройство по-прежнему видит внутренний уровень кавычек: setprop key 'two words' . Также возможен вариант экранирования, но обычно проще использовать двойное цитирование.

См. также инструмент командной строки Logcat , который полезен для мониторинга системного журнала.

Менеджер активности звонков

В оболочке adb вы можете подавать команды с помощью инструмента диспетчера активности ( am ) для выполнения различных системных действий, таких как запуск действия, принудительная остановка процесса, трансляция намерения, изменение свойств экрана устройства и многое другое.

В оболочке синтаксис am следующий:

am command

Вы также можете выполнить команду диспетчера активности непосредственно из adb , не входя в удаленную оболочку. Например:

adb shell am start -a android.intent.action.VIEW

Таблица 1. Доступные команды диспетчера активности

Спецификация аргументов намерения

Для команд диспетчера действий, которые принимают аргумент intent , вы можете указать намерение с помощью следующих параметров:

Позвоните пакетному менеджеру ( pm )

В оболочке adb вы можете отправлять команды с помощью инструмента диспетчера пакетов ( pm ) для выполнения действий и запросов к пакетам приложений, установленным на устройстве.

В оболочке синтаксис pm следующий:

pm command

Вы также можете выполнить команду менеджера пакетов непосредственно из adb , не входя в удаленную оболочку. Например:

adb shell pm uninstall com.example.MyApp

Таблица 2. Доступные команды менеджера пакетов

Вызов диспетчера политики устройств ( dpm )

Чтобы помочь вам разработать и протестировать приложения для управления устройствами, дайте команды инструменту диспетчера политик устройств ( dpm ). Используйте этот инструмент для управления активным приложением администратора или изменения данных о состоянии политики на устройстве.

В оболочке синтаксис dpm следующий:

dpm command

Вы также можете выполнить команду диспетчера политики устройств непосредственно из adb , не входя в удаленную оболочку:

adb shell dpm command

Таблица 3. Доступные команды диспетчера политик устройств

Сделать снимок экрана

Команда 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 OS.
• Некоторые устройства могут не поддерживать запись с исходным разрешением экрана. Если у вас возникли проблемы с записью экрана, попробуйте использовать более низкое разрешение экрана.
• Поворот экрана во время записи не поддерживается. Если экран действительно вращается во время записи, часть экрана отключается при записи.

Таблица 4. Параметры screenrecord

screenrecord --bit-rate 6000000 /sdcard/demo.mp4

Чтение профилей ART для приложений

Начиная с 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 для восстановления устройства, также изменяет следующие настройки устройства:

• В устройстве настраиваются определенные системные параметры, чтобы не появлялись мастера первоначальной настройки устройства. То есть устройство переходит в состояние, из которого вы можете быстро установить, отладить и протестировать свое приложение.
• Настройки:
  • Отключает экран блокировки.
  • Отключает экстренные оповещения.
  • Отключает автоматическую синхронизацию учетных записей.
  • Отключает автоматические обновления системы.
• Другой:
  • Отключает предустановленные приложения безопасности.

Если ваше приложение необходимо обнаружить и адаптироваться к настройкам по умолчанию команды 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 .

USB-серверы adb

Сервер adb может взаимодействовать со стеком USB через два бэкэнда. Он может использовать нативную бэкэнд ОС (Windows, Linux или MacOS), либо может использовать бэкэнд libusb . Некоторые функции, такие как attach , detach и обнаружение скорости USB, доступны только при использовании бэкэнда libusb .

Вы можете выбрать бэкэнд, используя переменную среды ADB_LIBUSB . Если он не установлен, adb использует свой бэкэнд по умолчанию. Поведение по умолчанию варьируется в зависимости от ОС. Начиная с ADB V34 , бэкэнд liubusb используется по умолчанию во всех ОС, кроме Windows, где собственный бэкэнд используется по умолчанию. Если установлен ADB_LIBUSB , он определяет, используется ли нативный бэкэнд или libusb . См. Страницу руководства ADB для получения дополнительной информации о переменных среды ADB.

бэкэнды adb mDNS

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. Это поведение может быть изменено с использованием переменной среды ADB_MDNS_OPENSCREEN (установлен в 1 или 0 ). Дополнительную информацию см. на странице руководства АБР .