ブラウザ

ブラウザ

ユーザーガイド

API リファレンス
androidx.browser.browseractions
androidx.browser.customtabs
androidx.browser.trusted

ユーザーのデフォルト ブラウザにウェブページを表示します。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2025 年 7 月 2 日	1.8.0	-	1.9.0-beta01	-

依存関係の宣言

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

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

Groovy

dependencies {
    implementation "androidx.browser:browser:1.8.0"
}

Kotlin

dependencies {
    implementation("androidx.browser:browser:1.8.0")
}

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

フィードバック

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

新しい問題を報告する

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

バージョン 1.9

バージョン 1.9.0-beta01

2025 年 7 月 2 日

androidx.browser:browser:1.9.0-beta01 がリリースされました。バージョン 1.9.0-beta01 には、以前のアルファ版からの変更はありません。

バージョン 1.9.0-alpha05

2025 年 6 月 18 日

androidx.browser:browser:1.9.0-alpha05 がリリースされました。バージョン 1.9.0-alpha05 にはこれらの commit が含まれています。

API の変更

• 一時的なブラウジング API から試験運用版アノテーションを削除（If8b1b）

バージョン 1.9.0-alpha04

2025 年 5 月 20 日

androidx.browser:browser:1.9.0-alpha04 がリリースされました。バージョン 1.9.0-alpha04 には、これらの commit が含まれています。

API の変更

• カスタムタブ用の新しいインテント エクストラを追加しました。（I911e0）
• TWADisplayMode に Browser モードと MiminalUi モードを追加しました（I230b5）
• Ephemeral Browsing の機能チェック API を追加しました（I17d42）
• PendingSession API の試験運用版アノテーションを削除しました（Id6fe3）
• Auth Tab の機能チェック API を追加しました（Ifc029）
• カスタムタブの最小化シグナルの試験運用版アノテーションを削除しました（If2b44）

バージョン 1.9.0-alpha03

2025 年 4 月 23 日

androidx.browser:browser:1.9.0-alpha03 がリリースされました。バージョン 1.9.0-alpha03 にはこれらの commit が含まれています。

API の変更

• Auth Tab から試験運用版のアノテーションを削除しました。（I786ff）

バージョン 1.9.0-alpha02

2025 年 4 月 9 日

androidx.browser:browser:1.9.0-alpha02 がリリースされました。バージョン 1.9.0-alpha02 には、これらの commit が含まれています。

新機能

• Launch Handler、Protocol Handler、File Handler など、複数のプログレッシブ ウェブアプリ API のサポートを追加

API の変更

• CustomTabsClient#createPendingAuthTabSession のオーバーロードを追加しました。（I71c3a）
• Auth Tab API を更新しました（Iaf9b1）
• TrustedWebActivityIntent に、ブラウザでこの API を使用できる Launch Handler API クライアント モードが含まれるようになりました。（Ifc95c）
• TrustedWebActivityIntent に、アプリの登録済みインテント フィルタを介して開かれたファイルの URI が含まれるようになり、ブラウザにこれらのファイルに対する読み取り / 書き込み権限が付与されます。（I2134a）
• TrustedWebActivityIntent の extras に、最初に起動された URL が含まれるようになりました。これにより、プロトコル ハンドラで使用される際に、ブラウザにコンテキストが追加されます。（I3759a）
• カスタムタブの閉じるボタンを有効/無効にする新しい API を追加しました。（I35acd）
• Auth Tab に閉じるボタン アイコンのカスタマイズのサポートを追加しました（Iaf877）

バージョン 1.9.0-alpha01

2025 年 1 月 29 日

androidx.browser:browser:1.9.0-alpha01 がリリースされました。バージョン 1.9.0-alpha01 にはこれらの commit が含まれています。

API の変更

