TV

  
Geliştiricilere TV uygulamaları yazabilmeleri için Oluşturma ve Materyal tasarım işlevleri sağlar
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.

Yeni sorun oluşturma

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 ve ModalNavigationDrawer 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ı dosya NavigationDrawerScope.hasFocus olarak yeniden adlandırıldı. (I8286b)
  • TabRowScope.isActivated adlı dosya TabRowScope.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çin TvKeyboardAlignment eklentisini ekleyin. (Idb772)
  • Saver ile birlikte CarouselState uygulamasının hatırlanması için TV'deki İçerik Oluşturma Materyali'ne rememberCarouselState ekleyin. (Id7275)
  • Kullanıcıların scrim'e renk geçişleri eklemesine izin vermek için scrimColor: Color parametresini scrimBrush: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şturulabilecek TabRow adlı iş ortağından durum paylaşımı için TabRowScope ö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 ve CarouselScope kaldırıldı. Slaytta, AnimatedContentScope öğesindeki Modifier.animateEnterExit kullanılarak ön plan içeriği animasyonu oluşturulabilir. (Ic038e)
  • TV Malzemesi Yüzeyi için color ve contentColor parametre colors 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.
    • Temel Kart (I5b701)
    • ClassicCard, CompactCard ve WideClassicCard (I70471)
    • StandardCardLayout ve WideCardLayout (I33fae)
  • TV için optimize edilmiş Materyal 3 Düğme uygulamaları ekleyin.

API Değişiklikleri

  • Carousel içindeki CarouselSlide ve slideCount adlı dosya, CarouselItem ve itemCount olarak yeniden adlandırıldı. (Ie554c)
  • forward ve backward ContentTransforms, StartToEnd ve EndToStart 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 şekilde CarouselSlide 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 öğesi androidx.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ı dosya immersiveListItem olarak yeniden adlandırıldı. Kullanıcıların immersiveListItem (5dd5078)(b/263061052) ile birlikte focusable() veya clickable() değiştiricisini manuel olarak eklemesi gerekir
  • timeToDisplayMillis öğesi, Bant bileşeninde autoScrollDurationMillis olarak yeniden adlandırıldı. (431494a)
  • CarouselItem artık Carousel içinde kullanılmak üzere kısıtlandı. (431494a)
  • Bant, animasyon tanımı olarak artık EnterTransition ve ExitTransitions yerine ContentTransforms 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 ve TvLazyGridLayoutInfo alanlarına mainAxisItemSpacing 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ık ImmersiveList 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 bir LazyColumn içinde dikey olarak kaydırma yapmak kötü performansa sahiptir.