Android TV'de Jetpack Compose'u kullanma

TV için oluşturma, 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ız için sunar. Böylece, uygulamanız için güzel ve işlevsel kullanıcı arayüzleri oluşturmayı çok daha kolay hale getirir.

TV için Oluştur'u 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 gelir ancak uygulamanızın ihtiyaçlarına uyacak şekilde özelleştirilebilir ve biçimlendirilebilir.
  • Basitleştirilmiş ve Hızlandırılmış Geliştirme: Compose, mevcut kodla uyumludur ve geliştiricilerin daha az kod kullanarak daha verimli bir şekilde uygulama oluşturmasını sağlar.
  • 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 açıklayıcı bir söz dizimi kullanır.

Jetpack Compose araç setini kullanma konusunda bilginiz yoksa Compose yoluna göz atın. Mobil Compose için geçerli olan geliştirme ilkelerinin çoğu TV için de geçerlidir. Beyan temelli kullanıcı arayüzü çerçevesinin genel avantajları hakkında daha fazla bilgi için Why Compose başlıklı makaleyi inceleyin. Daha fazla bilgi edinmek için GitHub'daki Compose for TV örnekleri deposuna da göz atın.

Android TV desteğini nasıl ekleyeceğinizi öğrenin

Bu istemde, Leanback yerine TV için Jetpack Compose'u kullanarak uygulamanıza Android TV desteği ekleme konusunda yardım istenir.

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

AI istemleri, Android Studio'daki Gemini'de (en son Canary sürümü gereklidir) kullanılmak üzere tasarlanmıştır

Studio'da Gemini hakkında daha fazla bilgiyi https://developer.android.com/studio/preview/gemini adresinde bulabilirsiniz.

Uyumluluk

TV için Oluştur, 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ünün ve Kotlin 1.7.10'un yüklü olması gerekir.

Kurulum

Android TV'de Jetpack Compose'u kullanmak, diğer Android projelerinde Jetpack Compose'u kullanmaya benzer. Aralarındaki temel fark, TV için Compose'un TV'ye optimize edilmiş bileşenler sunan ve TV'ye özel kullanıcı arayüzleri oluşturmayı kolaylaştıran kitaplıklar eklemesidir. Bazı durumlarda bu bileşenler, TV dışındaki muadilleriyle aynı ada sahiptir (ör. androidx.tv.material3.Button ve androidx.compose.material3.Button).

Jetpack Compose araç seti bağımlılıkları

TV için Compose'i kullanmak istiyorsanız Jetpack Compose araç seti bağımlılıkları uygulamanızın build.gradle dosyasına aşağıdaki gibi ekleyin:

Kotlin

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

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

   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:2024.10.01')
   implementation composeBom

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

   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, net odak göstergeleri ve uzaktan kumanda dostu giriş davranışı ile oturma odası için tasarlanmıştır. 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.

İçerik Oluşturma aracının mobil sürümünü teknik olarak kullanmak mümkün olsa da bu sürüm, Android TV'deki benzersiz etkileşim tarzı için optimize edilmemiştir. Ayrıca, TV için Oluştur'daki Oluştur Malzemesi ile Oluştur Malzemesi'ni 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, yazı tiplerinin veya şekillerin tutarsız olması olasıdır.

Aşağıdaki tabloda TV ile mobil cihazlar arasındaki bağımlılık farklılıkları özetlenmiştir:

TV Bağımlılığı
(androidx.tv.*)
Karşılaştırma Mobil Bağımlılık
(androidx.compose.*)
androidx.tv:tv-material yerine androidx.compose.material3:material3

Ek kaynaklar

  • TV tasarımı kılavuzları
    İlgili geliştirici kaynaklarına bağlantılar içeren, kullanıcı arayüzleri oluşturmaya yönelik özel TV bileşenlerine genel bakış.

  • TV için Materyal Katalog ö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ısı ekranı ve ayrıntılar ekranı içeren bir video oynatıcı uygulaması oluşturma adımları açıklanmaktadır.

Daha fazla bilgi

Aşağıdakiler için TV'ye optimize edilmiş mükemmel deneyimler oluşturma hakkında bilgi edinmek üzere bu kılavuzları inceleyin: