Remote-Fehlerbehebung für Android-Geräte

Kayce Basken

Twitter GitHub Glitch

Sofia Emelianova

GitHub

Remote-Debugging von Liveinhalten auf einem Android-Gerät über einen Windows-, Mac- oder Linux-Computer In dieser Anleitung erfahren Sie, wie Sie:

• Richten Sie Ihr Android-Gerät für Remote-Debugging ein und erkennen Sie es auf Ihrem Entwicklungscomputer.
• Untersuchen und debuggen Sie Liveinhalte auf Ihrem Android-Gerät über Ihr Entwicklungsgerät.
• Sie können Inhalte von Ihrem Android-Gerät per Screencast auf eine Entwicklertools-Instanz auf Ihrem Entwicklungscomputer übertragen.

Schritt 1: Android-Gerät finden

Der folgende Workflow funktioniert für die meisten Nutzer. Weitere Informationen finden Sie unter Fehlerbehebung: Die Entwicklertools erkennt das Android-Gerät nicht.

1. Öffnen Sie auf Ihrem Android-Gerät den Bildschirm Entwickleroptionen. Weitere Informationen finden Sie unter Optionen für Entwickler auf dem Gerät konfigurieren.
2. Wählen Sie USB-Debugging aktivieren aus.
3. Öffnen Sie Chrome auf Ihrem Entwicklungscomputer.
4. Öffnen Sie chrome://inspect#devices.

5. Prüfen Sie, ob USB-Geräte entdecken aktiviert ist.

   

6. Verbinden Sie Ihr Android-Gerät über ein USB-Kabel direkt mit dem Entwicklungscomputer.

7. Wenn du dein Gerät zum ersten Mal verbindest, wird es als „Offline“ angezeigt und die Authentifizierung steht aus.

   

   Akzeptieren Sie in diesem Fall die Aufforderung zur Fehlerbehebung auf dem Bildschirm Ihres Geräts.

8. Wenn Sie den Modellnamen Ihres Android-Geräts sehen, hat die Entwicklertools erfolgreich eine Verbindung zu Ihrem Gerät hergestellt.

   

9. Fahren Sie mit Schritt 2 fort.

Fehlerbehebung: Die Entwicklertools erkennt das Android-Gerät nicht

Prüfen Sie, ob Ihre Hardware korrekt eingerichtet ist:

• Wenn Sie einen USB-Hub verwenden, versuchen Sie stattdessen, Ihr Android-Gerät direkt mit dem Entwicklungscomputer zu verbinden.
• Ziehen Sie das USB-Kabel zwischen Ihrem Android-Gerät und Ihrem Entwicklungscomputer ab und stecken Sie es dann wieder ein. Tu es, während der Bildschirm deines Android-Geräts und der Bildschirm des Entwicklungsgeräts entsperrt sind.
• Vergewissern Sie sich, dass Ihr USB-Kabel funktioniert. Sie sollten Dateien auf Ihrem Android-Gerät nun von Ihrem Entwicklungscomputer aus prüfen können.

Prüfen Sie, ob Ihre Software korrekt eingerichtet ist:

• Wenn auf Ihrem Entwicklungscomputer Windows ausgeführt wird, versuchen Sie, die USB-Treiber für Ihr Android-Gerät manuell zu installieren. Weitere Informationen finden Sie unter OEM-USB-Treiber installieren.
• Einige Windows- und Android-Geräte (insbesondere Samsung) erfordern eine zusätzliche Einrichtung. Weitere Informationen finden Sie unter Chrome-Entwicklertools erkennen das Gerät nicht, wenn es angeschlossen ist.

Wenn die Aufforderung USB-Debugging zulassen auf Ihrem Android-Gerät nicht angezeigt wird, versuchen Sie Folgendes:

• Trennen Sie das USB-Kabel und schließen Sie es wieder an, während die Entwicklertools auf Ihrem Entwicklungscomputer ausgeführt werden und Ihr Android-Startbildschirm angezeigt wird. Mit anderen Worten: Manchmal wird die Aufforderung nicht angezeigt, wenn der Bildschirm Ihres Android- oder Entwicklungsgeräts gesperrt ist.
• Aktualisieren der Anzeigeeinstellungen für Ihr Android-Gerät und Ihr Entwicklungsgerät, damit diese nie in den Ruhemodus wechseln.
• USB-Modus von Android wird auf PTP eingestellt. Weitere Informationen finden Sie unter Das Galaxy S4-Dialogfeld zeigt nicht das Dialogfeld „USB-Debugging autorisieren“.
• Wählen Sie auf dem Bildschirm Entwickleroptionen Ihres Android-Geräts die Option USB-Debugging-Autorisierungen aufheben aus, um das Gerät auf einen neuen Zustand zurückzusetzen.

Wenn Sie eine Lösung finden, die in diesem Abschnitt oder im Abschnitt Geräte erkennt ein angeschlossenes Gerät nicht aufgeführt ist, antworten Sie bitte auf diese Stack Overflow-Frage oder öffnen Sie ein Problem im Repository developer.chrome.com.

Schritt 2: Fehler bei Inhalten auf Ihrem Android-Gerät über Ihr Entwicklungssystem beheben

1. Öffnen Sie Chrome auf Ihrem Android-Gerät.

2. In chrome://inspect/#devices auf Ihrem Entwicklungscomputer sehen Sie den Modellnamen Ihres Android-Geräts, gefolgt von der Seriennummer. Darunter ist die Chrome-Version zu sehen, die auf dem Gerät ausgeführt wird. Die Versionsnummer wird in Klammern angegeben.

   

