Apps auf Hardwaregerät ausführen

Teste deine Android-App immer auf auf einem echten Gerät installiert, bevor sie für Nutzende freigegeben werden. Auf dieser Seite wird beschrieben, wie Sie Entwicklungsumgebung und Android-Gerät zum Testen und Debuggen von eine ADB-Verbindung (Android Debug Bridge).

Gerät für Entwicklung einrichten

Bevor du mit der Fehlerbehebung auf deinem Gerät beginnen kannst, entscheide, ob du eine Verbindung herstellen möchtest mit einem USB-Kabel oder WLAN verbinden. 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).

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). Für eine Installationsanleitung und Links zu OEM-Treibern finden Sie unter OEM-USB-Kabel installieren Fahrer.

   • 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 hinzugefügt haben, fügen Sie sich mit dem folgenden Befehl selbst hinzu:

     sudo usermod -aG plugdev $LOGNAME
     

     Gruppen werden nur bei der Anmeldung aktualisiert, Sie müssen sich daher bei damit diese Änderung wirksam wird. Wenn du dich wieder anmeldest, kannst du mit id Folgendes tun: prüfen Sie, 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 Ein von der Community verwalteter 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 ist und Sie über USB angeschlossen sind, klicken Sie auf Ausführen. in Android Studio Erstellen Sie Ihre App und führen Sie sie auf dem Gerät aus.

Sie können auch adb verwenden, um Befehle auszuführen, wie folgt:

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

Gerät über WLAN verbinden

Android 11 und höher unterstützt die kabellose Bereitstellung und Fehlerbehebung für deine App von Ihrer Workstation über Android Debug Bridge (ADB) generieren. So können Sie zum Beispiel Ihre Debug-fähige App auf mehreren Remote-Geräten ohne physische Ihr Gerät über USB anzuschließen und mit gängigen USB-Verbindungsproblemen konfrontiert ist, wie die Treiberinstallation.

Wenn du das Debugging über WLAN verwenden möchtest, musst du dein Gerät mit deiner Workstation koppeln mithilfe eines Kopplungscodes. 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 Netzwerk.
2. Auf deinem Gerät muss Android 11 oder höher installiert sein. Weitere Informationen erhalten Sie unter Check & aktualisiere dein Android-Gerät .
3. Prüfen Sie, ob Sie die neueste Version von Android Studio installiert haben. Hier können Sie sie herunterladen.
4. Führen Sie auf Ihrer Workstation ein Update auf die neueste Version des SDK Platform Tools

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

1. Öffne Android Studio und wähle Geräte über WLAN koppeln aus. Konfigurationsmenü.
   <ph type="x-smartling-placeholder">

   </ph>

   
   
   Das Dialogfeld Geräte über WLAN koppeln wird angezeigt (siehe Abbildung 2).
   <ph type="x-smartling-placeholder">

   </ph>

2. Entwickler aktivieren Optionen auf deinem Gerät.
3. Debugging über aktivieren WLAN auf deinem Gerät.
   <ph type="x-smartling-placeholder">

   </ph>

4. Tippen Sie auf Debugging über WLAN und koppeln Sie Ihr Gerät: <ph type="x-smartling-placeholder">
   </ph>
   1. Wenn du dein Gerät über einen QR-Code koppeln möchtest, wähle Gerät mit QR-Code koppeln aus. und scanne den QR-Code (siehe Abbildung 2).
   2. Um Ihr Gerät mit einem Kopplungscode zu koppeln, wählen Sie Gerät koppeln mit: Kopplungscode aus dem Dialogfeld Neue Geräte über WLAN koppeln. Auf Ihrem wählen Sie Über Kopplungscode koppeln aus. Eine sechsstellige angezeigt wird. Sobald Ihr Gerät im Fenster Geräte über WLAN koppeln einen sechsstelligen Code ein und wähle Koppeln aus .
      <ph type="x-smartling-placeholder">

      </ph>

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 im Fenster Laufende Geräte spiegeln Studio Wenn du den Bildschirm deines Geräts direkt in Android Studio streamst, kannst du nutzen Sie die Studio-IDE selbst, um gängige Aktionen wie das Starten von Apps und um mit ihnen zu interagieren, das Display zu drehen, das Smartphone aus- und wieder zusammenzuklappen. die Lautstärke zu ändern.

Die Gerätespiegelung ist immer verfügbar, wenn Geräte mit dem Computer mit aktiviertem USB- oder WLAN-Debugging. Sie können die Spiegelung über das Fenster Laufende Geräte oder den Geräte-Manager (Ansicht > Toolfenster > Geräte-Manager). Du kannst auch anpassen, wann das Gerät Die Spiegelung ist in den Einstellungen aktiviert. (Einstellungen > Tools > Gerätespiegelung).

Audio weiterleiten

Wenn du die Gerätespiegelung verwendest, kannst du Audioinhalte von verbundenen mit Ihren Computerlautsprechern oder Kopfhörern verbinden. Mit Audio Kopfhörer an den Computer angeschlossen lassen und beide Computer und verbundenes Smartphone verbunden, ohne die Verbindung manuell neu herstellen zu müssen Gerät und dann ein weiteres. Um die Audioweiterleitung zu aktivieren, gehen Sie zu Datei (Android Studio unter macOS) > Einstellungen > Tools > Gerätespiegelung und wählen Sie Leite Audioinhalte von lokalen Geräten um. Audio wird immer weitergeleitet, für Firebase Test Lab-Geräte mit Android 12 oder höher liegen.

Bekannte Probleme

