ADB: Grundlagen der Arbeit mit Android Debug Bridge und gängige Befehle

Was ist ADB und wozu braucht man es

Android Debug Bridge (ADB) ist eine Client-Server-Anwendung, die aus drei Komponenten besteht: einem Client (läuft auf dem Computer), einem Server (Hintergrundprozess auf dem Computer) und einem Daemon adbd (läuft auf dem Android-Gerät selbst). Wenn ein Entwickler oder Ingenieur ein Smartphone an den PC anschließt, erstellt ADB einen zuverlässigen Kommunikationskanal, über den Befehle, Dateien und Daten übertragen werden können.

Zu den Hauptanwendungsfällen von ADB gehören das Debuggen von Anwendungen auf einem echten Gerät ohne Veröffentlichung einer APK in einem Store, das Extrahieren von Protokollen zur Fehleranalyse, die Testautomatisierung, Datensicherung, das Flashen von Recovery-Images und das Erlangen von Root-Zugriff. Selbst wenn Sie keinen Code schreiben, kann ADB nützlich sein, um Screenshots aus Apps zu extrahieren, eine Videoanleitung vom Telefonbildschirm aufzunehmen oder ein Gerät nach einem fehlgeschlagenen Firmware-Update wiederherzustellen.

ADB-Unterstützung ist in allen offiziellen Android-Builds ab Version 2.1 (API 7) integriert. Dafür muss die Option USB-Debugging in den Entwickleroptionen aktiviert sein. Ab Android 4.2 fordert das Gerät bei der ersten Verbindung eine Bestätigung: Sie müssen das Debugging für den bestimmten Computer über seinen RSA-Schlüssel erlauben.

ADB auf dem Computer installieren

Für Windows — laden Sie Platform Tools von der offiziellen Google Developers-Website herunter, entpacken Sie das Archiv in den Ordner C:\adb und fügen Sie diesen Pfad zur Umgebungsvariable PATH hinzu. Nach einem Neustart des Terminals ist der Befehl adb global verfügbar.

Für macOS — am einfachsten installieren Sie ADB über den Paketmanager Homebrew: führen Sie brew install android-platform-tools aus. Alle Abhängigkeiten werden automatisch aufgelöst.

Für Linux — auf Debian/Ubuntu-basierten Distributionen: sudo apt install adb. Fügen Sie nach der Installation den Benutzer zur Gruppe plugdev hinzu: sudo usermod -aG plugdev $USER und melden Sie sich neu an, damit ADB auf USB-Geräte zugreifen kann.

Überprüfen Sie die Installation mit dem Befehl adb version. Wenn die Ausgabe die Versionsnummer von Android Debug Bridge anzeigt, ist das Tool einsatzbereit.

Gerät verbinden und grundlegende Befehle

Erste Verbindung beginnt immer mit dem Befehl adb devices. Er zeigt eine Liste der verbundenen Geräte und deren Status an. Wenn das Gerät als unauthorized angezeigt wird, entsperren Sie den Bildschirm und bestätigen Sie das Debugging auf dem Telefon.

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

Installieren einer App — einer der häufigsten Vorgänge. Geben Sie einfach den Pfad zur APK-Datei an:

adb install C:\apps\myapp.apk

Wenn die App bereits installiert ist, aber durch eine aktualisierte Version ersetzt werden muss, fügen Sie das Flag -r (replace) hinzu:

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

Deinstallieren einer App erfolgt über den Paketnamen:

adb uninstall com.example.myapp

Dateien kopieren — adb pull holt eine Datei vom Gerät auf den Computer, adb push lädt eine Datei auf das Gerät hoch:

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

Interaktive Shell — der Befehl adb shell öffnet die Befehlsshell des Geräts. Darin können Sie standardmäßige Linux-Befehle ausführen: ls, ps, top, dumpsys, pm, am und andere.

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

Starten einer Aktivität über ADB ermöglicht das Öffnen jeder App oder jedes Bildschirms, ohne manuell nach dem Symbol suchen zu müssen:

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

Arbeiten mit Protokollen: Logcat

Logcat ist das Android-Protokollierungssystem, das Nachrichten von Anwendungen, Systemdiensten und dem Kernel sammelt. Das Tool ist unverzichtbar für das Debugging: Anhand der Protokolle können Sie nachvollziehen, warum eine App abgestürzt ist, welche Methode eine Ausnahme ausgelöst hat oder wie lange ein bestimmter Vorgang dauert.

Ein einfacher Start ohne Filter — adb logcat. Der Protokollstrom ist unendlich; drücken Sie Ctrl+C zum Anhalten. Um Nachrichten nach Tag zu filtern, verwenden Sie den Parameter -s:

adb logcat -s MainActivity:V

Schweregrade der Protokollierung (von detailliert bis kritisch): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). Die Kombination von Tag und Ebene ermöglicht es, nur die benötigten Nachrichten hervorzuheben.

