Webkit

Work with modern WebView APIs on Android 5 and above.
Latest Update Stable Release Release Candidate Beta Release Alpha Release
May 20, 2025 1.13.0 1.14.0-rc01 - -

Declaring dependencies

To add a dependency on Webkit, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Groovy

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

Kotlin

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

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Version 1.14

Version 1.14.0-rc01

May 20, 2025

androidx.webkit:webkit:1.14.0-rc01 is released. Version 1.14.0-rc01 contains these commits.

  • There are no changes from 1.14.0-beta01.

Version 1.14.0-beta01

May 7, 2025

androidx.webkit:webkit:1.14.0-beta01 is released. Version 1.14.0-beta01 contains these commits.

API Changes

Version 1.14.0-alpha01

April 9, 2025

androidx.webkit:webkit:1.14.0-alpha01 is released. Version 1.14.0-alpha01 contains these commits.

New Features

  • Introducing the PaymentRequest API for invoking Android native payment apps through org.chromium.intent.action.PAY intent. PaymentRequest is disabled by default and WebView host apps can call WebSettingsCompat.setPaymentRequestEnabled(settings, true) to enable it. In addition, PaymentRequest requires a <queries> tag in AndroidManifest.xml. See documentation for setPaymentRequestEnabled() for more information. (I3304e, b/404920055)
  • Introducing Experimental Navigation Callbacks. This release introduces experimental APIs for enhanced web navigation tracking and management within WebView. These APIs provide detailed information about navigation events. Key Features:
    • WebNavigationClient Interface: Introduces a new interface, WebNavigationClient, with callbacks for navigation events:
    • onNavigationStarted(Navigation navigation): Notifies when a navigation begins.
    • onNavigationRedirected(Navigation navigation): Notifies when a navigation is redirected.
    • onNavigationCompleted(Navigation navigation): Notifies when a navigation completes.
    • Navigation Interface: Provides detailed information about a navigation, including: URL, page initiation status, same-document status, reload status, history status, back/forward status, commit status, error page status, status code, and session restore status. The Navigation object serves as a unique identifier for each navigation, allowing developers to correlate related navigation events.
    • Page class: Introduces the Page class, which serves as a key for page-associated data. (I351a6)
  • Introduce a new experimental API to toggle the behaviour of caching provider objects. (I14636)

API Changes

  • Updated the PROFILE_URL_PREFETCH feature value in WebViewFeature. (I606fd)
  • Adds WebViewCompat#saveState, akin to WebView#saveState, but allows restricting the size of the returned state and deciding whether or not to save forward history entries. (Iea7d6)
  • Add maxPrerenders config to SpeculativeLoadingConfig API (I67245)

Version 1.13

Version 1.13.0

March 12, 2025

androidx.webkit:webkit:1.13.0 is released. Version 1.13.0 contains these commits.

Important changes since 1.12.0

  • Introduce a new experimental API for Url prerendering to allow developers to speculative prerender candidate urls resulting in faster navigations. (I0cfe7)
  • Introducing a set of new APIs to delete browsing data stored by WebView. The new APIs in WebStorageCompat should be preferred over the existing APIs in android.webkit.WebStorage, as they will guarantee deletion of all local storage, including the network cache and cookies, as well as any installed service workers. If new storage APIs are introduced in the future, then these new methods will be updated to include them in the storage deleted. (Iad54f, b/382273208)
  • Add setPartitionedCookiesEnabled API. This will allow developers to enable and disable partitioned cookies in WebView. (Ic506a, b/364904765)
  • Add socket tagging API to WebView for accounting of WebView's network traffic using NetworkStatsManager/TrafficStats. This feature will only be available from WebView M133. (Ica441, b/374932688)
  • Add experimental WebView async startup API. (I94b8a)
  • URL Prefetching in Profile: Introduced a new API in Profile to allow developers to trigger URL prefetching. Prefetch Clearing: Added an API to clear ongoing prefetches.(I42c5c)
  • Deprecate WebView.startSafeBrowsing. (If5626)

Version 1.13.0-rc01

February 26, 2025

androidx.webkit:webkit:1.13.0-rc01 is released. This release contains no changes from the 1.13.0-beta01release.

Version 1.13.0-beta01

February 12, 2025

androidx.webkit:webkit:1.13.0-beta01 is released. Version 1.13.0-beta01 contains these commits.

API Changes

  • Add Async suffix to prerender API. Rename any Data to Header in NoVarySearch to reflect the new name. (Ie91c9)
  • Add executor parameter to the url prerendering API. Also, restricting the API to be called only from the UI thread. (I50520)
  • Add an API to configure cache config for the profile prefetch requests. It also applies to Prerender requests initiated from WebViews associated with this Profile. (Iebb6e)

Bug Fixes

  • Change behavior of URLUtilCompat.guessFileName to only use the mimeType parameter to suggest an extension for filenames derived from the URL parameter. (I53ecd, b/382864232)

Version 1.13.0-alpha03

January 15, 2025

androidx.webkit:webkit:1.13.0-alpha03 is released. Version 1.13.0-alpha03 contains these commits.

New Features

  • Introduce a new experimental API for Url prerendering to allow developers to speculative prerender candidate urls resulting in faster navigations. (I0cfe7)
  • Introducing a set of new APIs to delete browsing data stored by WebView. The new APIs in WebStorageCompat should be preferred over the existing APIs in android.webkit.WebStorage, as they will guarantee deletion of all local storage, including the network cache and cookies, as well as any installed service workers. If new storage APIs are introduced in the future, then these new methods will be updated to include them in the storage deleted. (Iad54f, b/382273208)
  • Add setPartitionedCookiesEnabled API. This will allow developers to enable and disable partitioned cookies in WebView. (Ic506a, b/364904765)

API Changes

  • Change thread requirement for Prefetch API to only be called on the UI thread. (I866b5)
  • Update WebAuthn methods to highlight that they must be called on the UI thread. This requirement is enforced by the implementation already, and this change only adds the relevant annotation. (I6d6ba)

Version 1.13.0-alpha02

December 11, 2024

androidx.webkit:webkit:1.13.0-alpha02 is released. Version 1.13.0-alpha02 contains these commits.

New Features

  • Add socket tagging API to WebView for accounting of WebView's network traffic using NetworkStatsManager/TrafficStats. This feature will only be available from WebView M133. (Ica441, b/374932688)

API Changes

  • Update Prefetch API by renaming PrefetchParameter to SpeculativeLoadingParamaters, introducing new PrefetchNetworkException, replacing PrefetchOperationCallback with OutcomeReceiverCompat and update the javadoc. (If5072)
  • Get diagnostic information from WebView async startup API.
  • Provide an option for apps to only trigger init that doesn't block the UI thread. (I9bf2b)

Bug Fixes

  • This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage: -Xjspecify-annotations=strict (this is the default starting with version 2.1.0 of the Kotlin compiler). (I0e4c5, b/326456246)

Version 1.13.0-alpha01

November 13, 2024

androidx.webkit:webkit:1.13.0-alpha01 is released. Version 1.13.0-alpha01 contains these commits.

New Features

  • Add experimental WebView async startup API. (I94b8a)
  • URL Prefetching in Profile: Introduced a new API in Profile to allow developers to trigger URL prefetching. Prefetch Clearing: Added an API to clear ongoing prefetches. (I42c5c)

API Changes

  • Deprecate WebView.startSafeBrowsing. (If5626)

Version 1.12

Version 1.12.1

October 2, 2024

androidx.webkit:webkit:1.12.1 is released. Version 1.12.1 contains these commits.

Bug Fixes

  • Resolve the issue that prevented the 1.12.0 APIs from being available in the release.

Version 1.12.0

September 18, 2024

androidx.webkit:webkit:1.12.0 is released. Version 1.12.0 contains these commits.

Important changes since 1.11.0

  • Add a new API to WebSettingsCompat to enable/disable BackForwardCache for this WebSettings. This API is experimental and can be changed in the future. (aosp/3111705)
  • Add a new API to WebSettingsCompat to control the Speculative Loading behavior for this WebSettings. Only Prerender is available for now. This API is experimental and can be changed in the future. (I13962)
  • Added a new API to enable Web Authentication in WebView. Developers can enable/disable WebAuthn calls in a WebView for their apps using WebSettingsCompat#setWebAuthenticationSupport. (I8187f)

Version 1.12.0-rc01

September 4, 2024

androidx.webkit:webkit:1.12.0-rc01 is released. This release contains no changes from the 1.12.0-beta01 release.

Version 1.12.0-beta01

August 21, 2024

androidx.webkit:webkit:1.12.0-beta01 is released. Version 1.12.0-beta01 contains these commits.

Bug Fixes

  • Removed manual outlining of access to new platform APIs since this happens automatically via API modeling when using R8 with AGP 7.3 or later (e.g. R8 version 3.3) and for all builds when using AGP 8.1 or later (e.g. D8 version 8.1). Clients who are not using AGP are advised to update to D8 version 8.1 or later. See this article for more details. (Ia60e0, b/345472586)

Version 1.12.0-alpha02

June 12, 2024

androidx.webkit:webkit:1.12.0-alpha02 is released. Version 1.12.0-alpha02 contains these commits.

New Features

  • Add a new API to WebSettingsCompat to enabled/disable BackForwardCache. This API is experimental and can be changed in the future. (I64a38)
  • Add a new API to WebSettingsCompat to control the Speculative Loading behavior for this WebSettings. Only Prerender is available for now. This API is experimental and can be changed in the future. (I13962)

API Changes

  • Some methods are now documented with @UiThread where appropriate. (I6c7e0), (I44541)
  • Thread-safe methods are now documented with @AnyThread. (I70189)
  • Increasing minSdkVersion from 19 to 21. (Id7a43)

Version 1.12.0-alpha01

April 17, 2024

androidx.webkit:webkit:1.12.0-alpha01 is released. Version 1.12.0-alpha01 contains these commits.

API Changes

  • Added a new API to enable Web Authentication in WebView. Developers can enable/disable WebAuthn calls in a WebView for their apps using WebSettingsCompat#setWebAuthenticationSupport. (I8187f)

Version 1.11

Version 1.11.0

May 1, 2024

androidx.webkit:webkit:1.11.0 is released. Version 1.11.0 contains these commits.

Important changes since 1.10.0

  • Allow apps to control audio playback in WebView through the new setAudioMuted and isAudioMuted APIs, which are analogous to muting a tab in Chrome.
  • Introduced URLUtilCompat, which supports parsing of Content-Disposition headers that use the filename* encoded value attribute as defined in RFC 6266. The compatibility API also directly exposes a method to parse the Content-Disposition header where a suggested file name based on URL and MIME-type is not desired.

Version 1.11.0-rc01

April 3, 2024

androidx.webkit:webkit:1.11.0-rc01 is released. This release contains no changes from the 1.11.0-beta01 release.

Version 1.11.0-beta01

March 20, 2024

androidx.webkit:webkit:1.11.0-beta01 is released without any notable changes. Version 1.11.0-beta01 contains these commits.

Version 1.11.0-alpha02

February 21, 2024

androidx.webkit:webkit:1.11.0-alpha02 is released. Version 1.11.0-alpha02 contains these commits.

New Features

  • Add setAudioMuted and isAudioMuted methods for muting (and unmuting) WebViews. This method will allow you to prevent a WebView from playing audio. (Ie7a33)

API Changes

  • URLUtilCompat is made final as it should not be subclassed. (I49ec1)

Version 1.11.0-alpha01

February 7, 2024

androidx.webkit:webkit:1.11.0-alpha01 is released. Version 1.11.0-alpha01 contains these commits.

New Features

  • Add compatibility for URLUtil.guessFileName. The compatibility version in URLUtilCompat supports parsing of Content-Disposition headers that use the filename* encoded value attribute as defined in RFC 6266. The compatibility API also directly exposes a method to parse the Content-Disposition header where a suggested file name based on URL and MIME-type is not desired. (If6ae7, b/309927164)

Version 1.10

Version 1.10.0

January 24, 2024

androidx.webkit:webkit:1.10.0 is released. Version 1.10.0 contains these commits.

Important changes since 1.9.0

Version 1.10.0-rc01

January 10, 2024

androidx.webkit:webkit:1.10.0-rc01 is released. This release contains no changes from the 1.10.0-beta01 release.

Version 1.10.0-beta01

December 13, 2023

androidx.webkit:webkit:1.10.0-beta01 is released. Version 1.10.0-beta01 contains these commits.

  • No functional changes from 1.10.0-alpha01.

Version 1.10.0-alpha01

November 29, 2023

androidx.webkit:webkit:1.10.0-alpha01 is released. Version 1.10.0-alpha01 contains these commits.

New Features

  • Added a new API to WebSettingsCompat to control the experimental Android WebView Media Integrity API behaviour by either disabling the API entirely, or restrict sharing the application identity in the API response. This can be toggled for all origins and on a per origin basis.

Version 1.9

