Leanback

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da Leanback, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

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

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

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

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, 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.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Versione 1.0.0 di Leanback-Grid

Versione 1.0.0

23 aprile 2025

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

Versione 1.0.0-rc01

9 aprile 2025

androidx.leanback:leanback-grid:1.0.0-rc01 viene rilasciato. Non contiene commit importanti e sposta la libreria solo in stato stabile.

Versione 1.0.0-alpha03

15 novembre 2023

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

Aggiornamenti delle dipendenze

• Aggiornamento per fare affidamento su RecyclerView 1.3.2 per correggere un arresto anomalo comune nelle app per TV (I2c3a0, b/292114537)

Versione 1.0.0-alpha02

6 settembre 2023

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

Modifiche all'API

• È stato reso pubblico setFocusOutAllowed per consentire di impostare le proprietà di uscita da modalità di messa a fuoco in modo programmatico. (Iebd99)

Correzioni di bug

• Assicurati che le griglie vengano trattate come griglie dai servizi a11y impostando un nome di classe di informazioni del nodo a11y. (I12812)
• Aggiungere l'audio 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 viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• Le seguenti classi/interfacce sono state spostate da leanback alla nuova libreria leanback-grid: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility. Questa modifica mantiene la compatibilità binaria. Chiunque voglia utilizzare solo i componenti della visualizzazione 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 vengono rilasciati. La versione non contiene alcuna modifica, ma viene spostata in 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 vengono rilasciati. Non contiene commit importanti e sposta la libreria solo in stato 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 vengono rilasciati. La versione 1.2.0-alpha04 contiene questi commit.

Correzioni di bug

• (I2c3a0, b/292114537)

Aggiornamento delle dipendenze

• Aggiornamento del requisito recyclerview alla versione 1.3.2 per correggere un arresto anomalo comune nelle app per 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 vengono rilasciati. La versione 1.2.0-alpha03 contiene questi commit.

Modifiche all'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 vengono rilasciati. La versione 1.2.0-alpha02 contiene questi commit.

Nuove funzionalità

• Le seguenti classi/interfacce sono state spostate da leanback alla nuova libreria leanback-grid: BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility. Questa modifica mantiene la compatibilità binaria. Chiunque voglia utilizzare solo i componenti della visualizzazione 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 vengono rilasciati. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

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

Modifiche all'API

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

Versione 1.1.0

Versione Leanback 1.1.0-rc02

21 luglio 2021

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

Correzioni di bug

