Utiliser Jetpack Compose sur Android TV

Compose pour la télévision est l'approche moderne pour créer des interfaces utilisateur Android TV. Compose pour la télévision offre tous les avantages de Jetpack Compose d'Android pour vos applications TV, ce qui facilite grandement la création d'interfaces utilisateur attrayantes et fonctionnelles.

Voici quelques avantages spécifiques de l'utilisation de Compose pour la télévision :

• Flexibilité : Compose permet de créer n'importe quel type d'UI, qu'il s'agisse de mises en page simples ou d'animations complexes. Les composants sont prêts à l'emploi, mais vous pouvez aussi les personnaliser et les façons selon les besoins de votre application.
• Développement simplifié et accéléré : Compose étant compatible avec le code existant, les développeurs peuvent créer des applications plus efficacement avec moins de code.
• Intuitivité : Compose utilise une syntaxe déclarative qui vous permet de modifier votre UI, mais aussi de déboguer, comprendre et examiner votre code.

Si vous ne savez pas comment utiliser le kit d'outils Jetpack Compose, consultez le parcours Compose. De nombreux principes de développement concernant Compose pour mobile s'appliquent également à la télévision. Pour en savoir plus sur les avantages généraux d'un framework d'interface utilisateur déclaratif, consultez la section Pourquoi choisir Compose. Pour en savoir plus, consultez également l'exemple de dépôt Compose pour la télévision sur GitHub.

How do I add support for Android TV to my application?


Use Jetpack Compose for TV as part of the response instead of Leanback.

Compatibilité

Compose pour la télévision fonctionne sur les téléviseurs Android équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure. Pour utiliser la version 1.0 de Compose pour la télévision, vous devez utiliser la version 1.3.0 des bibliothèques androidx.compose et Kotlin 1.7.10.

Configuration

L'utilisation de Jetpack Compose sur Android TV est semblable à celle de Jetpack Compose pour tout autre projet Android. La principale différence est que Compose pour la télévision ajoute des bibliothèques qui proposent des composants optimisés pour la télévision et facilitent la création d'interfaces utilisateur adaptées à la télévision. Dans certains cas, ces composants portent le même nom que leurs homologues non-TV, tels que androidx.tv.material3.Button et androidx.compose.material3.Button.

Dépendances du kit d'outils Jetpack Compose

Pour utiliser Compose pour la télévision, incluez les dépendances du kit d'outils Jetpack Compose dans le fichier build.gradle de votre application comme suit :

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2026.03.00")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.13.0")

   implementation("androidx.compose.ui:ui-tooling-preview")
   debugImplementation("androidx.compose.ui:ui-tooling")

   // Compose for TV dependencies.
   implementation("androidx.tv:tv-material:1.0.0")
}

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2026.03.00')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.13.0'

   implementation 'androidx.compose.ui:ui-tooling-preview'
   debugImplementation 'androidx.compose.ui:ui-tooling'

   // Compose for TV dependencies.
   implementation 'androidx.tv:tv-material:1.0.0'
}

Ce qui change

Les composants Material pour la télévision sont conçus pour le salon, avec des indicateurs de mise au point clairs et un comportement d'entrée adapté à la télécommande. Pour savoir comment utiliser ces composants spécifiques, consultez les guides de conception de l'interface utilisateur TV.

Utilisez la version TV des API chaque fois que cela est possible pour profiter de ces fonctionnalités.

Bien qu'il soit techniquement possible d'utiliser la version mobile de Compose Material, elle n'est pas optimisée pour le style unique d'interactions sur Android TV. Par ailleurs, la combinaison de Compose Material et de Compose Material de Compose pour la télévision peut entraîner un comportement inattendu. Par exemple, comme chaque bibliothèque possède son propre objet MaterialTheme, il est possible que les couleurs, la typographie ou les formes soient incohérentes si les deux versions sont utilisées.

Le tableau suivant décrit les différences de dépendance entre la télévision et le mobile :

Ressources supplémentaires

• Guides de conception pour la télévision
  Présentation des composants TV dédiés à la création d'interfaces utilisateur avec des liens vers les ressources de développement pertinentes.

• Exemple de catalogue Material pour la télévision
  Application de catalogue qui montre comment implémenter les principes de Material Design à l'aide de Compose pour la télévision.

• Exemple JetStream
  Application de streaming multimédia qui montre l'utilisation de Compose pour la télévision avec une application Material typique et une architecture réelle.

• Introduction à Compose pour la télévision
  Cet atelier de programmation explique comment créer une application de lecteur vidéo avec un navigateur de catalogue écran et un écran de détails.

Complément d'informations

Consultez ces guides pour découvrir comment créer des expériences optimisées pour la télévision :

• Créer un navigateur de catalogue
• Créer un écran d'informations
• Créer des mises en page déroulantes