• Auth Tab にブラウザ接続/セッションのサポートを追加しました。（I6e47b）
• エフェメラル ブラウジングがサポートされているかどうかを判断する新しい API CustomTabsSession#isEphemeralBrowsingSupported を追加しました（Ie4dea、b/384548523）
• Auth Tab API にカラーパターン パラメータのサポートを追加しました。（I630e1）
• 試験運用版の一時的なブラウジング オプションをカスタムタブに追加しました（I9549d）
• 試験運用版の Auth Tab API を更新しました（I8b674）
• カスタムタブ プロバイダがマルチネットワークをサポートしているかどうかを確認する新しい API を追加。（I4307a）
• マルチネットワークをサポートするために、新しいサービス インテント フィルタ カテゴリを追加。（I4354a）
• カスタムタブで URL を起動する際に、バインドされたネットワークを設定/取得するための新しい API を追加しました。（I493e1）
• 試験運用版の Auth Tab API を追加しました（I9b4d4）
• PendingSession の新しい試験運用版 API（Ib40e5）

バグの修正

• AuthTabIntent の Javadoc を更新しました（I2490c）
• 認証タブのセッション サポートを修正しました（I4e280）
• このライブラリは、型使用である JSpecify nullness アノテーションを使用するようになりました。Kotlin を使用している場合、次のコンパイラ引数を使用して正しい使用法を適用する必要があります。-Xjspecify-annotations=strict（Kotlin コンパイラのバージョン 2.1.0 以降ではこれがデフォルトです）。（Ic7bf5、b/326456246）
• AGP 7.3 以降（R8 バージョン 3.3 など）で R8 を使用する場合、および AGP 8.1 以降（D8 バージョン 8.1 など）ですべてのビルドで、API モデリングを介して自動的に行われるため、新しいプラットフォーム API へのアクセスの手動でのアウトライン設定を削除しました。AGP を使用していないクライアントは、D8 バージョン 8.1 以降に更新することをおすすめします。詳しくは、こちらの記事をご覧ください。（I9496c、b/345472586）

外部からの協力

• 単一の URL に対する複数の IPC 呼び出しを回避するため、新しい IPC 呼び出し ICustomTabsService#prefetchWithMultipleUrls を導入します。（Ie5025）
• CustomTabsSession#prefetch が CustomTabsSession のセッション id(mID) を CustomTabsService に伝播するようにします。（I4ec7b）
• 複数の URL を受け入れるように既存の API をオーバーロードする新しい試験運用版 API CustomTabsSession#prefetch(List<Uri>, PrefetchOptions) を追加します。（I54f35）
• 新しい試験運用版 API CustomTabsSession#prefetch(Uri, PrefetchOptions) を追加しました。これは、今後のナビゲーションのためにメインページ（サブリソースなし）のプリフェッチを試みます。（I340cf）

バージョン 1.8

バージョン 1.8.0

2024 年 3 月 6 日

androidx.browser:browser:1.8.0 がリリースされました。バージョン 1.8.0 にはこれらの commit が含まれています。

1.7.0 以降の重要な変更

• CustomTabsIntent.Builder#setInitialActivityWidthPx を追加しました。これにより、デベロッパーはカスタムタブの初回起動の幅を指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetPosition を追加しました。これにより、デベロッパーはサイドシートとして動作する際のカスタムタブの位置を指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetDecorationType を追加しました。これにより、デベロッパーはサイドシートとして機能しているカスタムタブの装飾タイプを指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition を追加しました。これにより、デベロッパーはカスタムタブがサイドシートとして動作しているときに、角丸の位置を指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled を追加しました。これにより、デベロッパーはカスタムタブがサイドシートとして機能しているときに最大化ボタンを有効または無効にできます。（Ie3564）
• インターフェース CustomTabsCallback に onActivityLayout コールバック メソッドを追加しました。これにより、デベロッパーはカスタムタブが占有している領域の座標と、表示されている状態を知ることができます。これは、カスタムタブが最初に画面に表示されたときと、占有領域が変更されるたびに呼び出されます。（I443f6）
• インターフェース CustomTabsCallback に onWarmupCompleted コールバック メソッドを追加しました。これにより、デベロッパーは CustomTabsClient#warmupfinishes がブラウザ プロセスをウォームアップしているときに知ることができます。（I107cf）
• CustomTabsSession#setEngagementSignalsCallback と CustomTabsSession#isEngagementSignalsApiAvailable の extras にセッション ID を追加しました。（Iba7f1）
• 最小化されたカスタムタブ API の試験運用版のサポートを追加しました。（I67f2d）

バージョン 1.8.0-rc01

2024 年 2 月 21 日

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

バージョン 1.8.0-beta02

2024 年 2 月 7 日

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

API の変更

• CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization の名前を CustomTabsIntent Builder#setActivitySideSheetMaximizationEnabled に変更し、公開 API にしました。これにより、カスタムタブがサイドシートとして機能しているときに、デベロッパーが最大化ボタンを有効または無効にできます。（Ie3564）

バージョン 1.8.0-beta01

2023 年 11 月 29 日

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

新機能

• 最小化されたカスタムタブ API の試験運用版サポートを追加しました。（I67f2d）

バージョン 1.8.0-alpha01

2023 年 11 月 15 日

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

新機能

• CustomTabsIntent.Builder#setInitialActivityWidthPx を追加しました。これにより、デベロッパーはカスタムタブの初回起動の幅を指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetBreakpointDp を追加しました。これにより、デベロッパーはカスタムタブがサイドシートとして機能するための最小ウィンドウ幅を指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetPosition を追加しました。これにより、デベロッパーはサイドシートとして動作する際のカスタムタブの位置を指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization を追加しました。これにより、デベロッパーはカスタムタブがサイドシートとして機能しているときに最大化ボタンを有効または無効にできます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetDecorationType を追加しました。これにより、デベロッパーはサイドシートとして機能しているカスタムタブの装飾タイプを指定できます。（I443f6）
• CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition を追加しました。これにより、デベロッパーはカスタムタブがサイドシートとして動作しているときに、角丸の位置を指定できます。（I443f6）
• インターフェース CustomTabsCallback に onActivityLayout コールバック メソッドを追加しました。これにより、デベロッパーはカスタムタブが占有している領域の座標と、表示されている状態を知ることができます。これは、カスタムタブが最初に画面に表示されたときと、占有領域が変更されるたびに呼び出されます。（I443f6）
• インターフェース CustomTabsCallback に onWarmupCompleted コールバック メソッドを追加しました。これにより、デベロッパーは CustomTabsClient#warmup がブラウザ プロセスのウォームアップを完了したときに知ることができます。（I107cf）

バグの修正

• CustomTabsSession#setEngagementSignalsCallback と CustomTabsSession#isEngagementSignalsApiAvailable の extras にセッション ID を追加しました。（Iba7f1）

バージョン 1.7

バージョン 1.7.0

2023 年 11 月 15 日

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

1.6.0 以降の重要な変更

• オーバーフロー メニューのブックマーク ボタンを有効にする CustomTabsIntent.Builder#setBookmarksButtonEnabled を追加しました。（Ia792e）
• オーバーフロー メニューのダウンロード ボタンを有効にする CustomTabsIntent.Builder#setDownloadButtonEnabled を追加しました。（Ia792e）
• 外部ハンドラ アプリに初期 URL を送信できるようにする CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled を追加しました。（Ia792e）
• 翻訳 UI をトリガーするターゲット言語を指定する CustomTabsIntent.Builder#setTranslateLanguage を追加しました。（Ia792e）
• 部分的なカスタムタブが起動されたときに、バックグラウンド アプリとのやり取りを可能にする CustomTabsIntent.Builder#setBackgroundInteractionEnabled を追加しました。（Ia792e）
• カスタムタブが呼び出し元の ID を取得できるようにする CustomTabsIntent.Builder#setShareIdentityEnabled を追加しました。（I7bf2b）
• ユーザーが下部のツールバーから上にスワイプしたときに送信される PendingIntent を設定する CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture を追加しました。（Id42a2）

