Leanback

Escribe apps para dispositivos Android TV con widgets y fragmentos de plantillas compatibles con el Dpad.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
15 de noviembre de 2023 1.0.0 1.1.0-rc02 - 1.2.0-alpha04

Cómo declarar dependencias

Para agregar una dependencia en Leanback, debes agregar el repositorio Maven de Google a tu proyecto. Consulta el repositorio Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Leanback-Grid versión 1.0.0

Versión 1.0.0-alpha03

15 de noviembre de 2023

Lanzamiento de androidx.leanback:leanback-grid:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Actualizaciones de dependencias

Versión 1.0.0-alpha02

6 de septiembre de 2023

Lanzamiento de androidx.leanback:leanback-grid:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Cambios en la API

  • setFocusOutAllowed se hizo público para permitir que las propiedades de enfoque se establezcan de manera programática. (Iebd99).

Correcciones de errores

  • Para garantizar que las cuadrículas se traten como tales por servicios de a11y, configura un nombre de clase de información de nodo de a11y (I12812).
  • Se agregó el sonido de navegación faltante durante una caída para desplazamiento suave. (f49767).

Versión 1.0.0-alpha01

17 de noviembre de 2021

Lanzamiento de androidx.leanback:leanback-grid:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • Se movieron las siguientes interfaces y clases de leanback a la nueva biblioteca de leanback-grid: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask y Visibility. Este cambio conserva la compatibilidad binaria. Cualquier persona que desee usar solo los componentes de la vista de cuadrícula de Leanback puede usar directamente leanback-grid como una dependencia. (If1e49)

Leanback Leanback-Preference versión 1.2.0

Versión 1.2.0-alpha04

15 de noviembre de 2023

Lanzamiento de androidx.leanback:leanback:1.2.0-alpha04 y androidx.leanback:leanback-preference:1.2.0-alpha04. La versión 1.2.0-alpha04 contiene estas confirmaciones.

Correcciones de errores

Actualización de dependencia

  • Se actualizó el requisito de recyclerview a la versión 1.3.2 para corregir una falla común en apps para TV.

Versión 1.2.0-alpha03

6 de septiembre de 2023

Lanzamiento de androidx.leanback:leanback:1.2.0-alpha03 y androidx.leanback:leanback-preference:1.2.0-alpha03. La versión 1.2.0-alpha03 contiene estas confirmaciones.

Cambios en la API

  • Se agregó GuidedActionAppCompatEditText para mejorar la compatibilidad con el tema AppCompat. (ab7cf1, dc954d).

Versión 1.2.0-alpha02

17 de noviembre de 2021

Lanzamiento de androidx.leanback:leanback:1.2.0-alpha02 y androidx.leanback:leanback-preference:1.2.0-alpha02. La versión 1.2.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

  • Se movieron las siguientes interfaces y clases de leanback a la nueva biblioteca de leanback-grid: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask y Visibility. Este cambio conserva la compatibilidad binaria. Cualquier persona que desee usar solo los componentes de la vista de cuadrícula de Leanback puede usar directamente leanback-grid como una dependencia. (If1e49)

Versión 1.2.0-alpha01

21 de julio de 2021

Lanzamiento de androidx.leanback:leanback:1.2.0-alpha01 y androidx.leanback:leanback-preference:1.2.0-alpha01. La versión 1.2.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • GridLayoutManager de Leanback ahora es intercambiable y público en BaseGridView. (f316b5)

Cambios en la API

  • GridLayoutManager de Leanback ahora es intercambiable y público en BaseGridView. (f316b5)

Versión 1.1.0

Leanback versión 1.1.0-rc02

21 de julio de 2021

Lanzamiento de androidx.leanback:leanback:1.1.0-rc02. La versión 1.1.0-rc02 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió el error del fragmento de detalles en segundo plano. (40d8e3)

Leanback Leanback-Preference versión 1.1.0-rc01

7 de abril de 2021

Lanzamiento de androidx.leanback:leanback:1.1.0-rc01 y androidx.leanback:leanback-preference:1.1.0-rc01. La versión 1.1.0-rc01 contiene estas confirmaciones.

  • Se corrigieron las pérdidas de vista en SearchSupportFragment() (6c47a1, b/171909417)
  • Se permitió el reconocimiento de voz opcional para SearchSupportFragment. (4ff949,b/169936953)

Leanback-Paging versión 1.1

Versión 1.1.0-alpha11

15 de noviembre de 2023

Se lanzó androidx.leanback:leanback-paging:1.1.0-alpha11 sin cambios. La versión 1.1.0-alpha11 contiene estas confirmaciones.

Versión 1.1.0-alpha10

6 de septiembre de 2023

