Leanback

Créez des applications pour les appareils Android TV à l'aide de widgets et de fragments de modèles compatibles avec les pavés directionnels.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
15 novembre 2023 1.0.0 1.1.0-rc02 - 1.2.0-alpha04

Déclarer des dépendances

Pour ajouter une dépendance sur Leanback, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Leanback-Grid version 1.0.0

Version 1.0.0-alpha03

15 novembre 2023

Publication d'androidx.leanback:leanback-grid:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Mises à jour des dépendances

Version 1.0.0-alpha02

6 septembre 2023

Publication d'androidx.leanback:leanback-grid:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02.

Modifications apportées à l'API

  • setFocusOutAllowed rendu public pour permettre de définir les propriétés du focus par programmation. (Iebd99).

Correction de bugs

  • Permet de paramétrer un nom de classe d'informations de nœuds a11y afin que les grilles soit traitées en tant que telles par les services a11y. (I12812)
  • Ajout d'un son de navigation manquant lors du défilement fluide. (F49767).

Version 1.0.0-alpha01

17 novembre 2021

Publication d'androidx.leanback:leanback-grid:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

  • Classes/interfaces déplacées de leanback vers la nouvelle bibliothèque leanback-grid : BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility. Cette modification préserve la compatibilité binaire. Toute personne souhaitant n'utiliser que les composants du mode grille de Leanback peut directement utiliser leanback-grid en tant que dépendance. (If1e49)

Leanback Leanback-Preference version 1.2.0

Version 1.2.0-alpha04

15 novembre 2023

Publication d'androidx.leanback:leanback:1.2.0-alpha04 et d'androidx.leanback:leanback-preference:1.2.0-alpha04. Liste des commits de la version 1.2.0-alpha04

Correction de bugs

Mise à jour de la dépendance

  • Passez à la version 1.3.2 des exigences concernant RecyclerView pour corriger un plantage courant dans les applications TV

Version 1.2.0-alpha03

6 septembre 2023

Publication d'androidx.leanback:leanback:1.2.0-alpha03 et d'androidx.leanback:leanback-preference:1.2.0-alpha03. Liste des commits de la version 1.2.0-alpha03

Modifications apportées à l'API

  • Ajout de GuidedActionAppCompatEditText pour une meilleure compatibilité avec le thème AppCompat. (ab7cf1, dc954d).

Version 1.2.0-alpha02

17 novembre 2021

Publication d'androidx.leanback:leanback:1.2.0-alpha02 et d'androidx.leanback:leanback-preference:1.2.0-alpha02. Liste des commits de la version 1.2.0-alpha02.

Nouvelles fonctionnalités

  • Classes/interfaces déplacées de leanback vers la nouvelle bibliothèque leanback-grid : BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility. Cette modification préserve la compatibilité binaire. Toute personne souhaitant n'utiliser que les composants du mode grille de Leanback peut directement utiliser leanback-grid en tant que dépendance. (If1e49)

Version 1.2.0-alpha01

21 juillet 2021

Publication d'androidx.leanback:leanback:1.2.0-alpha01 et d'androidx.leanback:leanback-preference:1.2.0-alpha01. Liste des commits de la version 1.2.0-alpha01

Nouvelles fonctionnalités

  • GridLayoutManager de Leanback est désormais public et échangeable dans BaseGridView. (f316b5)

Modifications apportées à l'API

  • GridLayoutManager de Leanback est désormais public et échangeable dans BaseGridView. (f316b5)

Version 1.1.0

Leanback version 1.1.0-rc02

21 juillet 2021

Publication d'androidx.leanback:leanback:1.1.0-rc02. Liste des commits de la version 1.1.0-rc02

Correction de bugs

  • Correction du bug lié au fragment de détails en arrière-plan. (40d8e3)

Leanback Leanback-Preference version 1.1.0-rc01

7 avril 2021

Publication d'androidx.leanback:leanback:1.1.0-rc01 et d'androidx.leanback:leanback-preference:1.1.0-rc01. Liste des commits de la version 1.1.0-rc01

  • Correction des fuites de vues dans SearchSupportFragment() (6c47a1, b/171909417).
  • Reconnaissance vocale devenue facultative pour SearchSupportFragment (4ff949,b/169936953).

Leanback-Paging version 1.1

Version 1.1.0-alpha11

15 novembre 2023

Publication d'androidx.leanback:leanback-paging:1.1.0-alpha11 sans aucune modification. Liste des commits de la version 1.1.0-alpha11

Version 1.1.0-alpha10

6 septembre 2023

Publication d'androidx.leanback:leanback-paging:1.1.0-alpha10. Liste des commits de la version 1.1.0-alpha10

Nouvelles fonctionnalités

  • Mise à jour de Leanback-paging vers Paging 3.1.0. (882ed1).

Leanback-Paging version 1.1.0-alpha09

17 novembre 2021

Publication d'androidx.leanback:leanback-paging:1.1.0-alpha09. Liste des commits de la version 1.1.0-alpha09

Corrections de bugs

  • Mise à jour pour utiliser les dernières API de pagination.

Leanback-Paging version 1.1.0-alpha08

21 juillet 2021

Publication d'androidx.leanback:leanback-paging:1.1.0-alpha08. Liste des commits de la version 1.1.0-alpha08

Modifications apportées à l'API

  • Ajout des API .peek() et .snapshot() à PagingDataAdapter, permettant d'inspecter les données présentées sans déclencher de récupération de page. (Ic8917)

Leanback-Paging version 1.1.0-alpha07

13 janvier 2021

Publication d'androidx.leanback:leanback-paging:1.1.0-alpha07. Liste des commits de la version 1.1.0-alpha07

Modifications apportées à l'API

  • Mise à jour des propriétés de commodité, CombinedLoadStates.refresh, CombinedLoadStates.prepend et CombinedLoadStates.append pour qu'elles passent de Loading à NotLoading uniquement après que les états de chargement source et médiateur sont NotLoading, pour garantir que la mise à jour à distance a été appliquée. (I65619)

Leanback, Leanback-Preference et Leanback-Tab version 1.1.0-beta01

2 décembre 2020

Publication d'androidx.leanback:leanback:1.1.0-beta01, androidx.leanback:leanback-preference:1.1.0-beta01 et androidx.leanback:leanback-tab:1.1.0-beta01. Liste des commits de la version 1.1.0-beta01

Correction de bugs

  • Correction de la fuite de vue lors du transfert de VerticalGridSupportFragment vers la pile "Retour" (Iaac69, b/171909417).
  • Correction de la fuite de vue lors de la transmission de BrowseSupportFragment vers la pile "Retour" (I34483, b/171909417).
  • Correction de la fuite de vue lors du transfert de DetailsSupportFragment vers la pile "Retour" (Ifec9e, b/171909417).
  • Correction de la fuite de vue lors du transfert de RowsSupportFragment vers la pile "Retour" (I985d4, b/171909417).
  • Correction de l'animation de transition en arrière-plan GuidedStepSupportFragment. (I86d15, b/173647688)
  • Correction d'IllegalArgumentException lors de la restauration de GuidedStepSupportFragment (Ic829f, b/172000115).
  • Correction de GridLayoutManager NullPointerException dans findContainingItemView() avec clearFocus() (Id0e42).

Leanback-Paging version 1.1.0-alpha06

2 décembre 2020

Publication d'androidx.leanback:leanback-paging:1.1.0-alpha06. Liste des commits de la version 1.1.0-alpha06

Modifications apportées à l'API

  • Les API dataRefreshFlow/dataRefreshListener ont été supprimées, car redondantes avec les mises à jour loadStateFlow/Listener. Si vous comptez migrer, l'équivalent de loadStateFlow est :

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

    (Ib5570, b/173530908)

  • Abandon complet des méthodes dataRefreshFlow et Listener avec une clause replaceWith. (I6e2dd)

Version 1.1.0-alpha05

1er octobre 2020

Publication d'androidx.leanback:leanback-*:1.1.0-alpha05. Liste des commits de la version 1.1.0-alpha05

Nouvelles fonctionnalités

  • Laissez la navigation A11Y respecter les attributs GridLayoutManager focusOutFront et focusOutEnd. (b/161390258)

Correction de bugs

  • Correction de la fuite de vue dans GuidanceStylist.onDestroyView() (b/164841457).
  • Correction de ConcatAdapter dans GridLayoutManager (b/165694295).
  • leanback-tab : améliorations de Javadoc et refactorisations mineures du code(aosp/1393383).
  • Suppression de la méthode setRecyclerView de l'API, ajoutée lorsque la même méthode avait été abandonnée sur RecyclerView. Mise à jour de la bibliothèque Leanback pour utiliser la nouvelle méthode API addRecyclerListener de RecyclerView. (I14798)

Version 1.1.0-alpha04

11 août 2020

Publication de androidx.leanback:leanback:1.1.0-alpha04, androidx.leanback:leanback-paging:1.1.0-alpha04, androidx.leanback:leanback-preference:1.1.0-alpha04 et androidx.leanback:leanback-tab:1.1.0-alpha04. Liste des commits de la version 1.1.0-alpha04.

Nouvelles fonctionnalités

  • LeanbackTabLayout permet de naviguer dans la partie supérieure de l'interface de navigation (généralement affichée horizontalement en haut de l'application).
  • La pagination pour Leanback simplifie l'ajout de la pagination à un RecyclerView.Adapter.
  • Ajout de thèmes "appcompat" pour Leanback pour simplifier la création d'un code base unique entre les mobiles et les téléviseurs.

Modifications apportées à l'API

  • Ajout d'un adaptateur basé sur asyncpagingdatadiffer pour les widgets Leanback (If0dfe).
  • Ajout d'une TabLayout personnalisée à utiliser comme barre de navigation supérieure dans Leanback (I1e304).

Version 1.1.0-alpha03

18 décembre 2019

Publication d'androidx.leanback:leanback:1.1.0-alpha03 et d'androidx.leanback:leanback-preference:1.1.0-alpha03. Liste des commits de Leanback version 1.1.0-alpha03 et Liste des commits de Leanback-Preference version 1.1.0-alpha03.

Nouvelles fonctionnalités

  • BaseGridView est désormais compatible avec les vitesses de défilement personnalisées (aosp/952718).
  • Procédure guidée pour toucher des éléments plus accessible (aosp/1167964).
  • Exposition de BaseGridView OnLayoutCompleteListener afin que les applications puissent effectuer des transformations de View après la mise en page. (aosp/1164409)

Modifications apportées à l'API

  • Ajout d'une API permettant d'utiliser les vitesses de défilement personnalisées de BaseGridView (aosp/952718).
  • Ajout d'une API pour ajouter OnLayoutCompleteListener dans BaseGridView (aosp/1164409).

Corrections de bugs

  • Correction d'un bug qui empêchait la mise en page rapide de mettre à jour l'alignement d'un enfant. (aosp/1122745)
  • Correction d'un plantage de dépassement de pile dans le widget Picker lorsque le sélectionnable change (aosp/1168473).

Modifications de la dépendance

  • Leanback-preference : a épinglé la dépendance de androidx.preference sur 1.1.0 (aosp/1181902).

Version 1.1.0-alpha02

7 mai 2019

Publication d'androidx.leanback:leanback:1.1.0-alpha02 et d'androidx.leanback:leanback-preference:1.1.0-alpha02. Les commits inclus dans cette version sont disponibles dans leanback commits et leanback-preference commits.

Nouvelles fonctionnalités

  • RowsSupportFragment est désormais autorisé à partager des ViewHolders avec d'autres RowsSupportFragments, ce qui améliorerait les performances d'une interface utilisateur à plusieurs onglets.

Modifications apportées à l'API

  • Ajout de PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() pour permettre à l'application de désactiver le masquage/l'affichage automatique des commandes de lecture lorsque l'utilisateur appuie sur le pavé directionnel.

Corrections de bugs

  • Correction du thème Fragments de leanback-preference corrompu en raison d'une modification dans la bibliothèque de préférences.
  • Correction d'un bug de navigation lorsque l'utilisateur appuie sur la touche RETOUR dans SearchEditText.

Version 1.1.0-alpha01

30 janvier 2019

Publication d'androidx.leanback:leanback 1.1.0-alpha01.

Nouvelles fonctionnalités

  • Ajout du widget PinPicker.
  • Le détourage des contours est désormais désactivé par défaut sur les appareils à faible RAM.
  • Autorisation de PlaybackSupportFragment Comportement à afficher/masquer le comportement des commandes (b/122918400).

Modifications apportées à l'API

  • Abandon des fragments de framework.
  • Nouvelle classe PinPicker.

Corrections de bugs

  • Correction d'un plantage de transaction par fragment après l'arrêt de BrowseSupportFragment.
  • GuidedStepSupportFragment ne doit pas couper des éléments dans VerticalGridView (aosp/787396).
  • onCreateActionsStylist() et onCreateGuidanceStylist() ont été déplacés de constructeur vers GuidedSupportFragment.onCreate() (aosp/787397).
  • Correction d'un bug qui empêchait SearchSupportFragment de se concentrer sur le fragment des résultats. (aosp/798833)
  • Correction d'un bug de défilement dans VerticalGridView et HorizontalGridView (aosp/858809).

Publication d'androidx.leanback-preference 1.1.0-alpha01.

Nouvelles fonctionnalités

  • Ajout de classes de fragments androidx. Abandon de classes de fragment framework.
  • Les couleurs et les polices sont désormais basées sur les attributs du thème du framework.

Modifications apportées à l'API

  • Abandon des nouvelles classes de fragments androidx et framework.