バージョン 1.7.0-rc01

2023 年 11 月 1 日

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

• alpha-01 からの変更はありません

バージョン 1.7.0-beta01

2023 年 10 月 18 日

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

バージョン 1.7.0-alpha01

2023 年 10 月 4 日

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

新機能

• オーバーフロー メニューのブックマーク ボタンを有効にする CustomTabsIntent.Builder#setBookmarksButtonEnabled を追加しました。（Ia792e）
• オーバーフロー メニューのダウンロード ボタンを有効にする CustomTabsIntent.Builder#setDownloadButtonEnabled を追加しました。（Ia792e）
• 外部ハンドラ アプリに初期 URL を送信できるようにする CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled を追加しました。（Ia792e）
• 翻訳 UI をトリガーするターゲット言語を指定する CustomTabsIntent.Builder#setTranslateLanguage を追加しました。（Ia792e）
• 部分的なカスタムタブが起動されたときに、バックグラウンド アプリとのやり取りを可能にする CustomTabsIntent.Builder#setBackgroundInteractionEnabled を追加しました。（Ia792e）
• カスタムタブが呼び出し元の ID を取得できるようにする CustomTabsIntent.Builder#setShareIdentityEnabled を追加しました。（I7bf2b）
• ユーザーが下部のツールバーから上にスワイプしたときに送信される PendingIntent を設定する CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture を追加しました。（Id42a2）

バージョン 1.6

バージョン 1.6.0

2023 年 8 月 9 日

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

バージョン 1.6.0-rc01

2023 年 7 月 26 日

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

バージョン 1.6.0-beta01

2023 年 6 月 21 日

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

バージョン 1.6.0-alpha02

2023 年 6 月 7 日

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

API の変更

• CustomTabsSession#getGreatestScrollPercentage を削除しました。（I6c5ba）
• ターゲット オリジンを指定できる新しい requestPostMessageChannel API を追加しました。これにより、ユーザーはメッセージが想定したウェブサイトにのみ配信されることを確認できます。（Id5b7f）

バグの修正

• EngagementSignalsCallback のドキュメントを更新しました。（Ie833c）

バージョン 1.6.0-alpha01

2023 年 5 月 3 日

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

新機能

• エンゲージメント シグナル API を追加しました。これにより、デベロッパーは、スクロールなどのウェブページのユーザー操作に関するコールバックを受信できます。（I835e6）

API の変更

• エンゲージメント シグナル API を更新し、カスタムタブの実装側の API サーフェスを簡素化しました。（Iaa6dc）

バージョン 1.5

バージョン 1.5.0

2023 年 2 月 8 日

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

1.4.0 以降の重要な変更

• CustomTabsIntent.Builder#setInitialActivityHeightPx を追加しました。これにより、デベロッパーはカスタムタブの初回起動の高さを指定できます。また、オプションでサイズ変更動作を指定できます（固定またはサイズ変更可能）。（I48bd3）
• CustomTabsIntent.Builder#setToolbarCornerRadiusDp を追加しました。これにより、デベロッパーはツールバーの上隅角の丸みのサイズを指定できます。（I48bd3）
• CustomTabsIntent.Builder#setCloseButtonPosition を追加しました。これにより、デベロッパーはツールバーの閉じるボタンの位置を設定できます。（I48bd3）
• インターフェース CustomTabsCallback に onActivityResized コールバック メソッドを追加しました。これにより、デベロッパーはカスタムタブのサイズ変更が発生したときに知ることができます。（Ic864e）
• CustomTabsCallback API の一部を非同期にしました。（Ic86df）
• Android のアプリごとの言語エクスペリエンスに合わせて、Accept-Language の現在のアプリの言語がデフォルトで入力されます。（I3d1d7）
• SDK 33 以降で POST_NOTIFICATIONS 権限を付与する必要がある API に @RequiresPermission を追加しました。これは内部ブランチで開発されました。b/238790278 を参照してください。

バージョン 1.5.0-rc01

2023 年 1 月 25 日

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

• 1.5.0-beta01 からの変更はありません。

バージョン 1.5.0-beta01

2023 年 1 月 11 日

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

• 1.5.0-alpha02 からの変更はありません。

バージョン 1.5.0-alpha02

2022 年 12 月 7 日

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

API の変更

• CustomTabsCallback#onActivityResized の動作を変更し、新しいパラメータを追加しました。
• EXTRA_ACTIVITY_RESIZE_BEHAVIOR の名前を EXTRA_ACTIVITY_RESIZE_HEIGHT_BEHAVIOR に変更し、高さに関するものであることをより明確にしました。（Ic864e）
• CustomTabsCallback API の一部を非同期にしました。（Ic86df）

バージョン 1.5.0-alpha01

2022 年 10 月 24 日

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

新機能

• CustomTabsIntent.Builder#setInitialActivityHeightPx を追加しました。これにより、デベロッパーはカスタムタブの初回起動の高さを指定できます。また、オプションでサイズ変更動作を指定できます（固定またはサイズ変更可能）。（I48bd3）
• CustomTabsIntent.Builder#setToolbarCornerRadiusDp を追加しました。これにより、デベロッパーはツールバーの上隅角の丸みのサイズを指定できます。（I48bd3）
• CustomTabsIntent.Builder#setCloseButtonPosition を追加しました。これにより、デベロッパーはツールバーの閉じるボタンの位置を設定できます。（I48bd3）
• CustomTabsCallback インターフェースに onActivityResized コールバック メソッドを追加しました。これにより、デベロッパーはカスタムタブのサイズ変更（画面全体の高さまで最大化されるか、初回起動の高さまで最小化される）が発生したときにそれを知ることができます。（Id99ce）
• Android のアプリごとの言語エクスペリエンスに合わせて、Accept-Language の現在のアプリの言語がデフォルトで入力されます。（I3d1d7）

API の変更

• SDK 33 以降で POST_NOTIFICATIONS 権限を付与する必要がある API に @RequiresPermission を追加しました。これは内部ブランチで開発されました。b/238790278 を参照してください。

バージョン 1.4.0

バージョン 1.4.0

2021 年 11 月 3 日

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

1.3.0 以降の重要な変更

• Android 12 との互換性のために、PendingIntent を PendingIntent.FLAG_IMMUTABLE としてマークしました。

バージョン 1.4.0-rc01

2021 年 10 月 13 日

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

バージョン 1.4.0-beta01

2021 年 9 月 29 日

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

バージョン 1.4.0-alpha01

2021 年 9 月 15 日

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

バグの修正

• Android 12 との互換性のために、PendingIntent を PendingIntent.FLAG_IMMUTABLE としてマークしました。

バージョン 1.3.0

バージョン 1.3.0

2020 年 12 月 2 日

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

1.2.0 以降の主要な機能

• TrustedWebActivityServiceConnection#sendExtraCommand を呼び出すことにより、ブラウザから Trusted Web Activity クライアントに自由形式のコマンドを渡せるようになりました。クライアントは、そうしたコマンドを TrustedWebActivityService#onExtraCommand で処理できます。
• Trusted Web Activity クライアントがブラウザにデータを返すために使用できる TrustedWebActivityCallback インターフェースを追加しました。
• CustomTabsIntent#setShareState を追加しました。これにより、デベロッパーは共有オプションを表示するかどうか（またはブラウザにまかせるか）を指定できます。
• デベロッパーは、TrustedWebActivityIntentBuilder で setScreenOrientation メソッドを使用して、デフォルトの画面の向きを設定できるようになりました。
• ナビゲーション バーの分割線の色の変更をサポートするため、setNavigationBarDividerColor メソッドを CustomTabColorSchemeParams に追加しました。
• サポートが終了した #setNavigationBarColor、#setNavigationBarDividerColor、#setToolbarColor、および #setSecondaryToolbarColor メソッドに代えて、CustomTabsIntent.Builder#setDefaultColorSchemeParams メソッドを追加しました。
• CustomTabsClient#bindCustomTabsServicePreservePriority メソッドを追加しました。これにより、Context.BIND_WAIVE_PRIORITY フラグを使用せずにカスタムタブ サービスに接続できるようになりました。