3. Geben Sie im Textfeld Tab mit URL öffnen eine URL ein und klicken Sie dann auf Öffnen. Die Seite wird auf Ihrem Android-Gerät in einem neuen Tab geöffnet.

   

   Jeder Remote-Chrome-Tab hat in chrome://inspect/#devices einen eigenen Bereich. In diesem Bereich können Sie mit dem Tab interagieren. Falls es Apps gibt, die WebView verwenden, wird für jede dieser Apps ebenfalls ein eigener Abschnitt angezeigt. In diesem Beispiel ist nur ein Tab geöffnet.

4. Klicken Sie neben der URL, die Sie gerade geöffnet haben, auf Prüfen. Eine neue Entwicklertools-Instanz wird geöffnet.

Die Version von Chrome, die auf Ihrem Android-Gerät ausgeführt wird, bestimmt die Version der Entwicklertools, die auf Ihrem Entwicklungscomputer geöffnet werden. Wenn auf Ihrem Android-Gerät also eine sehr alte Chrome-Version ausgeführt wird, sieht die Entwicklertools-Instanz möglicherweise ganz anders aus als gewohnt.

Weitere Aktionen: Tab pausieren, hervorheben, neu laden oder schließen

Unter der URL befindet sich ein Menü zum Pausieren, Fokussieren, Aktualisieren oder Schließen eines Tabs.

Elemente untersuchen

Gehen Sie zum Bereich Elemente Ihrer Entwicklertools-Instanz und bewegen Sie den Mauszeiger auf ein Element, um es im Darstellungsbereich Ihres Android-Geräts hervorzuheben.

Sie können auch auf ein Element auf dem Bildschirm Ihres Android-Geräts tippen, um es im Steuerfeld Elemente auszuwählen. Klicken Sie in der Entwicklertools-Instanz auf Element auswählen und dann auf dem Bildschirm Ihres Android-Geräts auf das Element. Hinweis: Element auswählen ist nach dem ersten Tippen deaktiviert. Sie müssen es also jedes Mal wieder aktivieren, wenn Sie diese Funktion verwenden möchten.

Sie können Ihren Android-Bildschirm per Screencast auf Ihren Entwicklungscomputer streamen

Klicke auf Screencast ein-/ausblenden , um den Inhalt deines Android-Geräts in der Entwicklertools-Instanz aufzurufen.

Sie haben mehrere Möglichkeiten, mit dem Screencast zu interagieren:

• Klicks werden in Tippaktionen umgewandelt und die richtigen Berührungsereignisse werden auf dem Gerät ausgelöst.
• Tastenanschläge auf Ihrem Computer werden an das Gerät gesendet.
• Um eine Bewegung zu simulieren, halten Sie beim Ziehen die Umschalttaste gedrückt.
• Zum Scrollen können Sie das Touchpad oder Mausrad verwenden oder den Mauszeiger darüber bewegen.

Einige Hinweise zu Screencasts:

• Screencasts zeigen nur Seiteninhalte an. Transparente Teile des Screencasts stehen für Geräteschnittstellen wie die Chrome-Adressleiste, die Android-Statusleiste oder die Android-Tastatur.
• Screencasts wirken sich negativ auf die Framerates aus. Deaktiviere Screencasting, während du Scrollvorgänge oder Animationen misst, um ein genaueres Bild von der Leistung deiner Seite zu erhalten.
• Wenn die Displaysperre deines Android-Geräts aktiviert wird, verschwindet der Inhalt deines Screencasts. Entsperre den Bildschirm deines Android-Geräts, um den Screencast automatisch fortzusetzen.

Manuelle Fehlerbehebung über Android Debug Bridge (adb)

In einigen seltenen Fällen kann eine alternative Methode des Remote-Debugging nützlich sein. Sie können beispielsweise eine direkte Verbindung zum Chrome DevTools Protocol (CDP) von Chrome auf Android-Geräten herstellen.

Dazu können Sie die Android Debug Bridge (adb) verwenden:

1. Aktivieren Sie auf Ihrem Android-Gerät die Entwickleroptionen und das USB-Debugging.
2. Öffnen Sie Chrome auf Ihrem Android-Gerät.

3. So verbinden Sie das Android-Gerät mit Ihrem Entwicklungscomputer:

   • Ein USB-Kabel (geradlinig).
   • Alternativ können Sie eine ADB-WLAN-Verbindung verwenden.

4. Führen Sie in der Befehlszeile Ihres Entwicklungscomputers adb devices -l aus und prüfen Sie, ob Ihr Gerät in der Liste aufgeführt ist.

5. Leiten Sie den CDP-Socket des Geräts an den lokalen Port Ihres Computers weiter, z. B. 9222. Führen Sie hierzu Folgendes aus:

   adb forward tcp:9222 localabstract:chrome_devtools_remote
   

6. Nachdem die Verbindung hergestellt wurde, prüfen Sie Folgendes:

   • http://localhost:9222/json listet Ihre page-Ziele auf.
   • http://localhost:9222/json/version stellt den Zielendpunkt browser bereit, wie in der CDP-Dokumentation angegeben.
   • chrome://inspect/#devices ist ausgefüllt, auch wenn die Einstellung USB-Geräte entdecken nicht aktiviert ist.

Informationen zur Fehlerbehebung findest du unter:

• Dokumentation zu adb

• Optional können Sie auch ältere Leitfäden lesen:

  • remote-debugging-legacy
  • Remote-Debugging
  • girish.in/...wie