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 das Testen und Entwickeln über eine ADB-Verbindung (Android Debug Bridge) einrichten.

Gerät für die Entwicklung einrichten

Bevor Sie mit dem Debuggen auf Ihrem Gerät beginnen können, müssen Sie entscheiden, ob Sie eine Verbindung über ein USB-Kabel oder WLAN herstellen möchten. Gehen Sie dann so vor:

1. Öffnen Sie auf dem Gerät die Einstellungen, wählen Sie Entwickleroptionen aus und aktivieren Sie gegebenenfalls die USB-Debugging.

2. Richten Sie Ihr System so ein, dass es Ihr Gerät erkennt.

   • ChromeOS: Es ist keine zusätzliche Konfiguration erforderlich.
   • macOS: Es ist keine zusätzliche Konfiguration erforderlich.
   • Windows: Installieren Sie gegebenenfalls einen USB-Treiber für ADB. 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 die Fehlermeldung erhalten, dass Sie nicht zur Gruppe plugdev gehören, 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 in der Gruppe plugdev sind.

     • Auf dem System müssen udev-Regeln für das Gerät installiert sein. Das android-sdk-platform-tools-common-Paket enthält eine von der Community verwaltete Standardreihe 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 und das Gerät über USB angeschlossen haben, klicken Sie in Android Studio auf Ausführen , um die 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, indem Sie den Befehl adb devices aus dem Verzeichnis android_sdk/platform-tools/ ausführen. Wenn es verbunden ist, wird es in der Liste angezeigt.
• Geben Sie einen beliebigen adb-Befehl mit dem Flag -d aus, um Ihr Gerät als Ziel auszuwählen.

Über WLAN mit dem Gerät verbinden

Android 11 und höher unterstützt die drahtlose Bereitstellung und Fehlerbehebung Ihrer App über die Android Debug Bridge (ADB) von Ihrer Workstation aus. So können Sie Ihre debuggbare 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.

Wenn Sie das drahtlose Debuggen verwenden möchten, müssen Sie Ihr Gerät mithilfe eines Kopplungscodes 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. Auf Ihrem Gerät muss Android 11 oder höher installiert sein. Weitere Informationen finden Sie im Hilfeartikel Android-Version prüfen und aktualisieren.
3. Sie benötigen die neueste Version von Android Studio. Hier können Sie sie herunterladen.
4. Aktualisieren Sie auf Ihrer Workstation die SDK-Plattformtools auf die neueste Version.

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

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

   

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

   

2. Aktivieren Sie die Entwickleroptionen auf Ihrem Gerät.
3. Aktivieren Sie auf Ihrem Gerät das Debugging per WLAN.

   

4. Tippen Sie auf Drahtloses Debuggen und koppeln Sie Ihr Gerät:
   1. Wenn Sie Ihr Gerät über einen QR-Code koppeln möchten, wählen Sie Gerät über einen QR-Code koppeln aus und scannen Sie den QR-Code (siehe Abbildung 2).
   2. Wenn Sie Ihr Gerät über einen 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 .

      

5. Nach dem Koppeln können Sie versuchen, Ihre App auf Ihrem Gerät bereitzustellen.

So koppeln Sie ein anderes Gerät oder entfernen Sie dieses Gerät von Ihrer Workstation:

1. Gehen Sie auf Ihrem Gerät zu Kabelloses Debuggen.
2. Tippen Sie unter Gekoppelte Geräte auf den Namen Ihrer Workstation.
3. Wählen Sie Vergessen aus.

Gerätespiegelung

Sie können Ihr physisches Gerät im Fenster Laufende Geräte in Android Studio spiegeln. Wenn Sie den Bildschirm Ihres Geräts direkt an Android Studio streamen, können Sie über die Studio IDE gängige Aktionen ausführen, z. B. Apps starten und mit ihnen interagieren, den Bildschirm drehen, das Smartphone zusammen- und auseinanderfalten und die Lautstärke ändern.