Zum Löschen des angesammelten Puffers vor einem Test:

adb logcat -c

Und um Protokolle in einer Datei zu speichern:

adb logcat -d > app_logs.txt

Das Flag -d (dump) gibt den aktuellen Puffer aus und beendet sich, ohne das Terminal zu blockieren. Dies ist praktisch für Automatisierungsskripte.

Screenshots, Bildschirmaufnahme und nützliche Diagnosebefehle

Screenshot wird mit dem Befehl adb shell screencap erstellt. Das Ergebnis wird in einer Datei gespeichert, die dann über adb pull abgerufen wird:

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

Sie können beide Operationen durch Substitution und Piping in einer Zeile kombinieren. In der Praxis beschleunigt dies die Erstellung von Dokumentation und Testberichten.

Bildschirmaufnahme ist ab Android 4.4+ (API 19) verfügbar. Die Standardaufnahmedauer beträgt 180 Sekunden, die Bitrate 4 Mbit/s. Der Hauptbefehl:

adb shell screenrecord /sdcard/demo.mp4

Drücken Sie Ctrl+C, um die Aufnahme zu stoppen. Die Videoauflösung entspricht der Bildschirmauflösung des Geräts, überschreitet jedoch nicht 1080p. Zum Ändern der Bitrate geben Sie --bit-rate an:

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

Diagnosebefehle: adb shell dumpsys gibt den Status aller Systemdienste aus. Um nur Batterieinformationen zu erhalten:

adb shell dumpsys battery

Die Liste der installierten Pakete erhalten Sie über den Package Manager:

adb shell pm list packages

Zurücksetzen der App-Einstellungen (entspricht dem Löschen von Daten in den Einstellungen):

adb shell pm clear com.example.myapp

Erweiterte ADB-Funktionen

WLAN-Debugging macht es überflüssig, das Gerät über USB verbunden zu halten. Stellen Sie sicher, dass Computer und Gerät im selben Netzwerk sind. Führen Sie zuerst adb tcpip 5555 aus, trennen Sie USB, dann verbinden Sie sich per IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Wenn die IP-Adresse des Geräts unbekannt ist, ermitteln Sie sie über adb shell ip addr show wlan0 vor dem Trennen des Kabels.

Datensicherung einer App oder des gesamten Systems kann ohne Root durchgeführt werden:

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

Wiederherstellung aus einem Backup:

adb restore mybackup.ab

Eingabeemulation — der Befehl adb shell input ermöglicht die Simulation von Berührungen, Wischbewegungen, Tastendrücken und Texteingabe. Dies ist die Grundlage für die UI-Testautomatisierung ohne zusätzliche Frameworks:

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

Neustart in verschiedenen Modi:

adb reboot          # normal reboot
adb reboot recovery # recovery mode
adb reboot bootloader # bootloader (fastboot)

Der Fastboot-Modus bietet Zugriff zum Flashen von Images, Entsperren des Bootloaders und Installieren von Custom-Recovery.

Arbeiten mit mehreren Geräten

Wenn mehrere Geräte oder Emulatoren gleichzeitig angeschlossen sind, benötigt ADB eine bestimmte Seriennummer. Der Befehl adb devices listet alle verbundenen Geräte mit ihren Seriennummern auf.

Um einen Befehl an ein bestimmtes Gerät zu richten, verwenden Sie das Flag -s:

adb -s 0123456789ABCD install myapp.apk

Wenn nur ein Gerät vorhanden ist, kann das Flag weggelassen werden. In einer CI-Umgebung, in der mehrere Emulatoren gleichzeitig laufen, ist die Angabe der Seriennummer jedoch obligatorisch.

ADB-Server beenden — wenn ein Gerät nicht mehr erkannt wird oder einen Fehler ausgibt, hilft ein Neustart des Servers:

adb kill-server
adb start-server

Führen Sie danach adb devices aus — der Server wird neu gestartet und leitet Anfragen an die Geräte-Daemons weiter.

Wichtige ADB-Befehle: Referenztabelle

Fazit

ADB (Android Debug Bridge) ist ein grundlegendes Werkzeug für alle, die professionell mit Android arbeiten. Von der einfachen App-Installation bis zur komplexen Testautomatisierung und Gerätewiederherstellung — ADB deckt praktisch jedes Szenario der Interaktion zwischen Computer und Smartphone oder Tablet ab.

Wenn Sie die in diesem Artikel beschriebenen Befehle beherrschen, können Sie ein Android-Gerät sicher über das Terminal verwalten, Protokolle analysieren, Screenshots für die Dokumentation erstellen, Backups durchführen und den Entwicklungsprozess beschleunigen. Regelmäßige Praxis und das Studium der Ausgabe von adb help machen Sie zu einem erfahrenen Benutzer dieses leistungsstarken Tools.