Migración a Compose para TV
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Para migrar del kit de herramientas de la IU de Leanback a Compose para Android TV, sigue estos pasos:
Evalúa tu implementación actual de Leanback. Para ello, identifica los componentes que usas (incluidos los que se proporcionan dentro de los fragmentos prefabricados) y comprende cómo está estructurada tu IU y cómo fluyen los datos a través de tu app.
Migra pantallas individuales de tu app para TV a Compose para que puedas aprender a usar Compose y adaptarte a él de forma gradual.
Si bien puedes usar Leanback y Compose en la misma app para permitir un proceso de migración gradual, comienza por reemplazar fragmentos completos a la vez con el objetivo de convertir tu aplicación para TV en una sola actividad.
Empieza de a poco. No intentes migrar todo a la vez. Comienza con componentes más pequeños, como la configuración o las pantallas de la cuenta, y avanza gradualmente por la app.
Consulta la documentación y los ejemplos en los recursos que se indican en la sección
Recursos.
Aprovecha los componentes exclusivos de Compose para TV con las bibliotecas de Jetpack. Consulta nuestras guías de diseño para explorar cómo puedes personalizar y extender elementos componibles listos para usar y crear IU de TV atractivas.
Adapta tu administración de datos y estado para admitir el paradigma de programación declarativa de Compose. La adaptación puede requerir cambios en la forma en que administras los datos y el estado en tu app. Usa ViewModel
y los mecanismos de administración de estado interno de Jetpack Compose para administrar los datos y el estado en tu app.
Prueba e itera a medida que migras las partes más complejas de tu app.
Comunícate con la comunidad de desarrolladores de Android activa en Stack Overflow para informar los errores que encuentres o envíalos a través de nuestro seguimiento de errores público.
Recursos
Ya sea que seas nuevo en Compose o estés en proceso de migrar a Compose, nuestra gran colección de recursos está aquí para ayudarte a conocer las prácticas recomendadas para compilar IUs de TV con el moderno kit de herramientas de desarrollo de Android, Jetpack Compose:
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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/)"]]