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

バージョン 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 に含まれる commit については、こちらをご覧ください。

バージョン 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

バージョン 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 に含まれる commit については、こちらをご覧ください。

バグの修正

  • ローカルでの開発中にアプリを 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

バージョン 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

バージョン 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 のドキュメント形式を若干修正しました。