Migrar para o Compose para TV
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para migrar do kit de ferramentas da interface Leanback para o Compose para Android TV, siga estas etapas:
Avalie sua implementação atual do Leanback identificando os componentes
que você está usando (incluindo aqueles fornecidos nos fragmentos
pré-fabricados) e entendendo como a interface está estruturada e como os dados fluem
pelo app.
Migrar telas individuais do app de TV para o Compose e aprender e se adaptar a ele
gradualmente.
Embora você possa usar o Leanback e o Compose no mesmo app para permitir
um processo de migração gradual, comece substituindo fragmentos inteiros de uma vez
com o objetivo de converter seu aplicativo de TV em uma única atividade.
Comece aos poucos. Não tente migrar tudo de uma vez. Comece com componentes
menores, como configurações ou telas de conta, e avance gradualmente
pelo app.
Consulte a documentação e os exemplos nos recursos listados na seção
Recursos.
Aproveite os componentes dedicados do Compose para TV usando as bibliotecas
do Jetpack. Consulte nossos guias de design para saber
como personalizar e estender elementos combináveis prontos para uso e criar
belas interfaces de TV.
Adapte o gerenciamento de dados e estado para oferecer suporte ao paradigma
de programação declarativa do Compose. A adaptação pode exigir mudanças na forma como você gerencia
dados e estados no app. Use ViewModel
e os mecanismos de gerenciamento de estado interno do Jetpack Compose para gerenciar dados e
estados no app.
Teste e itere ao migrar partes mais complexas do app.
Entre em contato com a comunidade de desenvolvedores do Android no Stack
Overflow para relatar bugs ou envie-os pelo
nosso rastreador de bugs público.
Recursos
Se você é novo no Compose ou já está em processo de migração, nossa grande coleção de recursos está aqui para ajudar você a aprender as práticas
recomendadas para criar interfaces de TV com o kit de ferramentas de desenvolvimento moderno do Android,
o Jetpack Compose:
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# Migrate to Compose for TV\n\nTo migrate from the Leanback UI toolkit to Compose for Android TV, follow these steps:\n\n- **Assess your current Leanback implementation** by identifying the components\n you're using (including those that are provided inside the prefabricated\n fragments) and understanding how your UI is structured and how data flows\n through your app.\n\n- **Migrate individual screens** of your TV app to Compose so you can learn and adapt to Compose\n gradually.\n\n - While you can use both Leanback and Compose within the same app to allow for\n a gradual migration process, begin by replacing entire fragments at a time\n with a goal of converting your TV application into a single activity.\n\n - Start small. Don't try to migrate everything at once. Begin with smaller\n components like settings or account screens and gradually work your way\n through the app.\n\n - Refer to documentation and examples in the resources listed in the\n [Resources](#resources) section.\n\n- **Leverage dedicated components** from Compose for TV by using [the Jetpack\n libraries](/jetpack/androidx/releases/tv). Consult our [design guides](/design/ui/tv/guides/components) to explore\n how you can customize and extend ready-to-use composables to build\n beautiful TV UIs.\n\n- **Adapt your data and state management** to support the Compose [declarative\n programming paradigm](/develop/ui/compose/mental-model#paradigm). Adaptation might require changes in how you manage\n data and state in your app. Use [`ViewModel`](/reference/kotlin/androidx/lifecycle/ViewModel)\n and Jetpack Compose internal state management mechanisms to manage data and\n state in your app.\n\n- **[Test](/develop/ui/compose/testing) and iterate** as you migrate more complex parts of your app.\n\nEngage with the active Android [developer community on Stack\nOverflow](https://stackoverflow.com/questions/tagged/android-jetpack-compose-tv) for any bugs you encounter, or submit the bugs through\nour [public bug tracker](/jetpack/androidx/releases/tv#feedback).\n\nResources\n---------\n\nWhether you're new to Compose or are in the process of migrating to Compose\nalready, our large collection of resources are here to help you learn best\npractices for building TV UIs with the modern Android development toolkit,\nJetpack Compose:\n\n- [Compose for TV integration guides](/training/tv/playback/compose)\n- [TV design guides](/design/ui/tv/guides/components)\n- [Introduction to Compose for TV](/codelabs/compose-for-tv-introduction) codelab\n- [Library release notes](/jetpack/androidx/releases/tv)\n- [JetStream](https://github.com/android/tv-samples/tree/main/JetStreamCompose) video streaming sample app\n- [JetCaster](https://github.com/android/compose-samples/tree/main/Jetcaster/tv-app) audio streaming sample app\n- [Component samples](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:tv/samples/src/main/java/androidx/tv/samples/)"]]