このページは Cloud Translation API によって翻訳されました。

Leanback

API リファレンス
androidx.leanback.app
androidx.leanback.database
androidx.leanback.graphics
androidx.leanback.media
androidx.leanback.preference
androidx.leanback.system
androidx.leanback.widget
androidx.leanback.widget.picker

DPAD 対応のウィジェットとテンプレートフラグメントを使用して、Android TV デバイス向けのアプリを作成します。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2023 年 11 月 15 日	1.0.0	1.1.0-rc02	-	1.2.0-alpha04

依存関係の宣言

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

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

Groovy

dependencies {
    def leanback_version = "1.2.0-alpha04"

    implementation "androidx.leanback:leanback:$leanback_version"

    // leanback-preference is an add-on that provides a settings UI for TV apps.
    implementation "androidx.leanback:leanback-preference:$leanback_version"

    // leanback-paging is an add-on that simplifies adding paging support to a RecyclerView Adapter.
    implementation "androidx.leanback:leanback-paging:1.1.0-alpha11"

    // leanback-tab is an add-on that provides customized TabLayout to be used as the top navigation bar.
    implementation "androidx.leanback:leanback-tab:1.1.0-beta01"
}

Kotlin

dependencies {
    val leanback_version = "1.2.0-alpha04"

    implementation("androidx.leanback:leanback:$leanback_version")

    // leanback-preference is an add-on that provides a settings UI for TV apps.
    implementation("androidx.leanback:leanback-preference:$leanback_version")

    // leanback-paging is an add-on that simplifies adding paging support to a RecyclerView Adapter.
    implementation("androidx.leanback:leanback-paging:1.1.0-alpha11")

    // leanback-tab is an add-on that provides customized TabLayout to be used as the top navigation bar.
    implementation("androidx.leanback:leanback-tab:1.1.0-beta01")
}

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

フィードバック

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

新しい問題を報告する

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

Leanback-Grid バージョン 1.0.0

バージョン 1.0.0-alpha03

2023 年 11 月 15 日

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

依存関係の更新

TV アプリの一般的なクラッシュを修正するために RecyclerView 1.3.2 に依存するように更新しました。（I2c3a0、b/292114537）

バージョン 1.0.0-alpha02

2023 年 9 月 6 日

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

API の変更

フォーカスアウトプロパティをプログラムで設定できるように setFocusOutAllowed を公開しました。（Iebd99）

バグの修正

a11y ノード情報クラス名を設定して、a11y サービスでグリッドがグリッドとして処理されるようにしました。（I12812）
滑らかにスクロールするように落下したときに欠落していたナビゲーション音を追加しました。（f49767）

バージョン 1.0.0-alpha01

2021 年 11 月 17 日

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

新機能

次のクラス / インターフェースを leanback から新しい leanback-grid ライブラリに移動しました: BaseGridView、FacetProvider、FacetProviderAdapter、GridLayoutManager、HorizontalGridView、ItemAlignmentFacet、OnChildLaidOutListener、OnChildSelectedListener、OnChildViewHolderSelectedListener、VerticalGridView、ViewHolderTask、Visibility。この変更により、バイナリの互換性が保持されます。Leanback のグリッド表示コンポーネントのみを使用したいユーザーは、leanback-grid を依存関係として直接使用できます。（If1e49）

Leanback Leanback-Preference バージョン 1.2.0

バージョン 1.2.0-alpha04

2023 年 11 月 15 日

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

バグの修正

（I2c3a0、b/292114537）

依存関係の更新

TV アプリでの一般的なクラッシュを修正するために recyclerview の要件を 1.3.2 に更新しました

バージョン 1.2.0-alpha03

2023 年 9 月 6 日

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

API の変更

AppCompat テーマのサポートを強化するため GuidedActionAppCompatEditText を追加しました。（ab7cf1、dc954d）

バージョン 1.2.0-alpha02

2021 年 11 月 17 日

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

新機能

