Compose untuk TV adalah pendekatan modern untuk mem-build Android TV antarmuka pengguna. Compose untuk TV mendapatkan semua manfaat Jetpack Compose Android untuk aplikasi TV Anda, sehingga membuat UI yang indah dan fungsional untuk aplikasi Anda semuanya.
Beberapa manfaat khusus menggunakan Compose untuk TV meliputi:
- Fleksibilitas: Compose dapat digunakan untuk membuat jenis UI apa pun, dari yang sederhana tata letak hingga animasi yang kompleks. Komponen dapat langsung difungsikan, tetapi juga dapat disesuaikan dan ditata agar sesuai dengan kebutuhan aplikasi Anda.
- Disederhanakan & Pengembangan yang Dipercepat: Compose kompatibel dengan kode yang sudah ada dan memungkinkan pengembang untuk membangun aplikasi secara lebih efisien 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 lainnya informasi tentang keuntungan umum framework UI deklaratif. Untuk mempelajari lainnya, lihat juga Compose untuk Repositori contoh TV di GitHub.
Kompatibilitas
Compose untuk TV berfungsi di Android TV dengan Android 5.0 (level API 21) atau yang lebih baru. Penggunaan Compose untuk TV versi 1.0 memerlukan versi 1.3.0 Library androidx.compose 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. Dalam beberapa kasus, komponen
tersebut memiliki kesamaan
sebagai pasangan non-TV, seperti
androidx.tv.material3.Button
dan
androidx.compose.material3.Button
Dependensi toolkit Jetpack Compose
Agar dapat menggunakan Compose untuk TV, sertakan toolkit Jetpack Compose
dependensi dalam file build.gradle aplikasi Anda sebagai berikut:
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")
}
Groovy
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'
}
Yang berbeda
Komponen materi TV didesain untuk ruang keluarga, dengan fokus yang jelas indikator dan perilaku input yang mudah digunakan dari jarak jauh. Untuk mengetahui detail tentang cara untuk menggunakan komponen khusus ini, lihat panduan desain UI TV.
Gunakan versi TV API jika memungkinkan untuk mendapatkan manfaat dari fitur-fitur ini.
Meskipun secara teknis memungkinkan untuk
menggunakan Compose Material versi seluler,
aplikasi itu tidak dioptimalkan untuk gaya interaksi yang unik di Android TV. Di beberapa
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-nya sendiri, ada kemungkinan
warna, tipografi, atau bentuk menjadi tidak
konsisten jika kedua versi tersebut digunakan.
Tabel berikut menguraikan perbedaan ketergantungan antara TV dan Perangkat 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
Gambaran umum komponen TV khusus untuk membuat antarmuka pengguna dengan link ke referensi developer yang relevan.Contoh Katalog Material TV
Aplikasi katalog yang menunjukkan cara menerapkan Prinsip Desain Material menggunakan Compose untuk TV.Contoh JetStream
Aplikasi streaming media yang menunjukkan penggunaan TV Compose dengan aplikasi Material khas dan arsitektur dunia nyata.Pengantar Compose untuk TV
Codelab ini memandu pembuatan aplikasi pemutar video dengan browser katalog dan layar detail.
Bacaan lebih lanjut
Jelajahi panduan ini untuk mempelajari cara membuat pengalaman hebat yang dioptimalkan bagi TV untuk: