Compose for TV, Android TV kullanıcı arayüzleri oluşturmak için kullanılan modern bir yaklaşımdır. TV için Compose, Android'in Jetpack Compose'unun tüm avantajlarını TV uygulamalarınıza getirerek uygulamanız için güzel ve işlevsel kullanıcı arayüzleri oluşturmayı çok daha kolay hale getirir.
TV için Compose kullanmanın bazı avantajları şunlardır:
- Esneklik: Compose, basit düzenlerden karmaşık animasyonlara kadar her tür kullanıcı arayüzü oluşturmak için kullanılabilir. Bileşenler kullanıma hazır olarak sunulur ancak uygulamanızın ihtiyaçlarına uyacak şekilde özelleştirilebilir ve stil verilebilir.
- Basitleştirilmiş ve Hızlandırılmış Geliştirme: Compose, mevcut kodlarla uyumludur ve geliştiricilerin daha az kodla daha verimli bir şekilde uygulama oluşturmasına olanak tanır.
- Sezgisel: Compose, kullanıcı arayüzünüzde değişiklik yapmanıza, kodunuzda hata ayıklamanıza, kodunuzu anlamanıza ve incelemenize olanak tanıyan bildirimsel bir söz dizimi kullanır.
Jetpack Compose araç setini kullanma konusunda bilginiz yoksa Compose yoluna göz atın. Mobil Compose'un geliştirme ilkelerinin çoğu TV için de geçerlidir. Bildirim temelli bir kullanıcı arayüzü çerçevesinin genel avantajları hakkında daha fazla bilgi için Neden Compose? başlıklı makaleyi inceleyin. Daha fazla bilgi edinmek için GitHub'daki Compose for TV örnekleri deposuna da göz atın.
Yapay Zeka İstemleri
Android TV desteği eklemeyi öğrenin
Bu istemde, Leanback yerine Jetpack Compose for TV kullanarak uygulamanıza Android TV desteği ekleme konusunda rehberlik isteniyor.
How do I add support for Android TV to my application?
Use Jetpack Compose for TV as part of the response instead of Leanback.
Uyumluluk
Compose for TV, Android 5.0 (API düzeyi 21) veya sonraki sürümlerin yüklü olduğu Android TV'lerde çalışır. TV için Compose'un 1.0 sürümünü kullanmak için androidx.compose kitaplıklarının 1.3.0 sürümü ve Kotlin 1.7.10 gerekir.
Kurulum
Android TV'de Jetpack Compose'u kullanmak, diğer Android projelerinde Jetpack Compose'u kullanmaya benzer. Aradaki temel fark, Compose for TV'nin TV için optimize edilmiş bileşenler sunan ve TV'ye özel kullanıcı arayüzleri oluşturmayı kolaylaştıran kitaplıklar eklemesidir. Bu bileşenler bazı durumlarda TV dışı muadilleriyle aynı adı paylaşır. Örneğin, androidx.tv.material3.Button ve androidx.compose.material3.Button.
Jetpack Compose araç seti bağımlılıkları
TV için Compose'u kullanmak üzere Jetpack Compose araç seti bağımlılıklarını uygulamanızın build.gradle dosyasına aşağıdaki şekilde ekleyin:
Kotlin
dependencies { val composeBom = platform("androidx.compose:compose-bom:2025.05.00") implementation(composeBom) // General compose dependencies. implementation("androidx.activity:activity-compose:1.10.1") implementation("androidx.compose.ui:ui-tooling-preview") debugImplementation("androidx.compose.ui:ui-tooling") // Compose for TV dependencies. implementation("androidx.tv:tv-material:1.0.0") }
Groovy
dependencies { def composeBom = platform('androidx.compose:compose-bom:2025.05.00') implementation composeBom // General compose dependencies. implementation 'androidx.activity:activity-compose:1.10.1' implementation 'androidx.compose.ui:ui-tooling-preview' debugImplementation 'androidx.compose.ui:ui-tooling' // Compose for TV dependencies. implementation 'androidx.tv:tv-material:1.0.0' }
Farklılıklar
TV materyal bileşenleri, oturma odası için tasarlanmıştır. Net odak göstergeleri ve uzaktan kumandaya uygun giriş davranışı içerir. Bu bileşenlerin nasıl kullanılacağıyla ilgili ayrıntılar için TV kullanıcı arayüzü tasarım kılavuzlarına göz atın.
Bu özelliklerden yararlanmak için mümkün olduğunda API'lerin TV sürümünü kullanın.
Compose Material'ın mobil sürümünü kullanmak teknik olarak mümkün olsa da Android TV'deki benzersiz etkileşim stili için optimize edilmemiştir. Ayrıca, Compose Material'ı Compose for TV'deki Compose Material ile karıştırmak beklenmedik davranışlara neden olabilir. Örneğin, her kitaplığın kendi MaterialTheme nesnesi olduğundan her iki sürüm de kullanılıyorsa renklerin, tipografinin veya şekillerin tutarsız olma ihtimali vardır.
Aşağıdaki tabloda TV ve mobil cihaz arasındaki bağımlılık farklılıkları özetlenmektedir:
| TV Bağımlılığı (androidx.tv.*) |
Karşılaştırma | Mobile Dependency (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | yerine | androidx.compose.material3:material3 |
Ek kaynaklar
TV tasarım kılavuzları
Kullanıcı arayüzleri oluşturmak için özel TV bileşenlerine genel bakış ve ilgili geliştirici kaynaklarının bağlantıları.TV Material Catalog örneği
TV için Compose'u kullanarak Material Design ilkelerinin nasıl uygulanacağını gösteren bir katalog uygulaması.JetStream örneği
TV Compose'un tipik bir Material uygulaması ve gerçek dünya mimarisiyle kullanımını gösteren bir medya akışı uygulaması.TV için Compose'a Giriş
Bu codelab'de, katalog tarayıcı ekranı ve ayrıntılar ekranı içeren bir video oynatıcı uygulama oluşturma adımları açıklanmaktadır.
Daha fazla bilgi
Aşağıdaki platformlar için TV'ye optimize edilmiş harika deneyimler oluşturma hakkında bilgi edinmek için bu kılavuzları inceleyin: