Mit den Chrome-Entwicklertools debuggen

Mit den in den Chrome-Browser auf Ihrem Entwicklungscomputer integrierten Entwicklertools können Sie die in Ihrer App ausgeführten WebViews remote untersuchen und debuggen. Eine detaillierte Anleitung zum Remote-Debugging von WebViews finden Sie unter Remote-Debugging von WebViews.

Weitere Informationen zu den Entwicklertools

Verbindung über die Chrome-Entwicklertools aktivieren

Die WebView Ihrer App ermöglicht standardmäßig keine Verbindungen von Chrome-Entwicklertools. Sie müssen das WebView-Debugging im Code Ihrer Anwendung aktivieren.

1. Achten Sie darauf, dass Sie Ihre App auf einem Hardwaregerät oder virtuellen Gerät ausführen können.
2. Aktivieren Sie das WebView-Debugging in Ihrem Anwendungscode, indem Sie setWebContentsDebuggingEnabled aufrufen. Das erfolgt normalerweise in der Klasse Activity oder Application, in der die WebView initialisiert wird.

Wir empfehlen, setWebContentsDebuggingEnabled in eine bedingte Prüfung einzuschließen, damit das Debugging nur in Entwicklungs-Builds und nicht in der Produktion aktiviert wird. Diese Einstellung gilt für alle WebViews in Ihrer App.

Das WebView-Debugging ist nicht vom Status des Flags debuggable im Manifest der Anwendung betroffen. Wenn Sie das WebView-Debugging nur aktivieren möchten, wenn das Flag debuggable auf true gesetzt ist, testen Sie zur Laufzeit auf dieses Flag, wie im folgenden Beispiel gezeigt:

if (applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE != 0) {
     WebView.setWebContentsDebuggingEnabled(true)
}

if (0 != (getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE)) {
     WebView.setWebContentsDebuggingEnabled(true);
}

WebView debuggen

Nachdem Sie das WebView-Debugging in Ihrem Anwendungscode aktiviert haben und Ihre App auf einem physischen Gerät oder im Android-Emulator ausgeführt wird, können Sie Chrome-Entwicklertools mit Ihrem WebView verbinden:

1. Öffnen Sie Chrome auf Ihrem Entwicklungscomputer.
2. Geh zu chrome://inspect.

3. Achte auf der Seite chrome://inspect darauf, dass USB-Geräte erkennen aktiviert ist. Suchen Sie im Abschnitt Remote-Ziel nach Ihrem Gerät.

   

4. Unter dem Namen des Geräts werden alle Debug-fähigen WebViews aufgeführt, die auf diesem Gerät ausgeführt werden. Sie werden in der Regel durch WebView in gefolgt vom Paketnamen der App identifiziert. Suchen Sie die WebView, die Sie debuggen möchten, und klicken Sie auf den Link inspect.

Eine neue DevTools-Instanz wird geöffnet, mit der Sie Ihre WebView untersuchen können.

Wenn Sie Inhalte von einem lokalen Webserver auf Ihrem Entwicklungscomputer bereitstellen, finden Sie unter Über WebView auf einen lokalen Entwicklungsserver zugreifen Informationen dazu, wie Sie von Ihrem Gerät oder Emulator aus eine Verbindung zu diesem Server herstellen. Informationen zur Fehlerbehebung finden Sie unter Android-Geräte per Remote-Debugging debuggen und WebViews per Remote-Debugging debuggen.