次のクラス / インターフェースを leanback から新しい leanback-grid ライブラリに移動しました: BaseGridView、FacetProvider、FacetProviderAdapter、GridLayoutManager、HorizontalGridView、ItemAlignmentFacet、OnChildLaidOutListener、OnChildSelectedListener、OnChildViewHolderSelectedListener、VerticalGridView、ViewHolderTask、Visibility。この変更により、バイナリの互換性が保持されます。Leanback のグリッド表示コンポーネントのみを使用したいユーザーは、leanback-grid を依存関係として直接使用できます。（If1e49）

バージョン 1.2.0-alpha01

2021 年 7 月 21 日

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

新機能

Leanback GridLayoutManager を公開し、BaseGridView で交換できるようにしました。（f316b5）

API の変更

Leanback GridLayoutManager を公開し、BaseGridView で交換できるようにしました。（f316b5）

バージョン 1.1.0

Leanback バージョン 1.1.0-rc02

2021 年 7 月 21 日

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

バグの修正

詳細フラグメントの背景のバグを修正しました。（40d8e3）

Leanback Leanback-Preference バージョン 1.1.0-rc01

2021 年 4 月 7 日

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

SearchSupportFragment() でのビューのリークを修正しました（6c47a1、b/171909417）
SearchSupportFragment の音声認識機能を任意にしました（4ff949、b/169936953）

Leanback-Paging バージョン 1.1

バージョン 1.1.0-alpha11

2023 年 11 月 15 日

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

バージョン 1.1.0-alpha10

2023 年 9 月 6 日

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

新機能

leanback-paging を Paging 3.1.0 に更新しました（882ed1）

Leanback-Paging バージョン 1.1.0-alpha09

2021 年 11 月 17 日

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

バグの修正

最新のページング API を使用するように更新しました。

Leanback-Paging バージョン 1.1.0-alpha08

2021 年 7 月 21 日

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

API の変更

.peek() API と .snapshot() API を PagingDataAdapter に追加しました。これにより、ページのフェッチをトリガーしなくても、提示されたデータを検査できるようになります。（Ic8917）

Leanback-Paging バージョン 1.1.0-alpha07

2021 年 1 月 13 日

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

API の変更

コンビニエンスプロパティ CombinedLoadStates.refresh、CombinedLoadStates.prepend、CombinedLoadStates.append が更新され、リモート更新が確実に適用されるように、メディエータとソースの両方の読み込み状態が NotLoading になった後で初めて Loading から NotLoading に移行するようになりました。（I65619）

Leanback Leanback-Preference Leanback-Tab バージョン 1.1.0-beta01

2020 年 12 月 2 日

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

バグの修正

VerticalGridSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。（Iaac69、b/171909417）
BrowseSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。（I34483、b/171909417）
DetailsSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。（Ifec9e、b/171909417）
RowsSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。（I985d4、b/171909417）
GuidedStepSupportFragment の背景遷移アニメーションを修正しました。（I86d15、b/173647688）
GuidedStepSupportFragment を復元するときの IllegalArgumentException を修正しました。（Ic829f、b/172000115）
clearFocus() を行うときの findContainingItemView() における GridLayoutManager NullPointerException を修正しました。（Id0e42）

Leanback-Paging バージョン 1.1.0-alpha06

2020 年 12 月 2 日

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

API の変更

dataRefreshFlow API / dataRefreshListener API は、loadStateFlow / Listener の更新と重複するため、削除されました。移行する場合、loadStateFlow に相当するコードは次のようになります。
```
loadStateFlow.distinctUntilChangedBy { it.refresh }
    .filter { it.refresh is NotLoading }
```
（Ib5570、b/173530908）
replaceWith 句を使用する dataRefreshFlow / Listener メソッドのサポートが完全に終了しました。（I6e2dd）

バージョン 1.1.0-alpha05

2020 年 10 月 1 日

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

新機能

A11Y ナビゲーションは GridLayoutManager focusOutFront と focusOutEnd の属性に準拠するようになりました。（b/161390258）

バグの修正

GuidanceStylist.onDestroyView() でのビューのリークを修正しました。（b/164841457）
GridLayoutManager の ConcatAdapter を修正しました。（b/165694295）
leanback-tab: Javadoc の改善と小規模なコードリファクタリングを行いました。（aosp/1393383）
RecyclerView で同じメソッドのサポートが終了した際に追加された API から setRecyclerView メソッドを削除しました。RecyclerView の新しい API メソッド addRecyclerListener を使用するように leanback ライブラリを更新しました。（I14798）

