Apps auf Hardwaregerät ausführen

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.

Hinweis :Mit dem Android-Emulator kannst du deine App auf verschiedenen Versionen der Android-Plattform und mit unterschiedlichen Bildschirmgrößen testen. Mit dem Firebase Test Lab kannst du deine App auf einer Vielzahl von realen Geräten ausführen, die in einer cloudbasierten Infrastruktur gehostet werden.

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:

1. Öffnen Sie auf dem Gerät die App Einstellungen, wählen Sie Entwickleroptionen aus und aktivieren Sie dann USB-Debugging (falls zutreffend).

   Hinweis :Wenn die Option Entwickleroptionen nicht angezeigt wird, folgen Sie der Anleitung zum Aktivieren der Entwickleroptionen.

2. 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 Gruppe plugdev 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 Gruppe plugdev sind.

     • Auf dem System müssen udev Regeln installiert sein, die das Gerät abdecken. Das Paket android-sdk-platform-tools-common enthält einen von der Community verwalteten Standardsatz von udev-Regeln für Android-Geräte. Verwenden Sie den folgenden Befehl, um es zu installieren:

     apt-get install android-sdk-platform-tools-common
     

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 Verzeichnis android_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:

1. Achten Sie darauf, dass die Workstation und das Gerät mit demselben WLAN verbunden sind.
2. Auf deinem Gerät muss Android 11 oder höher installiert sein. Weitere Informationen findest du unter Android-Version prüfen und aktualisieren.
3. Prüfen Sie, ob Sie die neueste Version von Android Studio installiert haben. Dann laden Sie sie hier herunter.
4. Aktualisieren Sie auf Ihrer Workstation die SDK Platform Tools auf die neueste Version.

So stellen Sie eine Verbindung zu Ihrem Gerät her:

1. Öffne Android Studio und wähle im Menü „Ausführungskonfigurationen“ die Option Geräte über WLAN koppeln aus.

   

   Abbildung 1. Menü „Run Configurations“ (Konfigurationen ausführen) aus.

   
   
   Das Dialogfeld Geräte über WLAN koppeln wird angezeigt (siehe Abbildung 2).

   

   Abbildung 2: Dialogfeld zum Koppeln von Geräten per QR-Code oder Kopplungscode.

2. Aktiviere auf deinem Gerät die Entwickleroptionen.
3. Aktivieren Sie auf Ihrem Gerät das Debugging über WLAN.

   

   Abbildung 3: Die Einstellung Debugging über WLAN auf einem Google Pixel.

4. Tippen Sie auf Debugging über WLAN und koppeln Sie Ihr Gerät:
   1. 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).
   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 .

      

      Abbildung 4: Beispiel für die Eingabe eines sechsstelligen Kopplungscodes

5. 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:

1. Rufe auf deinem Gerät Debugging über WLAN auf.
2. Tippen Sie unter Gekoppelte Geräte auf den Namen Ihrer Workstation.
3. 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).

Hinweis: Wenn Sie bestimmte Geräte verwenden, z. B. Xiaomi Redmi K40, Poco F3 oder Mi 11X mit Android 12, müssen Sie sowohl die Einstellungen USB-Debugging als auch USB-Debugging (Sicherheitseinstellungen) aktivieren und dann das Gerät neu starten, um die Gerätespiegelung zu aktivieren.

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:

1. Öffnen Sie den Geräte-Manager.
2. Erstellen Sie ein neues AVD, falls Sie noch keines haben.
3. Führen Sie den Emulator über das AVD aus.
4. 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:

1. Schließen Sie das Gerät mit dem sekundären Kabel an.
2. Prüfen Sie, ob der Verbindungsassistenten das Gerät jetzt erkennen kann.
3. Wenn das Gerät nicht erkannt wird, versuchen Sie es noch einmal mit dem Hauptkabel.
4. 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:

1. Schließen Sie das zweite Gerät an den Computer an.

2. 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:

1. Folgen Sie der Anleitung im Abschnitt Gerät für die Entwicklung einrichten.
2. 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.