ADB: основи на работа с Android Debug Bridge и популярни команди

Какво е ADB и за какво служи

Android Debug Bridge (ADB) — е клиент-сървърно приложение, което се състои от три компонента: клиент (стартира на компютъра), сървър (фонов процес на компютъра) и демон adbd (изпълнява се на самото Android устройство). Когато разработчик или инженер свърже смартфон към компютър, ADB създава надежден комуникационен канал, през който могат да се предават команди, файлове и данни.

Основните сценарии за използване на ADB включват отстраняване на грешки в приложения на реално устройство без необходимост от публикуване на APK в магазина, извличане на регистрационни файлове за анализ на грешки, автоматизация на тестване, архивиране на данни, флашване на recovery образи и получаване на root достъп. Дори и да не пишете код, ADB може да бъде полезен за извличане на екранни снимки от приложения, записване на видео ръководство от екрана на телефона или възстановяване на устройството след неуспешно флашване.

Поддръжката на ADB е вградена във всички официални компилации на Android, започвайки от версия 2.1 (API 7). За работа е необходима включена опция „Отстраняване на грешки чрез USB" в настройките за разработчици. Започвайки от Android 4.2, при първото свързване устройството изисква потвърждение: трябва да разрешите отстраняване на грешки за конкретния компютър въз основа на неговия RSA ключ.

Инсталиране на ADB на компютър

За Windows — изтеглете Platform Tools от официалния уебсайт на Google Developers, разархивирайте архива в папка C:\adb и добавете този път към променливата на средата PATH. След рестартиране на терминала командата adb ще бъде глобално достъпна.

За macOS — най-лесният начин е да инсталирате ADB чрез мениджъра на пакети Homebrew: изпълнете brew install android-platform-tools. Всички зависимости ще бъдат разрешени автоматично.

За Linux — в дистрибуции, базирани на Debian / Ubuntu: sudo apt install adb. След инсталиране добавете потребителя към групата plugdev: sudo usermod -aG plugdev $USER и влезте отново, за да получи ADB достъп до USB устройства.

Коректността на инсталирането може да се провери с командата adb version. Ако в отговора се покаже номерът на версията на Android Debug Bridge, инструментът е готов за работа.

Свързване на устройство и основни команди

Първото свързване винаги започва с командата adb devices. Тя показва списък на свързаните устройства и техния статус. Ако устройството се показва като unauthorized, отключете екрана и потвърдете отстраняването на грешки на телефона.

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

Инсталиране на приложение — една от най-честите операции. Достатъчно е да посочите пътя до APK файла:

adb install C:\apps\myapp.apk

Ако приложението вече е инсталирано, но трябва да бъде заменено с актуализирана версия, добавете флага -r (replace):

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

Деинсталиране на приложение се извършва по име на пакет:

adb uninstall com.example.myapp

Копиране на файлове — adb pull извлича файл от устройството на компютъра, adb push качва файл на устройството:

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

Интерактивен shell — командата adb shell отваря командна обвивка на устройството. Вътре в нея могат да се изпълняват стандартни Linux команди: ls, ps, top, dumpsys, pm, am и други.

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

Стартиране на активност чрез ADB ви позволява да отворите всяко приложение или екран без ръчно търсене на икона:

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

Работа с регистрационни файлове: Logcat

Logcat — е системата за регистриране на Android, която събира съобщения от приложения, системни услуги и ядрото. Инструментът е незаменим при отстраняване на грешки: от регистрационните файлове можете да разберете защо приложението се е сривнало, кой метод е предизвикал изключение или колко време отнема дадена операция.

Просто стартиране без филтри — adb logcat. Потокът от регистрационни файлове е безкраен, за спиране натиснете Ctrl+C. За да филтрирате съобщения по таг, използвайте параметъра -s:

adb logcat -s MainActivity:V

Нива на важност на регистриране (от най-подробно до критично): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). Комбинацията от таг и ниво ви позволява да извлечете само необходимите съобщения.

За изчистване на натрупания буфер преди тест:

adb logcat -c

А за запазване на регистрационните файлове във файл:

adb logcat -d > app_logs.txt

Флагът -d (dump) показва текущия буфер и приключва, без да блокира терминала. Това е удобно за скриптове за автоматизация.

Екранни снимки, запис на екрана и полезни диагностични команди

Екранна снимка се прави с командата adb shell screencap. Резултатът се запазва във файл, който след това се извлича чрез adb pull:

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

Можете да комбинирате двете операции в един ред чрез заместване и тръбопровод. На практика това ускорява създаването на документация и отчети за тестване.

Запис на екрана е достъпен на Android 4.4+ (API 19). Продължителността на записа по подразбиране е 180 секунди, битрейт — 4 Mbit/s. Основната команда:

adb shell screenrecord /sdcard/demo.mp4

За спиране на записа натиснете Ctrl+C. Разделителната способност на видеото съответства на разделителната способност на екрана на устройството, но не надвишава 1080p. За промяна на битрейта посочете --bit-rate:

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

Диагностични команди: adb shell dumpsys показва състоянието на всички системни услуги. За да получите информация само за батерията:

adb shell dumpsys battery

Списък на инсталираните пакети можете да получите чрез Package Manager:

adb shell pm list packages

Нулиране на настройките на приложението (аналог на изчистване на данни в настройките):

adb shell pm clear com.example.myapp

Разширени възможности на ADB

Wi-Fi отстраняване на грешки премахва необходимостта от държане на устройството свързано чрез USB. Уверете се, че компютърът и устройството са в една и съща мрежа. Първо изпълнете adb tcpip 5555, изключете USB, след това се свържете чрез IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Ако IP адресът на устройството е неизвестен, разберете го чрез adb shell ip addr show wlan0 преди изключване на кабела.

Архивиране на данни на приложение или на цялата система се извършва без root:

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

Възстановяване от архив:

adb restore mybackup.ab

Емулация на въвеждане — командата adb shell input позволява симулиране на докосвания, плъзгания, натискане на клавиши и въвеждане на текст. Това е основата за автоматизация на UI тестове без допълнителни рамки:

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

Рестартиране в различни режими:

adb reboot          # обикновено рестартиране
adb reboot recovery # режим на възстановяване
adb reboot bootloader # bootloader (fastboot)

Режимът fastboot отваря достъп до флашване на образи, отключване на bootloader и инсталиране на персонализирано recovery.

Работа с няколко устройства

Когато са свързани няколко устройства или емулатора едновременно, ADB изисква посочване на конкретен сериен номер. Командата adb devices показва всички свързани устройства с техните серийни номера.

За адресиране на команда към конкретно устройство използвайте флага -s:

adb -s 0123456789ABCD install myapp.apk

Ако устройството е едно, можете да работите без флаг. Въпреки това в CI среда, където няколко емулатора работят едновременно, посочването на сериен номер е задължително.

Убиване на ADB сървър — ако устройството спре да се открива или дава грешка, рестартирането на сървъра помага:

adb kill-server
adb start-server

След това изпълнете adb devices — сървърът ще се рестартира и ще пренасочи заявките към демоните на устройствата.

Основни команди на ADB: обобщена таблица

Заключение

ADB (Android Debug Bridge) — е основен инструмент за всички, които работят с Android на професионално ниво. От основно инсталиране на приложения до сложна автоматизация на тестване и възстановяване на устройства — ADB покрива почти всеки сценарий на взаимодействие на компютър със смартфон или таблет.

Усвоявайки командите, описани в тази статия, ще можете уверено да управлявате Android устройство чрез терминал, да анализирате регистрационни файлове, да правите екранни снимки за документация, да извършвате архивиране и да ускорявате процеса на разработка. Редовната практика и изучаването на резултата от adb help ще ви направят опитен потребител на този мощен инструмент.