Menggunakan Jetpack Compose di Android TV

Compose untuk TV adalah pendekatan modern untuk membangun antarmuka pengguna Android TV. Compose untuk TV mendapatkan semua manfaat Jetpack Compose Android untuk aplikasi TV Anda, sehingga mempermudah pembuatan UI yang indah dan fungsional untuk aplikasi Anda.

Beberapa manfaat khusus menggunakan Compose untuk TV mencakup hal berikut:

  • Fleksibilitas: Compose dapat digunakan untuk membuat jenis UI apa pun, mulai dari tata letak yang sederhana hingga animasi yang kompleks. Komponen dapat langsung difungsikan, tetapi juga dapat disesuaikan dan ditata agar sesuai dengan kebutuhan aplikasi Anda.
  • Pengembangan yang Disederhanakan &Dipercepat: Compose kompatibel dengan kode yang sudah ada dan memungkinkan developer membangun aplikasi dengan lebih efisien dan dengan lebih sedikit kode.
  • Intuitif: Compose menggunakan sintaksis deklaratif yang memungkinkan Anda membuat perubahan pada UI, melakukan debug, memahami, dan meninjau kode Anda.

Jika Anda tidak terbiasa menggunakan toolkit Jetpack Compose, lihat jalur Compose. Banyak prinsip pengembangan untuk Compose seluler juga berlaku untuk TV. Lihat Mengapa Compose untuk mengetahui informasi selengkapnya tentang keuntungan umum framework UI deklaratif. Untuk mempelajari lebih lanjut, lihat juga repositori contoh Compose untuk TV di GitHub.

Perintah AI

Pelajari cara menambahkan dukungan untuk Android TV

Perintah ini meminta panduan terkait penambahan dukungan Android TV ke aplikasi Anda menggunakan Jetpack Compose untuk TV, bukan Leanback.

How do I add support for Android TV to my application?



Use Jetpack Compose for TV as part of the response instead of Leanback.

Menggunakan perintah AI

Perintah AI dimaksudkan untuk digunakan dalam Gemini di Android Studio.

Pelajari lebih lanjut Gemini di Studio di sini: https://developer.android.com/studio/gemini/overview

Kompatibilitas

Compose untuk TV berfungsi di Android TV dengan Android 5.0 (level API 21) atau yang lebih tinggi. Penggunaan Compose untuk TV versi 1.0 memerlukan library androidx.compose versi 1.3.0 dan Kotlin 1.7.10.

Penyiapan

Menggunakan Jetpack Compose di Android TV mirip dengan menggunakan Jetpack Compose untuk project Android lainnya. Perbedaan utamanya adalah Compose untuk TV menambahkan library yang menawarkan komponen yang dioptimalkan untuk TV dan mempermudah pembuatan antarmuka pengguna yang disesuaikan untuk TV. Terkadang, komponen tersebut memiliki nama yang sama dengan komponen non-TV, seperti androidx.tv.material3.Button dan androidx.compose.material3.Button.

Dependensi toolkit Jetpack Compose

Untuk menggunakan Compose untuk TV, sertakan dependensi toolkit Jetpack Compose dalam file build.gradle aplikasi Anda sebagai berikut:

Kotlin

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2026.03.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

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2026.03.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'
}

Yang berbeda

Komponen material TV didesain untuk ruang keluarga, dengan indikator fokus yang jelas dan perilaku input yang kompatibel dengan remote. Untuk mengetahui detail cara menggunakan komponen tertentu ini, lihat panduan desain UI TV.

Gambar 1. Contoh komponen dari library material TV.

Gunakan versi TV dari API jika memungkinkan untuk memanfaatkan fitur ini.

Meskipun secara teknis dapat dilakukan, tetapi penggunaan Compose Material versi seluler tidak dioptimalkan untuk gaya interaksi unik di Android TV. Selain itu, menggabungkan Compose Material dengan Compose Material dari Compose untuk TV dapat menyebabkan perilaku yang tidak terduga. Misalnya, karena setiap library memiliki objek MaterialTheme sendiri, ada kemungkinan warna, tipografi, atau bentuk menjadi tidak konsisten jika kedua versi tersebut digunakan.

Tabel berikut menguraikan perbedaan dependensi antara TV dan Seluler:

Dependensi TV
(androidx.tv.*) 		Perbandingan Dependensi Perangkat Seluler
(androidx.compose.*)
androidx.tv:tv-material bukan androidx.compose.material3:material3

Referensi lainnya

  • Panduan desain TV
    Ringkasan komponen TV khusus untuk membangun antarmuka pengguna dengan link ke referensi developer yang relevan.

  • Contoh Katalog Material TV
    Aplikasi katalog yang menunjukkan cara menerapkan Desain Material prinsip menggunakan Compose untuk TV.

  • Contoh JetStream
    Aplikasi streaming media yang menunjukkan penggunaan TV Compose dengan aplikasi Material umum dan arsitektur dunia nyata.

  • Pengantar Compose untuk TV
    Codelab ini membahas langkah-langkah membangun aplikasi pemutar video dengan browser katalog layar dan layar detail.

Bacaan lebih lanjut

Jelajahi panduan ini untuk mempelajari cara membangun pengalaman yang dioptimalkan untuk TV yang hebat untuk:

Berikutnya
Membuat browser katalog