Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

WebView-Implementierung mit Jetpack Webkit vereinfachen

In dieser Anleitung werden die Vorteile der Jetpack Webkit-Bibliothek beschrieben. Außerdem wird erläutert, wie sie funktioniert und wie Sie sie in Ihren Projekten implementieren können.

Übersicht

WebViews sind ein wesentlicher Bestandteil der Android-Entwicklung. Aufgrund von Inkonsistenzen bei den Funktionen in verschiedenen Android-Betriebssystemversionen kann ihre Verwaltung jedoch manchmal schwierig sein. Jede Android-Betriebssystemversion bietet eine feste Anzahl von WebView APIs. Da Android langsamer als WebView veröffentlicht wird, decken die Android APIs möglicherweise nicht alle verfügbaren WebView-Funktionen ab. Dies führt zu einer langsameren Einführung von Funktionen und höheren Testkosten.

Jetpack Webkit löst diese Probleme, indem es als Kompatibilitätsebene fungiert und das aktuelle WebView APK auf dem Gerät des Nutzers verwendet. Es enthält auch neue und moderne APIs, die ausschließlich in dieser Bibliothek verfügbar sind.

Warum Jetpack Webkit verwenden?

Jetpack Webkit bietet nicht nur Kompatibilität über verschiedene Versionen hinweg, sondern auch neue und moderne APIs, die die Entwicklung vereinfachen und die Funktionalität Ihrer App verbessern können:

Moderne Authentifizierung aktivieren: WebView kann moderne Web authentifizierungsstandards wie WebAuthn nahtlos verarbeiten und so passkeybasierte Anmeldungen ermöglichen. Mit der androidx.webkit Bibliothek haben Sie die volle Kontrolle über diese Integration mit der Methode WebSettingsCompat.setWebAuthenticationSupport. Damit können Sie den Grad der Unterstützung konfigurieren, die Ihre App benötigt.
Leistung verbessern: Sie können die Leistung von WebView mit APIs wie setBackForwardCacheEnabled optimieren oder die Navigationslatenz mit spekulativen Lade-APIs wie prefetchUrlAsync und prerenderUrlAsync reduzieren. Weitere Informationen finden Sie unter Spekulatives Laden in WebView.
Stabilität erhöhen: Sie können angehaltene oder nicht reagierende Renderer-Prozesse wiederherstellen, ohne dass es zu Abstürzen kommt. Weitere Informationen finden Sie unter WebViewRenderProcess#terminate.
Granulare Kontrolle über Browserdaten: Mit der Klasse WebStorageCompat können Sie Browserdaten löschen, die von WebView für bestimmte Ursprünge gespeichert wurden.
Verbesserte Seitennavigation: Ersetzen Sie WebView.loadUrl durch WebViewCompat.navigate, um eine detaillierte Navigationssteuerung, den Austausch von Verlaufseinträgen, die Unterstützung von Headern für gespeicherte Status und die korrelierte Lebenszyklusverfolgung mit NavigationListener zu ermöglichen. Weitere Informationen finden Sie unter Verbesserte Seitennavigation mit WebViewCompat.navigate.
Statusverwaltung optimieren: Sie können sich vor TransactionTooLargeException schützen, indem Sie bei der Statusserialisierung maximale Byte-Limits festlegen. Weitere Informationen finden Sie unter WebView-Status effizient verwalten.

Komponenten

Damit Sie Jetpack Webkit effektiv nutzen können, müssen Sie die Beziehung zwischen den folgenden Komponenten verstehen:

Android System WebView: Dies ist die Chromium-basierte Rendering-Engine, die Google regelmäßig über den Google Play Store aktualisiert, und zwar im gleichen Rhythmus wie Chrome. Sie enthält die neuesten Funktionen und den zugrunde liegenden Implementierungscode für alle WebView APIs.
Framework APIs (android.webkit): Diese APIs sind an eine bestimmte Android-Betriebssystemversion gebunden. Eine App unter Android 10 kann beispielsweise nur auf die APIs zugreifen, die bei der Veröffentlichung dieser Version verfügbar waren. Sie kann also keine neuen Funktionen verwenden, die in neueren Updates zum WebView APK hinzugefügt wurden. Wenn Sie beispielsweise mit einen nicht reagierenden Renderer verwenden möchten WebView#getWebViewRenderProcess(), können Sie diese Methode nur unter Android 10 und höher aufrufen.
Jetpack Webkit-Bibliothek (androidx.webkit): Dies ist eine kleine Bibliothek, die in Ihrer Anwendung enthalten ist. Diese Bibliothek fungiert als Brücke, die das WebView APK aufruft, anstatt die in der Android-Plattform definierten APIs aufzurufen, die eine feste Betriebssystemversion haben. So kann die Anwendung auch dann die neuesten WebView-Funktionen verwenden, wenn sie auf einem Gerät mit einer älteren Betriebssystemversion wie Android 10 installiert ist. For example, WebViewCompat.getWebViewRenderProcess() funktioniert ähnlich wie die Framework API, kann aber auch für alle Betriebssystemversionen vor Android 10 aufgerufen werden.

Wenn eine API sowohl im Framework als auch in Jetpack Webkit verfügbar ist, empfehlen wir, die Jetpack Webkit-Version zu verwenden. So sorgen Sie für ein einheitliches Verhalten und Kompatibilität auf einer Vielzahl von Geräten.

Interaktion zwischen Jetpack Webkit und APK

Die APIs in Jetpack Webkit sind in zwei Teilen implementiert:

Statisches Jetpack Webkit: Die statische Jetpack Webkit-Bibliothek enthält einen kleinen Teil des Codes, der für die Implementierung der API verantwortlich ist.
WebView APK: Das WebView APK enthält den größten Teil des Codes.

Ihre App ruft die Jetpack Webkit API auf, die dann das WebView APK aufruft.

Sie können zwar die Jetpack Webkit-Version in Ihrer App steuern, aber nicht die WebView APK-Updates auf den Geräten der Nutzer. Im Allgemeinen haben die meisten Nutzer aktuelle Versionen des WebView APK, aber Ihre App muss trotzdem darauf achten, keine APIs aufzurufen, die von dieser Version des WebView APK nicht unterstützt werden.

Jetpack Webkit macht es auch überflüssig, WebView-Versionen manuell zu prüfen. Um festzustellen, ob eine Funktion verfügbar ist, prüfen Sie die entsprechende Feature-Konstante. Beispiel: WebViewFeature.WEB_AUTHENTICATION.

Zusammenarbeit

Jetpack Webkit schließt die Lücke zwischen der statischen Framework API und dem häufig aktualisierten WebView APK. Wenn Sie die Jetpack Webkit API mit dem Muster zur Funktionserkennung verwenden, prüft die Bibliothek, ob die Funktion vom WebView APK unterstützt wird, das auf dem Gerät des Nutzers installiert ist. So müssen Sie die Android-Betriebssystemversion (Framework) nicht prüfen.

Wenn das WebView APK eine aktuelle Version hat, ruft die Bibliothek die Funktion auf. Andernfalls wird gemeldet, dass die Funktion nicht verfügbar ist. So wird verhindert, dass Ihre App abstürzt, und Sie können die Situation auf angemessene Weise behandeln.

Jetpack Webkit und Framework APIs im Vergleich

In diesem Abschnitt werden Implementierungsmethoden mit und ohne die Jetpack Webkit-Bibliothek verglichen:

Moderne Authentifizierung (WebAuthn) aktivieren

Ohne Jetpack Webkit

Über Framework APIs nicht möglich.

Mit Jetpack Webkit

Verwendet WebViewFeature.WEB_AUTHENTICATION für Kompatibilitätsprüfungen.

if (WebViewFeature.isFeatureSupported(WebViewFeature.WEB_AUTHENTICATION)) {
  WebSettingsCompat.setWebAuthenticationSupport(
      webView.settings,
      WebSettingsCompat.WEB_AUTHENTICATION_SUPPORT_FOR_APP
  )
}

Daten für einen Ursprung löschen (sitespezifischer Speicher)

Ohne Jetpack Webkit

Keine direkte API zum Löschen bestimmter Ursprungsdaten. Oft müssen alle Daten gelöscht werden.

Mit Jetpack Webkit

Verwendet Kompatibilitäts-APIs für das präzise Löschen von Daten. Sie haben folgende Möglichkeiten:

WebStorageCompat.getInstance().deleteBrowsingData()

Oder

WebStorageCompat.getInstance().deleteBrowsingDataForSite()

WebView-Version abrufen

Ohne Jetpack Webkit

Verwendet die Standard-Framework-Klasse.

val webViewPackage = WebView.getCurrentWebViewPackage()

Mit Jetpack Webkit

Verwendet die Kompatibilitätsebene für einen sichereren Abruf.

val webViewPackage = WebViewCompat.getCurrentWebViewPackage()

Nicht reagierenden Renderer verarbeiten (Renderer-Client)

Ohne Jetpack Webkit

Verwendet die Standard-Framework-Methode.

webView.setWebViewRenderProcessClient(myClient)

Mit Jetpack Webkit

Verwendet WebViewCompat und eine Funktionsprüfung zum Festlegen des Clients.

if (WebViewFeature.isFeatureSupported(WebViewFeature.WEB_VIEW_RENDERER_CLIENT_BASIC_USAGE)) {
  WebViewCompat.setWebViewRenderProcessClient(webView, myClient)
}

Informationen zum Implementieren von Strategien zur Wiederherstellung nach Abstürzen finden Sie unter Umgang mit der Beendigung von WebView. Details zu den APIs finden Sie in der androidx.webkit Referenzdokumentation.

Gespeicherten Status und Transaktionsgröße verwalten

Mit der WebViewCompat.saveState API können Sie Byte-Limits erzwingen und den Vorwärtsverlauf während der Serialisierung bereinigen. So werden Abstürze aufgrund von TransactionTooLargeException verhindert und gleichzeitig der wichtige Navigationsverlauf beibehalten.

Ohne Jetpack Webkit

Verwendet die Standard-Framework-Methode, die den gesamten Navigationsstack ohne Größenbeschränkungen serialisiert und TransactionTooLargeException auslösen kann, wenn die Nutzlast das Transaktionslimit von 1 MB für Android überschreitet.

webView.saveState(outState)

Mit Jetpack Webkit

Verwendet WebViewCompat, um ein maximales Byte-Limit zu erzwingen oder Vorwärtsnavigationseinträge zu löschen. So werden Transaktionsüberläufe verhindert.

WebViewCompat.saveState(webView, outState, maxSizeBytes)

Weitere Informationen finden Sie unter WebView-Status effizient verwalten.

Seiten navigieren und Lebenszyklus verfolgen

Wenn Sie Webseiten mit Unterstützung für den Austausch von Verlaufseinträgen, die Unterstützung von Headern für gespeicherte Status und korrelierte Lebenszyklus-Callbacks navigieren möchten, verwenden Sie WebViewCompat.navigate anstelle von WebView.loadUrl.

Ohne Jetpack Webkit

Verwendet WebView.loadUrl, das den Austausch von Verlaufseinträgen oder die korrelierte Verfolgung von Lebenszyklus-Callbacks nicht unterstützt.

webView.loadUrl("https://www.example.com")

Mit Jetpack Webkit

Verwendet WebViewCompat.navigate mit NavigationParameters, um Verlaufseinträge zu ersetzen, benutzerdefinierte Header im gespeicherten Status beizubehalten und Navigationsstatus zu verfolgen.

if (WebViewFeature.isFeatureSupported(WebViewFeature.WEBVIEW_NAVIGATE_EXPERIMENTAL_V1)) {
  val params = NavigationParameters.Builder()
      .setShouldReplaceCurrentEntry(true)
      .build()
  val navigation = WebViewCompat.navigate(webView, "https://www.example.com", params)
} else {
  webView.loadUrl("https://www.example.com")
}

Weitere Informationen zur Navigationsverfolgung und Parameterkonfiguration finden Sie unter Verbesserte Seitennavigation mit WebViewCompat.navigate.

Jetpack Webkit in Ihren Code einbinden

Durch die Verwendung von Jetpack Webkit werden die Funktionen der Standard-WebView-Klasse erweitert, aber die ursprüngliche WebView-Klasse wird nicht vollständig ersetzt.

Sie können die android.webkit.WebView Klasse weiterhin verwenden. Sie können sie Ihren XML-Layouts hinzufügen und eine Referenz zur Instanz in Ihrem Code abrufen. Wenn Sie auf Standard-Framework-Funktionen zugreifen möchten, können Sie weiterhin Methoden direkt für die WebView-Instanz oder das zugehörige Einstellungsobjekt aufrufen.