バージョン 1.3.0-rc01

2020 年 11 月 11 日

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

バージョン 1.3.0-beta01

2020 年 10 月 28 日

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

API の変更

• bindCustomTabServicePreservePriority の名前が bindCustomTabsServicePreservePriority に変更されました。（I29ac1）

バグの修正

• MissingGetterMatchingBuilder の API lint チェックが androidx で有効になりました（I4bbea、b/138602561）

バージョン 1.3.0-alpha06

2020 年 10 月 1 日

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

新機能

• CustomTabsIntent#setShareState を追加しました。これにより、デベロッパーは共有状態を有効、無効、ブラウザの指定に従う、のいずれかに設定できるようになります。（I153fe）
• サポートが終了した #setNavigationBarColor、#setNavigationBarDividerColor、#setToolbarColor、#setSecondaryToolbarColor メソッドの代わりに使用できる、CustomTabsIntent.Builder#setDefaultColorSchemeParams を追加しました。（I09012）

API の変更

• StaticFinalBuilder の API lint チェックが androidx で有効になりました（I2b11b、b/138602561）
• extraCommand が成功したことを示すために使用できる CustomTabsService#KEY_SUCCESS と TrustedWebActivityService#KEY_SUCCESS を追加しました。（I6f7b5）

バージョン 1.3.0-alpha05

2020 年 8 月 5 日

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

新機能

• 起動済みの Trusted Web Activity の向きを設定できるようになりました。
• Trusted Web Activity とカスタムタブのナビゲーション バーの分割線の色を設定できるようになりました。

API の変更

• setScreenOrientation メソッドを TrustedWebActivityIntentBuilder に追加しました。
• ロックタイプを表す ScreenOrientation.LockType 用の @IntDef を追加しました。（I802d2）
• setNavigationBarDividerColor メソッドを TrustedWebActivityIntentBuilder と CustomTabColorSchemeParams に追加しました。（Ia04dd）
  • カラーパターンを取得する TrustedWebActivityIntentBuilder のメソッドに @IntDef を追加しました。

バージョン 1.3.0-alpha04

2020 年 6 月 24 日

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

新機能

• CustomTabsClient#bindCustomTabServicePreservePriority メソッドが追加されました。そのため、Context.BIND_WAIVE_PRIORITY フラグを使用せずにカスタムタブ サービスに接続できるようになりました。

バージョン 1.3.0-alpha03

2020 年 6 月 10 日

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

新機能

• Trusted Web Activity クライアントがブラウザにデータを返すために使用できる TrustedWebActivityCallback インターフェースを追加しました。（I64dbb）

API の変更

• TrustedWebActivityServiceConnection.extraCommand は、@Nullable の TrustedWebActivityCallback パラメータも受け取るようになりました。バンドル パラメータは @Nullable ではなく @NonNull とマークされるようになりました。（I64dbb）
• TrustedWebActivityServiceConnection.extraCommand メソッドの名前が sendExtraCommand に変更されました。（Id29a8）
• CustomTabsIntent.Builder#addDefaultShareMenuItem() を非推奨とし、新しい #setDefaultShareMenuItemEnabled(boolean) に置き換えました。また、CustomTabsIntent.Builder#enableUrlBarHiding() を非推奨とし、新しい #setUrlBarHidingEnabled(boolean) に置き換えました。（Iad702）

