ADB: Das umfassende Tool zur Android-Debug-Bridge

Was ist ADB (Android Debug Bridge)?

Die Android Debug Bridge (ADB) ist ein vielseitiges Tool, mit dem du dein Android-Gerät von deinem Computer aus steuern und debuggen kannst. Es ist ein unverzichtbares Werkzeug für Entwickler, Tester und erfahrene Nutzer, die Funktionen nutzen möchten, die über die herkömmlichen Benutzeroberflächen hinausgehen.

Funktionen der ADB

ADB bietet eine Reihe von Funktionen, mit denen du dein Android-Gerät fernsteuern kannst, darunter:

Installieren und Deinstallieren von Apps
Starten und Stoppen von Diensten
Abrufen von Systemprotokollen
Ausführen von Shell-Befehlen

Vorteile der Verwendung von ADB

Die Verwendung von ADB bietet mehrere Vorteile gegenüber der Verwendung herkömmlicher Debugging-Methoden:

Remotezugriff: Du kannst dein Gerät von deinem Computer aus steuern, auch wenn der Bildschirm gesperrt oder beschädigt ist.
Erweiterte Funktionen: ADB bietet Zugriff auf erweiterte Funktionen, die in der Standard-Benutzeroberfläche nicht verfügbar sind.
Automatisierung: Du kannst Aufgaben wie das Installieren von Apps oder das Ausführen von Tests automatisieren.
Fehlerbehebung: ADB ist ein wertvolles Tool zur Fehlerbehebung von Problemen mit deinem Android-Gerät oder -Apps.

Installation von ADB

Voraussetzungen

Um ADB zu installieren, benötigst du Folgendes:

Einen Computer mit Windows, macOS oder Linux
Ein USB-Kabel zum Verbinden deines Android-Geräts mit deinem Computer
Die Android SDK Platform Tools von Google

Installation der Android SDK Platform Tools

Lade die Android SDK Platform Tools von der offiziellen Website von Google herunter: https://developer.android.com/studio/releases/platform-tools
Entpacke die ZIP-Datei in einen Ordner auf deinem Computer.

Hinzufügen von ADB zum Pfad

Damit du ADB von überall auf deinem Computer aus aufrufen kannst, musst du den Pfad zu den Platform Tools deinem Betriebssystem hinzufügen:

Windows:

Öffne die Systemsteuerung.
Gehe zu "System und Sicherheit" > "System".
Klicke auf "Erweiterte Systemeinstellungen".
Klicke auf die Registerkarte "Erweitert" und dann auf "Umgebungsvariablen".
Unter "Systemvariablen" wähle "Path" aus und klicke auf "Bearbeiten".
Füge den Pfad zum Ordner der Android SDK Platform Tools hinzu.

macOS:

Öffne das Terminal.
Führe den folgenden Befehl aus:

export PATH="$PATH:/Applications/adt-bundle-mac-x86_64-20220823/sdk/platform-tools"

Ersetze dabei /Applications/adt-bundle-mac-x86_64-20220823/sdk/platform-tools durch den tatsächlichen Pfad zum Ordner der Platform Tools.

Linux:

Öffne ein Terminal.
Führe den folgenden Befehl aus:

export PATH="$PATH:/home/benutzername/Android/sdk/platform-tools"

Ersetze dabei /home/benutzername/Android/sdk/platform-tools durch den tatsächlichen Pfad zum Ordner der Platform Tools.

Überprüfung der Installation

Um zu überprüfen, ob ADB korrekt installiert ist, öffne ein Terminal oder eine Eingabeaufforderung und führe den folgenden Befehl aus:

adb

Wenn die Installation erfolgreich war, sollte eine Liste der verfügbaren Befehle angezeigt werden.

Herstellung einer Verbindung zu einem Android-Gerät über ADB

Um ADB verwenden zu können, musst du eine Verbindung zu deinem Android-Gerät herstellen. Dies ist ein relativ einfacher Vorgang, der jedoch einige Schritte erfordert:

USB-Treiber installieren

Bevor du eine Verbindung über ADB herstellen kannst, musst du die entsprechenden USB-Treiber für dein Android-Gerät installieren. Diese Treiber findest du in der Regel auf der Website des Geräteherstellers.

ADB-Modus aktivieren

Auf deinem Android-Gerät musst du den ADB-Modus aktivieren. Gehe dazu zu "Einstellungen" > "Über das Telefon" > "Build-Nummer" und tippe siebenmal auf die Build-Nummer. Dadurch werden die Entwickleroptionen freigeschaltet. Gehe nun zurück zu "Einstellungen" > "System" > "Erweiterte Optionen" > "Entwickleroptionen" und aktiviere die Option "USB-Debugging".

Geräteverbindung prüfen

Verbinde dein Android-Gerät über ein USB-Kabel mit deinem Computer. Öffnen ein Terminalfenster (z. B. Git Bash oder die Eingabeaufforderung) und führe den folgenden Befehl aus:

adb devices

Wenn dein Gerät erkannt wird, siehst du eine Seriennummer aufgelistet. Wenn das Gerät nicht erkannt wird, überprüfe die USB-Verbindung und stelle sicher, dass die USB-Treiber korrekt installiert sind.

Verwendung grundlegender ADB-Befehle

Sobald du ADB eingerichtet und eine Verbindung zu deinem Android-Gerät hergestellt hast, kannst du mit der Verwendung der grundlegenden Befehle beginnen.

Geräteinformationen anzeigen

Verwende den Befehl adb devices, um eine Liste der an deinen Computer angeschlossenen Android-Geräte anzuzeigen:

adb devices

Shell-Zugriff erhalten

Starte eine Shell-Sitzung auf dem Gerät mit dem Befehl adb shell:

adb shell

Dies gibt dir einen Root-Zugriff auf das Gerät, mit dem du Befehle wie ls, cd und mkdir ausführen kannst.

Dateien übertragen

Verwende den Befehl adb push, um Dateien von deinem Computer auf dein Gerät zu übertragen:

adb push <quelle> <ziel>

Ersetze <quelle> durch den Pfad zur Datei auf deinem Computer und <ziel> durch den Pfad zum Zielverzeichnis auf dem Gerät.

Um Dateien vom Gerät auf deinen Computer zu kopieren, verwende den Befehl adb pull:

adb pull <quelle> <ziel>

Systemprotokolle anzeigen

Zeige die Systemprotokolle des Geräts mit dem Befehl adb logcat an:

adb logcat

Dies kann dir bei der Fehlersuche und Fehlerbehebung helfen.

App-Installation und Deinstallation

Installiere Apps auf dem Gerät mit dem Befehl adb install:

adb install <app-datei>.apk

Ersetze <app-datei>.apk durch den Namen der APK-Datei.

Deinstalliere Apps mit dem Befehl adb uninstall:

adb uninstall <paketname>

Ersetze <paketname> durch den Paketnamen der App.

Verwenden von ADB zum Debuggen von Android-Apps

ADB ist ein unverzichtbares Tool für das Debuggen von Android-Apps. Es ermöglicht dir, auf Systemdetails zuzugreifen, Protokolldateien zu lesen und Befehle direkt auf dem Gerät auszuführen.

Anschließen an einen Debugger

Um deine App mit ADB zu debuggen, musst du sie zuerst mit einem Debugger verbinden. Du kannst dies mit dem Befehl adb shell tun:

adb shell

Dadurch wird eine Eingabeaufforderung auf deinem Gerät geöffnet. Von hier aus kannst du Befehle ausführen, um deine App zu debuggen.

LogCat verwenden

LogCat ist ein Tool zum Überwachen der Protokolldateien deiner App. Es kann helfen, Fehler zu identifizieren und Informationen über die Leistung deiner App zu sammeln.

Um LogCat zu verwenden, führe den folgenden Befehl aus:

adb logcat

Dadurch wird ein Protokoll aller Nachrichten angezeigt, die von deiner App und dem Android-System generiert werden. Du kannst die Nachrichten filtern, indem du nach bestimmten Tags oder Nachrichtenebenen suchst.

Debuggen von Netzwerkproblemen

ADB kann auch verwendet werden, um Netzwerkprobleme zu debuggen. Mit dem Befehl adb tcpdump kannst du den Netzwerkverkehr deines Geräts aufzeichnen. Dies kann hilfreich sein, um die Ursache von Verbindungsproblemen oder Verzögerungen zu ermitteln.

adb tcpdump

Debugging von Speicherlecks

Speicherlecks können zu Leistungsproblemen auf Android-Geräten führen. Mit ADB kannst du nach Speicherlecks suchen, indem du den Befehl adb meminfo verwendest.

adb meminfo

Dieser Befehl zeigt Informationen zum Speicherverbrauch deiner App an, einschließlich des aktuellen Speichers, des maximalen Speichers und möglicher Speicherlecks.

