tv

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada tv-foundation dan tv-material, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

dependencies {
    implementation "androidx.tv:tv-foundation:1.0.0-alpha04"
    implementation "androidx.tv:tv-material:1.0.0-alpha04"
}

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-alpha04")
    implementation("androidx.tv:tv-material:1.0.0-alpha04")
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Tidak ada catatan rilis untuk artefak ini.

Versi 1.0.0

Versi 1.0.0-alpha04

8 Februari 2023

androidx.tv:tv-foundation:1.0.0-alpha04 dan androidx.tv:tv-material:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit berikut ini.

Fitur Baru

• Di baris, kolom, dan petak lambat, pivot akan diganti, jika perlu, untuk memastikan seluruh item ditampilkan. (11d7e40)
• Menambahkan penyesuaian warna tab dalam berbagai status. (21b2925)
• Carousel kini menerima animasi kustom untuk scroll manual maju dan mundur. (431494a)

Perubahan API

• Mengganti nama androidx.tv.material menjadi androidx.tv.material3 dan meratakan struktur paket pada androidx.tv.material3. (I6ca52)
• Indikator dalam baris Indikator Carousel sekarang menjadi slot yang dapat disesuaikan oleh developer. (268af2a)
• Mengganti nama focusableItem menjadi immersiveListItem. Pengguna harus menambahkan pengubah focusable() atau clickable() secara manual bersama dengan immersiveListItem (5dd5078)(b/263061052)
• Mengganti nama timeToDisplayMillis menjadi autoScrollDurationMillis di komponen Carousel. (431494a)
• CarouselItem kini dibatasi untuk digunakan dalam Carousel. (431494a)
• Carousel kini menerima ContentTransforms sebagai definisi animasi, bukan EnterTransition dan ExitTransitions. (431494a)
• Memperkenalkan PinnableContainer API yang disebarkan oleh daftar lambat melalui komposisi lokal yang memungkinkan penyematan item saat ini. (Ib8881, b/259274257, b/195049010)
• Menambahkan properti mainAxisItemSpacing ke TvLazyListLayoutInfo dan TvLazyGridLayoutInfo (I37765)

Perbaikan Bug

• Perbarui tab-baris untuk memastikannya menangani jumlah tab ke 0 atau 1 dengan benar. (I44009), (1c01525), (b/264018028)
• Memperbaiki error penelusuran fokus saat TvLazyColumn berisi TvLazyRow kosong. (e11b4fe), (b/260299091)
• Pengubah clickable kini berfungsi dengan ImmersiveList. (5dd5078), (b/263061052)
• Tombol Kembali kini ditangani dan digunakan untuk keluar dari Carousel Unggulan. (84c138c)
• Carousel tidak kehilangan fokus pada beberapa penekanan tombol cepat. (799489f)
• Carousel tidak kehilangan fokus pada penekanan tombol yang lama. (b2cf37e)
• Mengatasi error saat jumlah slide carousel berubah. (b261247)

Versi 1.0.0-alpha03

7 Desember 2022

androidx.tv:tv-foundation:1.0.0-alpha03 dan androidx.tv:tv-material:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit ini.

Fitur Baru

• TabRow kini tersedia sebagai API eksperimental yang memungkinkan pengguna menambahkan menu navigasi atas ke aplikasi mereka. Secara umum, perangkat TV berharap tab dimuat saat judul tab difokuskan di baris tab.
• Indikator khusus TV seperti indikator garis bawah dan indikator pil ditawarkan untuk dapat langsung dipakai. Contoh penggunaan dapat ditemukan di tv-samples

Versi 1.0.0-alpha02

9 November 2022

androidx.tv:tv-foundation:1.0.0-alpha02 dan androidx.tv:tv-material:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perbaikan Bug

• Meningkatkan performa scroll saat men-scroll koleksi TvLazyRows/TvLazyColumns dengan mengurangi ruang penelusuran fokus.(I723a3)

Versi 1.0.0-alpha01

5 Oktober 2022

androidx.tv:tv-foundation:1.0.0-alpha01 dan androidx.tv:tv-material:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

Versi alfa pertama berisi implementasi pratinjau awal dari komponen untuk kasus penggunaan TV, termasuk:

• Menambahkan pengubah scrollableWithPivot untuk mengizinkan penampung scroll non-lazy seperti Baris, Kolom, Petak agar penampung scroll men-scroll konten sehingga item dalam fokus tetap berada di posisi yang sama pada layar TV.
• Menambahkan composable TvLazyRow, TvLazyColumn, TvLazyHorizontalGrid, TvLazyVerticalGrid agar penampung scroll men-scroll konten sehingga item dalam fokus tetap berada di posisi yang sama pada layar TV.
• Menambahkan composable Carousel Unggulan untuk TV yang memungkinkan pengguna membuat carousel banner scroll otomatis.
• Menambahkan composable Daftar Imersif untuk TV yang memungkinkan pengguna membuat Baris/Kolom/Petak Imersif yang mengubah latar belakang berdasarkan item daftar yang sedang difokuskan.

Masalah umum

• Saat penampung scroll mendapatkan fokus, elemen pertama tidak mendapatkan fokus secara default.
• Memfokuskan ke TextField tidak selalu membuka keyboard atau dapat menghambat fokus untuk berpindah ke kolom lain.
• Scroll secara vertikal di LazyColumn yang berisi LazyRows memiliki performa buruk.