Für den Zugriff auf moderne Funktionen verwenden Sie die statischen Hilfsmethoden von Jetpack Webkit, z. B. WebViewCompat und WebSettingsCompat. Sie übergeben Ihre vorhandene WebView-Instanz an diese Methoden.

Kotlin

import android.webkit.WebView
import androidx.webkit.WebSettingsCompat
import androidx.webkit.WebViewFeature

// You still get your WebView instance the standard way.
val webView: WebView = findViewById(R.id.my_webview)

// To enable a modern feature, you pass that instance to a Jetpack Webkit helper.
if (WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) {
    WebSettingsCompat.setForceDark(webView.settings, WebSettingsCompat.FORCE_DARK_ON)
}

Java

import android.webkit.WebView;
import androidx.webkit.WebSettingsCompat;
import androidx.webkit.WebViewFeature;

// You still get your WebView instance the standard way.
WebView webView = findViewById(R.id.my_webview);

// To enable a modern feature, you pass that instance to a Jetpack Webkit helper.
if (WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) {
    WebSettingsCompat.setForceDark(webView.settings, WebSettingsCompat.FORCE_DARK_ON);
}

Jetpack Webkit implementieren

So implementieren Sie Jetpack Webkit:

Schritt 1: Abhängigkeit hinzufügen

Fügen Sie in der Datei build.gradle.kts oder build.gradle Ihres Moduls die folgende Abhängigkeit hinzu, um Jetpack Webkit hinzuzufügen:

Cool

dependencies {
    implementation "androidx.webkit:webkit:1.16.0"
}

Kotlin

dependencies {
    implementation("androidx.webkit:webkit:1.16.0")
}

Jetpack Webkit enthält schlanke Wrapper, sodass die Auswirkungen auf die Größe Ihrer Anwendung minimal sind.

Schritt 2: Muster zur Funktionserkennung übernehmen

Verwenden Sie Funktionsprüfungen, um Abstürze beim Aufrufen nicht verfügbarer APIs zu vermeiden. Wir empfehlen, jeden API-Aufruf mit einer Funktionsprüfung zu umgeben und möglicherweise eine Fallback-Logik für den Fall zu berücksichtigen, dass die API nicht verfügbar ist.

Wir empfehlen das folgende Muster für die Verwendung einer modernen WebView API:

Kotlin

import android.webkit.WebView
import androidx.webkit.WebSettingsCompat
import androidx.webkit.WebViewFeature

val webView: WebView = findViewById(R.id.my_webview)

// Before you use a modern API, first check if it is supported.
if (WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) {
    // If the check passes, it is safe to call the API.
    WebSettingsCompat.setForceDark(webView.settings, WebSettingsCompat.FORCE_DARK_ON)
} else {
    // Optionally, provide a fallback for older WebView versions.
}

Java

import android.webkit.WebView;
import androidx.webkit.WebSettingsCompat;
import androidx.webkit.WebViewFeature;

WebView webView = findViewById(R.id.my_webview);

// Before you use a modern API, first check if it is supported.
if (WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) {
    // If the check passes, it is safe to call the API.
    WebSettingsCompat.setForceDark(webView.getSettings(), WebSettingsCompat.FORCE_DARK_ON);
} else {
    // Optionally, provide a fallback for older WebView versions.
}

Dieses Muster trägt dazu bei, dass die Anwendung robust ist. Da die Funktionsprüfung zuerst ausgeführt wird, stürzt die Anwendung nicht ab, wenn die Funktion nicht verfügbar ist. Der Leistungsaufwand der WebViewFeature#isFeatureSupported Prüfung ist vernachlässigbar.

WebView-Implementierung mit Jetpack Webkit vereinfachen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

Warum Jetpack Webkit verwenden?

Komponenten

Interaktion zwischen Jetpack Webkit und APK

Zusammenarbeit

Jetpack Webkit und Framework APIs im Vergleich

Moderne Authentifizierung (WebAuthn) aktivieren

Daten für einen Ursprung löschen (sitespezifischer Speicher)

WebView-Version abrufen

Nicht reagierenden Renderer verarbeiten (Renderer-Client)

Gespeicherten Status und Transaktionsgröße verwalten

Seiten navigieren und Lebenszyklus verfolgen

Jetpack Webkit in Ihren Code einbinden

Kotlin

Java

Jetpack Webkit implementieren

Cool

Kotlin

Kotlin

Java

WebView-Implementierung mit Jetpack Webkit vereinfachen