Bermigrasi ke Compose untuk TV
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Untuk bermigrasi dari toolkit UI Leanback ke Compose untuk Android TV, ikuti langkah-langkah berikut:
Evaluasi penerapan Leanback Anda saat ini dengan mengidentifikasi komponen
yang Anda gunakan (termasuk yang disediakan di dalam fragmen
prafabrikasi) dan memahami cara UI Anda disusun dan cara data mengalir
melalui aplikasi Anda.
Memigrasikan setiap layar aplikasi TV ke Compose sehingga Anda dapat mempelajari dan beradaptasi dengan Compose
secara bertahap.
Meskipun Anda dapat menggunakan Leanback dan Compose dalam aplikasi yang sama untuk memungkinkan
proses migrasi bertahap, mulailah dengan mengganti seluruh fragmen sekaligus
dengan tujuan mengonversi aplikasi TV menjadi satu aktivitas.
Mulai dari yang kecil. Jangan mencoba memigrasikan semuanya sekaligus. Mulailah dengan komponen
yang lebih kecil seperti setelan atau layar akun, lalu lanjutkan
melalui aplikasi secara bertahap.
Lihat dokumentasi dan contoh dalam referensi yang tercantum di bagian Referensi.
Manfaatkan komponen khusus dari Compose untuk TV menggunakan library
Jetpack. Lihat panduan desain kami untuk mempelajari
cara menyesuaikan dan memperluas composable siap pakai untuk membuat
UI TV yang menarik.
Adaptasi data dan pengelolaan status Anda untuk mendukung paradigma
pemrograman deklaratif Compose. Adaptasi mungkin memerlukan perubahan dalam cara Anda mengelola
data dan status di aplikasi. Gunakan ViewModel
dan mekanisme pengelolaan status internal Jetpack Compose untuk mengelola data dan
status di aplikasi Anda.
Uji dan lakukan iterasi saat Anda memigrasikan bagian aplikasi yang lebih kompleks.
Berinteraksilah dengan komunitas developer Android yang aktif di Stack
Overflow untuk bug yang Anda temui, atau kirimkan bug melalui
pelacak bug publik kami.
Referensi
Baik Anda baru menggunakan Compose atau sedang dalam proses migrasi ke Compose, koleksi referensi kami yang lengkap siap membantu Anda mempelajari praktik
terbaik untuk mem-build UI TV dengan toolkit pengembangan Android modern,
Jetpack Compose:
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[null,null,["Terakhir diperbarui pada 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/)"]]
