Remote-Fehlerbehebung für Android-Geräte

Kayce Basques
Sofia Emelianova
Sofia Emelianova
GitHub

Debuggen Sie Liveinhalte auf einem Android-Gerät per Remotezugriff von Ihrem Windows-, Mac- oder Linux-Computer aus. In dieser Anleitung erfahren Sie, wie Sie:

  • Richten Sie Ihr Android-Gerät für die Fehlerbehebung per Fernzugriff ein und erkennen Sie es auf Ihrem Entwicklungscomputer.
  • Du kannst Live-Inhalte auf deinem Android-Gerät von deinem Entwicklungscomputer aus prüfen und debuggen.
  • Streamen Sie Inhalte von Ihrem Android-Gerät in eine Entwicklertools-Instanz auf Ihrem Entwicklungscomputer.

Diagramm zur Fehlerbehebung per Fernzugriff

Schritt 1: Android-Gerät finden

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

  1. Öffnen Sie auf Ihrem Android-Gerät den Bildschirm Entwickleroptionen. Siehe 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. Bewegen bis chrome://inspect#devices.

  5. Achten Sie darauf, dass Kästchen. USB-Geräte entdecken aktiviert ist.

    Das Kästchen „USB-Geräte erkennen“ ist aktiviert.

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

  7. Wenn Sie Ihr Gerät zum ersten Mal anschließen, wird es als „Offline“ angezeigt und die Authentifizierung steht aus.

    Authentifizierung des Offlinegeräts steht aus.

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

  8. Wenn der Modellname deines Android-Geräts angezeigt wird, hat die Entwicklertools erfolgreich eine Verbindung zu deinem Gerät hergestellt.

    Ein erfolgreich verbundenes Gerät mit einem Modellnamen.

  9. Fahren Sie mit Schritt 2 fort.

Fehlerbehebung: Android-Gerät wird in den Entwicklertools nicht erkannt

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 dem Entwicklungscomputer ab und stecken Sie es dann wieder ein. Tun Sie dies, während der Bildschirm Ihres Android-Geräts und der Entwicklercomputer entsperrt sind.
  • Prüfen Sie, ob das USB-Kabel funktioniert. Sie sollten Dateien auf Ihrem Android-Gerät von Ihrem Entwicklungscomputer aus prüfen können.

Überprüfen Sie, ob Ihre Software korrekt eingerichtet ist:

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

  • Trenne das USB-Kabel und schließe es dann wieder an, während sich die Entwicklertools auf deinem Entwicklungscomputer befinden und dein Android-Startbildschirm angezeigt wird. Mit anderen Worten, die Eingabeaufforderung wird manchmal nicht angezeigt, wenn der Bildschirm Ihres Android- oder Entwicklungsgeräts gesperrt ist.
  • Aktualisieren der Anzeigeeinstellungen für Ihr Android-Gerät und Ihren Entwicklungscomputer, damit sie nie in den Ruhemodus wechseln
  • USB-Modus von Android wird auf PTP gesetzt. Weitere Informationen findest du unter Das Dialogfeld "USB-Debugging autorisieren" von Galaxy S4 wird nicht angezeigt.
  • Wählen Sie auf Ihrem Android-Gerät unter Entwickleroptionen die Option USB-Debugging-Autorisierungen widerrufen aus, um das Gerät auf den ursprünglichen Zustand zurückzusetzen.

Wenn Sie eine Lösung finden, die in diesem Abschnitt oder unter Chrome DevTools Geräte erkennt das Gerät nicht, wenn angeschlossen nicht erwähnt wird, fügen Sie eine Antwort auf die Stack Overflow-Frage hinzu oder öffnen Sie ein Problem im Repository „developer.chrome.com“.

Schritt 2: Inhalte auf dem Android-Gerät vom Entwicklungscomputer aus debuggen

  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 sehen Sie die auf dem Gerät ausgeführte Chrome-Version. Die Versionsnummer ist in Klammern angegeben.

    Die Chrome-Version, die auf dem Gerät ausgeführt wird.

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

    Ein Remote-Tab, der in einem Bereich aufgeführt ist.

    Jeder Remote-Chrome-Tab hat einen eigenen Bereich in chrome://inspect/#devices. In diesem Bereich können Sie mit diesem Tab interagieren. Falls einige Apps WebView verwenden, wird für jede dieser Apps 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.

Eine neue Entwicklertools-Instanz für den Tab „Remote“.

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

Weitere Aktionen: Pausieren, Fokussieren, Aktualisieren oder Schließen eines Tabs

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

Das Menü zum Pausieren, Aktualisieren, Fokussieren 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 dem Bildschirm Ihres Android-Geräts auf ein Element tippen, um es im Steuerfeld Elemente auszuwählen. Klicken Sie in Ihrer Entwicklertools-Instanz auf Element auswählen Element auswählen und tippen Sie dann auf dem Bildschirm Ihres Android-Geräts auf das Element. Hinweis: Die Funktion Element auswählen wird nach dem ersten Tippen deaktiviert. Sie müssen sie also jedes Mal neu aktivieren, wenn Sie diese Funktion verwenden möchten.

Ihren Android-Bildschirm per Screencast auf Ihren Entwicklungscomputer übertragen

Klicken Sie auf Screencast umschalten Screencast ein-/ausschalten, um den Inhalt Ihres Android-Geräts in der Entwicklertools-Instanz anzuzeigen.

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

  • Klicks werden in Berührungen umgewandelt und lösen die entsprechenden Touch-Ereignisse auf dem Gerät aus.
  • Tastenanschläge auf Ihrem Computer werden an das Gerät gesendet.
  • Halten Sie beim Ziehen die Umschalttaste gedrückt, um eine Auseinander- und Zusammenziehen-Geste zu simulieren.
  • Scrollen Sie mit Ihrem Touchpad oder Mausrad oder bewegen Sie den Finger mit dem Mauszeiger.

Einige Hinweise zu Screencasts:

  • Bei Screencasts werden nur Seiteninhalte angezeigt. 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. Deaktivieren Sie den Screencast, während Sie Scrolls oder Animationen messen, um ein genaueres Bild von der Leistung Ihrer Seite zu erhalten.
  • Wenn die Displaysperre Ihres Android-Geräts aktiviert wird, verschwindet der Inhalt Ihres Screencasts. Entsperre den Bildschirm deines Android-Geräts, um den Screencast automatisch fortzusetzen.

Manuelle Fehlerbehebung über Android Debug Bridge (ADB)

In seltenen Fällen kann eine alternative Methode zur Fehlerbehebung per Fernzugriff nützlich sein. So können Sie beispielsweise eine direkte Verbindung zum Chrome DevTools Protocol (CDP) von Chrome unter Android herstellen.

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

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

  3. Verbinden Sie das Android-Gerät folgendermaßen mit Ihrem Entwicklungscomputer:

  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. Sobald die Verbindung hergestellt ist, wird Folgendes angezeigt:

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

Informationen zur Fehlerbehebung finden Sie unter: