adb-Grundlagen für jeden App-Tester

In diesem Ratgeber

Einrichtung in zwei Minuten
Builds installieren und entfernen
Zustand zurücksetzen
Berechtigungen
Logs
Dateien, Screenshots, Bildschirmaufnahmen
Grenzen

adb (Android Debug Bridge) ist ein Kommandozeilenwerkzeug, das per USB oder WLAN mit Handy oder Emulator spricht. Du musst nicht alles kennen. Etwa ein Dutzend Befehle reichen für den Testalltag: Build installieren, App zurücksetzen, Berechtigung setzen, Log für den Fehlerbericht sichern.

Einrichtung in zwei Minuten

Installiere die Android SDK Platform-Tools (darin steckt adb).
Aktiviere am Handy die Entwickleroptionen (in den Einstellungen mehrfach auf die Build-Nummer tippen) und schalte das USB-Debugging ein.
Verbinde das Handy und bestätige die Abfrage zum USB-Debugging.
Starte adb devices. Dein Gerät sollte als device erscheinen. Steht dort unauthorized, bestätige die Abfrage am Handy erneut.

Sind mehrere Geräte verbunden, hänge an jeden Befehl -s <Seriennummer> aus der Ausgabe von adb devices.

Builds installieren und entfernen

Ziel	Befehl
APK installieren	`adb install app.apk`
Aktualisieren, Daten behalten	`adb install -r app.apk`
Ältere Version erlauben (Debug-Builds)	`adb install -r -d app.apk`
Deinstallieren	`adb uninstall com.example.app`
Deinstallieren, Daten behalten	`adb uninstall -k com.example.app`

Ersetze com.example.app durch deinen Paketnamen. Scheitert die Installation, nennt die Fehlermeldung meist die Ursache (etwa abweichende Signatur oder Versionscode). Ein Bundle (.aab) installierst du nicht direkt; zum Testen nimmst du daraus erzeugte APKs oder eine Test-Spur im Store.

Zustand zurücksetzen

adb shell pm clear com.example.app löscht Daten und Cache der App, ähnlich einer Neuinstallation, nur schneller. Nutze es vor jedem Test des ersten Starts.
adb shell am force-stop com.example.app beendet die App. Praktisch für Kaltstart-Tests.
adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1 startet die App, ohne den Activity-Namen zu kennen.

Berechtigungen

Erteilen: adb shell pm grant com.example.app android.permission.CAMERA
Entziehen: adb shell pm revoke com.example.app android.permission.CAMERA

So testest du „erlaubt“ und „abgelehnt“ schnell nacheinander. Das geht nur für Laufzeit-Berechtigungen, die deine App deklariert.

Logs

adb logcat zeigt das Systemlog live. Es ist laut; filtere nach Paket oder Tag.
adb logcat -c leert den Puffer, damit die Aufnahme sauber beginnt.
adb logcat -d > log.txt schreibt den aktuellen Puffer in eine Datei und beendet sich.

Bewährter Ablauf für einen reproduzierbaren Fehler: Log leeren, Problem einmal auslösen, Log sichern, anhängen. Mehr dazu: Absturzberichte priorisieren.

Dateien, Screenshots, Bildschirmaufnahmen

adb pull /sdcard/datei.png . kopiert eine Datei vom Handy.
adb exec-out screencap -p > screen.png speichert einen Screenshot.
adb shell screenrecord /sdcard/demo.mp4 nimmt den Bildschirm auf (mit Strg+C beenden, dann Datei holen). Nach einem geräteabhängigen Zeitlimit endet die Aufnahme von selbst.

Grenzen

adb zeigt, was das Gerät getan hat, nicht, was ein Mensch empfunden hat. Es ersetzt keine Tests mit echten Menschen auf echten Handys, macht deren Meldungen aber deutlich besser: Log und genauer Build sind mehr wert als „es ist abgestürzt“.

Teil des Android-Testing-Leitfadens. Verwandt: Pre-Launch-Bericht der Play Console und Android-Vitals-Grundlagen.

Du willst Rückmeldung zu einem Build von echten Menschen? Kostenlos starten und privates, strukturiertes Feedback zu deiner App bekommen.