バージョン 1.3.0-alpha01

2020 年 1 月 8 日

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

新機能

• TrustedWebActivityServiceConnection#extraCommand を呼び出すことで、ブラウザから Trusted Web Activity のクライアントに自由形式のコマンドを渡せます。クライアントはそうしたコマンドを TrustedWebActivityService#onExtraCommand で処理します。

API の変更

• CustomTabsSession#mayLauncherUrl に提供して CustomTabsService#mayLaunchUrl で受け取る URL を @Nullable にしました。

バージョン 1.2.0

バージョン 1.2.0

2019 年 12 月 18 日

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

1.0.0 以降の主な変更

• Trusted Web Activity
  • Trusted Web Activity のサポートが安定版になりました。
  • TrustedWebActivityIntent のカスタマイズと作成に TrustedWebActivityIntentBuilder を使用して、Trusted Web Activity を起動できます。
  • TrustedWebActivityService を含めるか拡張することで、クライアントがブラウザから渡されたウェブプッシュ通知を表示できるようになります。
  • ブラウザで TrustedWebActivityServiceConnectionPool を使用して、クライアントで TrustedWebActivityService に接続できます。TrustedWebActivityServiceConnection はそのような接続を表します。
  • Trusted Web Activity を起動して、Web Share Target に情報を提供できます。
• ダークテーマ
  • デベロッパーは CustomTabColorSchemeParams を介して、デバイスがライトモードまたはダークモードのときに使用する、異なるテーマカラーを提供できます。
  • デベロッパーは、ブラウザ自体のライトモードまたはダークモードをリクエストできます。
• セッションの再開
  • ID を指定して CustomTabsSession を作成すると、同じクライアントと ID による後続のカスタムタブの起動をマージできます。
• ナビゲーション バーの色は、カスタムタブで指定できます。
• ブラウザ アクション関連のクラスは、機能がほとんど利用されていないため非推奨としました。ライブラリの将来のバージョンで削除される予定です。

バージョン 1.2.0-rc01

2019 年 12 月 4 日

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

バグの修正

• コードサンプルの Javadoc 形式が修正されました。

バージョン 1.2.0-beta01

2019 年 11 月 20 日

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

バージョン 1.2.0-alpha09

2019 年 10 月 23 日

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

新機能

• Token クラスをパッケージの識別情報を表すのに使用できます。これには、パッケージ名と、パッケージの署名証明書の署名の両方が含まれます。
  • 永続化のために byte [] にシリアル化されるように設計されています。
  • TrustedWebActivityService が使用して、どのような TWA プロバイダが接続できるかを判断します。
  • TWA プロバイダが TrustedWebActivityConnectionPool で使用して、どのパッケージへの接続が有効かを判断します。
• TokenStore インターフェースを TrustedWebActivityService が使用して、どのアプリが接続できるかを判断するようになりました。
  • TokenStore#store の呼び出しはクライアント次第であり、TrustedWebActivityService は Token を読み込むだけです。
• TrustedWebActivityServiceConnectionPool（以前の TrustedWebActivityServiceConnectionManager）は、検証済みパッケージ セットを保存しなくなりました。
  • registerClient と getVerifiedPackages を削除しました。
  • 検証済みパッケージのコレクションは、手動で execute（以前の connect）と serviceExistsForScope に提供されます。
• TrustedWebActivityService は検証済みのプロバイダの保存をオーバーライド クラスにデリゲートします。
  • setVerifiedProvider を削除しました。
  • クライアントは、Token の保存と取得に使用できる TokenStore を返す getTokenStore を実装する必要があります。

API の変更

• TrustedWebActivityServiceConnectionManager クラス
  • TrustedWebActivityServiceConnectionPool と呼ばれるようになりました。
  • 今回が最終版です。
  • パブリック コンストラクタの代わりに、静的な create メソッドで作成されます。