Version 1.9.0

November 29, 2023

androidx.webkit:webkit:1.9.0 is released. Version 1.9.0 contains these commits.

Important changes since 1.8.0

  • Added a new multi-profile API for WebViews.
  • Added an API to inject and run Javascript before page load.
    • The WebViewCompat#addDocumentStartJavascript API allows apps to inject scripts into a WebView which are guaranteed to run before any page scripts are executed. The API allows the app to specify a target list of origins for the script to be enabled on, ensuring that it only runs on intended pages. Unlike WebView#evaluateJavascript, this API will allow execution of scripts in embedded Iframes when they load. Apps can use this new API in combination with WebViewCompat#addWebMessageListener to set up two-way communication with JavaScript in the page in a reliable way.
  • Added APIs to modify how Privacy Sandbox Attribution Reporting events are registered.
    • We introduced a new API WebSettingsCompat#setAttributionRegistrationBehavior which allows developers to configure whether attribution sources and triggers are registered as coming from the app itself or coming from the web content in the WebView. This method can also be used to disable Attribution Reporting in WebView. Additionally we added a new API WebSettingsCompat#getAttributionRegistrationBehavior to get the current behavior.
    • For more information see the Privacy Sandbox documentation.
  • Added APIs to override user-agent metadata for client hints.

Version 1.9.0-rc01

November 15, 2023

androidx.webkit:webkit:1.9.0-rc01 is released. This release contains no changes from the 1.9.0-beta01 release.

Version 1.9.0-beta01

November 1, 2023

androidx.webkit:webkit:1.9.0-beta01 is released. Version 1.9.0-beta01 contains these commits.

API Changes

  • Address user-agent metadata API's nullability issue. We update BrandVersion class to use builder pattern, make the UserAgentMetadata class's getters and setters nullability consistent. (Ibf195)
  • Annotating ProfileStore, WebViewCompat#setProfile and WebViewCompat.getProfile with @UiThread. (I499b2)

Version 1.9.0-alpha01

October 18, 2023

androidx.webkit:webkit:1.9.0-alpha01 is released. Version 1.9.0-alpha01 contains these commits.

New Features

  • We added the multi-profile API which allows you to have separate browsing sessions between WebViews, each profile has its own data (e.g. cookies). You can create profiles, assign them to WebView instances, and retrieve them later for any data access. There is a singleton class ProfileStore to help you manage profiles by creation or deletion with APIs; getOrCreateProfile, getProfile, getAllProfileNames and deleteProfile. The Profile class will have different APIs to use to get associated data with this profile such as its name, GeoLocationPermissions, ServiceWorkerController, CookieManager and WebStorage. Each WebView will run with the default profile by default however, you can change that using WebViewCompat#setProfile Related to that, a WebView’s profile can be retrieved using WebViewCompat#getProfile. (I32d22)
  • Add APIs to modify how Attribution Reporting events are registered. We introduced a new API WebSettingsCompat#setAttributionRegistrationBehavior which allows developers to configure whether sources and triggers are registered as coming from the app itself or coming from the web content in the WebView. This method can also be used to disable Attribution Reporting in WebView. Additionally we added a new API WebSettingsCompat#getAttributionRegistrationBehavior to get the current behavior. For more information see the Privacy Sandbox documentation. (I661f2)
  • Add APIs to override user-agent metadata. We introduced a new API WebSettingsCompat#setUserAgentMetadata to override the user-agent metadata for WebView, which is used to populate the user-agent client hints, and we also added another new API WebSettingsCompat#getUserAgentMetadata to get current user-agent overrides. We encourage apps to use the new API to set the right override values instead of relying on changing user-agent. (I74500)
  • Add an API to inject Javascript to be run during page load. The WebViewCompat.addDocumentStartJavascript API allows apps to inject scripts into a WebView which will be run before any page scripts are executed. The API allows the app to specify a target list of origins for the script to be enabled on, ensuring that it only runs on intended pages. Unlike WebView.evaluateJavascript, this API will allow execution of scripts in embedded Iframes when they load. (Ide063)

Version 1.8

Version 1.8.0

September 6, 2023

androidx.webkit:webkit:1.8.0 is released. Version 1.8.0 contains these commits.

Important changes since 1.7.0

Version 1.8.0-rc01

August 9, 2023

androidx.webkit:webkit:1.8.0-rc01 is released with no changes since 1.8.0-beta01. Version 1.8.0-rc01 contains these commits.

Version 1.8.0-beta01

July 26, 2023

androidx.webkit:webkit:1.8.0-beta01 is released with no changes since 1.8.0-alpha01. Version 1.8.0-beta01 contains these commits.

Version 1.8.0-alpha01

June 7, 2023

androidx.webkit:webkit:1.8.0-alpha01 is released. Version 1.8.0-alpha01 contains these commits.

API Changes

  • See the External Contribution section.

External Contribution

  • Add support for passing ArrayBuffer over WebMessagePortCompat#postMessage, JsReplyProxy#postMessage and WebViewCompat#postWebMessage, receiving ArrayBuffer from JavaScript over WebMessagePortCompat and WebMessageListener, and receiving transferable ArrayBuffer from JavaScript over WebMessagePortCompat. Please note that this API will only be available from WebView version 116. (Ie7567, b/251152171)

Version 1.7

Version 1.7.0

May 24, 2023

androidx.webkit:webkit:1.7.0 is released. Version 1.7.0 contains these commits.

Important changes since 1.6.0

  • We added support for Image drag in WebView. You can enable your users to drag images out of the WebView by adding the new DropDataContentProvider to your app's manifest as described in the class documentation.
  • We added the ProcessGlobalConfig#setDirectoryBasePaths(Context,File,File) API which can be used to set the base directories that WebView will use for the current process. As with all methods on ProcessGlobalConfig, this method must be called before the first instance of WebView is instantiated. This method is added to provide Android framework the capability to tweak WebView settings. For general purpose applications, using this method is not recommended.

Version 1.7.0-rc01

May 10, 2023

androidx.webkit:webkit:1.7.0-rc01 is released with no changes since 1.7.0-beta01. Version 1.7.0-rc01 contains these commits.

Version 1.7.0-beta01

April 5, 2023

androidx.webkit:webkit:1.7.0-beta01 is released. Version 1.7.0-beta01 contains these commits.

API Changes

  • Minor change to feature flag and method name and make setDirectoryBasePaths() accept File instead of String (Ib0d0a)

Version 1.7.0-alpha03

March 8, 2023

androidx.webkit:webkit:1.7.0-alpha03 is released. Version 1.7.0-alpha03 contains these commits.

API Changes

  • Add ProcessGlobalConfig#setDirectoryBasePath(String, String) API which can be used to set the base directories that WebView will use for the current process. (Ibd1a1, b/250553687)

Bug Fixes

  • Fix invalid ProGuard rule causing build errors when using DexGuard (Ia65c2, b/270034835)

Version 1.7.0-alpha02

February 8, 2023

androidx.webkit:webkit:1.7.0-alpha02 is released. Version 1.7.0-alpha02 contains these commits.

Bug Fixes

  • Documentation bugs for DropDataContentProvider.

Version 1.7.0-alpha01

January 25, 2023

androidx.webkit:webkit:1.7.0-alpha01 is released. Version 1.7.0-alpha01 contains these commits.

New Features

  • We are adding support for Image drag in WebView. You can enable your users to drag images out of the WebView by adding the new DropDataContentProvider to your app's manifest. (05a1a6)

Version 1.6

Version 1.6.1

March 22, 2023

androidx.webkit:webkit:1.6.1 is released. Version 1.6.1 contains these commits.

Bug Fixes

  • Fix proguard parse error (Ia65c2)

Version 1.6.0

January 25, 2023

androidx.webkit:webkit:1.6.0 is released. Version 1.6.0 contains these commits.

Important changes since 1.5.0

  • A new ProcessGlobalConfig API has been added to allow apps to provide configuration settings that need to be set before loading WebView, such as the WebView data directory suffix. The configuration should be set up and applied as early as possible during application startup, to ensure that it happens before any other thread can call a method that loads WebView into the process.
  • A new CookieManagerCompat API has been added to expand android.webkit.CookieManager with a new getCookieInfo method, which retrieves all attributes for all cookies set on a specific URL. This differs from the existing getCookie API in CookieManager which returns only the name and value attributes of the cookies.
  • WebSettingsCompat has new methods to enable/disable the effect of EnterpriseAuthenticationAppLinkPolicy if set by admin in WebView, and to get the current setting. This feature lets WebView open an Authentication app instead of opening the authentication URL. This feature has no effect on devices that are not managed by an enterprise policy.
  • Adding a new API to WebSettingsCompat to let applications explicitly send the app package name in the X-Requested-With header to allowlisted origins. The header has traditionally been sent on every request from WebView.

