Android TV'de Jetpack Compose'u kullanma

TV için Yazma, Android TV geliştirmenin modern yaklaşımıdır çok kolaylaşır. TV için Compose'u kullanarak Android'in Jetpack Compose'un tüm avantajlarından yararlanabilirsiniz. Böylece uygulamanız için çok güzel ve işlevsel kullanıcı arayüzleri oluşturabilirsiniz. daha kolay olur.

TV için Yazma özelliğini kullanmanın özel avantajlarından bazıları şunlardır:

  • Esneklik: Compose'dan yararlanarak basit, şık ve esnek her türlü kullanıcı arayüzü karmaşık animasyonlara kadar geniş bir yelpazededir. Bileşenler kullanıma hazırdır ancak uygulamanızın ihtiyaçlarına uyacak şekilde özelleştirilebilir ve biçimlendirilmelidir.
  • Basitleştirilmiş ve Hızlandırılmış Geliştirme: Oluşturma, daha verimli bir şekilde uygulama geliştirmelerine olanak tanır. daha az kod yazmaktır.
  • Kullanımı kolaydır: Oluşturma işleminde bildirime dayalı bir söz dizimi kullanılır. hata ayıklamanızı, kodunuzu anlamanızı ve incelemenizi öneririz.

Jetpack Compose araç setini kullanmayı bilmiyorsanız şu makaleye göz atın: Yol yolu oluşturun. Birçok mobil Beste'ye yönelik geliştirme ilkelerinin tümü TV için de geçerlidir. Neden? Daha fazlası için oluşturun bildirim temelli kullanıcı arayüzü çerçevesinin genel avantajları hakkında bilgi. Öğrenmek için daha fazla bilgi için GitHub'daki TV örnekleri deposu.

Uyumluluk

TV için Yazma özelliği, 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 1.3.0 sürümü gerekir androidx.compose kitaplıkları ve Kotlin 1.7.10 sürümlerinde kullanılabilir.

Kurulum

Android TV'de Jetpack Compose'u kullanmak, tüm cihazlar için Jetpack Compose'u kullanmaya benzer. başka bir Android projesi yapabilirsiniz. Temel fark, TV için Yazma özelliğinin TV için optimize edilmiş bileşenler sunan ve içerik oluşturmayı kolaylaştıran kitaplıklar eklendi. TV'ye özel kullanıcı arayüzleri. Bazı durumlarda bu bileşenler aynı yerine androidx.tv.material3.Button ve androidx.compose.material3.Button.

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

TV için Compose'u kullanmak istiyorsanız Jetpack Compose araç setini ekleyin aşağıdaki gibi bağımlılıkları uygulamanızın build.gradle dosyasında görebilirsiniz:

Kotlin

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

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.9.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-rc01")
}

Eski

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

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.9.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-rc01'
}

Farklar

TV malzemesi bileşenleri oturma odası için tasarlanmıştır ve net odak noktası göstergeleri ve uzaktan uyumlu giriş davranışı ile ilgili daha fazla bilgi edinin. Google Cloud'un bu belirli bileşenleri kullanmak için TV kullanıcı arayüzü tasarım kılavuzlarına bakın.

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

Yararlanmak için mümkün olduğunda API'lerin TV sürümünü kullanın özellikler.

Materyal Oluşturma özelliğinin mobil sürümünü kullanmak teknik olarak mümkün olsa da, Android TV'deki benzersiz etkileşim tarzına göre optimize edilmemiştir. İçinde ek olarak, Compose Materyalini şuradan oluşturabilirsiniz: TV için içerik oluşturma, beklenmedik davranışlara neden olabilir. Örneğin, Her kitaplığın kendi MaterialTheme nesnesi olduğundan, değişiklik yapma her iki sürüm de kullanıldığında tutarsız olan renkler, yazılar veya şekiller.

Aşağıdaki tabloda TV ile pazarlama arasındaki bağımlılık farkları Mobil:

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

Ek kaynaklar

  • TV tasarım kılavuzları
    Kullanıcı arayüzü oluşturmaya yönelik özel TV bileşenlerine genel bakış ilgili geliştirici kaynaklarının bağlantıları.

  • TV Materyal Kataloğu örneği
    Nasıl uygulayacağınızı gösteren bir katalog uygulaması TV için Oluşturma'yı kullanan Materyal Tasarım ilkeleri.

  • JetStream örneği
    TV Compose'un kullanımını gösteren bir medya akış uygulaması tipik Materyal uygulamaları ve gerçek dünya mimarisi.

  • TV için Compose'a giriş
    Bu codelab'de, katalog tarayıcısıyla video oynatıcı uygulaması derlenir ve ayrıntılar ekranını göreceksiniz.

Daha fazla bilgi

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