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.

Gerät für die Entwicklung einrichten

Bevor Sie mit dem Debugging auf Ihrem Gerät beginnen, entscheiden Sie, ob Sie das Gerät per USB-Kabel oder 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 gegebenenfalls USB-Debugging.

  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 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 zur Gruppe plugdev gehö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 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 android-sdk-platform-tools-common-Paket 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
      

Per USB-Gerät mit dem Gerät verbinden

Wenn die Einrichtung abgeschlossen und über USB angeschlossen ist, klicke in Android Studio auf Ausführen , um die App zu erstellen und auf dem Gerät auszuführen.

Sie können auch adb verwenden, um Befehle auszugeben:

  • Prüfen Sie, ob Ihr Gerät verbunden ist. Führen Sie dazu den Befehl adb devices aus dem android_sdk/platform-tools/-Verzeichnis aus. Wenn eine Verbindung besteht, wird das Gerät in der Liste angezeigt.
  • Führen Sie einen beliebigen adb-Befehl mit dem Flag -d aus, um ein Targeting auf Ihr Gerät vorzunehmen.

Gerät per WLAN verbinden

Android 11 und höher unterstützt die kabellose Bereitstellung und Fehlerbehebung von Apps von Ihrer Workstation über Android Debug Bridge (ADB). So können Sie beispielsweise Ihre debugfähige App auf mehreren Remote-Geräten bereitstellen, ohne das Gerät physisch über USB verbinden zu müssen und häufige USB-Verbindungsprobleme wie die Treiberinstallation zu vermeiden.

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

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

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.
    Drop-down-Menü zum Ausführen von Konfigurationen
    Abbildung 1: Menü zum Ausführen von Konfigurationen.

    Das Dialogfeld Geräte über WLAN koppeln wird angezeigt (siehe Abbildung 2).
    Screenshot des Pop-up-Fensters für die Gerätekopplung über WLAN
    Abbildung 2: Dialogfeld zum Koppeln von Geräten über QR-Code oder Kopplungscode.
  2. Aktivieren Sie die Entwickleroptionen auf Ihrem Gerät.
  3. Aktivieren Sie die Fehlerbehebung über WLAN auf Ihrem Gerät.
    Screenshot eines Pixel Smartphones, auf dem die Einstellung „Wireless Debugging Systems“ zu sehen ist
    Abbildung 3: Die Einstellung Fehlerbehebung bei WLAN-Verbindungen auf einem Google Pixel-Smartphone.
  4. Tippen Sie auf Debugging über WLAN und koppeln Sie Ihr Gerät:
    1. Wählen Sie zum Koppeln Ihres Geräts mit einem QR-Code Gerät mit QR-Code koppeln aus und scannen Sie den QR-Code (siehe Abbildung 2).
    2. Wenn du dein Gerät mit einem Kopplungscode koppeln möchtest, 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. Ein sechsstelliger Code wird angezeigt. Sobald dein Gerät im Fenster Geräte über WLAN koppeln angezeigt wird, gib den auf deinem Gerät angezeigten sechsstelligen Code ein und wähle Koppeln aus .
      Screenshot der Beispieleingabe für den Kopplungscode
      Abbildung 4: Beispiel für die Eingabe eines sechsstelligen Kopplungscodes.
  5. Nach dem Koppeln können Sie versuchen, die App auf Ihrem Gerät bereitzustellen.

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

  1. Gehen Sie auf Ihrem Gerät zu Debugging bei WLAN.
  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 im Fenster Running Devices in Android Studio spiegeln. Wenn Sie den Bildschirm Ihres Geräts direkt zu Android Studio streamen, können Sie die Studio-IDE selbst verwenden, um gängige Aktionen wie das Starten von Apps und das Interagieren mit ihnen, das Drehen des Bildschirms, das Falten und Aufklappen des Smartphones sowie das Ändern der Lautstärke auszuführen.

Die Gerätespiegelung ist immer verfügbar, wenn mit dem Computer verbundene Geräte mit aktiviertem USB- oder kabellosem Debugging verbunden sind. Sie können die Spiegelung über das Fenster Aktive Geräte oder den Geräte-Manager starten und beenden (Ansicht > Tool-Fenster > Geräte-Manager). Sie können auch in den Einstellungen festlegen, wann die Gerätespiegelung aktiviert wird (Einstellungen > Tools > Gerätespiegelung).

Benutzeroberfläche für laufende Geräte

Bekannte Probleme

Einige Geräte können möglicherweise nicht mit einer ausreichenden Bitrate codiert werden, um die Gerätespiegelung zu unterstützen. In diesen Situationen werden möglicherweise Fehler im Fenster Running Devices sowie ähnliche Logs 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. Dies kann dazu führen, dass Informationen für Geräte offengelegt werden, die mit dem Befehl adb tcpip verbunden sind, da die Spiegelungsinformationen und Befehle über einen unverschlüsselten Kanal übergeben werden. Darüber hinaus verwendet Android Studio einen unverschlüsselten Kanal für die Kommunikation mit dem ADB-Server, sodass Spiegelungen 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 herstellen kann, versuchen Sie Folgendes, um das Problem zu beheben:

