Webkit

API リファレンス
androidx.webkit

Android 5 以上で、最新の WebView API を操作します。

最新の更新	現在の安定版リリース	次のリリース候補	ベータ版リリース	アルファ版リリース
2020 年 12 月 16 日	1.4.0	-	-	-

依存関係の宣言

Webkit への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

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

Kotlin

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

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.4.0

2020 年 12 月 16 日

androidx.webkit:webkit:1.4.0 がリリースされました。バージョン 1.4.0 に含まれるコミットについては、こちらをご覧ください。

1.3.0 以降の主な変更

setSafeBrowsingWhitelist() に代わる新しい setSafeBrowsingAllowlist() API を追加しました。これにより、サポートが終了した API と同じ範囲の Android SDK バージョンと WebView バージョンをサポートしつつ、差別的な用語を避けるためにアプリのコードを更新できます。
setProxyOverride でフォールバックルールが正しく適用されないバグを修正しました。

バージョン 1.4.0-rc02

2020 年 12 月 2 日

androidx.webkit:webkit:1.4.0-rc02 がリリースされました。バージョン 1.4.0-rc02 に含まれるコミットについては、こちらをご覧ください。

バグの修正

setProxyOverride を使用したときにフォールバックルールが正しく適用されないバグを修正しました。

バージョン 1.4.0-rc01

2020 年 11 月 11 日

androidx.webkit:webkit:1.4.0-rc01 がリリースされました。1.4.0-beta01 からの変更はありません。バージョン 1.4.0-rc01 に含まれるコミットについては、こちらをご覧ください。

バージョン 1.4.0-beta01

2020 年 10 月 14 日

androidx.webkit:webkit:1.4.0-beta01 がリリースされました。1.4.0-alpha01 からの変更はありません。バージョン 1.4.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.4.0-alpha01

2020 年 9 月 16 日

androidx.webkit:webkit:1.4.0-alpha01 がリリースされました。バージョン 1.4.0-alpha01 に含まれる commit については、こちらをご覧ください。

API の変更

setSafeBrowsingWhitelist() に代わる新しい WebViewCompat#setSafeBrowsingAllowlist() API を追加しました。これにより、サポートが終了した API と同じ範囲の Android SDK バージョンと WebView バージョンをサポートしつつ、差別的な用語を避けるためにアプリのコードを更新できます。（I8d65d）

バージョン 1.3.0

2020 年 8 月 19 日

androidx.webkit:webkit:1.3.0 がリリースされました。バージョン 1.3.0 に含まれる commit については、こちらをご覧ください。

1.2.0 以降の主な変更

ForceDarkStrategy API による WebView ダークニング（CSS / ウェブコンテンツのダークニング対自動ダークニング）の制御が強化されました。
WebMessageListener API とその関連 API は、ウェブコンテンツと WebView 埋め込みアプリ間の通信を確立するためのシンプルで安全なメカニズムを提供します。
isMultiProcessEnabled API を使用して、WebView がマルチプロセスで実行されているかどうかを確認します。これは Android O から可能です。ウェブコンテンツは、アプリプロセスとは別のサンドボックスレンダラプロセスでレンダリングされます。このサンドボックス化されたレンダラは、同じアプリの他の WebView と共有できますが、他のアプリプロセスとは共有されません。

バージョン 1.3.0-rc02

2020 年 8 月 5 日

androidx.webkit:webkit:1.3.0-rc02 がリリースされました。バージョン 1.3.0-rc02 に含まれるコミットについては、こちらをご覧ください。

バグの修正

ローカルでの開発中にアプリを Android Studio Instant Run で開始した場合に WebMessageListener がクラッシュすることがある互換性の問題が修正されました。

バージョン 1.3.0-rc01

2020 年 6 月 24 日

androidx.webkit:webkit:1.3.0-rc01 がリリースされました。1.3.0-beta01 からの変更はありません。バージョン 1.3.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.3.0-beta01

2020 年 6 月 10 日

androidx.webkit:webkit:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 に含まれる commit については、こちらをご覧ください。

新機能

WebView ダークニング（CSS / ウェブコンテンツのダークニング対自動ダークニング）を制御する ForceDarkStrategy API。
WebMessageListener API は、ウェブコンテンツと WebView 埋め込みアプリ間の通信を確立するためのシンプルで安全なメカニズムを提供します。
MultiProcessEnabled API を使用して、WebView がマルチプロセスモードで実行されているかどうかを確認します。

バージョン 1.3.0-alpha03

2020 年 5 月 27 日

androidx.webkit:webkit:1.3.0-alpha03 がリリースされました。バージョン 1.3.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

addWebMessageListener メソッドが、許可されている元のルールの Set<String> を受け取るようになりました（以前は List<String> でした）。

バージョン 1.3.0-alpha02

2020 年 4 月 29 日

androidx.webkit:webkit:1.3.0-alpha02 がリリースされました。バージョン 1.3.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