Lanzamiento de androidx.leanback:leanback-paging:1.1.0-alpha10. La versión 1.1.0-alpha10 contiene estas confirmaciones.

Nuevas funciones

  • Actualiza Leanback-paging a Paging 3.1.0. (882ed1).

Leanback-Paging versión 1.1.0-alpha09

17 de noviembre de 2021

Lanzamiento de androidx.leanback:leanback-paging:1.1.0-alpha09. La versión 1.1.0-alpha09 contiene estas confirmaciones.

Correcciones de errores

  • Se realizó una actualización para usar las API de Paging más recientes.

Leanback-Paging versión 1.1.0-alpha08

21 de julio de 2021

Lanzamiento de androidx.leanback:leanback-paging:1.1.0-alpha08. La versión 1.1.0-alpha08 contiene estas confirmaciones.

Cambios en la API

  • Se agregaron las API de .peek() y .snapshot() a PagingDataAdapter, lo que permite inspeccionar los datos presentados sin que se activen las cargas de página. (Ic8917)

Leanback-Paging versión 1.1.0-alpha07

13 de enero de 2021

Lanzamiento de androidx.leanback:leanback-paging:1.1.0-alpha07. La versión 1.1.0-alpha07 contiene estas confirmaciones.

Cambios en la API

  • Se actualizaron las propiedades de conveniencia, CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append, para pasar de Loading a NotLoading después de que los estados de mediador y de carga fuente se conviertan en NotLoading a fin de garantizar que se aplicó la actualización remota. (I65619)

Leanback Leanback-Preference Leanback-Tab versión 1.1.0-beta01

2 de diciembre de 2020

Lanzamiento de androidx.leanback:leanback:1.1.0-beta01, androidx.leanback:leanback-preference:1.1.0-beta01 y androidx.leanback:leanback-tab:1.1.0-beta01. La versión 1.1.0-beta01 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió la filtración de vistas cuando se envía VerticalGridSupportFragment a la pila de actividades. (Iaac69, b/171909417)
  • Se corrigió la pérdida de vistas cuando se envía BrowseSupportFragment a la pila de actividades. (I34483, b/171909417)
  • Se corrigió la pérdida de vistas cuando se envía DetailsSupportFragment a la pila de actividades. (Ifec9e, b/171909417)
  • Se corrigió la pérdida de vistas cuando se envía RowsSupportFragment a la pila de actividades. (I985d4, b/171909417)
  • Se corrigió la animación de transición en segundo plano de GuidedStepSupportFragment. (I86d15, b/173647688)
  • Se corrigió una IllegalArgumentException cuando se restauraba GuidedStepSupportFragment. (Ic829f, b/172000115)
  • Se corrigió GridLayoutManager NullPointerException en findContainingItemView() cuando clearFocus(). (Id0e42)

Leanback-Paging versión 1.1.0-alpha06

2 de diciembre de 2020

Lanzamiento de androidx.leanback:leanback-paging:1.1.0-alpha06. La versión 1.1.0-alpha06 contiene estas confirmaciones.

Cambios en la API

  • Se quitaron las API de dataRefreshFlow/dataRefreshListener, ya que son redundantes con las actualizaciones del objeto loadStateFlow/Listener. Para quienes migran, el equivalente loadStateFlow es el siguiente:

    loadStateFlow.distinctUntilChangedBy { it.refresh }
    .filter { it.refresh is NotLoading }

    (Ib5570, b/173530908)

  • Los métodos dataRefreshFlow y Listener dejaron de estar disponibles completamente con una cláusula replaceWith. (I6e2dd)

Versión 1.1.0-alpha05

1 de octubre de 2020

Lanzamiento de androidx.leanback:leanback-*:1.1.0-alpha05. La versión 1.1.0-alpha05 contiene estas confirmaciones.

Nuevas funciones

  • Permite que la navegación A11Y respete los atributos focusOutFront y focusOutEnd de GridLayoutManager. (b/161390258)

Correcciones de errores

  • Se corrigió la pérdida de vistas en GuidanceStylist.onDestroyView() (b/164841457).
  • Se corrigió ConcatAdapter en GridLayoutManager (b/165694295).
  • leanback-tab: mejoras de Javadoc y refactorización de código menor (aosp/1393383).
  • Se quitó el método setRecyclerView de la API que se había agregado cuando dejó de estar disponible el mismo método en RecyclerView. Se actualizó la biblioteca leanback para usar el nuevo método de la API de addRecyclerListener de RecyclerView. (I14798)

Versión 1.1.0-alpha04

11 de agosto de 2020

Lanzamiento de androidx.leanback:leanback:1.1.0-alpha04, androidx.leanback:leanback-paging:1.1.0-alpha04, androidx.leanback:leanback-preference:1.1.0-alpha04 y androidx.leanback:leanback-tab:1.1.0-alpha04. La versión 1.1.0-alpha04 contiene estas confirmaciones.

