Apps auf Hardwaregerät ausführen

Testen Sie Ihre Android-App immer auf einem echten Gerät, bevor Sie sie für Nutzer veröffentlichen. Auf dieser Seite wird beschrieben, wie Sie Ihre Entwicklungsumgebung und Ihr Android-Gerät für Tests und Debugging über eine Android Debug Bridge-Verbindung (ADB) einrichten.

Hinweis: Verwenden Sie den Android-Emulator, um Ihre App auf verschiedenen Android-Plattformversionen und mit verschiedenen Bildschirmgrößen zu testen. Sie können Firebase Test Lab verwenden, um Ihre App auf einer Vielzahl von echten Geräten auszuführen, die in einer cloudbasierten Infrastruktur gehostet werden.

Gerät für die Entwicklung einrichten

Bevor Sie mit dem Debugging auf Ihrem Gerät beginnen können, müssen Sie entscheiden, ob Sie eine Verbindung zum Gerät über ein USB-Kabel oder WLAN herstellen möchten. Führen Sie anschließend folgende Schritte aus:

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

   Hinweis: Wenn Sie Entwickleroptionen nicht sehen, folgen Sie der Anleitung, um die Entwickleroptionen zu aktivieren.

2. Richten Sie Ihr System so ein, dass Ihr Gerät erkannt wird.

   • ChromeOS: Keine zusätzliche Konfiguration erforderlich.
   • macOS: Keine zusätzliche Konfiguration erforderlich.
   • Windows: Installieren Sie einen USB-Treiber für ADB (falls zutreffend). 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 sich in der Gruppe plugdev befinden. Wenn Sie eine Fehlermeldung sehen, dass Sie nicht in der Gruppe plugdev sind, fügen Sie sich mit dem folgenden Befehl hinzu:

     sudo usermod -aG plugdev $LOGNAME
     

     Gruppen werden nur bei der Anmeldung aktualisiert. Sie müssen sich also abmelden, damit diese Änderung wirksam wird. Wenn Sie sich wieder anmelden, können Sie mit id prüfen, ob Sie sich in der Gruppe plugdev befinden.

     • Auf dem System müssen udev-Regeln installiert sein, die das Gerät abdecken. Das Paket android-sdk-platform-tools-common enthält eine von der Community verwaltete Standardgruppe 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
     

Über USB mit dem Gerät verbinden

Wenn Sie die Einrichtung abgeschlossen haben und über USB verbunden sind, 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 auszugeben, wie folgt:

• Prüfen Sie, ob Ihr Gerät verbunden ist, indem Sie den adb devices Befehl im Verzeichnis android_sdk/platform-tools/ ausführen. Wenn eine Verbindung besteht, wird das Gerät aufgeführt.
• Geben Sie einen beliebigen adb Befehl mit dem -d Flag aus, um Ihr Gerät anzusprechen.

Über WLAN mit dem Gerät verbinden

Android 11 und höher unterstützt die Bereitstellung und das Debugging Ihrer App drahtlos von Ihrer Workstation über Android Debug Bridge (ADB). Sie können Ihre debugfähige App beispielsweise auf mehreren Remote-Geräten bereitstellen, ohne Ihr Gerät physisch über USB zu verbinden und sich mit häufigen USB-Verbindungsproblemen wie der Treiberinstallation auseinandersetzen zu müssen.

Mit Android 17 und adb 37.0.0 wird adb Wi-Fi 2.0 eingeführt, das viele der Usability-Probleme der vorherigen Version behebt. Das Gerät stellt automatisch eine Verbindung zur Workstation her, wenn es mit einem vertrauenswürdigen Netzwerk für das Debugging über WLAN verbunden wird.

Für das Debugging über WLAN müssen Sie Ihr Gerät mit einem Kopplungscode mit Ihrer Workstation koppeln. Führen Sie dazu die folgenden Schritte aus:

1. Achten Sie darauf, dass Ihre Workstation und Ihr Gerät mit demselben WLAN verbunden sind.
2. Achten Sie darauf, dass auf Ihrem Gerät Android 11 oder höher ausgeführt wird. Weitere Informationen finden Sie unter Android-Version prüfen und aktualisieren.
3. Achten Sie darauf, dass die neueste Version von Android Studio installiert ist. Hier herunterladen.
4. Aktualisieren Sie auf Ihrer Workstation auf die neueste Version der SDK-Plattformtools.

So koppeln Sie Ihr Gerät:

Hinweis: Sie müssen Ihr Gerät nur einmal mit Ihrer Workstation koppeln. Das Gerät bleibt mit Ihrer Workstation gekoppelt, bis Sie es explizit entkoppeln oder die ADB-Debugging-Autorisierungen auf Ihrem Gerät widerrufen. Das Gerät und die Workstation stellen automatisch eine Verbindung her, wenn sie sich im selben Netzwerk befinden.

1. Aktivieren Sie die Entwickleroptionen auf Ihrem Gerät.

2. Tippen Sie auf Ihrem Gerät auf „Drahtloses Debugging“.

   

   Abbildung 1. Die Debugging über WLAN Eingabeaufforderung auf einem Google Pixel-Smartphone.

3. Lassen Sie das Debugging über WLAN in Ihrem Netzwerk zu. Wenn Sie das Kästchen In diesem Netzwerk immer zulassen anklicken, wird das Netzwerk zu einem vertrauenswürdigen Netzwerk für das drahtlose Debugging. Ihr Gerät lässt das Debugging über WLAN in diesem Netzwerk immer zu, sobald es eine Verbindung zum Netzwerk herstellt.

   

   Abbildung 2. Die EinstellungDrahtloses Debugging auf einem Google Pixel Smartphone.

4. Öffnen Sie Android Studio und wählen Sie im Menü „Ausführungskonfigurationen“ die Option Geräte über WLAN koppeln aus.

   

   Abbildung 3. Menü „Ausführungskonfigurationen“ .

   
   

5. Das Dialogfeld Geräte über WLAN koppeln wird angezeigt, wie in Abbildung 4 dargestellt.

   

   Abbildung 4 Dialogfeld zum Koppeln Geräte über WLAN.

   Alternativ können Sie das Gerät über den Geräte-Manager koppeln. Beispiel: My Pixel.

   

   Abbildung 5 : Geräte-Manager mit Gerät verfügbar für die WLAN-Kopplung.

   
   

6. Klicken Sie auf dem Gerät, das Sie koppeln möchten, auf Pair. Das Dialogfeld für die Gerätekopplung wird angezeigt.

   1. Wenn Sie Ihr Gerät mit einem QR-Code koppeln möchten, wählen Sie Gerät über einen QR-Code koppeln aus und scannen Sie den QR-Code.

      

      Abbildung 6 Dialogfeld zum Koppeln des Geräts über einen QR-Code.

   2. Wenn Sie Ihr Gerät mit einem Kopplungscode koppeln möchten, wählen Sie im Dialogfeld Neue Geräte über WLAN koppeln die Option Gerät über einen Kopplungscode koppeln aus. Wählen Sie auf Ihrem Gerät Über Kopplungscode koppeln aus. Ein sechsstelliger Code wird angezeigt. Sobald Ihr Gerät im Fenster Geräte über WLAN koppeln angezeigt wird, geben Sie den sechsstelligen Code ein, der auf Ihrem Gerät angezeigt wird, und wählen Sie Koppeln aus .

      

      Abbildung 7 : Beispiel für die Eingabe eines sechsstelligen Kopplungscodes.

7. Nach der Kopplung können Sie versuchen, Ihre App auf Ihrem Gerät bereitzustellen.

Wenn Sie die Kopplung Ihrer Workstation aufheben möchten, rufen Sie auf Ihrem Gerät Drahtloses Debugging auf. Tippen Sie unter Gekoppelte Geräte auf den Namen Ihrer Workstation und wählen Sie Entkoppeln aus. Alternativ können Sie auf der Seite „Einstellungen“ Ihres Geräts auf ADB-Debugging-Autorisierungen widerrufen klicken, um die Kopplung Ihrer Workstation und aller anderen zuvor gekoppelten Workstations aufzuheben.

