Leanback

Utilizza Compose for TV anziché questo artefatto.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
19 maggio 2026 1.2.0 - - 1.3.0-alpha01

Dichiara le dipendenze

Per aggiungere una dipendenza da Leanback, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

dependencies {
    def leanback_version = "1.3.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"

    // 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.3.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")

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

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Leanback-Grid versione 1.1

Versione 1.1.0-alpha01

19 maggio 2026

androidx.leanback:leanback-grid:1.1.0-alpha01 è stato rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Modifiche alle API

  • Aggiungi setSelectedPositionToUnalignedChild e setSelectedPositionToAlignedChild per modificare la posizione selezionata senza attivare lo scorrimento. (If53ab, b/499067714)
  • Fornisce setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) per supportare l'agganciamento in modalità touch. (I55fbc)
  • Supporta SpanSizeLookup con la possibilità di occupare tutti gli intervalli e l'area di riempimento. (I7f87c)
  • Esporre getNumColumns() e getNumRows() (Icd8c0, b/138276997)

Correzioni di bug

Leanback Leanback-Preference Version Version 1.3

Versione 1.3.0-alpha01

19 maggio 2026

androidx.leanback:leanback:1.3.0-alpha01 è stato rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Modifiche alle API

  • Supporta SpanSizeLookup con la possibilità di occupare tutti gli intervalli e l'area di riempimento. (I7f87c)
  • Esporre getNumColumns() e getNumRows() (Icd8c0, b/138276997)
  • Rimozione delle annotazioni @RequiresApi(21) obsolete (Ic4792)

Correzioni di bug

Leanback-Grid versione 1.0.0

Versione 1.0.0

23 aprile 2025

androidx.leanback:leanback-grid:1.0.0 è stato rilasciato. La versione non contiene alcuna modifica, ma viene spostata nella versione stabile.

Versione 1.0.0-rc01

9 aprile 2025

androidx.leanback:leanback-grid:1.0.0-rc01 è stato rilasciato. Non sono presenti commit importanti e la libreria viene spostata solo alla versione stabile.

Versione 1.0.0-alpha03

15 novembre 2023

androidx.leanback:leanback-grid:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Aggiornamenti delle dipendenze

Versione 1.0.0-alpha02

6 settembre 2023

androidx.leanback:leanback-grid:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

  • Reso setFocusOutAllowed pubblico per consentire l'impostazione programmatica delle proprietà di messa a fuoco. (Iebd99)

Correzioni di bug

  • Assicurati che le griglie vengano trattate come griglie dai servizi di accessibilità impostando un nome di classe delle informazioni del nodo di accessibilità. (I12812)
  • Aggiungi il suono di navigazione mancante quando si passa allo scorrimento fluido. (f49767)

Versione 1.0.0-alpha01

17 novembre 2021

androidx.leanback:leanback-grid:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Sono state spostate le seguenti classi/interfacce da leanback alla nuova libreria leanback-grid: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility. Questa modifica preserva la compatibilità binaria. Chiunque voglia utilizzare solo i componenti della visualizzazione a griglia di Leanback può utilizzare direttamente leanback-grid come dipendenza. (If1e49)

Leanback Leanback-Preference versione 1.2.0

Versione 1.2.0

23 aprile 2025

androidx.leanback:leanback:1.2.0 e androidx.leanback:leanback-preference:1.2.0 sono state rilasciate. La versione non contiene alcuna modifica, ma viene spostata nella versione stabile.

Versione 1.2.0-rc01

9 aprile 2025

androidx.leanback:leanback:1.2.0-rc01 e androidx.leanback:leanback-preference:1.2.0-rc01 sono state rilasciate. Non sono presenti commit importanti e la libreria viene spostata solo alla versione stabile.

Versione 1.2.0-alpha04

15 novembre 2023

androidx.leanback:leanback:1.2.0-alpha04 e androidx.leanback:leanback-preference:1.2.0-alpha04 sono state rilasciate. La versione 1.2.0-alpha04 contiene questi commit.

Correzioni di bug

Aggiornamento delle dipendenze

  • Aggiorna il requisito recyclerview alla versione 1.3.2 per correggere un arresto anomalo comune nelle app TV

Versione 1.2.0-alpha03

6 settembre 2023

androidx.leanback:leanback:1.2.0-alpha03 e androidx.leanback:leanback-preference:1.2.0-alpha03 sono state rilasciate. La versione 1.2.0-alpha03 contiene questi commit.

Modifiche alle API

  • È stato aggiunto GuidedActionAppCompatEditText per supportare meglio il tema AppCompat. (ab7cf1, dc954d)

Versione 1.2.0-alpha02

17 novembre 2021

androidx.leanback:leanback:1.2.0-alpha02 e androidx.leanback:leanback-preference:1.2.0-alpha02 sono state rilasciate. La versione 1.2.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Sono state spostate le seguenti classi/interfacce da leanback alla nuova libreria leanback-grid: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility. Questa modifica preserva la compatibilità binaria. Chiunque voglia utilizzare solo i componenti della visualizzazione a griglia di Leanback può utilizzare direttamente leanback-grid come dipendenza. (If1e49)

Versione 1.2.0-alpha01

21 luglio 2021

androidx.leanback:leanback:1.2.0-alpha01 e androidx.leanback:leanback-preference:1.2.0-alpha01 sono state rilasciate. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stato reso pubblico e scambiabile in BaseGridView il GridLayoutManager di leanback. (f316b5)

Modifiche alle API

  • È stato reso pubblico e scambiabile in BaseGridView il GridLayoutManager di leanback. (f316b5)

Versione 1.1.0

Versione 1.1.0-alpha01

19 maggio 2026

androidx.leanback:leanback-grid:1.1.0-alpha01 è stato rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Modifiche alle API

  • aggiungi setSelectedPositionToUnalignedChild e setSelectedPositionToAlignedChild per modificare la posizione selezionata senza attivare lo scorrimento. (If53ab, b/499067714)
  • Fornisce setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) per supportare lo scorrimento in modalità touch. (I55fbc)
  • supporta SpanSizeLookup con la possibilità di occupare tutti gli intervalli e l'area di spaziatura interna. (I7f87c)
  • Esporre getNumColumns() e getNumRows() (Icd8c0, b/138276997)

Correzioni di bug

Leanback versione 1.1.0-rc02

21 luglio 2021

androidx.leanback:leanback:1.1.0-rc02 è stato rilasciato. La versione 1.1.0-rc02 contiene questi commit.

Correzioni di bug

  • Correzione del bug dello sfondo del frammento dei dettagli. (40d8e3)

Leanback Leanback-Preference versione 1.1.0-rc01

7 aprile 2021

androidx.leanback:leanback:1.1.0-rc01 e androidx.leanback:leanback-preference:1.1.0-rc01 sono state rilasciate. La versione 1.1.0-rc01 contiene questi commit.

  • Sono state corrette le perdite di visualizzazione in SearchSupportFragment() (6c47a1, b/171909417)
  • È stato reso facoltativo il riconoscimento vocale per SearchSupportFragment (4ff949,b/169936953)

Leanback-Paging versione 1.1

Versione 1.1.0

23 aprile 2025

androidx.leanback:leanback-paging:1.1.0 e androidx.leanback:leanback-tab:1.1.0 sono state rilasciate. La versione non contiene alcuna modifica, ma viene spostata nella versione stabile.

Versione 1.1.0-rc01

9 aprile 2025

androidx.leanback:leanback-paging:1.1.0-rc01 e androidx.leanback:leanback-tab:1.1.0-rc01 sono state rilasciate. Non sono presenti commit importanti e la libreria viene spostata solo alla versione stabile.

Versione 1.1.0-alpha11

15 novembre 2023

androidx.leanback:leanback-paging:1.1.0-alpha11 viene rilasciato senza modifiche. La versione 1.1.0-alpha11 contiene questi commit.

Versione 1.1.0-alpha10

6 settembre 2023

androidx.leanback:leanback-paging:1.1.0-alpha10 è stato rilasciato. La versione 1.1.0-alpha10 contiene questi commit.

Nuove funzionalità

  • Aggiorna leanback-paging alla versione 3.1.0 di Paging. (882ed1)

Leanback-Paging versione 1.1.0-alpha09

17 novembre 2021

androidx.leanback:leanback-paging:1.1.0-alpha09 è stato rilasciato. La versione 1.1.0-alpha09 contiene questi commit.

Correzioni di bug

  • Aggiornato per utilizzare le API di paginazione più recenti.

Leanback-Paging versione 1.1.0-alpha08

21 luglio 2021

androidx.leanback:leanback-paging:1.1.0-alpha08 è stato rilasciato. La versione 1.1.0-alpha08 contiene questi commit.