Fehlerbehebung mit dem Verbindungsassistenten

Der Connection Assistant bietet eine Schritt-für-Schritt-Anleitung zum Einrichten und Verwenden eines Geräts über die ADB-Verbindung.

Um den Assistenten zu starten, wählen Sie Tools > Fehlerbehebung bei Geräteverbindungen aus.

Der Connection Assistant bietet eine Anleitung, kontextbezogene Steuerelemente und eine Liste der verbundenen Geräte auf einer Reihe von Seiten im Bereich Assistant. Verwenden Sie die Schaltflächen Next (Weiter) und Previous (Zurück) unten im Bereich Assistant, um die Seiten nach Bedarf durchzugehen:

  • Gerät über USB verbinden: Der Verbindungsassistenten fordert Sie zuerst auf, das Gerät über USB zu verbinden, und bietet die Schaltfläche USB-Geräte erneut suchen, mit der Sie einen neuen Scan nach verbundenen Geräten starten können.
  • USB-Debugging aktivieren: Der Verbindungsassistenten teilt Ihnen dann mit, wie Sie das USB-Debugging in den Entwickleroptionen auf dem Gerät aktivieren können.
  • ADB-Server neu starten: Wenn das Gerät immer noch nicht in der Liste der verfügbaren Geräte aufgeführt wird, verwenden Sie die Schaltfläche ADB-Server neu starten auf der letzten Seite des Verbindungsassistenten. Ein Neustart des ADB-Servers führt außerdem dazu, dass ADB wieder nach Geräten sucht. Wenn dein Gerät immer noch nicht in der Liste der verfügbaren Geräte angezeigt wird, führe die Schritte zur Fehlerbehebung im folgenden Abschnitt aus.

Probleme mit der USB-Verbindung beheben

Wenn der Connection Assistant Ihr Gerät nicht über USB erkennt, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

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 ein neues AVD, falls Sie noch keines haben.
  3. Führen Sie den Emulator mit Ihrem AVD aus.
  4. Führen Sie einen der folgenden Schritte aus:
    • 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

Prüfen Sie, ob das Problem durch ein defektes USB-Kabel verursacht wird. Folgen Sie dazu den Schritten in diesem Abschnitt.

Wenn Sie ein anderes USB-Kabel haben:

  1. Verbinden Sie das Gerät mit dem sekundären Kabel.
  2. Prüfen Sie, ob der Verbindungsassistenten das Gerät jetzt erkennen kann.
  3. Wenn das Gerät nicht erkannt wird, versuchen Sie noch einmal, das Hauptkabel zu verwenden.
  4. Wenn das Gerät immer noch nicht erkannt wird, gehen Sie davon aus, dass das Problem beim Gerät liegt. Prüfen Sie dann, 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. Schließen Sie das sekundäre Gerät an Ihren 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 zusammenhängt, und 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 überprüfen Sie, ob das Problem auf die Einstellungen des Geräts zurückzuführen ist:

  1. Führe die Schritte im Abschnitt Gerät für die Entwicklung einrichten aus.
  2. Wenn das Problem dadurch nicht behoben wird, wenden Sie sich an den Kundensupport des Geräte-OEMs. Teilen Sie dem Kundensupportmitarbeiter mit, dass das Gerät nicht über ADB mit Android Studio verbunden werden kann.

Probleme mit der WLAN-Verbindung beheben

Wenn Sie Probleme bei der drahtlosen Verbindung zu Ihrem Gerät haben, können Sie die folgenden Schritte zur Fehlerbehebung ausprobieren:

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

So erfüllen Sie die Voraussetzungen für das Debugging über WLAN:

Auf andere bekannte Probleme prüfen

Im Folgenden findest du eine Liste mit derzeit bekannten Problemen beim Debugging von WLAN in Android Studio und erfährst, wie du sie beheben kannst:

  • WLAN-Verbindung wird nicht hergestellt: Einige WLAN-Netzwerke, z. B. Unternehmens-WLANs, blockieren möglicherweise P2P-Verbindungen und lassen keine Verbindung über WLAN zu. 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 mit Ihrem Computer verbinden, zeigt das System ein Dialogfeld an, in dem Sie gefragt werden, ob ein RSA-Schlüssel akzeptiert werden soll, der eine Fehlerbehebung über diesen Computer ermöglicht. Dieser Sicherheitsmechanismus schützt Nutzergeräte, da USB-Debugging und andere adb-Befehle nur dann ausgeführt werden können, wenn Sie das Gerät entsperren und das Dialogfeld bestätigen können.