Android Debug Bridge (ADB) verwenden
Kurze Antwort
Android Debug Bridge (ADB) ist ein Kommandozeilenwerkzeug der Android SDK Platform Tools. Es steuert ein Android-Gerät über USB, installiert Apps, überträgt Dateien und gibt Systemprotokolle aus. Für die Nutzung müssen USB-Debugging und bei Bedarf passende Treiber aktiviert bzw. installiert werden.
Das Wichtigste
- ADB ist Teil der Android SDK Platform Tools und steuert Android-Geräte über die Kommandozeile.
- Vor der Nutzung müssen USB-Debugging und bei Bedarf passende Treiber aktiviert bzw. installiert werden.
- Typische Aufgaben sind APK-Installation, Dateitransfer, Shell-Zugriff und Protokollausgabe mit adb logcat.
- Für die meisten ADB-Aufgaben ist kein Root-Zugriff erforderlich.
Was ist Android Debug Bridge (ADB)?
Der Ausdruck android debug bridge adb bezeichnet ein vielseitiges Kommandozeilenwerkzeug zur Kommunikation mit einem Android-Gerät. Es gehört zu den Android SDK Platform Tools und unterstützt unter anderem Installation und Fehlersuche bei Apps sowie den Zugriff auf eine Unix-Shell auf dem Gerät. Über USB lassen sich damit Geräte steuern, Dateien austauschen, Apps hinzufügen oder entfernen und Shell-Befehle ausführen.
Hauptsächlich dient ADB der Fehlersuche bei Apps. Darüber hinaus wird es für Aufgaben wie das Sideloading von APK-Dateien, das Entfernen vorinstallierter Apps, Softwareupdates, das Zurücksetzen auf Werkseinstellungen, das Entsperren des Bootloaders oder das Rooten genutzt. Für die meisten dieser Aufgaben ist kein Root-Zugriff erforderlich.
ADB läuft auf gängigen Desktop-Betriebssystemen wie Windows, macOS, Linux und Chrome OS. Die Befehle werden in einem Terminal oder einer Eingabeaufforderung eingegeben, nachdem das Gerät verbunden und autorisiert wurde.
Android Debug Bridge ADB einrichten
1. Platform Tools herunterladen
Die benötigten Dateien stammen aus den Android SDK Platform Tools. Auf der Downloadseite wählt man den Link zum eigenen Betriebssystem; danach liegt ein ZIP-Archiv vor. Es wird in einen neuen Ordner entpackt. Die Dateien sind portabel und können an beliebiger Stelle gespeichert werden. Ein einfacher Pfad wie C:\platform-tools erleichtert spätere Befehle. Unter Windows kann der Ordner auch unter C:\Users\\Downloads\platform-tools liegen; der genaue Pfad wird im Dateibrowser nachgeschlagen.
2. USB-Debugging aktivieren
Auf dem Android-Gerät öffnet man die Einstellungen, wählt "Über das Telefon" und tippt siebenmal auf "Build-Nummer". Danach erscheint eine Meldung, dass man Entwickler ist. Anschließend steht in den Einstellungen die Option "USB-Debugging" zur Verfügung und muss aktiviert werden. Beim ersten Verbinden erscheint auf dem Gerät ein Dialog mit dem Titel "USB-Debugging zulassen?"; dort aktiviert man "Von diesem Computer immer zulassen" und bestätigt mit OK.
3. Verbindung prüfen
Man öffnet ein Kommandozeilenwerkzeug – unter Windows die Eingabeaufforderung, unter macOS das Terminal. Anschließend wechselt man in den Ordner mit den entpackten Platform Tools. Mit dem Befehl adb devices lässt sich prüfen, ob das Gerät erkannt wird. Erscheint das Gerät in der Liste, ist die Einrichtung abgeschlossen. Bleibt ein angeschlossenes Gerät unsichtbar, sind passende Treiber nötig. Diese stammen vom Gerätehersteller oder von Google und sind oft als ausführbare Datei oder INF-Datei verfügbar.
ADB ohne Android Studio nutzen
Die Platform Tools reichen für die meisten Aufgaben aus. Android Studio ist nicht erforderlich, wenn man nur Befehle ausführen, APK-Dateien installieren oder Dateien übertragen möchte. Diese Vorgehensweise eignet sich für schnelle Wartungsarbeiten an einem Gerät, etwa beim Testen einer App oder beim Sichern von Daten.
Befehle für typische Aufgaben
Die folgende Tabelle zeigt häufig genutzte Befehle. Dateinamen und Paketnamen werden an die eigene Situation angepasst.
| Befehl | Zweck |
|---|---|
| adb devices | Verbundene Geräte anzeigen |
| adb install datei.apk | APK-Datei auf dem Gerät installieren |
| adb uninstall paketname | App anhand des Paketnamens entfernen |
| adb push lokal gerät | Datei vom Computer auf das Gerät kopieren |
| adb pull gerät lokal | Datei vom Gerät auf den Computer kopieren |
| adb shell | Unix-Shell auf dem Gerät öffnen |
| adb logcat | Geräteprotokoll mit Fehler- und Debug-Meldungen ausgeben |
Der Befehl adb logcat gibt ein Geräteprotokoll aus. Damit lassen sich Fehlermeldungen und Debug-Informationen finden, etwa beim Testen einer App oder eines Softwareupdates. Wer eine APK-Datei manuell installieren möchte, findet weitere Schritte in der Anleitung APK auf Android installieren: Schritt-für-Schritt-Anleitung.
Dateien und Apps verwalten
ADB kann Dateien in beide Richtungen übertragen. Mit adb push wird eine Datei vom Computer auf das Gerät kopiert, mit adb pull in die umgekehrte Richtung. Apps werden über adb install hinzugefügt und über adb uninstall entfernt. Diese Funktionen sind nützlich, wenn eine App nicht über einen Store bezogen wird oder wenn Systemdateien gesichert werden sollen. Wer einen Screenshot auf Android erstellen möchte, kann die separate Anleitung So machst du einen Screenshot auf Android nutzen; ADB ist dafür nicht zwingend erforderlich.
Der Shell-Zugriff über adb shell erlaubt das Ausführen von Befehlen direkt auf dem Gerät. Dadurch lassen sich Dateien prüfen, Prozesse beobachten oder Einstellungen abfragen, ohne eine zusätzliche App zu installieren. Da diese Befehle mit den Rechten des Shell-Nutzers ausgeführt werden, sollten nur bekannte Befehle verwendet werden.
Fehlerbehebung bei der Verbindung
Wenn adb devices keine Geräte anzeigt, obwohl das Kabel verbunden ist, helfen einige Prüfungen. Zuerst sollte USB-Debugging auf dem Gerät aktiviert sein. Danach prüft man, ob der Autorisierungsdialog auf dem Gerät bestätigt wurde. Ein anderes USB-Kabel oder ein anderer Port kann ebenfalls helfen. Fehlende Treiber sind eine häufige Ursache; in diesem Fall installiert man die Treiber des Herstellers oder von Google. Die Treiber liegen oft als ausführbare Datei oder INF-Datei vor.
Bei instabilen Verbindungen lohnt sich ein Blick in das Geräteprotokoll. Mit adb logcat lassen sich Fehlermeldungen und Debug-Informationen auslesen. Diese Ausgabe ist besonders hilfreich, wenn eine App abstürzt oder ein Update nicht wie erwartet funktioniert. Für eine vollständige Rücksetzung des Geräts gibt es die Anleitung Android auf Werkseinstellungen zurücksetzen: Anleitung; ADB kann dabei helfen, ist aber nicht der einzige Weg.
Sicherheit und sinnvolle Grenzen
USB-Debugging gewährt weitreichenden Zugriff auf das Gerät. Deshalb sollte es nur aktiviert werden, wenn es benötigt wird, und der Autorisierungsdialog sollte nur für vertrauenswürdige Computer bestätigt werden. Die Option "Von diesem Computer immer zulassen" speichert diese Entscheidung; bei fremden oder öffentlichen Rechnern ist Vorsicht geboten.
ADB ist ein Werkzeug für Diagnose und Verwaltung, keine Garantie für erfolgreiche Systemänderungen. Aufgaben wie das Entsperren des Bootloaders oder das Rooten eines Geräts erfordern zusätzliche Schritte. Solche Eingriffe sollten nur mit passender Anleitung und nach einer Sicherung wichtiger Daten erfolgen.
Weitere häufige Fragen
Brauche ich Android Studio, um ADB zu nutzen?
Nein. Die Android SDK Platform Tools reichen für die meisten Aufgaben aus, etwa für Befehle, APK-Installation und Dateitransfer.
Funktioniert ADB ohne Root-Zugriff?
Ja. Für die meisten Aufgaben wie Installation, Dateitransfer und Protokollausgabe ist kein Root-Zugriff nötig.
Warum erkennt ADB mein Gerät nicht?
Häufige Ursachen sind deaktiviertes USB-Debugging, fehlende Treiber oder ein nicht bestätigter Autorisierungsdialog. Ein anderes Kabel oder ein anderer USB-Port kann ebenfalls helfen.
Was macht adb logcat?
Der Befehl erzeugt ein Geräteprotokoll mit Fehler- und Debug-Meldungen. Entwickler nutzen es zur Fehlersuche beim Testen von Apps oder Updates.
Verwandte Seiten
- Speicherplatz Android freigeben: Anleitung
Speicherplatz auf Android lässt sich durch Prüfen der Speicherbelegung, Leeren von Cache, Entfernen großer Apps und Medien sowie Sichern und Löschen von Dateien freigeben. Versteckte Dateien und der Bereich Sonstiges erklären oft, warum das Gerät trotz Aufräumens voll bleibt. Halte mindestens 10 bis 15 Prozent des Speichers frei, damit Android stabil läuft.
- Wie sicher sind Android-Handys? So sicherst du dein Gerät
Wie sicher sind Android-Handys? Sie sind dann gut geschützt, wenn du Bildschirmsperre, automatische Backups und Kontoschutz zusammen nutzt. Google sichert Daten in dein Konto, verschlüsselt einen Teil davon mit deiner Bildschirmsperre und erlaubt die Wiederherstellung nur unter bestimmten Versions- und Gerätebedingungen.
- Entwickleroptionen Android aktivieren: Anleitung
Entwickleroptionen Android aktivieren gelingt über die Build-Nummer in den Geräteeinstellungen. Danach stehen Debugging, Profiling und systemnahe Optionen zur Verfügung. Nach der Nutzung sollte der Hauptschalter wieder ausgeschaltet werden.
- Android Cache löschen: Anleitung für Apps und Browser
Android Cache löschen entfernt temporäre Dateien von Apps und Browsern, ohne Fotos, Nachrichten oder Anmeldedaten zu berühren. Die Anleitung zeigt den Weg über die Einstellungen, die Speicherverwaltung und, bei Bedarf, den Wiederherstellungsmodus.
- Wiederherstellungsmodus iPhone: Android-Recovery erklärt
Der Android-Recovery-Modus ist ein separater Startmodus für Wartung, Updates und Zurücksetzen. Er liegt auf einer eigenen Partition und wird über Tastenkombinationen gestartet. Dieser Artikel erklärt Zugriff, Menüpunkte, Beenden und typische Fehler.
- APK auf Android installieren: Schritt-für-Schritt-Anleitung
APK-Dateien lassen sich auf Android installieren, sobald die öffnende App dafür freigegeben ist. Der Ablauf umfasst Freigabe, Dateisuche, Installation und Start der App. Nur Dateien aus vertrauenswürdigen Quellen sollten verwendet werden.
Wie diese Seite entstanden ist
Vor dem Schreiben wurde das Thema in den unten genannten Quellen recherchiert. Danach hat die Seite automatische Qualitätsprüfungen bestanden.