MultiProcessEnabled API を使用して、WebView がマルチプロセスモードで実行されているかどうかを確認します。

API の変更

すべてのダークストラテジー定数に DARK_STRATEGY プレフィックスが付きました。

バージョン 1.3.0-alpha01

2020 年 4 月 15 日

androidx.webkit:webkit:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

WebView ダークニング（CSS/ウェブコンテンツのダークニング対自動ダークニング）を制御する ForceDarkStrategy API。
WebMessageListener API は、ウェブコンテンツと WebView 埋め込みアプリ間の通信を確立するためのシンプルで安全なメカニズムを提供します。

バージョン 1.2.0

2020 年 3 月 4 日

androidx.webkit:webkit:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

1.1.0 以降の主な変更

WebView をダークモードでレンダリングするかどうかを制御する ForceDark API を追加しました。

バージョン 1.2.0-rc01

2020 年 2 月 19 日

androidx.webkit:webkit:1.2.0-rc01 がリリースされました。1.2.0-beta01 からの変更はありません。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-beta01

2020 年 2 月 5 日

androidx.webkit:webkit:1.2.0-beta01 がリリースされました。1.2.0-alpha01 からの変更はありません。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-alpha01

2019 年 12 月 18 日

androidx.webkit:webkit:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

WebView をダークモードでレンダリングするかどうかを制御する ForceDark API。

バージョン 1.1.0

2019 年 11 月 7 日

androidx.webkit:webkit:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください。

1.0.0 以降の重要な変更

setWebViewClient() と setWebChromeClient() を補完する Getter API
アプリの WebView のネットワークリクエストプロキシを設定する ProxyController API
リクエストのインターセプトを介してアプリデータディレクトリからの APK アセット、リソース、ファイルの読み込みを簡素化する WebViewAssetLoader API。これにより、CORS を無効にすることなくウェブリソースとローカルリソースにアクセスできます。
デバッグ目的で WebView トレース情報を収集する TracingController API
WebView レンダラサービスを管理し、動作の不完全なコンテンツによって WebView レンダラが応答しなくなったことを検出する、RenderProcess API
既存の API を更新し、null 可能性アノテーション（@NonNull、@Nullable）とスレッドアノテーション（@UiThread、@WorkerThread）を追加しました。

バージョン 1.1.0-rc01

2019 年 10 月 9 日

androidx.webkit:webkit:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

バグの修正

null クライアントが渡されると setWebViewRenderProcessClient() がクラッシュすることがある問題を修正しました。

バージョン 1.1.0-beta01

2019 年 9 月 5 日

androidx.webkit:webkit:1.1.0-beta01 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

新機能

アプリのデータディレクトリからファイルを読み込むための、WebViewAssetLoader の新しい InternalStoragePathHandler

API の変更

ProxyConfig#getProxyRules() が ProxyRule インスタンスの変更不可能なリストを返すようになりました。これは、スキームフィルタとそれに対応するプロキシ URL を保持する新しいクラスです。

バグの修正

ファイルパスから MIME タイプを推測できない場合、WebViewAssetLoader はデフォルトで（null ではなく）「text/plain」MIME タイプに設定されます。
パス名に特殊文字を含むファイルを読み込んだときに、WebViewAssetLoader が NullPointerException をスローしなくなりました。

バージョン 1.1.0-alpha02

2019 年 8 月 7 日

androidx.webkit:webkit:1.1.0-alpha02 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

新機能

アプリがカスタムパス処理機能を作成できるように、WebViewAssetLoader が PathHandler インターフェースを公開します。

API の変更

WebViewAssetLoader は、サブクラス化されることを意図しないため、最終クラスになりました。
WebViewAssetLoader#PathHandler 実装が公開され最終版になりました。
ProxyConfig メソッド名に小さな変更を加えました。
ProxyController: サーバーに直接接続するための新しいメソッド addDirect() と addDirect(String) を追加し、DIRECT String を削除しました。
既存の API を更新し、null 可能性アノテーション（@NonNull、@Nullable）とスレッドアノテーション（@UiThread、@WorkerThread）を追加しました。

バージョン 1.1.0-alpha01

2019 年 5 月 7 日

androidx.webkit:webkit:1.1.0-alpha01 がリリースされました。このバージョンに含まれる commit については、こちらをご覧ください。

新機能

setWebViewClient() と setWebChromeClient() を補完する Getter API
アプリの WebView のネットワークリクエストプロキシを設定する ProxyController API
リクエストのインターセプトを介して APK アセットとリソースの読み込みを簡素化する AssetLoader API。CORS を無効にすることなくウェブリソースにアクセスできます。
デバッグ目的で WebView トレース情報を収集する TracingController API
WebView レンダラサービスを管理し、動作の不十分なコンテンツによって WebView レンダラが応答しなくなったことを検出する、RenderProcess API

バグの修正

既存の API のドキュメント形式を若干修正しました。