Version 1.6.0-rc01

January 11, 2023

androidx.webkit:webkit:1.6.0-rc01 is released. Version 1.6.0-rc01 contains these commits.

Bug Fixes

  • Fixed NullPointerException in WebViewFeature.isStartupFeatureSupported(Context, String) when running on SDK < L. (Ic7292)

Version 1.6.0-beta01

December 7, 2022

androidx.webkit:webkit:1.6.0-beta01 is released. Version 1.6.0-beta01 contains these commits.

API Changes

  • ProcessGlobalConfig has been changed to use a normal constructor and a static apply method. The apply method should only be called once per process, as early as possible, and will throw IllegalStateException if called more than once. ProcessGlobalConfig objects no longer have any restrictions on how many times setters can be called. (I456c3)

Version 1.6.0-alpha03

November 9, 2022

androidx.webkit:webkit:1.6.0-alpha03 is released. Version 1.6.0-alpha03 contains these commits.

New Features

  • Add ProcessGlobalConfig class enabling users to set process global config before loading WebView. WebView has some process-global configuration parameters that cannot be changed once WebView has been loaded (e.g. the WebView data directory). This class allows apps to set these parameters. The configuration should be set up and applied as early as possible during application startup, to ensure that it happens before any other thread can call a method that loads WebView into the process. (I7c0e0, b/250553687)
  • Adding new API to let applications explicitly send the app package name in the X-Requested-With header to allowlisted origins. The header has traditionally been sent on every request from WebView. (I0adfe, b/226552535)

API Changes

  • The WebSettingsCompat#setAlgorithmicDarkeningAllowed API is supported on all Android versions in WebView version 105 and later. Previous versions of WebView only supported the API on Android Q and later. As a result, this api is no longer marked @RequiresApi(Build.VERSION_CODES.Q). (I3ac1d)

Version 1.6.0-alpha02

October 24, 2022

androidx.webkit:webkit:1.6.0-alpha02 is released. Version 1.6.0-alpha02 contains these commits.

New Features

  • Adds a new CookieManagerCompat class along with a getCookieInfo API which retrieves all attributes for all cookies set on a specific URL. This differs from the existing getCookie API in CookieManager which returns only the name and value attributes of the cookies. (I07365, b/242161756)

Version 1.6.0-alpha01

August 24, 2022

androidx.webkit:webkit:1.6.0-alpha01 is released. Version 1.6.0-alpha01 contains these commits.

New Features

  • Added APIs in WebSettingsCompat to enable/disable the effect of EnterpriseAuthenticationAppLinkPolicy if set by admin in WebView. This feature lets WebView open an Authentication app instead of opening the authentication URL. This feature has no effect on devices that are not managed by an enterprise policy.

Version 1.5.0

Version 1.5.0

August 24, 2022

androidx.webkit:webkit:1.5.0 is released. Version 1.5.0 contains these commits.

Important changes since 1.4.0

  • A new setAlgorithmicDarkeningAllowed API on WebSettingsCompat replaces the old setForceDark and setForceDarkStrategy APIs. Apps targeting SDK 33 and higher (T) should use the new API, as the old API will no longer have any effect for those apps.
  • An allow-list of URLs to use the configured proxy can now be set through ProxyCofig.Builder by setting setReverseBypassEnabled to true. When this is in effect, all other URLs will bypass the configured proxy.

Version 1.5.0-rc01

August 10, 2022

androidx.webkit:webkit:1.5.0-rc01 is released with no changes since 1.5.0-beta01. Version 1.5.0-rc01 contains these commits.

Version 1.5.0-beta01

June 29, 2022

androidx.webkit:webkit:1.5.0-beta01 is released. Version 1.5.0-beta01 contains these commits.

API Changes

  • Alogrithimic Darkening related APIs are now annotated to require API level Q. The API will not have any effect on API levels < Q, since dark theme is not an option on these devices. (I0905e)

Version 1.5.0-alpha01

May 18, 2022

androidx.webkit:webkit:1.5.0-alpha01 is released. Version 1.5.0-alpha01 contains these commits.

New Features

  • Add a new getVariationsHeader() method on WebViewCompat to get the X-Client-Data header value sent by the WebView. The returned value will be a base64 encoded ClientVariations protobuf.
  • Add APIs on WebSettingsCompat to allow/disallow algorithmic darkening for app with targetSdk >= 33. (I29597)

