Android TV'de Jetpack Compose'u kullanma

TV için Compose, Android TV kullanıcı arayüzleri oluşturmaya yönelik modern bir yaklaşımdır. TV için Compose, Android'in Jetpack Compose'unun tüm avantajlarını TV uygulamalarınızda kullanmanızı sağlar. Böylece, uygulamanız için güzel ve işlevsel kullanıcı arayüzleri oluşturmak çok daha kolay hale gelir.

TV için Compose'u kullanmanın bazı avantajları şunlardır:

  • Esneklik: Compose, temel düzenlerden karmaşık animasyonlara kadar her türlü kullanıcı arayüzünü 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 kodla 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, 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 istemi

Android TV desteği eklemeyi öğrenin

Bu istemde, Leanback yerine TV için Jetpack Compose kullanarak uygulamanıza Android TV desteği ekleme konusunda yardım 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.

Yapay zeka istemlerini kullanma

Yapay zeka istemleri, Android Studio'da Gemini'da kullanılmak üzere tasarlanmıştır.

Studio'da Gemini hakkında daha fazla bilgiye buradan ulaşabilirsiniz: https://developer.android.com/studio/gemini/overview

Uyumluluk

TV için Compose, Android 5.0 (API düzeyi 21) veya sonraki sürümlere sahip 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 kullanmak, diğer Android projelerinde Jetpack Compose kullanmaya benzer. Aradaki temel fark, TV için Compose'un 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 gibi ekleyin:

Kotlin (build.gradle.kts)

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2026.08.00")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.13.0")

   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 (build.gradle)

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2026.08.00')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.13.0'

   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 odaklanma göstergeleri ve uzaktan kumandaya uygun giriş davranışı sunar. 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.

Şekil 1. TV materyal kitaplığındaki örnek bileşenler.

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 Materyal'i Compose for TV'deki Compose Materyal 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 cihazlar 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 Materyal Tasarım Kataloğu örneği
    TV için Compose'u kullanarak Materyal Tasarım 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ı olan bir video oynatıcı uygulama oluşturma adımları açıklanmaktadır.

Daha fazla bilgi

Aşağıdaki kılavuzları inceleyerek TV için optimize edilmiş mükemmel deneyimler oluşturma hakkında bilgi edinin:

Sonraki
Katalog tarayıcı oluşturma