TV için Compose'a geçiş
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Leanback kullanıcı arayüzü araç setinden Android TV için Compose'a geçmek üzere aşağıdaki adımları uygulayın:
Kullandığınız bileşenleri (hazır bileşenler içinde sağlananlar dahil) tanımlayarak, kullanıcı arayüzünüzün nasıl yapılandırıldığını ve verilerin uygulamanızda nasıl aktığını anlayarak mevcut Leanback uygulamanızı değerlendirin.
Compose'u yavaş yavaş öğrenip uyum sağlayabilmek için TV uygulamanızın ekranlarını tek tek Compose'a taşıyın.
Kademeli bir taşıma işlemine izin vermek için aynı uygulamada hem Leanback'i hem de Compose'u kullanabilirsiniz. TV uygulamanızı tek bir etkinliğe dönüştürme hedefiyle, bir seferde tüm parçaları değiştirerek başlayın.
Küçük adımlarla başlayın. Her şeyi tek seferde taşımaya çalışmayın. Ayarlar veya hesap ekranları gibi daha küçük bileşenlerle başlayın ve kademeli olarak uygulamanın geri kalanını inceleyin.
Kaynaklar bölümünde listelenen kaynaklardaki dokümanlara ve örneklere göz atın.
Jetpack kitaplıklarını kullanarak TV için Compose'daki özel bileşenlerden yararlanın. Güzel TV kullanıcı arayüzleri oluşturmak için hazır bileşenleri nasıl özelleştirebileceğinizi ve genişletebileceğinizi keşfetmek üzere tasarım kılavuzlarımıza göz atın.
Compose belirtmeci programlama paradigmasını desteklemek için veri ve durum yönetiminizi uyarlayın. Uyumlulaştırma, uygulamanızdaki verileri ve durumu yönetme şeklinizde değişiklik yapmayı gerektirebilir. Uygulamanızdaki verileri ve durumu yönetmek için ViewModel ve Jetpack Compose'un dahili durum yönetimi mekanizmalarını kullanın.
Uygulamanızın daha karmaşık bölümlerini taşırken test edin ve yineleyin.
Karşılaştığınız hatalar için Stack Overflow'daki etkin Android geliştirici topluluğuyla iletişime geçin veya herkese açık hata izleyicimiz üzerinden hataları gönderin.
Kaynaklar
Compose'da yeniyseniz veya Compose'a geçiş sürecindeyseniz modern Android geliştirme araç seti Jetpack Compose ile TV kullanıcı arayüzleri oluşturmayla ilgili en iyi uygulamaları öğrenmenize yardımcı olacak geniş kaynak koleksiyonumuzdan yararlanabilirsiniz:
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[null,null,["Son güncelleme tarihi: 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/)"]]
