Teste deine Android-App immer auf einem echten Gerät, bevor du sie für Nutzer veröffentlichst. Auf dieser Seite wird beschrieben, wie Sie Ihre Entwicklungsumgebung und Ihr Android-Gerät zum Testen und Debuggen über eine ADB-Verbindung (Android Debug Bridge) einrichten.
Gerät für Entwicklung einrichten
Bevor Sie mit der Fehlerbehebung auf Ihrem Gerät beginnen können, müssen Sie entscheiden, ob Sie das Gerät über ein USB-Kabel oder über WLAN verbinden möchten. Gehen Sie dann so vor:
Öffnen Sie auf dem Gerät die App Einstellungen, wählen Sie Entwickleroptionen aus und aktivieren Sie dann USB-Debugging (falls zutreffend).
Richten Sie Ihr System so ein, dass es Ihr Gerät erkennt.
- ChromeOS: Keine zusätzliche Konfiguration erforderlich.
- macOS: Keine zusätzliche Konfiguration erforderlich.
- Windows: Installieren Sie einen USB-Treiber für ADB (falls vorhanden). Eine Installationsanleitung und Links zu OEM-Treibern finden Sie unter OEM-USB-Treiber installieren.
Ubuntu Linux: Richten Sie Folgendes ein:
- Jeder Nutzer, der ADB verwenden möchte, muss der Gruppe
plugdev
angehören. Wenn Sie in einer Fehlermeldung darauf hingewiesen werden, dass Sie nicht in der Gruppeplugdev
sind, fügen Sie sich mit dem folgenden Befehl selbst hinzu:
sudo usermod -aG plugdev $LOGNAME
Gruppen werden nur bei der Anmeldung aktualisiert, sodass Sie sich abmelden müssen, damit diese Änderung wirksam wird. Nach der erneuten Anmeldung können Sie mit
id
prüfen, ob Sie in der Gruppeplugdev
sind.- Auf dem System müssen
udev
Regeln installiert sein, die das Gerät abdecken. Das Paketandroid-sdk-platform-tools-common
enthält einen von der Community verwalteten Standardsatz vonudev
-Regeln für Android-Geräte. Verwenden Sie den folgenden Befehl, um es zu installieren:
apt-get install android-sdk-platform-tools-common
- Jeder Nutzer, der ADB verwenden möchte, muss der Gruppe
Gerät per USB verbinden
Wenn die Einrichtung abgeschlossen und über USB angeschlossen ist, klicken Sie in Android Studio auf Ausführen , um Ihre App auf dem Gerät zu erstellen und auszuführen.
Sie können auch adb
verwenden, um Befehle auszuführen:
- Prüfen Sie, ob Ihr Gerät verbunden ist. Führen Sie dazu den Befehl
adb devices
in Ihrem Verzeichnisandroid_sdk/platform-tools/
aus. Wenn die Verbindung hergestellt ist, wird das Gerät in der Liste angezeigt. - Führen Sie einen beliebigen
adb
-Befehl mit dem Flag-d
aus, um das Gerät als Ziel zu verwenden.
Gerät über WLAN verbinden
Android 11 und höher unterstützt die kabellose Bereitstellung und Fehlerbehebung für Ihre App von Ihrer Workstation aus über Android Debug Bridge (ADB). Sie können Ihre Debug-fähige Anwendung beispielsweise auf mehreren Remote-Geräten bereitstellen, ohne Ihr Gerät physisch über USB anzuschließen und mit häufigen USB-Verbindungsproblemen wie der Treiberinstallation zu kämpfen.
Wenn Sie das kabellose Debugging verwenden möchten, müssen Sie Ihr Gerät mithilfe eines Kopplungscodes mit Ihrer Workstation koppeln. Führen Sie zunächst die folgenden Schritte aus:
- Achten Sie darauf, dass die Workstation und das Gerät mit demselben WLAN verbunden sind.
- Auf deinem Gerät muss Android 11 oder höher installiert sein. Weitere Informationen findest du unter Android-Version prüfen und aktualisieren.
- Prüfen Sie, ob Sie die neueste Version von Android Studio installiert haben. Dann laden Sie sie hier herunter.
- Aktualisieren Sie auf Ihrer Workstation die SDK Platform Tools auf die neueste Version.
So stellen Sie eine Verbindung zu Ihrem Gerät her:
- Öffne Android Studio und wähle im Menü „Ausführungskonfigurationen“ die Option Geräte über WLAN koppeln aus.
- Aktiviere auf deinem Gerät die Entwickleroptionen.
- Aktivieren Sie auf Ihrem Gerät das Debugging über WLAN.
- Tippen Sie auf Debugging über WLAN und koppeln Sie Ihr Gerät:
- Wenn du dein Gerät mit einem QR-Code koppeln möchtest, wähle Gerät mit QR-Code koppeln aus und scanne den QR-Code (siehe Abbildung 2).
- Um dein Gerät mit einem Kopplungscode zu koppeln, wähle im Dialogfeld Neue Geräte über WLAN koppeln die Option Gerät mit Kopplungscode koppeln aus. Wähle auf deinem Gerät Über Kopplungscode koppeln aus. Es erscheint ein sechsstelliger
Code. Wenn dein Gerät im Fenster Geräte über WLAN koppeln angezeigt wird, gib den auf dem Gerät angezeigten sechsstelligen Code ein und wähle Koppeln aus .
- Nach dem Koppeln kannst du versuchen, deine App auf deinem Gerät bereitzustellen.
So koppelst du ein anderes Gerät oder entkoppelst dieses Gerät auf deiner Workstation:
- Rufe auf deinem Gerät Debugging über WLAN auf.
- Tippen Sie unter Gekoppelte Geräte auf den Namen Ihrer Workstation.
- Wählen Sie Entfernen aus.
Gerätespiegelung
Sie können Ihr physisches Gerät in Android Studio im Fenster Laufende Geräte spiegeln. Wenn Sie den Bildschirm Ihres Geräts direkt in Android Studio streamen, können Sie mit der Studio-IDE selbst gängige Aktionen ausführen, wie z. B. Apps starten und mit ihnen interagieren, den Bildschirm drehen, das Smartphone zu- und aufklappen oder die Lautstärke ändern.
Die Gerätespiegelung ist immer verfügbar, wenn Geräte mit dem Computer verbunden sind, bei denen das Debugging über USB oder kabelloses Debugging aktiviert ist. Sie können das Spiegeln über das Fenster Laufende Geräte oder den Gerätemanager (Ansicht > Tool-Fenster > Geräte-Manager) starten und beenden. Sie können auch anpassen, wann die Gerätespiegelung in den Einstellungen aktiviert ist (Einstellungen > Tools > Gerätespiegelung).
Audio weiterleiten
Wenn Sie die Gerätespiegelung verwenden, können Sie Audio von verbundenen physischen Geräten an die Lautsprecher oder Kopfhörer Ihres Computers weiterleiten. Bei der Audioweiterleitung bleiben die Kopfhörer an den Computer angeschlossen und können sowohl den Computer als auch das verbundene Smartphone hören, ohne die Verbindung zu einem Gerät und einem anderen manuell neu herstellen zu müssen. Um die Audioweiterleitung zu aktivieren, gehen Sie zu Datei (Android Studio unter macOS) > Einstellungen > Tools > Gerätespiegelung und wählen Sie Audio von lokalen Geräten weiterleiten aus. Bei Firebase Test Lab-Geräten mit Android 12 oder höher werden Audiodaten unabhängig von den Einstellungen immer weitergeleitet.
Bekannte Probleme
Einige Geräte können möglicherweise nicht mit einer für die Gerätespiegelung ausreichenden Bitrate codieren. In diesen Situationen werden möglicherweise ein Fehler im Fenster Running Devices (Laufende Geräte) sowie in Logs ähnlich den folgenden angezeigt.
2023-06-01 15:32:22,675 [ 56094] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [ 56289] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [ 56290] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1
Datenschutzhinweise
Android Studio kann basierend auf den Einstellungen für die Gerätespiegelung automatisch das Spiegeln aller verbundenen und gekoppelten Geräte starten. Dies kann dazu führen, dass für Geräte, die mit dem Befehl adb tcpip
verbunden sind, Informationen offengelegt werden, da die Spiegelungsinformationen und Befehle über einen unverschlüsselten Kanal übergeben werden. Außerdem verwendet Android Studio einen unverschlüsselten Kanal für die Kommunikation mit dem ADB-Server, sodass die Spiegelung von Informationen von anderen Nutzern auf Ihrem Hostcomputer abgefangen werden kann.
Fehlerbehebung bei der Geräteverbindung
Wenn sich dein Gerät nicht mit Android Studio verbindet, führe die folgenden Schritte aus, um das Problem zu beheben:
Fehlerbehebung mit dem Verbindungsassistenten
Der Verbindungsassistenten bietet eine detaillierte Anleitung zum Einrichten und Verwenden eines Geräts über die ADB-Verbindung.
Um den Assistenten zu starten, wähle Tools > Fehlerbehebung bei Geräteverbindungen aus.
Der Verbindungsassistenten bietet im Bereich Assistant Anleitungen, kontextbezogene Steuerelemente und eine Liste der verbundenen Geräte auf einer Reihe von Seiten. Verwenden Sie die Schaltflächen Weiter und Zurück unten im Assistant-Bereich, um die Seiten nach Bedarf durchzugehen:
- Gerät über USB verbinden: Der Verbindungsassistenten fordert Sie zuerst auf, Ihr Gerät über USB zu verbinden, und bietet die Schaltfläche USB-Geräte erneut scannen, mit der Sie eine neue Suche nach verbundenen Geräten starten können.
- USB-Debugging aktivieren: Der Verbindungsassistenten teilt Ihnen dann mit, wie Sie USB-Debugging in den Entwickleroptionen auf dem Gerät aktivieren können.
- ADB-Server neu starten: Wenn Ihr Gerät immer noch nicht in der Liste der verfügbaren Geräte aufgeführt ist, verwenden Sie die Schaltfläche ADB-Server neu starten auf der letzten Seite des Verbindungsassistenten. Ein Neustart des ADB-Servers führt auch dazu, dass ADB noch einmal nach Geräten sucht. Wenn dein Gerät immer noch nicht in der Liste der verfügbaren Geräte aufgeführt ist, führe die Schritte zur Fehlerbehebung im folgenden Abschnitt durch.
Probleme mit der USB-Verbindung beheben
Wenn der Verbindungsassistenten Ihr Gerät nicht über USB erkennt, führen Sie die folgenden Schritte zur Fehlerbehebung aus:
Verbindung zwischen Android Studio und dem Android-Emulator herstellen
So überprüfen Sie, ob das Problem durch ein Verbindungsproblem zwischen Android Studio und dem Android-Emulator verursacht wird:
- Öffnen Sie den Geräte-Manager.
- Erstellen Sie ein neues AVD, falls Sie noch keines haben.
- Führen Sie den Emulator über das AVD aus.
- Sie haben folgende Möglichkeiten:
- Wenn Android Studio keine Verbindung zum Emulator herstellen kann, laden Sie die neuesten SDK Platform Tools herunter und versuchen Sie es dann noch einmal.
- Wenn der Emulator erfolgreich gestartet wird, prüfen Sie das USB-Kabel, wie im folgenden Abschnitt beschrieben.
USB-Kabel prüfen
Führen Sie die Schritte in diesem Abschnitt aus, um zu prüfen, ob das Problem durch ein defektes USB-Kabel verursacht wird.
Wenn Sie ein anderes USB-Kabel haben:
- Schließen Sie das Gerät mit dem sekundären Kabel an.
- Prüfen Sie, ob der Verbindungsassistenten das Gerät jetzt erkennen kann.
- Wenn das Gerät nicht erkannt wird, versuchen Sie es noch einmal mit dem Hauptkabel.
- Wenn das Gerät immer noch nicht erkannt wird, gehen Sie davon aus, dass das Problem am Gerät liegt, und prüfen Sie, ob das Gerät für die Entwicklung eingerichtet ist, wie im folgenden Abschnitt beschrieben.
Wenn Sie kein anderes USB-Kabel haben, aber ein anderes Android-Gerät haben:
- Schließen Sie das zweite Gerät an den Computer an.
Wenn der Verbindungsassistenten das sekundäre Gerät erkennen kann, gehen Sie davon aus, dass das Problem beim primären Gerät liegt, und prüfen Sie, ob das Gerät für die Entwicklung eingerichtet ist.
Wenn das sekundäre Gerät nicht erkannt wird, könnte das Problem am USB-Kabel liegen.
Prüfen, ob das Gerät für die Entwicklung eingerichtet ist
So prüfen Sie, ob das Problem durch Einstellungen auf dem Gerät verursacht wird:
- Folgen Sie der Anleitung im Abschnitt Gerät für die Entwicklung einrichten.
- Wenn das Problem dadurch nicht behoben wird, wende dich an den Kundensupport des OEMs. Teile dem Kundensupportmitarbeiter mit, dass sich das Gerät nicht über ADB mit Android Studio verbindet.
Probleme mit der drahtlosen Verbindung beheben
Wenn Sie Probleme haben, eine drahtlose Verbindung zu Ihrem Gerät herzustellen, können Sie die folgenden Schritte zur Fehlerbehebung ausprobieren:
Prüfen, ob Ihre Workstation und Ihr Gerät die Voraussetzungen erfüllen
Um die Voraussetzungen für das Debugging über WLAN zu erfüllen, müssen folgende Voraussetzungen erfüllt sein:
- Ihre Workstation und Ihr Gerät sind mit demselben WLAN verbunden.
- Auf deinem Gerät ist Android 11 oder höher installiert. Weitere Informationen findest du unter Android-Version prüfen und aktualisieren.
- Sie haben die neueste Version von Android Studio. Sie können es von der Hauptseite von Android Studio herunterladen.
- Auf Ihrer Workstation ist die neueste Version der SDK Platform Tools installiert.
Nach weiteren bekannten Problemen suchen
Im Folgenden finden Sie eine Liste der derzeit bekannten Probleme beim Debugging über WLAN in Android Studio und erfahren, wie Sie diese beheben können:
- WLAN-Verbindung ist nicht möglich: Einige WLANs, z. B. Unternehmens-WLANs, blockieren P2P-Verbindungen möglicherweise und ermöglichen eine Verbindung nicht über WLAN. Versuche, eine Verbindung über ein Kabel oder ein anderes WLAN herzustellen.
- ADB über WLAN wird manchmal automatisch deaktiviert: Dies kann passieren, wenn das Gerät entweder das WLAN wechselt oder die Verbindung zum Netzwerk trennt.
RSA-Sicherheitsschlüssel
Wenn Sie ein Gerät mit Android 4.2.2 (API-Level 17) oder höher an Ihren Computer anschließen, wird ein Dialogfeld angezeigt, in dem Sie gefragt werden, ob ein RSA-Schlüssel akzeptiert werden soll, der die Fehlerbehebung über diesen Computer ermöglicht. Dieser Sicherheitsmechanismus schützt Nutzergeräte, da USB-Debugging und andere adb
-Befehle nur ausgeführt werden können, wenn Sie das Gerät entsperren und das Dialogfeld bestätigen.