• Bug relativo allo sfondo del frammento dei dettagli corretto. (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 vengono rilasciati. La versione 1.1.0-rc01 contiene questi commit.

• Sono stati corretti i problemi di fuga delle visualizzazioni in SearchSupportFragment() (6c47a1, b/171909417)
• È stato reso facoltativo il riconoscimento vocale per SearchSupportFragment (4ff949,b/169936953)

Versione 1.1 di sfoglio Leanback

Versione 1.1.0

23 aprile 2025

androidx.leanback:leanback-paging:1.1.0 e androidx.leanback:leanback-tab:1.1.0 vengono rilasciati. La versione non contiene alcuna modifica, ma viene spostata in 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 vengono rilasciati. Non contiene commit importanti e sposta la libreria solo in stato 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 viene rilasciato. La versione 1.1.0-alpha10 contiene questi commit.

Nuove funzionalità

• Aggiorna leanback-paging a Paging 3.1.0. (882ed1)

Versione 1.1.0-alpha09 di scambio di Leanback

17 novembre 2021

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

Correzioni di bug

• Aggiornamento per l'utilizzo delle API di paginazione più recenti.

Versione 1.1.0-alpha08 di Paginazione Leanback

21 luglio 2021

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

Modifiche all'API

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

Versione 1.1.0-alpha07 di Paginazione Leanback

13 gennaio 2021

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

Modifiche all'API

• Sono state aggiornate le proprietà di praticità CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append per passare da Loading a NotLoading 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 vengono rilasciati. La versione 1.1.0-beta01 contiene questi commit.

Correzioni di bug

• Correggere la perdita di vista quando si inserisce VerticalGridSupportFragment nell'area di memoria di riserva (Iaac69, b/171909417)
• Correzione della perdita di visualizzazioni quando si inserisce BrowseSupportFragment nella pila di ritorno (I34483, b/171909417)
• Correggere la perdita di vista quando si spinge DetailsSupportFragment nell'area di attesa (Ifec9e, b/171909417)
• Correggere la fuga di vista quando si inserisce RowsSupportFragment nella pila di ritorno (I985d4, b/171909417)
• Correzione dell'animazione di transizione dello sfondo di GuidedStepSupportFragment. (I86d15, b/173647688)
• Correzione dell'IllegalArgumentException durante il ripristino di GuidedStepSupportFragment (Ic829f, b/172000115)
• Correggere l'eccezione NullPointerException di GridLayoutManager in findContainingItemView() quando viene chiamato clearFocus() (Id0e42)

Versione 1.1.0-alpha06 di Paginazione Leanback

2 dicembre 2020

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

Modifiche all'API

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

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

  (Ib5570, b/173530908)

• Rifai 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 viene 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

• Correzione della perdita di visualizzazione in GuidanceStylist.onDestroyView() (b/164841457)
• Correggi ConcatAdapter in GridLayoutManager (b/165694295)
• leanback-tab: miglioramenti ai Javadoc e refactoring del codice minore (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 dell'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 vengono rilasciati. La versione 1.1.0-alpha04 contiene questi commit.

Nuove funzionalità

• LeanbackTabLayout fornisce la navigazione in alto (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 semplificano la creazione di un'unica base di codice tra dispositivi mobili e TV.

Modifiche all'API

• È stato aggiunto un'opzione di aggiornamento basata 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 vengono rilasciati. La versione 1.1.0-alpha03 di Leanback contiene questi commit e la versione 1.1.0-alpha03 di Leanback-Preference contiene questi commit.

Nuove funzionalità

• BaseGridView ora supporta velocità di scorrimento personalizzate (aosp/952718)
• È stato reso più intuitivo l'elemento della procedura guidata (aosp/1167964)
• È stato esposto l'ascoltatore OnLayoutCompleteListener di BaseGridView in modo che le app possano eseguire trasformazioni della visualizzazione dopo il passaggio del layout. (aosp/1164409)

Modifiche all'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 risolto un bug per cui il passaggio di layout rapido non aggiornava l'allineamento di un elemento secondario. (aosp/1122745)
• È stato corretto un arresto anomalo dovuto a overflow dello stack nel widget Selettore quando l'attenzione cambia (aosp/1168473)

Modifiche alle dipendenze

• Leanback-preference: è stata bloccata la dipendenza di androidx.preference da 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 vengono rilasciati. I commit inclusi in questa versione possono essere commit leanback e commit leanback-preference.

Nuove funzionalità

• Ora RowsSupportFragment è autorizzato a condividere ViewHolder con altri RowsSupportFragment, il che migliorerebbe le prestazioni per un'interfaccia utente con più schede.

Modifiche all'API

• È stato aggiunto PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() per consentire all'app di disattivare l'automazione di visualizzazione/nascondimento dei controlli di riproduzione quando viene premuto il D-pad.

Correzioni di bug

• È stato corretto il tema dei frammenti leanback-preference non funzionante a causa di una modifica nella raccolta delle preferenze.
• Correzione del bug di navigazione quando viene premuto il tasto BACK su SearchEditText

Versione 1.1.0-alpha01

30 gennaio 2019

androidx.leanback:leanback 1.1.0-alpha01 viene rilasciato.

Nuove funzionalità

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

Modifiche all'API

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

Correzioni di bug

• È stato corretto un arresto anomalo della transazione del frammento 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 viene rilasciato.

Nuove funzionalità

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

Modifiche all'API

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