Tipps zur Fehlerbehebung

Wenn du Probleme beim Debuggen mit ADB hast, versuche Folgendes:

Stelle sicher, dass du die richtige Version von ADB verwendest.
Vergewissere dich, dass auf deinem Gerät USB-Debugging aktiviert ist.
Versuche, dein Gerät neu zu starten und es erneut mit ADB zu verbinden.
Konsultiere die offizielle ADB-Dokumentation für weitere Hilfe.

Beheben häufiger ADB-Probleme

Bei der Verwendung von ADB kannst du auf verschiedene Probleme stoßen. Hier sind einige häufige Probleme und Tipps zu deren Behebung:

ADB erkennt mein Gerät nicht

Stelle sicher, dass du die ADB-Treiber auf deinem Computer installiert hast.
Überprüfe, ob das USB-Debugging auf deinem Android-Gerät aktiviert ist.
Versuche, ein anderes USB-Kabel zu verwenden.
Starte sowohl dein Android-Gerät als auch deinen Computer neu.

ADB-Befehle werden nicht ausgeführt

Stelle sicher, dass du die richtigen ADB-Befehle verwendest.
Überprüfe, ob du Administratorrechte hast.
Versuche, die ADB-Shell zu verwenden, um Befehle direkt auf deinem Gerät auszuführen.

ADB dauert ewig oder friert ein

Verwende den Befehl adb kill-server und starte den ADB-Server neu.
Trenne dein Android-Gerät vom Computer und verbinde es erneut.
Versuche, ein anderes USB-Kabel zu verwenden.

ADB-Befehle melden Zugriffsverweigerung

Stelle sicher, dass du als Superuser (root) handelst.
Verwende den Befehl adb shell su oder adb root (falls verfügbar).
Aktiviere die USB-Debugging-Autorisierung auf deinem Android-Gerät.

Andere Probleme

Wenn du auf andere Probleme stößt, kannst du die folgenden Ressourcen konsultieren:

Alternative Debugging-Tools für Android

Zusätzlich zu ADB gibt es noch andere Tools, die dir bei der Fehlersuche auf deinem Android-Gerät helfen können:

Android Studio Logcat

Der Logcat in Android Studio ist ein leistungsstarkes Debugging-Tool, das dir ermöglicht, Protokolle von deiner App und dem Android-System anzuzeigen. Mit dem Logcat kannst du Probleme identifizieren, die durch Fehler in der App oder Probleme mit dem Betriebssystem verursacht werden.

Firebase Crashlytics

Firebase Crashlytics ist ein Dienst, der dir hilft, App-Abstürze zu analysieren und zu beheben. Er sammelt automatisch Crash-Berichte und bietet dir detaillierte Informationen darüber, wo und warum deine App abstürzt.

Stetho

Stetho ist eine Bibliothek, die es dir ermöglicht, dein Android-Gerät über Chrome DevTools zu debuggen. Mit Stetho kannst du auf Datenbanken, Netzwerkanforderungen und andere Aspekte deiner App zugreifen und diese inspizieren.

Genymotion

Genymotion ist ein Android-Emulator, mit dem du deine Apps in einer virtuellen Umgebung testen kannst. Genymotion bietet eine Vielzahl von Funktionen wie Geräteemulation, GPS-Spoofing und Netzwerksimulation.

Weitere Ressourcen

Hier sind einige zusätzliche Ressourcen, die dir bei der Verwendung alternativer Debugging-Tools helfen können:

Ressourcen für weitere ADB-Informationen

Für alle, die tiefer in die ADB-Welt eintauchen möchten, stehen zahlreiche Ressourcen zur Verfügung:

Umfangreiche Dokumentationen

Forumunterstützung und Community-Ressourcen

Lern- und Schulungsmaterialien

Tools und Software

Zusätzliche Tipps und Tricks

Lies die Dokumentation: Die offizielle Dokumentation ist eine wertvolle Ressource für detaillierte Anleitungen und Beispiele.
Suche in Online-Foren: Andere Entwickler stehen dir bei Fragen und Problemen gerne zur Seite.
Experimentiere mit Befehlen: Der beste Weg, um ADB zu meistern, ist, verschiedene Befehle auszuprobieren und zu sehen, wie sie funktionieren.
Bleib auf dem Laufenden: Die ADB-Entwicklung schreitet ständig voran. Bleibe über neue Funktionen und Verbesserungen auf dem Laufenden.