Usar o Jetpack Compose no Android TV

O Compose para TV é a abordagem moderna para criar interfaces do usuário do Android TV. Ele oferece todos os benefícios do Jetpack Compose do Android para seus apps de TV, o que facilita muito a criação de interfaces incríveis e funcionais para seu app.

Confira alguns benefícios específicos do uso do Compose para TV:

• Flexibilidade: o Compose pode ser usado para criar qualquer tipo de interface, de layouts simples a animações complexas. Os componentes funcionam imediatamente, mas também podem ser personalizados e estilizados para atender às necessidades do seu app.
• Desenvolvimento simplificado e acelerado: o Compose é compatível com o código atual e permite que os desenvolvedores criem apps com mais eficiência e menos código.
• Intuitivo: o Compose usa uma sintaxe declarativa que permite fazer mudanças na interface, depurar, entender e revisar o código.

Se você não sabe usar o kit de ferramentas do Jetpack Compose, confira o Programa de treinamentos do Compose. Muitos dos princípios de desenvolvimento do Compose para dispositivos móveis também se aplicam à TV. Consulte Por que usar o Compose para mais informações sobre as vantagens gerais de um framework de interface declarativo. Para saber mais, consulte também o repositório de exemplos do Compose para TV no 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.

Compatibilidade

O Compose para TV funciona em TVs Android com Android 5.0 (nível 21 da API) ou mais recente. Para usar a versão 1.0 do Compose para TV, é necessário ter a versão 1.3.0 das bibliotecas androidx.compose e o Kotlin 1.7.10.

Configuração

O uso do Jetpack Compose no Android TV é semelhante ao uso do Jetpack Compose para qualquer outro Projeto do Android. A principal diferença é que o Compose para TV adiciona bibliotecas que oferecem componentes otimizados para TV e facilitam a criação de interfaces do usuário personalizadas para TV. Em alguns casos, esses componentes compartilham o mesmo nome das contrapartes não relacionadas à TV, como androidx.tv.material3.Button e androidx.compose.material3.Button.

Dependências do kit de ferramentas do Jetpack Compose

Para usar o Compose para TV, inclua dependências do kit de ferramentas do Jetpack Compose no arquivo build.gradle do app da seguinte maneira:

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

O que é diferente

Os componentes de Material Design para TV são projetados para a sala de estar, com indicadores de foco claros e comportamento de entrada adequado para controles remotos. Para detalhes sobre como usar esses componentes específicos, consulte os guias de design de interface para TV.

Use a versão para TV das APIs sempre que possível para aproveitar estes recursos.

Embora seja tecnicamente possível usar a versão para dispositivos móveis do Compose Material, ela não é otimizada para o estilo exclusivo de interações no Android TV. Além disso, misturar o Compose Material com o Compose Material do Compose para TV pode resultar em um comportamento inesperado. Por exemplo, como cada biblioteca tem o próprio objeto MaterialTheme, é possível que cores, tipografias ou formas sejam inconsistentes se as duas versões forem usadas.

A tabela a seguir descreve as diferenças de dependência entre TV e dispositivos móveis:

Outros recursos

• Guias de design para TV
  Uma visão geral dos componentes dedicados para TV para criar interfaces do usuário com links para recursos relevantes para desenvolvedores.

• Exemplo do catálogo de Material Design para TV
  Um app de catálogo que demonstra como implementar os princípios do Material Design usando o Compose para TV.

• Exemplo do JetStream
  Um app de streaming de mídia que demonstra o uso do Compose para TV com um app Material típico e arquitetura do mundo real.

• Introdução ao Compose para TV
  Este codelab mostra como criar um app de player de vídeo com uma tela de navegador de catálogo e uma tela de detalhes.

Leitura adicional

Confira estes guias para aprender a criar ótimas experiências otimizadas para TV:

• Criar um navegador de catálogo
• Criar uma tela de detalhes
• Criar layouts roláveis