Nuevas funciones

  • LeanbackTabLayout proporciona la navegación en la parte superior (por lo general, se muestra horizontalmente en la parte superior de la app) en la experiencia de navegación.
  • Paging para Leanback simplifica la adición de compatibilidad de paginación a un RecyclerView.Adapter.
  • Se agregaron temas appcompat para Leanback que facilitarán la creación de una base de código única entre dispositivos móviles y TV.

Cambios en la API

  • Se agregó un adaptador basado en asyncpagingdatadiffer para los widgets de leanback (If0dfe).
  • Se agregará un TabLayout personalizado para que se use como la barra de navegación superior en Leanback (I1e304)

Versión 1.1.0-alpha03

18 de diciembre de 2019

Lanzamiento de androidx.leanback:leanback:1.1.0-alpha03 y androidx.leanback:leanback-preference:1.1.0-alpha03. Leanback versión 1.1.0-alpha03 contiene estas confirmaciones y Leanback-Preference versión 1.1.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

  • BaseGridView ahora admite velocidades de desplazamiento personalizadas (aosp/952718).
  • Se optimizaron los pasos guiados para tocar un elemento (aosp/1167964).
  • Se expuso BaseGridView OnLayoutCompleteListener para que las apps puedan realizar transformaciones de Vista después de la fase de diseño. (aosp/1164409)

Cambios en la API

  • Se agregó una nueva API para permitir velocidades de desplazamiento personalizadas de BaseGridView (aosp/952718).
  • Se agregó una nueva API para incluir OnLayoutCompleteListener en BaseGridVie (aosp/1164409).

Correcciones de errores

  • Se corrigió un error en el que un pase de diseño rápido no actualiza la alineación de un elemento secundario (aosp/1122745).
  • Se corrigió una falla de desbordamiento de pila en el widget de un selector cuando cambia el enfoque (aosp/1168473).

Cambios de dependencia

  • Leanback-preference: Se fijó la dependencia de androidx.preference a 1.1.0 (aosp/1181902).

Versión 1.1.0-alpha02

7 de mayo de 2019

Lanzamiento de androidx.leanback:leanback:1.1.0-alpha02 y androidx.leanback:leanback-preference:1.1.0-alpha02. Para conocer las confirmaciones incluidas en esta versión, consulta Confirmaciones de Leanback Confirmaciones de Leanback-Preference.

Nuevas funciones

  • RowsSupportFragment ahora puede compartir ViewHolders con otros RowsSupportFragments, lo que mejorará el rendimiento de una IU de varias pestañas.

Cambios en la API

  • Se agregó PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() para permitir que la app inhabilite la función de ocultar/mostrar automáticamente los controles de reproducción cuando se presiona el pad direccional.

Correcciones de errores

  • Se corrigió el tema Fragments de Leanback-Preference que se dañó debido a un cambio en la biblioteca de preferencias.
  • Se corrigió el error de navegación que se producía cuando se presionaba la tecla BACK en SearchEditText.

Versión 1.1.0-alpha01

30 de enero de 2019

Lanzamiento de androidx.leanback:leanback 1.1.0-alpha01.

Nuevas funciones

  • Se agregó el widget de PinPicker.
  • El recorte de contorno ahora está inhabilitado de forma predeterminada en el dispositivo cuando la memoria RAM es baja.
  • Se permite la personalización del comportamiento de mostrar/ocultar los controles de PlaybackSupportFragment (b/122918400).

Cambios en la API

  • Los fragmentos del marco de trabajo quedaron obsoletos.
  • Se agregó la nueva clase PinPicker.

Correcciones de errores

  • Se corrigió una falla de transacción de fragmento después de la detención de BrowseSupportFragment.
  • GuidedStepSupportFragment no debería recortar elementos en VerticalGridView (aosp/787396).
  • Se trasladó a onCreateActionsStylist() y onCreateGuidanceStylist() del constructor a GuidedSupportFragment.onCreate() (aosp/787397).
  • Se corrigió un error por el que SearchSupportFragment no se enfocaba en el fragmento de resultados (aosp/798833).
  • Se corrigió un error relacionado con el desplazamiento en VerticalGridView y HorizontalGridView (aosp/858809).

Lanzamiento de androidx.leanback-preference 1.1.0-alpha01.

Nuevas funciones

  • Se agregaron clases de fragmentos de androidx y se dieron de baja clases de fragmentos de marco de trabajo.
  • Los colores y las fuentes ahora están basados en los atributos del tema del marco de trabajo.

Cambios en la API

  • Se agregaron nuevas clases de fragmentos de androidx y se dieron de baja clases de fragmentos del marco de trabajo.