API Changes

  • Add a new method in ProxyCofig.Builder to set reverse bypass. Setting reverse bypass to true means only URLs in the bypass list will use the proxy settings. (I9eaa2, b/168728599)

Bug Fixes

  • Fixed a typo in dark theme documentation. (I36ebf, b/194343633)
  • Fixed a bug where WebViewAssetLoader.Builder methods were unintentionally order-dependent. (If420d, b/182196765)

Version 1.4.0

Version 1.4.0

December 16, 2020

androidx.webkit:webkit:1.4.0 is released. Version 1.4.0 contains these commits.

Major changes since 1.3.0

  • Added a new setSafeBrowsingAllowlist() API to replace setSafeBrowsingWhitelist(). This helps apps update their code to avoid non-inclusive terminology, while still supporting the same range of Android SDKs and WebView versions as the deprecated API.
  • Fixed a bug in setProxyOverride that caused fallback rules not being correctly applied.

Version 1.4.0-rc02

December 2, 2020

androidx.webkit:webkit:1.4.0-rc02 is released. Version 1.4.0-rc02 contains these commits.

Bug Fixes

  • Fixes fallback rules not being correctly applied when using setProxyOverride.

Version 1.4.0-rc01

November 11, 2020

androidx.webkit:webkit:1.4.0-rc01 is released with no changes since 1.4.0-beta01. Version 1.4.0-rc01 contains these commits.

Version 1.4.0-beta01

October 14, 2020

androidx.webkit:webkit:1.4.0-beta01 is released with no changes since 1.4.0-alpha01. Version 1.4.0-beta01 contains these commits.

Version 1.4.0-alpha01

September 16, 2020

androidx.webkit:webkit:1.4.0-alpha01 is released. Version 1.4.0-alpha01 contains these commits.

API Changes

  • Added a new WebViewCompat#setSafeBrowsingAllowlist() API to replace setSafeBrowsingWhitelist(). This helps apps update their code to avoid non-inclusive terminology, while still supporting the same range of Android SDKs and WebView versions as the deprecated API. (I8d65d)

Version 1.3.0

Version 1.3.0

August 19, 2020

androidx.webkit:webkit:1.3.0 is released. Version 1.3.0 contains these commits.

Major changes since 1.2.0

  • ForceDarkStrategy API provides more control to WebView darkening (CSS/web content darkening versus auto darkening).
  • WebMessageListener and its related APIs provide a simple and secure mechanism to establish communication between web contents and the WebView embedder app.
  • isMultiProcessEnabled API to check whether WebView is running in multi process. This is possible starting in Android O and it means web content is rendered in a sandboxed renderer process separate to the application process. This sandboxed renderer may be shared with other WebViews in the same application but it's not shared with other application processes.

Version 1.3.0-rc02

August 5, 2020

androidx.webkit:webkit:1.3.0-rc02 is released. Version 1.3.0-rc02 contains these commits.

Bug Fixes

  • This fixes a compatibility issue where WebMessageListener would sometimes crash during local development if your app was started with Android Studio instant run.

Version 1.3.0-rc01

June 24, 2020

androidx.webkit:webkit:1.3.0-rc01 is released with no changes since 1.3.0-beta01. Version 1.3.0-rc01 contains these commits.

Version 1.3.0-beta01

June 10, 2020

androidx.webkit:webkit:1.3.0-beta01 is released. Version 1.3.0-beta01 contains these commits.

New Features

  • ForceDarkStrategy API to control WebView darkening (CSS/web content darkening versus auto darkening).
  • WebMessageListener APIs provide a simple and secure mechanism to establish communication between web contents and the WebView embedder app.
  • MultiProcessEnabled API to check if WebView is running in multi process mode.

Version 1.3.0-alpha03

May 27, 2020

androidx.webkit:webkit:1.3.0-alpha03 is released. Version 1.3.0-alpha03 contains these commits.

API Changes

  • addWebMessageListener method now receives a Set<String> of allowed origin rules (previously a List<String>).

Version 1.3.0-alpha02

April 29, 2020

androidx.webkit:webkit:1.3.0-alpha02 is released. Version 1.3.0-alpha02 contains these commits.

New Features

  • MultiProcessEnabled API to check if WebView is running in multi process mode.

API Changes

  • All dark strategy constants are now prefixed with DARK_STRATEGY.

Version 1.3.0-alpha01

April 15, 2020

androidx.webkit:webkit:1.3.0-alpha01 is released. Version 1.3.0-alpha01 contains these commits.

New Features

  • ForceDarkStrategy API to control WebView darkening (CSS/web content darkening versus auto darkening).
  • WebMessageListener APIs provide a simple and secure mechanism to establish communication between web contents and the WebView embedder app.

Version 1.2.0

Version 1.2.0

March 4, 2020

androidx.webkit:webkit:1.2.0 is released. Version 1.2.0 contains these commits.

Major changes since 1.1.0

  • Added the ForceDark API to control if WebViews should be rendered in dark mode.

Version 1.2.0-rc01

February 19, 2020

androidx.webkit:webkit:1.2.0-rc01 is released with no changes since 1.2.0-beta01. Version 1.2.0-rc01 contains these commits.

Version 1.2.0-beta01

February 5, 2020

androidx.webkit:webkit:1.2.0-beta01 is released with no changes since 1.2.0-alpha01. Version 1.2.0-beta01 contains these commits.

Version 1.2.0-alpha01

December 18, 2019

androidx.webkit:webkit:1.2.0-alpha01 is released. Version 1.2.0-alpha01 contains these commits.

New features

  • ForceDark API to control if WebViews should be rendered in dark mode.

Version 1.1.0

Version 1.1.0

November 7, 2019

androidx.webkit:webkit:1.1.0 is released. Version 1.1.0 contains these commits.

Important changes since 1.0.0

  • Getter APIs to complement setWebViewClient() and setWebChromeClient().
  • ProxyController API to set a network request proxy for an app's WebViews.
  • WebViewAssetLoader API to simplify loading APK assets, resources, and files from the app data directory via request interception. This allows access to web and local resources without disabling CORS.
  • TracingController API to collect WebView tracing information for debugging purposes.
  • RenderProcess APIs to manage WebView renderer services, and to detect when poorly behaved content causes WebView renderers to become unresponsive.
  • Updated existing APIs to include nullability (@NonNull, @Nullable) and thread (@UiThread, @WorkerThread) annotations.

Version 1.1.0-rc01

October 9, 2019

androidx.webkit:webkit:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

Bug fixes

  • Fixed an issue where setWebViewRenderProcessClient() could crash if passed a null client.

Version 1.1.0-beta01

September 5, 2019

androidx.webkit:webkit:1.1.0-beta01 is released. The commits included in this version can be found here.

New features

  • New InternalStoragePathHandler in WebViewAssetLoader to load files from the app's data directory.

API changes

  • ProxyConfig#getProxyRules() now returns an unmodifiable list of ProxyRule instances, which is a new class to hold a scheme filter and its corresponding proxy URL.

Bug fixes

  • WebViewAssetLoader defaults to a "text/plain" MIME type (rather than null) when it can't guess the MIME type from the file path.
  • WebViewAssetLoader no longer throws a NullPointerException when loading files with special characters in their path names.

Version 1.1.0-alpha02

August 7, 2019

androidx.webkit:webkit:1.1.0-alpha02 is released. The commits included in this version can be found here.

New features

  • WebViewAssetLoader exposes the PathHandler interface to allow apps to create custom path-handling functionality.

API changes

  • WebViewAssetLoader is now a final class, since it's not meant to be subclassed.
  • WebViewAssetLoader#PathHandler implementations are now public and final.
  • Minor changes to ProxyConfig method names.
  • ProxyController: added new methods addDirect() and addDirect(String) to connect directly to servers; removed DIRECT String.
  • Updated existing APIs to include nullability (@NonNull, @Nullable) and thread (@UiThread, @WorkerThread) annotations.

Version 1.1.0-alpha01

May 7, 2019

androidx.webkit:webkit:1.1.0-alpha01 is released. The commits included in this version can be found here.

New features

  • Getter APIs to complement setWebViewClient() and setWebChromeClient()
  • ProxyController API to set a network request proxy for an app's WebViews.
  • AssetLoader API to simplify loading APK assets and resources via request interception, allowing access to web resources without disabling CORS.
  • TracingController API to collect WebView tracing information for debugging purposes.
  • RenderProcess APIs to manage WebView renderer services, and to detect when poorly behaved content causes WebView renderers to become unresponsive.

Bug fixes

  • Minor fixes to documentation formatting for existing APIs.