Leanback

请使用 Compose for TV 而非此工件。
最新更新 稳定版 候选发布版 Beta 版 Alpha 版
2025 年 4 月 23 日 1.2.0 - - -

声明依赖项

要添加对 Leanback 的依赖项，您必须将 Google Maven 代码库添加到您的项目中。如需了解详情，请阅读Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项

Groovy

dependencies {
    def leanback_version = "1.2.0"

    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"

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

Kotlin

dependencies {
    val leanback_version = "1.2.0"

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

    // 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")
}

如需了解有关依赖项的更多信息，请参阅添加构建依赖项。

反馈

您的反馈有助于改进 Jetpack。如果您发现了新问题或对改进此库有任何建议，请告诉我们。在创建新问题之前，请查看此库中的现有问题。您可以点击星形按钮为您关注的现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

Leanback-Grid 版本 1.0.0

版本 1.0.0

2025 年 4 月 23 日

androidx.leanback:leanback-grid:1.0.0 已发布。此版本不包含任何更改，仅将其移至稳定版。

版本 1.0.0-rc01

2025 年 4 月 9 日

androidx.leanback:leanback-grid:1.0.0-rc01 已发布。此版本没有任何重大提交，仅将库移至稳定版。

版本 1.0.0-alpha03

2023 年 11 月 15 日

androidx.leanback:leanback-grid:1.0.0-alpha03 已发布。版本 1.0.0-alpha03 包含这些提交。

依赖项更新

版本 1.0.0-alpha02

2023 年 9 月 6 日

androidx.leanback:leanback-grid:1.0.0-alpha02 已发布。版本 1.0.0-alpha02 包含这些提交。

API 更改

  • 将 setFocusOutAllowed 设为公共方法，以便通过编程方式设置焦点退出属性。(Iebd99)

Bug 修复

  • 通过设置无障碍节点信息类名称，确保无障碍服务将网格视为网格。(I12812)
  • 修复平滑滚动时缺少导航音的问题。(f49767)

版本 1.0.0-alpha01

2021 年 11 月 17 日

androidx.leanback:leanback-grid:1.0.0-alpha01 已发布。版本 1.0.0-alpha01 包含这些提交。

新功能

  • 将以下类/接口从 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

2025 年 4 月 23 日

androidx.leanback:leanback:1.2.0 和 androidx.leanback:leanback-preference:1.2.0 已发布。此版本不包含任何更改，仅将其移至稳定版。

版本 1.2.0-rc01

2025 年 4 月 9 日

androidx.leanback:leanback:1.2.0-rc01 和 androidx.leanback:leanback-preference:1.2.0-rc01 已发布。此版本没有任何重大提交，仅将库移至稳定版。

版本 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 包含这些提交。

Bug 修复

依赖项更新

  • 将 recyclerview 要求更新到 1.3.2，以修复 TV 应用中的常见崩溃

版本 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 包含这些提交。

API 更改

  • 添加了 GuidedActionAppCompatEditText 以更好地支持 AppCompat 主题。(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 包含这些提交。

新功能

  • 将以下类/接口从 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 包含这些提交。

新功能

  • 使 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 包含这些提交。

Bug 修复

  • 修复了详情片段背景错误。(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 包含这些提交。

  • 修复了 SearchSupportFragment() 中的视图内存泄漏问题。(6c47a1, b/171909417)
  • 使 SearchSupportFragment 的语音识别器成为可选。(4ff949,b/169936953)

Leanback-Paging 版本 1.1

版本 1.1.0

2025 年 4 月 23 日

androidx.leanback:leanback-paging:1.1.0 和 androidx.leanback:leanback-tab:1.1.0 已发布。此版本不包含任何更改，仅将其移至稳定版。

版本 1.1.0-rc01

2025 年 4 月 9 日

androidx.leanback:leanback-paging:1.1.0-rc01 和 androidx.leanback:leanback-tab:1.1.0-rc01 已发布。此版本没有任何重大提交，仅将库移至稳定版。

版本 1.1.0-alpha11

2023 年 11 月 15 日

androidx.leanback:leanback-paging:1.1.0-alpha11 已发布，无任何更改。版本 1.1.0-alpha11 包含这些提交。

版本 1.1.0-alpha10

2023 年 9 月 6 日

androidx.leanback:leanback-paging:1.1.0-alpha10 已发布。版本 1.1.0-alpha10 包含这些提交。

新功能

  • 将 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 包含这些提交。

Bug 修复

  • 更新为使用最新的分页 API。

Leanback-Paging 版本 1.1.0-alpha08

2021 年 7 月 21 日

androidx.leanback:leanback-paging:1.1.0-alpha08 已发布。版本 1.1.0-alpha08 包含这些提交。

API 更改

  • 向 PagingDataAdapter 添加了 .peek() 和 .snapshot() API，允许检查呈现的数据而不触发页面获取。(Ic8917)

Leanback-Paging 版本 1.1.0-alpha07

2021 年 1 月 13 日

androidx.leanback:leanback-paging:1.1.0-alpha07 已发布。版本 1.1.0-alpha07 包含这些提交。

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 包含这些提交。

Bug 修复

  • 修复将 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() 时 GridLayoutManager 在 findContainingItemView() 中出现的 NullPointerException 错误。(Id0e42)

Leanback-Paging 版本 1.1.0-alpha06

2020 年 12 月 2 日

androidx.leanback:leanback-paging:1.1.0-alpha06 已发布。版本 1.1.0-alpha06 包含这些提交。

API 更改

  • dataRefreshFlow / 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 包含这些提交。

新功能

  • 让 A11Y 导航尊重 GridLayoutManager 的 focusOutFront 和 focusOutEnd 属性。(b/161390258)

Bug 修复

  • 修复 GuidanceStylist.onDestroyView() 中的视图内存泄漏问题。(b/164841457)
  • 修复 GridLayoutManager 中的 ConcatAdapter 问题。(b/165694295)
  • leanback-tab：Javadoc 改进和少量代码重构 (aosp/1393383)
  • 从 API 中移除了 setRecyclerView 方法，该方法是在 RecyclerView 上弃用相同方法时添加的。更新 leanback 库以使用 RecyclerView 的新 addRecyclerListener API 方法。(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 包含这些提交。

新功能

  • LeanbackTabLayout 提供了浏览体验中的顶部导航（通常水平显示在应用顶部）。
  • 适用于 Leanback 的 Paging 简化了向 RecyclerView.Adapter 添加分页支持的操作。
  • 为 leanback 添加了 appcompat 主题，这将简化移动设备和 TV 之间单一代码库的创建。

API 更改

  • 为 leanback 微件添加了基于 asyncpagingdatadiffer 的适配器 (If0dfe)
  • 添加了自定义的 TabLayout，用作 leanback 中的顶部导航栏 (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 包含这些提交，Leanback-Preference 版本 1.1.0-alpha03 包含这些提交。

新功能

  • BaseGridView 现在支持自定义滚动速度 (aosp/952718)
  • 使引导步骤项触摸更友好 (aosp/1167964)
  • 公开了 BaseGridView OnLayoutCompleteListener，以便应用在布局过程后执行 View 转换。(aosp/1164409)

API 更改

  • 添加了新 API 以允许自定义 BaseGridView 滚动速度 (aosp/952718)
  • 添加了新 API 以在 BaseGridView 中添加 OnLayoutCompleteListener (aosp/1164409)

Bug 修复

  • 修复了快速布局传递不更新子项对齐方式的错误。(aosp/1122745)
  • 修复了当焦点改变时，选择器微件中出现的堆栈溢出崩溃。(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 已发布。此版本包含的提交内容可在leanback 提交和leanback-preference 提交中查看。

新功能

  • RowsSupportFragment 现在允许与其他 RowsSupportFragment 共享 ViewHolder，这将提高多标签页 UI 的性能。

API 更改

  • 添加了 PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() 以允许应用在按下方向键时禁用自动隐藏/显示播放控件。

Bug 修复

  • 修复了由于偏好设置库更改而导致的 leanback-preference Fragments 主题损坏问题。
  • 修复在 SearchEditText 上按下 BACK 键时的导航错误

版本 1.1.0-alpha01

2019 年 1 月 30 日

androidx.leanback:leanback 1.1.0-alpha01 已发布。

新功能

  • 添加了 PinPicker 微件。
  • 现在，在低内存设备上，轮廓剪裁默认禁用。
  • 允许自定义 PlaybackSupportFragment 显示/隐藏控件的行为 (b/122918400)

API 更改

  • 框架片段已弃用。
  • 新的 PinPicker 类。

Bug 修复

  • 修复了 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 片段类，框架片段类已弃用。