Gerätespiegelung

Sie können Ihr physisches Gerät im Fenster Ausgeführte Geräte in Android Studio spiegeln. Wenn Sie das Display Ihres Geräts direkt in Android Studio streamen, können Sie die Studio-IDE selbst verwenden, um häufige Aktionen auszuführen, z. B. Apps zu starten und mit ihnen zu interagieren, den Bildschirm zu drehen, das Smartphone auf- und zuzuklappen und die Lautstärke zu ändern.

Die Gerätespiegelung ist immer verfügbar, wenn Geräte mit dem Computer verbunden sind, auf denen das USB-Debugging oder das Debugging über WLAN aktiviert ist. Sie können die Spiegelung über das Fenster Ausgeführte Geräte oder den Geräte-Manager (Ansicht > Toolfenster > Geräte-Manager) starten und beenden. Sie können auch anpassen, wann die Gerätespiegelung aktiviert wird (Einstellungen > Tools > Gerätespiegelung).

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

Audio umleiten

Wenn Sie die Gerätespiegelung verwenden, können Sie Audio von verbundenen physischen Geräten an die Lautsprecher oder Kopfhörer Ihres Computers umleiten. Mit der Audioumleitung können Sie Ihre Kopfhörer mit Ihrem Computer verbunden lassen und sowohl den Computer als auch das verbundene Smartphone hören, ohne die Verbindung zu einem Gerät manuell trennen und dann wieder mit dem anderen Gerät verbinden zu müssen. Wenn Sie die Audioumleitung aktivieren möchten, wählen Sie Datei (Android Studio unter macOS) > Einstellungen > Tools > Gerätespiegelung aus und aktivieren Sie Audio von lokalen Geräten umleiten. Audio wird immer umgeleitet, unabhängig von den Einstellungen für Firebase Test Lab-Geräte mit Android 12 oder höher.

Bekannte Probleme

Einige Geräte können möglicherweise nicht mit einer Bitrate codieren, die für die Gerätespiegelung ausreicht. In diesen Fällen wird möglicherweise ein Fehler im Fenster Ausgeführte Geräte sowie 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

Je nach den Einstellungen für die Gerätespiegelung kann Android Studio die Gerätespiegelung für jedes verbundene und gekoppelte Gerät automatisch starten. Dies kann zur Offenlegung von Informationen für Geräte führen, die mit dem Befehl adb tcpip verbunden sind, da die Spiegelungsinformationen und -befehle über einen nicht verschlüsselten Kanal übertragen werden. Außerdem verwendet Android Studio einen nicht verschlüsselten Kanal für die Kommunikation mit dem ADB-Server, sodass Spiegelungsinformationen von anderen Nutzern auf Ihrem Hostcomputer abgefangen werden können.

Probleme mit der Geräteverbindung beheben

Wenn Ihr Gerät keine Verbindung zu Android Studio herstellt, versuchen Sie, das Problem mit den folgenden Schritten zu beheben:

Fehlerbehebung mit dem Verbindungsassistenten

Der Verbindungsassistent bietet eine detaillierte Anleitung zum Einrichten und Verwenden eines Geräts über die ADB-Verbindung.

Wählen Sie zum Starten des Assistenten Tools > Probleme mit Geräteverbindungen beheben aus.

Der Verbindungsassistent bietet auf mehreren Seiten im Bereich Assistent eine Anleitung, kontextbezogene Steuerelemente und eine Liste der verbundenen Geräte. Verwenden Sie die Schaltflächen Weiter und Zurück unten im Bereich Assistent , um die Seiten nach Bedarf zu durchlaufen:

• Gerät über USB verbinden: Der Verbindungsassistent fordert Sie zuerst auf, Ihr Gerät über USB zu verbinden, und bietet die Schaltfläche USB-Geräte neu scannen , mit der Sie einen neuen Scan nach verbundenen Geräten starten können.
• USB-Debugging aktivieren: Der Verbindungsassistent zeigt Ihnen dann, wie Sie das USB-Debugging in den Entwickleroptionen auf dem Gerät aktivieren.
• ADB-Server neu starten: Wenn Ihr Gerät immer noch nicht in der Liste der verfügbaren Geräte angezeigt wird, verwenden Sie die Schaltfläche ADB-Server neu starten auf der letzten Seite des Verbindungsassistenten. Durch den Neustart des ADB-Servers wird ADB auch dazu veranlasst, noch einmal nach Geräten zu suchen. Wenn Ihr Gerät immer noch nicht in der Liste der verfügbaren Geräte angezeigt wird, versuchen Sie die Schritte zur Fehlerbehebung im folgenden Abschnitt.

Probleme mit der USB-Verbindung beheben

Wenn der Verbindungsassistent Ihr Gerät nicht über USB erkennt, versuchen Sie, das Problem mit den folgenden Schritten zur Fehlerbehebung zu beheben:

Prüfen, ob Android Studio eine Verbindung zum Android-Emulator herstellt

So prü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 eine neue AVD, falls Sie noch keine haben.
3. Führen Sie den Emulator aus mit Ihrer AVD.
4. Führen Sie einen der folgenden Schritte aus:
   • Wenn Android Studio keine Verbindung zum Emulator herstellen kann, laden Sie die neuesten SDK-Plattformtools herunter und versuchen Sie es noch einmal.
   • Wenn der Emulator erfolgreich gestartet wird, prüfen Sie das USB-Kabel wie im folgenden Abschnitt beschrieben.

USB-Kabel prüfen

So prüfen Sie, ob das Problem durch ein defektes USB-Kabel verursacht wird:

Wenn Sie ein anderes USB-Kabel haben:

1. Verbinden Sie das Gerät mit dem zweiten Kabel.
2. Prüfen Sie, ob der Verbindungsassistent das Gerät jetzt erkennen kann.
3. Wenn das Gerät nicht erkannt wird, versuchen Sie es noch einmal mit dem ersten Kabel.
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, aber ein anderes Android-Gerät haben:

1. Verbinden Sie das zweite Gerät mit Ihrem Computer.

2. Wenn der Verbindungsassistent das zweite Gerät erkennen kann, gehen Sie davon aus, dass das Problem am ersten Gerät liegt, und prüfen Sie, ob das Gerät für die Entwicklung eingerichtet ist.

   Wenn das zweite Gerät nicht erkannt wird, liegt das Problem möglicherweise am USB-Kabel.

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, wenden Sie sich an den Kundensupport des Geräte-OEM. Teilen Sie dem Kundensupportmitarbeiter mit, dass das Gerät keine Verbindung zu Android Studio über ADB herstellt.

Probleme mit der drahtlosen Verbindung beheben

Wenn Sie Probleme haben, eine drahtlose Verbindung zu Ihrem Gerät herzustellen, versuchen Sie, das Problem mit den folgenden Schritten zur Fehlerbehebung zu beheben:

Prüfen, ob Ihre Workstation und Ihr Gerät die Voraussetzungen erfüllen

Prüfen Sie, ob die Workstation und das Gerät die Voraussetzungen erfüllen.

Anleitung zur Fehlerbehebung für ADB prüfen

Folgen Sie der Anleitung zur Fehlerbehebung für ADB guide.

RSA-Sicherheitsschlüssel

Wenn Sie ein Gerät mit Android 4.2.2 (API-Level 17) oder höher mit Ihrem Computer verbinden, wird ein Dialogfeld angezeigt, in dem Sie gefragt werden, ob Sie einen RSA-Schlüssel akzeptieren möchten, der das Debugging über diesen Computer ermöglicht. Dieser Sicherheitsmechanismus schützt Nutzergeräte, da das USB-Debugging und andere adb-Befehle nur ausgeführt werden können, wenn Sie das Gerät entsperren und das Dialogfeld bestätigen können.