Modifiche alle API

  • Sono state aggiunte le API .peek() e .snapshot() a PagingDataAdapter, consentendo l'ispezione dei dati presentati senza attivare il recupero della pagina. (Ic8917)

Leanback-Paging versione 1.1.0-alpha07

13 gennaio 2021

androidx.leanback:leanback-paging:1.1.0-alpha07 è stato rilasciato. La versione 1.1.0-alpha07 contiene questi commit.

Modifiche alle API

  • Sono state aggiornate le proprietà di convenienza, CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append in modo che la transizione da Loading a NotLoading avvenga solo dopo che gli stati di caricamento del mediatore e dell'origine sono NotLoading per garantire che l'aggiornamento remoto sia stato applicato. (I65619)

Leanback Leanback-Preference Leanback-Tab versione 1.1.0-beta01

2 dicembre 2020

androidx.leanback:leanback:1.1.0-beta01, androidx.leanback:leanback-preference:1.1.0-beta01 e androidx.leanback:leanback-tab:1.1.0-beta01 sono stati rilasciati. La versione 1.1.0-beta01 contiene questi commit.

Correzioni di bug

  • Correzione della perdita di visualizzazione quando VerticalGridSupportFragment viene inserito nello stack precedente (Iaac69, b/171909417)
  • È stata corretta la perdita di visualizzazione quando BrowseSupportFragment viene inserito nello stack indietro (I34483, b/171909417)
  • È stata corretta la perdita di visualizzazione quando viene inserito DetailsSupportFragment nello stack precedente (Ifec9e, b/171909417)
  • È stata corretta la perdita di visualizzazione quando viene eseguito il push di RowsSupportFragment nello stack indietro. (I985d4, b/171909417)
  • Correzione dell'animazione di transizione dello sfondo di GuidedStepSupportFragment. (I86d15, b/173647688)
  • È stata corretta l'eccezione IllegalArgumentException durante il ripristino di GuidedStepSupportFragment (Ic829f, b/172000115)
  • Correzione di GridLayoutManager NullPointerException in findContainingItemView() quando clearFocus() (Id0e42)

Leanback-Paging versione 1.1.0-alpha06

2 dicembre 2020

androidx.leanback:leanback-paging:1.1.0-alpha06 è stato rilasciato. La versione 1.1.0-alpha06 contiene questi commit.

Modifiche alle API

  • Le API dataRefreshFlow / dataRefreshListener sono state rimosse perché sono ridondanti con gli aggiornamenti di loadStateFlow / Listener. Per gli utenti che eseguono la migrazione, l'equivalente di loadStateFlow è:

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

    (Ib5570, b/173530908)

  • Deprecare completamente i metodi dataRefreshFlow / Listener con una clausola replaceWith. (I6e2dd)

Versione 1.1.0-alpha05

1° ottobre 2020

androidx.leanback:leanback-*:1.1.0-alpha05 è stato rilasciato. La versione 1.1.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Consenti alla navigazione A11Y di rispettare gli attributi focusOutFront e focusOutEnd di GridLayoutManager. (b/161390258)

Correzioni di bug

  • È stata corretta la perdita di visualizzazione in GuidanceStylist.onDestroyView() (b/164841457)
  • Correzione di ConcatAdapter in GridLayoutManager (b/165694295)
  • leanback-tab: miglioramenti di Javadoc e refactoring del codice secondario (aosp/1393383)
  • Rimuovi il metodo setRecyclerView dall'API che è stato aggiunto quando lo stesso metodo è stato ritirato da RecyclerView. Aggiorna la libreria leanback per utilizzare il nuovo metodo API addRecyclerListener di RecyclerView. (I14798)

Versione 1.1.0-alpha04

11 agosto 2020

androidx.leanback:leanback:1.1.0-alpha04, androidx.leanback:leanback-paging:1.1.0-alpha04, androidx.leanback:leanback-preference:1.1.0-alpha04 e androidx.leanback:leanback-tab:1.1.0-alpha04 sono stati rilasciati. La versione 1.1.0-alpha04 contiene questi commit.