Die Gerätespiegelung ist immer verfügbar, wenn Geräte mit aktiviertem USB- oder kabellosem Debugging mit dem Computer verbunden sind. Sie können das Spiegeln über das Fenster Aktuelle Geräte oder den Gerätemanager (Ansicht > Toolfenster > Gerätemanager) starten und beenden. Sie können auch festlegen, wann die Gerätespiegelung aktiviert wird (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 Ihre Kopfhörer mit dem Computer verbunden und Sie können sowohl auf dem Computer als auch auf dem verbundenen Smartphone Musik hören, ohne manuell eine Verbindung zu einem Gerät und dann zu einem anderen herstellen zu müssen. Wenn Sie die Audioweiterleitung aktivieren möchten, klicken Sie auf Datei (Android Studio unter macOS) > Einstellungen > Tools > Gerätespiegelung und wählen Sie Audio von lokalen Geräten weiterleiten aus. Auf Firebase Test Lab-Geräten mit Android 12 oder höher wird Audio unabhängig von den Einstellungen immer umgeleitet.

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 Laufende Geräte sowie Protokolle wie die 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 alle verbundenen und gekoppelten Geräte automatisch starten. Das kann zur Offenlegung von Informationen für Geräte führen, die über den Befehl adb tcpip verbunden sind, da die Spiegelungsinformationen und ‑befehle über einen nicht verschlüsselten Kanal übergeben werden. Außerdem verwendet Android Studio einen nicht verschlüsselten Kanal, um mit dem adb-Server zu kommunizieren. Daher können Informationen zum Spiegeln von anderen Nutzern auf Ihrem Hostcomputer abgefangen werden.

Probleme mit der Geräteverbindung beheben

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

Fehlerbehebung mit dem Verbindungsassistenten

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

Wählen Sie Tools > Geräteverbindungen beheben aus, um den Assistenten zu starten.

Der Verbindungsassistent bietet auf mehreren Seiten im Bereich Assistant eine Anleitung, Kontextsteuerelemente und eine Liste der verbundenen Geräte. Mit den Schaltflächen Weiter und Zurück unten im Bereich Assistant können Sie die Seiten nach Bedarf durchgehen:

• Gerät über USB verbinden: Der Verbindungsassistent fordert Sie zuerst auf, Ihr Gerät über USB zu verbinden. Über die Schaltfläche USB-Geräte noch einmal scannen können Sie einen neuen Scan nach verbundenen Geräten starten.
• USB-Debugging aktivieren: Der Verbindungsassistent erklärt 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, klicken Sie auf der letzten Seite des Verbindungsassistenten auf die Schaltfläche ADB-Server neu starten. Wenn Sie den ADB-Server neu starten, wird auch noch einmal nach Geräten gesucht. Wenn dein Gerät immer noch nicht in der Liste der verfügbaren Geräte angezeigt wird, versuche es mit den Schritten 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. Starten Sie den Emulator 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 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 Verbindungsassistent das Gerät jetzt erkennen kann.
3. Wenn das Gerät nicht erkannt wird, versuchen Sie es noch einmal mit dem primären Kabel.
4. Wenn das Gerät immer noch nicht erkannt wird, liegt das Problem wahrscheinlich am Gerät. Prüfen Sie dann, ob das Gerät für die Entwicklung eingerichtet ist, wie im nächsten Abschnitt beschrieben.

Wenn Sie kein anderes USB-Kabel, aber ein anderes Android-Gerät haben:

1. Verbinden Sie das sekundäre Gerät mit Ihrem Computer.

2. Wenn der Verbindungsassistent das sekundäre Gerät erkennen kann, liegt das Problem wahrscheinlich am primären Gerät. Prüfen Sie, ob das Gerät für die Entwicklung eingerichtet ist.

   Wenn das sekundäre 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äteherstellers. Teile dem Kundenservicemitarbeiter mit, dass das Gerät keine Verbindung über ADB mit Android Studio herstellen kann.

Probleme mit der WLAN-Verbindung beheben

Wenn Sie Probleme beim Herstellen einer drahtlosen Verbindung mit Ihrem Gerät haben, können Sie die folgenden Schritte zur Fehlerbehebung ausführen:

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

Damit die Voraussetzungen für das drahtlose Debugging erfüllt sind, müssen folgende Bedingungen erfüllt sein:

• Ihre Workstation und Ihr Gerät sind mit demselben WLAN verbunden.
• Auf Ihrem Gerät wird Android 11 oder höher ausgeführt. Weitere Informationen finden Sie unter Android-Version prüfen und aktualisieren.
• Sie haben die neueste Version von Android Studio. Sie können es auf der Hauptseite von Android Studio herunterladen.
• Sie haben die neueste Version der SDK-Plattformtools auf Ihrer Workstation installiert.

Nach anderen bekannten Problemen suchen

Im Folgenden finden Sie eine Liste der derzeit bekannten Probleme mit dem drahtlosen Debuggen in Android Studio und deren Behebung:

• Es kann keine WLAN-Verbindung hergestellt werden: Einige WLANs, z. B. WLANs von Unternehmen, blockieren möglicherweise P2P-Verbindungen und Sie können keine Verbindung über WLAN herstellen. Versuchen Sie, eine Verbindung über ein Kabel oder ein anderes WLAN herzustellen.
• ADB over Wi-Fi wird manchmal automatisch deaktiviert: Das kann passieren, wenn das Gerät 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 in einem Dialogfeld gefragt, ob Sie einen RSA-Schlüssel akzeptieren möchten, der das Debuggen über diesen Computer ermöglicht. Dieser Sicherheitsmechanismus schützt die Geräte der Nutzer, 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.