TV
Son Güncelleme | Kararlı Sürüm | Serbest Bırakma Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
4 Ekim 2023 | - | - | - | 1.0.0-alfa10 |
Bağımlılıkları bildirme
tv-foundation ve tv-material'e bağımlılık eklemek üzere projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanız veya modülünüz için build.gradle
dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:
Modern
dependencies { implementation "androidx.tv:tv-foundation:1.0.0-alpha10" implementation "androidx.tv:tv-material:1.0.0-alpha10" }
Kotlin
dependencies { implementation("androidx.tv:tv-foundation:1.0.0-alpha10") implementation("androidx.tv:tv-material:1.0.0-alpha10") }
Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme bölümüne bakın.
Geri bildirim
Geri bildirimleriniz Jetpack'i iyileştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı geliştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni hesap oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.
Daha fazla bilgi için Sorun İzleyici belgelerine bakın.
Bu yapı için sürüm notu yok.
Sürüm 1.0.0
Sürüm 1.0.0-alpha10
4 Ekim 2023
androidx.tv:tv-foundation:1.0.0-alpha10
ve androidx.tv:tv-material:1.0.0-alpha10
yayınlandı. Sürüm 1.0.0-alpha10 bu kaydetmeleri içerir.
Yeni Özellikler
NavigationDrawerItem
,NavigationDrawer
veModalNavigationDrawer
içinde kullanılmak üzere kullanıma sunuldu. (I4b491)- tv-foundation kitaplığına temel profil ekleyin. (2b57fd7)
- Televizyon materyali kitaplığına temel profil ekleyin. (1711ff5)
API Değişiklikleri
NavigationDrawerScope.doesTabRowHaveFocus
adlı dosyaNavigationDrawerScope.hasFocus
olarak yeniden adlandırıldı. (I8286b)TabRowScope.isActivated
adlı dosyaTabRowScope.hasFocus
olarak yeniden adlandırıldı. (Ic4273)
Hata Düzeltmeleri
- Bant'ın, odak geri kazanıcı API'leri kullanan bitişik öğelerle uyumluluğu düzeltildi. (7b2a7a4)
- OS tarafından desteklenmediğinden API_LEVEL 28'in altında parlaklık gösterimini devre dışı bırak. (6d3616f)
- Ters yönde hızlı kaydırma yaparken, öğelerin geç kapsayıcılara yanlış yerleştirilmesinden kaynaklanan ANR kilitlenmelerini düzeltin. (642d65c)
- Kalıcı Gezinme Çekmecesi'ndeki arka plan dolgusu kaldırıldı. (69965b2)
- Gezinme Çekmecesindeki Scrim'i, arka plan içeriğinin arkasında değil üzerine çizilecek şekilde düzeltin. (d4bbefb)
Sürüm 1.0.0-alpha09
6 Eylül 2023
androidx.tv:tv-foundation:1.0.0-alpha09
ve androidx.tv:tv-material:1.0.0-alpha09
yayınlandı. Sürüm 1.0.0-alpha09 bu kaydetmeleri içerir.
API Değişiklikleri
- Yaşam döngüsünü yönetmek ve alt bestelerin yeniden kullanımı için
ReusableComposition
arayüzü ekleyin. (I812d1, b/252846775) - TV-Temel çatalını, yazma temeli ile senkronize edin. (I737c3, b/287011882)
- Aşırı
LazyLayout
yüklemesi eklendi.LazyLayoutItemProvider
lambda değerini kabul ediyor, eskisi gibi düz bir nesne kabul etmiyor. Önceki aşırı yükleme kullanımdan kaldırıldı. (I42a5a) - Geliştiricinin dokunmatik klavye konumunu
AndroidImeOptions
aracılığıyla yapılandırmasına izin vermek içinTvKeyboardAlignment
eklentisini ekleyin. (Idb772) Saver
ile birlikteCarouselState
uygulamasının hatırlanması için TV'deki İçerik Oluşturma Materyali'nerememberCarouselState
ekleyin. (Id7275)- Kullanıcıların scrim'e renk geçişleri eklemesine izin vermek için
scrimColor: Color
parametresiniscrimBrush:Brush
parametresi olarak değiştirme. (I254d4)
Sürüm 1.0.0-alpha08
26 Temmuz 2023
androidx.tv:tv-foundation:1.0.0-alpha08
ve androidx.tv:tv-material:1.0.0-alpha08
yayınlandı. 1.0.0-alpha08 sürümü bu kayıtları içerir.
Yeni Özellikler
- TV materyalleri için Compose'un Çip bileşenlerini tanıtın. (I86da4)
- TV Oluşturma Materyali'ne
ListItem
bileşenini ekleyin. (I3f0b3) - TV Oluşturma Materyali'ne
DenseListItem
bileşenini ekleyin. (I536bf)
API Değişiklikleri
- Herkese açık tv materyali API'leri Deneysel olarak işaretlendi. (I632e7)
- Sekme oluşturabilir ve yeniden adlandırılmış
TabColors
özellikleriyle oluşturulabilecekTabRow
adlı iş ortağından durum paylaşımı içinTabRowScope
özelliği kullanıma sunuldu. (Ief587)
Sürüm 1.0.0-alpha07
7 Haziran 2023
androidx.tv:tv-foundation:1.0.0-alpha07
ve androidx.tv:tv-material:1.0.0-alpha07
yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.
API Değişiklikleri
- Bileşenlerin ölçek göstergelerinde artık ölçeklendirmeyi devre dışı bırakmak için Yok ibaresi yer alır. (I50df5)
- TV Materyali Yüzeyi, Kartlar ve Düğmeler için uzun tıklama desteği eklendi. (Id2b89)
CarouselItem
veCarouselScope
kaldırıldı. Slaytta,AnimatedContentScope
öğesindekiModifier.animateEnterExit
kullanılarak ön plan içeriği animasyonu oluşturulabilir. (Ic038e)- TV Malzemesi Yüzeyi için
color
vecontentColor
parametrecolors
olarak birleştirildi. (Ie69eb) - TV Materyali ile derlenebilir
RadioButton
kullanıma sunuldu. (I08690) - TV Materyali ile derlenebilir
Switch
kullanıma sunuldu. (I45e29) - TV Materyali ile derlenebilir
Checkbox
kullanıma sunuldu. (I6a45a) - TV Malzemesinde etkileşim kuramayan yüzey kullanıldı. (Ic5f85)
- Dahili göstergeler sunun. (Ibff82)
Sürüm 1.0.0-alpha06
19 Nisan 2023
androidx.tv:tv-foundation:1.0.0-alpha06
ve androidx.tv:tv-material:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
Yeni Özellikler
- TV için optimize edilmiş Materyal 3 Kart uygulamalarını ekleyin.
- TV için optimize edilmiş Materyal 3 Düğme uygulamaları ekleyin.
API Değişiklikleri
Carousel
içindekiCarouselSlide
veslideCount
adlı dosya,CarouselItem
veitemCount
olarak yeniden adlandırıldı. (Ie554c)forward
vebackward
ContentTransforms
,StartToEnd
veEndToStart
olarak yeniden adlandırıldı. (Ie554c)
Hata Düzeltmeleri
NavigationDrawer
odaklanıldığında DPAD düğmesini arkada tut. (d654f4)
Sürüm 1.0.0-alpha05
22 Mart 2023
androidx.tv:tv-foundation:1.0.0-alpha05
ve androidx.tv:tv-material:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
API Değişiklikleri
tv-material
içinde oluşturulabilen Yan Gezinme Çekmecesi ile tanışın. Bu beste öğesinin nasıl kullanılacağını öğrenmek için lütfen örneklere bakın. (I12c08)- TV Materyali 3'te (I72db9) oluşturulabilen simgeyi kullanıma sunma
tv-material
için Kenarlık, Parlaklık ve Ölçek gibi göstergelerle derlenebilir yüzey kullanıma sunuluyor. Bu özellikler, TV ekranında odaklanılan öğeyi net bir şekilde vurgulayan bileşenler oluşturmak için kullanılabilir. (I4a6d8), (Iceea1), (Iee4d4), (I79edf), (Icb376)CarouselItem
değerini, "Carousel" API'sindeki (Ic4299)slideCount
parametre adıyla eşleşecek şekildeCarouselSlide
olarak güncelleyin
Sürüm 1.0.0-alpha04
8 Şubat 2023
androidx.tv:tv-foundation:1.0.0-alpha04
ve androidx.tv:tv-material:1.0.0-alpha04
yayınlandı. 1.0.0-alpha04 sürümü bu kayıtları içerir.
Yeni Özellikler
- Geç satır, sütun ve ızgaralarda, tüm öğenin görünüme getirilmesini sağlamak için gerekirse pivot tablo geçersiz kılınır. (11d7e40)
- Farklı durumlara sekme renklerini özelleştirebilirsiniz. (21b2925)
- Bant artık ileri ve geri manuel kaydırma için özel animasyonları kabul ediyor. (431494a)
API Değişiklikleri
androidx.tv.material
öğesiandroidx.tv.material3
olarak yeniden adlandırılıyor ve paket yapısıandroidx.tv.material3
altında birleştiriliyor. (I6ca52)- Atlı Karınca Göstergesi satırındaki gösterge artık geliştirici tarafından özelleştirilebilen bir yuvadır. (268af2a)
focusableItem
adlı dosyaimmersiveListItem
olarak yeniden adlandırıldı. KullanıcılarınimmersiveListItem
(5dd5078)(b/263061052) ile birliktefocusable()
veyaclickable()
değiştiricisini manuel olarak eklemesi gerekirtimeToDisplayMillis
öğesi, Bant bileşenindeautoScrollDurationMillis
olarak yeniden adlandırıldı. (431494a)CarouselItem
artıkCarousel
içinde kullanılmak üzere kısıtlandı. (431494a)- Bant, animasyon tanımı olarak artık
EnterTransition
veExitTransitions
yerineContentTransforms
değerini kabul ediyor. (431494a) - Geçerli öğenin sabitlenmesini sağlayan bir beste yerel aracılığıyla geç listeler tarafından yayılan
PinnableContainer
API'si kullanıma sunuldu. (Ib8881, b/259274257, b/195049010) TvLazyListLayoutInfo
veTvLazyGridLayoutInfo
alanlarınamainAxisItemSpacing
mülkü eklendi (I37765)
Hata Düzeltmeleri
- Sekme satırını, 0 veya 1 sekme sayısını doğru şekilde işlediğinden emin olmak için güncelleyin. (I44009), (1c01525), (b/264018028)
TvLazyColumn
, boşTvLazyRow
içerdiğinde odak-arama kilitlenmesi düzeltildi. (e11b4fe), (b/260299091)clickable
değiştirici artıkImmersiveList
ile çalışıyor. (5dd5078), (b/263061052)- Geri tuşu artık İşlenir ve Öne Çıkan Bant'tan çıkmak için kullanılır. (84c138c)
- Birden fazla hızlı tuşa basıldığında bantın odağı kaybolmuyor. (799489f)
- Uzun tuşlara basıldığında bantın odağı kaybolmuyor. (b2cf37e)
- Bant slayt sayısı değiştiğinde yaşanan kilitlenmeler düzeltildi. (b261247)
Sürüm 1.0.0-alpha03
7 Aralık 2022
androidx.tv:tv-foundation:1.0.0-alpha03
ve androidx.tv:tv-material:1.0.0-alpha03
yayınlandı. Sürüm 1.0.0-alpha03 bu kayıtları içerir.
Yeni Özellikler
TabRow
artık kullanıcıların uygulamalarına üst gezinme çubuklarını eklemesine olanak tanıyan deneysel bir API olarak kullanılabilir. Genel olarak TV cihazları, sekme satırında sekme başlığı odaklanıldığında sekmelerin yüklenmesini bekler.- Altı çizili göstergesi ve hap göstergesi gibi TV'ye özel göstergeler kullanıma hazır olarak sunulur. Örnek kullanımlar tv-örnekleri bölümünde bulunabilir.
Sürüm 1.0.0-alpha02
9 Kasım 2022
androidx.tv:tv-foundation:1.0.0-alpha02
ve androidx.tv:tv-material:1.0.0-alpha02
yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.
Hata Düzeltmeleri
- Odaklanılan arama alanını azaltarak
TvLazyRows/TvLazyColumns
koleksiyonunda gezinirken kaydırma performansı iyileştirildi.(I723a3)
Sürüm 1.0.0-alpha01
5 Ekim 2022
androidx.tv:tv-foundation:1.0.0-alpha01
ve androidx.tv:tv-material:1.0.0-alpha01
yayınlandı. Sürüm 1.0.0-alpha01 bu kayıtları içerir.
Yeni Özellikler
İlk alfa, aşağıdakiler de dahil olmak üzere TV kullanım alanları için bileşenlerin erken önizleme uygulamalarını içerir:
- Satır, Sütun, Tablo gibi geç olmayan kaydırma kapsayıcılarının, kaydırılan kapsayıcının içeriği kaydırmasını sağlayarak odaklanılan öğenin TV ekranında aynı konumda kalması için
scrollableWithPivot
değiştiricisi eklendi. - Kaydırma kapsayıcısının içeriği kaydırarak odaklandığı öğenin TV ekranında aynı konumda kalması için besteler
TvLazyRow
,TvLazyColumn
,TvLazyHorizontalGrid
,TvLazyVerticalGrid
ekleniyor. - Kullanıcının otomatik kayan bir banner bandı oluşturmasına olanak tanıyan TV için oluşturulabilir Öne Çıkan Bant ekleniyor.
- Kullanıcının, odaklanılan liste öğesine göre arka planı değiştiren bir Yoğun Satır/Sütun/Izgara oluşturmasına olanak tanıyan, TV için oluşturulabilir Yoğun İçerik Listesi ekleme.
Bilinen sorunlar
- Kaydırma kapsayıcısı odaklandığında, ilk öğeye varsayılan olarak odaklanmaz.
TextField
öğesine odaklanmak her zaman klavyeyi açmaz veya odağın diğer alanlara gitmesini engelleyebilir.LazyRows
içeren birLazyColumn
içinde dikey olarak kaydırma yapmak kötü performansa sahiptir.