Eseguire la migrazione a Compose per la TV
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per eseguire la migrazione dal toolkit UI Leanback a Compose per Android TV, segui questi passaggi:
Valuta l'attuale implementazione di Leanback identificando i componenti che utilizzi (inclusi quelli forniti all'interno dei frammenti prefabbricati) e comprendendo come è strutturata l'interfaccia utente e come i dati fluiscono nell'app.
Esegui la migrazione di singole schermate della tua app TV a Compose per imparare e adattarti gradualmente a Compose.
Sebbene tu possa utilizzare sia Leanback sia Compose all'interno della stessa app per consentire un processo di migrazione graduale, inizia sostituendo interi frammenti alla volta con l'obiettivo di convertire l'applicazione TV in un'unica attività.
Inizia in piccolo. Non tentare di eseguire la migrazione di tutti i dati contemporaneamente. Inizia con componenti più piccoli come le impostazioni o le schermate dell'account e poi passa gradualmente all'app.
Consulta la documentazione e gli esempi nelle risorse elencate nella sezione Risorse.
Sfrutta i componenti dedicati di Compose per TV utilizzando le librerie di Jetpack. Consulta le nostre guide di progettazione per scoprire come personalizzare ed estendere i componenti composibili pronti all'uso per creare UI TV accattivanti.
Adatta la gestione dei dati e dello stato per supportare il paradigma di programmazione declarative di Compose. L'adattamento potrebbe richiedere modifiche alla modalità di gestione
degli stati e dei dati nell'app. Utilizza ViewModel
e i meccanismi di gestione dello stato interno di Jetpack Compose per gestire gli stati e
i dati nell'app.
Esegui test ed esegui l'iterazione durante la migrazione delle parti più complesse della tua app.
Contatta la community di sviluppatori Android attiva su Stack Overflow per eventuali bug riscontrati o inviali tramite il nostro tracker dei bug pubblico.
Risorse
Che tu non abbia mai utilizzato Compose o che stia già eseguendo la migrazione a Compose, la nostra vasta raccolta di risorse è a tua disposizione per aiutarti a conoscere le best practice per la creazione di UI per TV con il moderno toolkit per lo sviluppo Android, Jetpack Compose:
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[null,null,["Ultimo aggiornamento 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/)"]]