• TrustedWebActivityService クラス
  • オーバーライド可能なメソッドにスレッド アノテーションがあります。
• TrustedWebActivityServiceWrapper クラス
  • TrustedWebActivityServiceConnection と呼ばれるようになりました。
  • 今回が最終版です。
  • RuntimeExceptions でラップせずに、未加工の RemoteExceptions をスローするようになりました。
• ShareTarget#FileFormField クラスは今回が最終版です。
• TrustedWebUtils#splashScreensAreSupported メソッドの名前が areSplashScreensSupported に変更されました。
• TrustedWebActivityIntentBuilder#getUrl メソッドの名前が TrustedWebActivityIntentBuilder#getUri に変更されました。
• SplashScreenParamKey の静的フィールドにプレフィックス KEY_ が付きました。

バージョン 1.2.0-alpha08

2019 年 9 月 18 日

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

注: このバージョンは Java 8 プログラミング言語に依存しています。プロジェクトで Java 8 言語を使用する方法については、Java 8 言語機能の使用をご覧ください。

新機能

• 信頼できるウェブ アクティビティ用の新しい Share Target API を導入しました。Trusted Web Activity を使用するアプリは、プロトコル https://wicg.github.io/web-share-target/level-2/ で定義される Web Share Target にデータを送信できるようになりました（aosp/I47b93、aosp/I0ec3e）

API の変更

• コールバック extraCallbackWithResult を ICustomTabsCallback に追加しまし （aosp/Ic2cc2 ）
• CustomTabsSession メソッドの一部のパラメータに Nullable または NonNull のマークを付けました（aosp/Iec460）
• TrustedWebActivityIntentBuilder は未加工のインテントではなく TrustedWebActivityIntent を作成するようになりました（aosp/I03fb6）

バグの修正

• CustomTabsClient は必要に応じて以前の requestPostMessageChannel を使用するようになりました（aosp/Ibb324）
• CustomTabsSessionToken#equals を修正しました（aosp/I7f249）
• CustomTabsClient は可能であれば以前の newSession を使用するようになりました（aosp/Ie27dc）

外部からの協力

• MinMaxConstant の API lint チェックが androidx で有効になりました（aosp/I29b78）（b/138602561）

バージョン 1.2.0-alpha07

2019 年 8 月 7 日

注: このバージョンは Java 8 プログラミング言語に依存しています。プロジェクトで Java 8 言語を使用する方法については、Java 8 言語機能の使用をご覧ください。

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

注: このバージョンは Java 8 プログラミング言語に依存しています。プロジェクトで Java 8 言語を使用する方法については、Java 8 言語機能の使用をご覧ください。

新機能

• ダークテーマ

  • 開発者は、デバイスがダークモードのときに使用するテーマカラーを提供できます。
  • 開発者は、起動したブラウザをダークモードにするかライトモードにするかをオーバーライドすることもできます。
  • ナビゲーション バーの色は、カスタムタブで指定できます。

• Trusted Web Activity

  • TrustedWebActivityBuilder を使用すると、Trusted Web Activity を簡単に作成して起動できます。
  • TrustedWebActivityService と関連クラスを使用すると、プロバイダと通信でき、リンクされたウェブサイトのウェブプッシュ通知を受け入れ、クライアント アプリから通知を表示します。API のこの部分は変更される可能性があります。

• カスタムタブ セッション ID

  • ID を使用してカスタムタブ セッションを作成できるようになり、同じアプリケーションが同じ ID で起動した 2 つのセッションをマージできるようになりました。

API の変更

• ブラウザ アクション関連のクラスとメソッドは非推奨となりました。この機能には大きな期待を寄せていましたが、残念ながら結局ほとんどの人が使用せず、サポートを提供したブラウザは 1 つだけでした。コードと API を簡素化するためにサポートを終了します。

バージョン 1.0.0

バージョン 1.0.0

2018 年 9 月 21 日

browser-1.0.0 がリリースされました。