バージョン 1.1.0-alpha04

2020 年 8 月 11 日

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

新機能

LeanbackTabLayout を使用して、ブラウジングエクスペリエンスでトップナビゲーション（通常はアプリの上部で水平方向に表示）を提供できます。
Leanback のページ分けを使用して、RecyclerView.Adapter にページ分けのサポートを簡単に追加できます。
Leanback 用の appcompat テーマを追加したことにより、モバイルとテレビの単一のコードベースを作成するのが簡単になりました。

API の変更

Leanback ウィジェット用に asyncpagingdatadiffer ベースのアダプタを追加しました。（If0dfe）
Leanback で上部のナビゲーションバーとして使用するカスタムの TabLayout を追加しました。（I1e304）

バージョン 1.1.0-alpha03

2019 年 12 月 18 日

androidx.leanback:leanback:1.1.0-alpha03 と androidx.leanback:leanback-preference:1.1.0-alpha03 がリリースされました。Leanback バージョン 1.1.0-alpha03 に含まれる commit はこちら、Leanback-Preference バージョン 1.1.0-alpha03 に含まれる commit はこちらをご覧ください。

新機能

BaseGridView が、カスタムスクロール速度をサポートするようになりました（aosp/952718）
ガイド付きステップ項目をタッチした場合に使いやすくしました（aosp/1167964）
アプリでレイアウトパスの後にビュー変換を実行できるように BaseGridView の OnLayoutCompleteListener を公開しました。（aosp/1164409）

API の変更

BaseGridView スクロール速度をカスタム設定できる新しい API を追加しました（aosp/952718）
BaseGridView で OnLayoutCompleteListener を追加するための新しい API を追加しました（aosp/1164409）

バグの修正

高速レイアウトパスで子の配置が更新されないというバグを修正しました（aosp/1122745）
フォーカス変更中の Picker ウィジェットにおけるスタックオーバーフローのクラッシュを修正しました（aosp/1168473）

依存関係の変更

Leanback-preference: androidx.preference の依存関係を 1.1.0 に固定しました（aosp/1181902）

バージョン 1.1.0-alpha02

2019 年 5 月 7 日

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

新機能

RowsSupportFragment で、ViewHolders を他の RowsSupportFragment と共有できるようになりました。これにより、複数タブ UI のパフォーマンスが向上します。

API の変更

PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() が追加され、D-pad が押されたときにアプリが再生コントロールの自動非表示 / 表示を無効にできるようになりました。

バグの修正

preference ライブラリの変更により破損した leanback-preference Fragments テーマを修正
SearchEditText で「戻る」キーが押されたときの移動のバグを修正

バージョン 1.1.0-alpha01

2019 年 1 月 30 日

androidx.leanback:leanback 1.1.0-alpha01 がリリースされました。

新機能

PinPicker ウィジェットを追加
RAM の少ないデバイスでは、アウトラインクリッピングがデフォルトで無効になりました。
コントロールを表示する / 非表示にする PlaybackSupportFragment の動作をカスタマイズできるようになりました。（b/122918400）

API の変更

フレームワークフラグメントのサポートが終了しました。
新しい PinPicker クラス

バグの修正

BrowseSupportFragment が停止した後のフラグメントトランザクションのクラッシュを修正
GuidedStepSupportFragment で VerticalGridView のアイテムをクリップしない（aosp/787396）
onCreateActionsStylist() と onCreateGuidanceStylist() をコンストラクタから GuidedSupportFragment.onCreate() に移動（aosp/787397）
SearchSupportFragment が結果フラグメントにフォーカスできないバグを修正しました。（aosp/798833）
VerticalGridView と HorizontalGridView のスクロールのバグを修正（aosp/858809）

androidx.leanback-preference 1.1.0-alpha01 がリリースされました。

新機能

androidx フラグメントクラスを追加しました。フレームワークフラグメントクラスのサポートが終了しました。
色とフォントが、フレームワークのテーマ属性に基づくようになりました。

API の変更

新しい androidx フラグメントクラス。フレームワークフラグメントクラスのサポートが終了しました。