Nuove funzionalità

  • LeanbackTabLayout fornisce la navigazione nella parte superiore (in genere visualizzata orizzontalmente nella parte superiore dell'app) nell'esperienza di navigazione.
  • La paginazione per Leanback semplifica l'aggiunta del supporto della paginazione a un RecyclerView.Adapter.
  • Sono stati aggiunti temi appcompat per leanback che semplificheranno la creazione di un unico codebase tra dispositivi mobili e TV.

Modifiche alle API

  • Aggiunta dell'adattatore basato su asyncpagingdatadiffer per i widget leanback (If0dfe)
  • Aggiunta di un TabLayout personalizzato da utilizzare come barra di navigazione superiore in leanback (I1e304)

Versione 1.1.0-alpha03

18 dicembre 2019

androidx.leanback:leanback:1.1.0-alpha03 e androidx.leanback:leanback-preference:1.1.0-alpha03 sono state rilasciate. Leanback versione 1.1.0-alpha03 contiene questi commit e Leanback-Preference versione 1.1.0-alpha03 contiene questi commit.

Nuove funzionalità

  • BaseGridView ora supporta velocità di scorrimento personalizzate (aosp/952718)
  • Reso più semplice il tocco dell'elemento di camminata guidata (aosp/1167964)
  • È stato esposto il listener OnLayoutCompleteListener di BaseGridView in modo che le app possano eseguire trasformazioni di visualizzazione dopo il passaggio del layout. (aosp/1164409)

Modifiche alle API

  • È stata aggiunta una nuova API per consentire velocità di scorrimento personalizzate di BaseGridView (aosp/952718)
  • È stata aggiunta una nuova API per aggiungere OnLayoutCompleteListener in BaseGridView (aosp/1164409)

Correzioni di bug

  • È stato corretto un bug per cui il passaggio rapido del layout non aggiorna l'allineamento di un elemento secondario. (aosp/1122745)
  • È stato corretto un arresto anomalo di stack overflow nel widget Picker quando lo stato attivo cambia (aosp/1168473)

Modifiche alle dipendenze

  • Leanback-preference: pinned the dependency of androidx.preference to 1.1.0 (aosp/1181902)

Versione 1.1.0-alpha02

7 maggio 2019

androidx.leanback:leanback:1.1.0-alpha02 e androidx.leanback:leanback-preference:1.1.0-alpha02 sono state rilasciate. I commit inclusi in questa versione possono essere leanback commits e leanback-preference commits.

Nuove funzionalità

  • Ora RowsSupportFragment può condividere i ViewHolders con altri RowsSupportFragments, il che migliora il rendimento di un'interfaccia utente con più schede.

Modifiche alle API

  • È stato aggiunto PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() per consentire la disattivazione della visualizzazione/occultamento automatico dei controlli di riproduzione quando viene premuto il D-pad.

Correzioni di bug

  • È stato corretto il tema dei frammenti leanback-preference danneggiato a causa di una modifica alla libreria delle preferenze.
  • Correzione del bug di navigazione quando viene premuto il tasto INDIETRO su SearchEditText

Versione 1.1.0-alpha01

30 gennaio 2019

androidx.leanback:leanback 1.1.0-alpha01 è stato rilasciato.

Nuove funzionalità

  • È stato aggiunto il widget PinPicker.
  • Il ritaglio del contorno ora è disattivato per impostazione predefinita sui dispositivi con poca RAM.
  • È stato consentito il comportamento di visualizzazione/occultamento dei controlli personalizzati di PlaybackSupportFragment (b/122918400)

Modifiche alle API

  • I frammenti del framework sono stati ritirati.
  • Nuova classe PinPicker.

Correzioni di bug

  • È stato risolto un arresto anomalo della transazione di frammenti dopo l'interruzione di BrowseSupportFragment
  • GuidedStepSupportFragment non deve tagliare gli elementi in VerticalGridView (aosp/787396)
  • onCreateActionsStylist() e onCreateGuidanceStylist() sono stati spostati dal costruttore a GuidedSupportFragment.onCreate() (aosp/787397)
  • È stato corretto un bug per cui SearchSupportFragment non riusciva a mettere a fuoco il frammento dei risultati. (aosp/798833)
  • È stato corretto un bug di scorrimento in VerticalGridView e HorizontalGridView (aosp/858809).

androidx.leanback-preference 1.1.0-alpha01 è stato rilasciato.

Nuove funzionalità

  • Sono state aggiunte le classi di frammenti androidx e sono state ritirate le classi di frammenti del framework.
  • Ora i colori e i caratteri si basano sugli attributi del tema del framework.

Modifiche alle API

  • Sono state ritirate le nuove classi di frammenti androidx e le classi di frammenti del framework.