Einige Geräte können möglicherweise nicht mit einer ausreichenden Bitrate codieren um Gerätespiegelungen zu unterstützen. In diesen Fällen wird möglicherweise ein Fehler Running Devices (Laufende Geräte) sowie Logs ähnlich den folgenden zu sehen.

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 Gerätespiegelung für alle verbundenen und gekoppelten Geräte. Dies kann zu Offenlegung von Informationen für Geräte, die mit dem Befehl adb tcpip verbunden sind da die Spiegelungsinformationen und Befehle über eine Kanal. Außerdem nutzt Android Studio einen unverschlüsselten Kanal für die Kommunikation mit dem ADB-Server, damit die Spiegelung von Informationen von anderen Nutzern abgefangen werden kann. auf Ihrem Hostcomputer ausführen.

Fehlerbehebung bei der Geräteverbindung

Wenn Ihr Gerät keine Verbindung zu Android Studio herstellen kann, führen Sie die folgenden Schritte aus: So beheben Sie das Problem:

Fehlerbehebung mit dem Verbindungsassistenten

Der Connection Assistant hilft Ihnen Schritt für Schritt, und ein Gerät über die ADB-Verbindung nutzen.

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

Der Verbindungsassistenten bietet Anleitungen, kontextbezogene Steuerelemente und eine Liste durch eine Reihe von Seiten im Assistant-Bereich. Verwenden Sie die Methode Weiter und Zurück unten im Assistant-Bereich, die Seiten nach Bedarf durch:

• Gerät über USB verbinden: Der Verbindungsassistenten fordert Sie zuerst auf, können Sie Ihr Gerät über USB verbinden. Außerdem erhalten Sie eine Anleitung zum erneuten Scannen von USB-Geräten. Schaltfläche, über die Sie einen neuen Scan nach verbundenen Geräten starten können.
• USB-Debugging aktivieren: Der Verbindungsassistent sagt Ihnen, wie Sie USB-Debugging in den Entwickleroptionen auf dem Gerät aktivieren
• Starten Sie den ADB-Server neu: Wenn Ihr Gerät immer noch nicht auf der Geräteliste angezeigt wird, klicken Sie auf die Schaltfläche ADB-Server neu starten des Verbindungsassistenten. Der Neustart des ADB-Servers ADB, um noch einmal nach Geräten zu suchen. Wenn dein Gerät immer noch nicht in der Liste erscheint der verfügbaren Geräte führen Sie die Schritte zur Fehlerbehebung im folgenden Abschnitt aus.

Probleme mit der USB-Verbindung beheben

Wenn der Verbindungsassistenten Ihr Gerät nicht über USB erkennt, versuchen Sie es führen Sie die folgenden Schritte aus, um das Problem zu beheben:

Verbindung zwischen Android Studio und dem Android-Emulator herstellen

Um zu prüfen, ob das Problem durch ein Verbindungsproblem zwischen Android und Android verursacht wird in Studio und im Android-Emulator an:

1. Öffnen Sie den Geräte-Manager.
2. Erstellen Sie ein neues AVD, falls noch nicht geschehen. haben eins.
3. Führen Sie den Emulator über das AVD aus.
4. Führen Sie einen der folgenden Schritte aus: <ph type="x-smartling-placeholder">
   </ph>
   • Wenn Android Studio keine Verbindung zum Emulator herstellen kann, lade die neueste SDK-Plattformtools 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

Um zu überprüfen, ob das Problem durch ein defektes USB-Kabel verursacht wird, folgen Sie den Schritten in diesem Abschnitt.

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 mit dem Gerät und Prüfen, 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, Problem mit dem primären Gerät und Prüfen, ob das Gerät für die Entwicklung eingerichtet ist

   Wenn das sekundäre Gerät nicht erkannt wird, liegt möglicherweise ein Problem mit dem USB- Kabel.

Prüfen, ob das Gerät für die Entwicklung eingerichtet ist

Wenn Sie prüfen möchten, ob das Problem durch Einstellungen auf dem Gerät verursacht wird, gehen Sie so vor: Schritte:

1. Folgen Sie der Anleitung unter Gerät für die Entwicklung einrichten. .
2. Wird das Problem dadurch nicht behoben, wenden Sie sich an den OEM des Geräts. Kundensupport um Hilfe. Teilen Sie dem Mitarbeiter des Kundensupports mit, dass die Gerät verbindet sich nicht über ADB mit Android Studio.

Probleme mit der drahtlosen Verbindung beheben

Wenn Sie Probleme haben, eine kabellose Verbindung zu Ihrem Gerät herzustellen, versuchen Sie Folgendes: führen Sie die folgenden Schritte aus, um das Problem zu beheben:

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 finden Sie unter Prüfen und aktualisiere dein Android-Gerät
• Sie haben die neueste Version von Android Studio. Du kannst Folgendes herunterladen: über die Android Studio-Hauptseite.
• Sie haben die neueste Version des SDK Platform Tools auf Ihrer Workstation

Nach weiteren bekannten Problemen suchen

Im Folgenden finden Sie eine Liste mit derzeit bekannten Problemen beim Debugging über WLAN in Android Studio und wie Sie diese beheben:

• Keine WLAN-Verbindung: Einige WLANs, beispielsweise Unternehmens-WLANs blockieren. Versuche, eine Verbindung über ein Kabel oder ein anderes WLAN herzustellen.
• ADB über WLAN wird manchmal automatisch deaktiviert: Dies kann passieren, wenn das WLAN wechselt oder die Verbindung zum Netzwerk getrennt wird.

RSA-Sicherheitsschlüssel

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