Leanback

D-pad 対応のウィジェットとテンプレート フラグメントを使用して、Android TV デバイス向けのアプリを作成します。
最新の更新 現在の安定版リリース 次のリリース候補 ベータ版リリース アルファ版リリース
2021 年 7 月 21 日 - 1.1.0-rc02 - 1.2.0-alpha01

依存関係の宣言

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

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

Groovy

dependencies {
    def leanback_version = "1.2.0-alpha01"

    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-alpha08"

    // 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-alpha01"

    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-alpha08")

    // 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 Leanback-Preference バージョン 1.2.0

バージョン 1.2.0-alpha01

2021 年 7 月 21 日

androidx.leanback:leanback:1.2.0-alpha01androidx.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-rc01androidx.leanback:leanback-preference:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

  • SearchSupportFragment() でのビューのリークを修正しました(6c47a1b/171909417
  • SearchSupportFragment の音声認識機能を任意にしました(4ff949b/169936953

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.refreshCombinedLoadStates.prependCombinedLoadStates.append が更新され、リモート更新が確実に適用されるように、メディエータとソースの両方の読み込み状態が NotLoading になった後で初めて Loading から NotLoading に移行するようになりました。(I65619

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

2020 年 12 月 2 日

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

バグの修正

  • VerticalGridSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。(Iaac69b/171909417
  • BrowseSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。(I34483b/171909417
  • DetailsSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。(Ifec9eb/171909417
  • RowsSupportFragment をバックスタックにプッシュするときのビューのリークを修正しました。(I985d4b/171909417
  • GuidedStepSupportFragment の背景遷移アニメーションを修正しました。(I86d15b/173647688
  • GuidedStepSupportFragment を復元するときの IllegalArgumentException を修正しました。(Ic829fb/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 }
    

    Ib5570b/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-alpha04androidx.leanback:leanback-paging:1.1.0-alpha04androidx.leanback:leanback-preference:1.1.0-alpha04androidx.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-alpha03androidx.leanback:leanback-preference:1.1.0-alpha03 がリリースされました。Leanback バージョン 1.1.0-alpha03 に含まれるコミットはこちらLeanback-Preference バージョン 1.1.0-alpha03 に含まれるコミットはこちらをご覧ください。

新機能

  • 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-alpha02androidx.leanback:leanback-preference:1.1.0-alpha02 がリリースされました。このバージョンに含まれる commit については、leanback のコミットleanback-preference のコミットをご覧ください。

新機能

  • 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 が停止した後のフラグメント トランザクションのクラッシュを修正
  • GuidedStepSupportFragmentVerticalGridView のアイテムをクリップしない(aosp/787396
  • onCreateActionsStylist()onCreateGuidanceStylist() をコンストラクタから GuidedSupportFragment.onCreate() に移動(aosp/787397
  • SearchSupportFragment が結果フラグメントにフォーカスできなかったバグを修正(aosp/798833
  • VerticalGridViewHorizontalGridView のスクロールのバグを修正(aosp/858809

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

新機能

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

API の変更

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