ADB: základy práce s Android Debug Bridge a oblíbené příkazy

Co je ADB a k čemu slouží

Android Debug Bridge (ADB) — je klientsko-serverová aplikace, která se skládá ze tří komponent: klienta (běží na počítači), serveru (proces na pozadí na počítači) a démona adbd (běží na samotném zařízení Android). Když vývojář nebo inženýr připojí smartphone k PC, ADB vytvoří spolehlivý komunikační kanál, přes který lze přenášet příkazy, soubory a data.

Hlavní scénáře použití ADB zahrnují ladění aplikací na skutečném zařízení bez nutnosti publikovat APK v obchodě, extrahování logů pro analýzu chyb, automatizaci testování, zálohování dat, flashování recovery obrazů a získání root přístupu. I když nepíšete kód, ADB se může hodit pro extrahování snímků obrazovky z aplikací, nahrávání videonávodu z obrazovky telefonu nebo obnovení zařízení po neúspěšném flashování.

Podpora ADB je vestavěna do všech oficiálních sestavení Android od verze 2.1 (API 7). Pro provoz je vyžadována zapnutá možnost „Ladění přes USB“ v nastavení pro vývojáře. Od Android 4.2 při prvním připojení zařízení vyžaduje potvrzení: je třeba povolit ladění pro konkrétní počítač na základě jeho RSA klíče.

Instalace ADB na počítač

Pro Windows — stáhněte Platform Tools z oficiálních stránek Google Developers, rozbalte archiv do složky C:\adb a přidejte tuto cestu do proměnné prostředí PATH. Po restartu terminálu bude příkaz adb globálně dostupný.

Pro macOS — nejsnazší způsob je nainstalovat ADB přes správce balíčků Homebrew: spusťte brew install android-platform-tools. Všechny závislosti budou automaticky vyřešeny.

Pro Linux — v distribucích založených na Debian / Ubuntu: sudo apt install adb. Po instalaci přidejte uživatele do skupiny plugdev: sudo usermod -aG plugdev $USER a znovu se přihlaste, aby ADB získal přístup k USB zařízením.

Správnost instalace lze ověřit příkazem adb version. Pokud se v odpovědi zobrazí číslo verze Android Debug Bridge, nástroj je připraven k práci.

Připojení zařízení a základní příkazy

První připojení vždy začíná příkazem adb devices. Zobrazí seznam připojených zařízení a jejich stav. Pokud je zařízení zobrazeno jako unauthorized, odemkněte obrazovku a potvrďte ladění na telefonu.

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

Instalace aplikace — jedna z nejčastějších operací. Stačí zadat cestu k APK souboru:

adb install C:\apps\myapp.apk

Pokud je aplikace již nainstalována, ale je třeba ji nahradit aktualizovanou verzí, přidejte příznak -r (replace):

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

Odinstalace aplikace se provádí podle názvu balíčku:

adb uninstall com.example.myapp

Kopírování souborů — adb pull extrahuje soubor ze zařízení do počítače, adb push nahraje soubor do zařízení:

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

Interaktivní shell — příkaz adb shell otevře příkazový shell zařízení. Uvnitř lze spouštět standardní Linuxové příkazy: ls, ps, top, dumpsys, pm, am a další.

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

Spuštění aktivity přes ADB umožňuje otevřít jakoukoli aplikaci nebo obrazovku bez ručního hledání ikony:

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

Práce s logy: Logcat

Logcat — je logovací systém Android, který shromažďuje zprávy od aplikací, systémových služeb a jádra. Nástroj je nepostradatelný při ladění: z logů lze pochopit, proč aplikace spadla, která metoda způsobila výjimku nebo jak dlouho trvá konkrétní operace.

Jednoduché spuštění bez filtrů — adb logcat. Tok logů je nekonečný, pro zastavení stiskněte Ctrl+C. Pro filtrování zpráv podle tagu použijte parametr -s:

adb logcat -s MainActivity:V

Úrovně důležitosti logování (od nejpodrobnější po kritickou): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). Kombinace tagu a úrovně umožňuje extrahovat pouze potřebné zprávy.

Pro vyčištění nahromaděného bufferu před testem:

adb logcat -c

A pro uložení logů do souboru:

adb logcat -d > app_logs.txt

Příznak -d (dump) zobrazí aktuální buffer a ukončí běh bez blokování terminálu. To je vhodné pro automatizační skripty.

Snímky obrazovky, nahrávání obrazovky a užitečné diagnostické příkazy

Snímek obrazovky se pořizuje příkazem adb shell screencap. Výsledek se uloží do souboru, který se pak extrahuje přes adb pull:

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

Obě operace lze spojit do jednoho řádku pomocí substituce a roury. V praxi to urychluje tvorbu dokumentace a testovacích zpráv.

Nahrávání obrazovky je dostupné na Android 4.4+ (API 19). Výchozí délka nahrávání — 180 sekund, bitrate — 4 Mbit/s. Hlavní příkaz:

adb shell screenrecord /sdcard/demo.mp4

Pro zastavení nahrávání stiskněte Ctrl+C. Rozlišení videa odpovídá rozlišení obrazovky zařízení, ale nepřesahuje 1080p. Pro změnu bitrate uveďte --bit-rate:

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

Diagnostické příkazy: adb shell dumpsys zobrazí stav všech systémových služeb. Pro získání informací pouze o baterii:

adb shell dumpsys battery

Seznam nainstalovaných balíčků lze získat přes Package Manager:

adb shell pm list packages

Resetování nastavení aplikace (analogie vymazání dat v nastavení):

adb shell pm clear com.example.myapp

Pokročilé možnosti ADB

Wi-Fi ladění odstraňuje nutnost držet zařízení připojené přes USB. Ujistěte se, že počítač a zařízení jsou ve stejné síti. Nejprve spusťte adb tcpip 5555, odpojte USB, pak se připojte přes IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Pokud je IP adresa zařízení neznámá, zjistěte ji přes adb shell ip addr show wlan0 před odpojením kabelu.

Záloha dat aplikace nebo celého systému se provádí bez root:

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

Obnovení ze zálohy:

adb restore mybackup.ab

Emulace vstupu — příkaz adb shell input umožňuje simulovat dotyky, přejetí, stisknutí kláves a zadávání textu. To je základ pro automatizaci UI testů bez dalších frameworků:

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

Restart do různých režimů:

adb reboot          # běžný restart
adb reboot recovery # režim obnovy
adb reboot bootloader # zavaděč (fastboot)

Režim fastboot otevírá přístup k flashování obrazů, odemykání bootloaderu a instalaci vlastní obnovy.

Práce s více zařízeními

Když je připojeno více zařízení nebo emulátorů současně, ADB vyžaduje uvedení konkrétního sériového čísla. Příkaz adb devices zobrazí všechna připojená zařízení s jejich sériovými čísly.

Pro adresování příkazu konkrétnímu zařízení použijte příznak -s:

adb -s 0123456789ABCD install myapp.apk

Pokud je zařízení jedno, lze pracovat bez příznaku. Avšak v CI prostředí, kde běží několik emulátorů současně, je uvedení sériového čísla povinné.

Zabití serveru ADB — pokud zařízení přestane být detekováno nebo hlásí chybu, pomáhá restart serveru:

adb kill-server
adb start-server

Poté spusťte adb devices — server se restartuje a přesměruje požadavky na démony zařízení.

Hlavní příkazy ADB: souhrnná tabulka

Závěr

ADB (Android Debug Bridge) — je základní nástroj pro všechny, kdo pracují s Android na profesionální úrovni. Od základní instalace aplikací po složitou automatizaci testů a obnovu zařízení — ADB pokrývá prakticky každý scénář interakce počítače se smartphonem nebo tabletem.

Zvládnutím příkazů popsaných v tomto článku budete schopni sebevědomě spravovat zařízení Android přes terminál, analyzovat logy, pořizovat snímky obrazovky pro dokumentaci, provádět zálohy a urychlovat vývojový proces. Pravidelná praxe a studium výstupu adb help z vás udělá zkušeného uživatele tohoto mocného nástroje.