tv

  
Geliştiricilerin TV uygulamaları yazmaları için Compose ve Materyal Tasarım işlevlerini sağlar.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
15 Ocak 2025 1.0.0 - - 1.1.0-alpha01

Bağımlılıkları bildirme

tv-foundation ve tv-material bağımlılıklarını eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

Eski

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

Kotlin

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

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy verebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

Bu yapı için sürüm notu yok.

Tv-Material Sürümü 1.1

Sürüm 1.1.0-alpha01

15 Ocak 2025

androidx.tv:tv-material:1.1.0-alpha01 yayınlanır. 1.1.0-alpha01 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • FocusEnterExitScope.cancelFocus() değerini cancelFocusChange() olarak değiştirin(I89959)
  • FocusDirection parametresi yerine alıcı kapsamı kullanılarak FocusProperties.enter ve FocusProperties.exit sırasıyla onEnter ve onExit ile değiştirildi. (I6e667)

Hata Düzeltmeleri

  • Ölçeklendirme sırasında titreyen metni düzeltmek için CompositingStrategy.OffScreen, Yüzey'den Metin'e taşındı. (I92b15f17)
  • Bantta bozuk odak yönetimi düzeltildi (Ie508b721375)
  • Yüzey (etkileşimli olmayan), etkileşimli yüzeylere kıyasla basitleştirilmiş bir uygulamaya sahiptir. (I7ea545150)

Tv-Material Sürümü 1.0

Sürüm 1.0.0

21 Ağustos 2024

androidx.tv:tv-material:1.0.0 yayınlanır. 1.0.0 sürümü, androidx.tv:tv-material'ün ilk kararlı sürümüdür.

Sürüm 1.0.0-rc02

7 Ağustos 2024

androidx.tv:tv-material:1.0.0-rc02 yayınlanır. 1.0.0-rc02 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Surface kompozisyonunda titrek metin animasyonu düzeltildi. (3163319)

Sürüm 1.0.0-rc01

10 Temmuz 2024

androidx.tv:tv-material:1.0.0-rc01 yayınlanır. 1.0.0-rc01 sürümü bu taahhütleri içerir.

Sürüm 1.0.0-beta01

1 Mayıs 2024

androidx.tv:tv-material:1.0.0-beta01 yayınlanır. 1.0.0-beta01 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • ColorScheme ve yardımcı program işlevleri artık kararlı. (If34fa)
  • LocalContentColor artık kararlı (I60ee2)
  • Typography API artık kararlı (I088d6)
  • Şekil API'leri artık kararlı (I0f5f4)
  • Border API artık kararlı (I69281)
  • Glow API artık kararlı (Iea5f1)
  • Simge bileşeni artık kararlı (I62c2d)
  • LocalTextStyles API artık kararlı (Iaded8)
  • MaterialTheme API artık kararlı (I2f541)
  • Metin bileşeni artık kararlı (Ib9e31)
  • RadioButton bileşeni artık kararlı (Ia03c8)
  • Geçiş bileşeni artık kararlı (I6cea3)
  • Checkbox bileşenleri artık kararlı (I7eafc)
  • Yüzey bileşenleri artık kararlı (I58758, I04aca)
  • NonInteractiveSurfaceDefaults SurfaceDefaults, NonInteractiveSurfaceColors ise SurfaceColors olarak yeniden adlandırıldı (I0812e)
  • Seçilebilir Yüzey'de artık "işaretle" yerine "seç" terminolojisi kullanılıyor. Bunun nedeni, her iki terimin de farklı anlamlara sahip olmasıdır (I5a206)
  • NavigationDrawer ve NavigationDrawerScope artık kararlı (I249c1)
  • NavigationDrawerItem bileşeni artık kararlı (Id6986)
  • Sekme ve TabRow bileşenleri artık kararlı (I92d92)
  • Button, OutlinedButton, IconButton, OutlinedIconButton ve WideButton bileşenleri artık kararlı (Ib4de8)
  • Card, ClassicCard, CompactCard, WideClassicCard, StandardCardContainer ve WideCardContainer bileşenleri artık kararlı (I34390)
  • StandardCardLayout, StandardCardContainer olarak ve WideCardLayout, WideCardContainer olarak yeniden adlandırıldı (I08883)
  • CardContainerDefaults.ImageCard kaldırıldı ve CardDefaults.ContainerGradient, CardDefaults.ScrimBrush (I6adfe) olarak yeniden adlandırıldı. Kart kapsayıcılarınızda CardContainerDefaults.ImageCard yerine Card kullanabilirsiniz.
  • ListItem ve DenseListItem artık kararlı (Idebd9)
  • ListItemDefaults.ListItemShape, ListItemDefaults.FocusedDisabledBorder ve ListItemDefaults.SelectedContainerColorOpacity artık gizli (I5d533)
  • ListItem parametreleri yeniden düzenlendi ve ListItemDefaults.ListItemElevation, ListItemDefaults.TonalElevation olarak yeniden adlandırıldı (Id6841). headlineContent parametresi, derlenen öğenin en üstüne taşındı. Daha önce, headlineContent parametresini iletmek için Kotlin'in son lambda söz dizimini kullanabiliyordunuz. Artık headlineContent değerini sağlamak için adlandırılmış parametre söz dizimini kullanmanız gerekir.
  • LocalAbsoluteTonalElevation artık şirket içi (Ibfc65)
  • ImmersiveList bileşeni kaldırıldı. Nasıl oluşturacağınızı öğrenmek için bu örneğe göz atın. (Id48da)
  • API'lerinde MutableInteractionSource gösteren tv-material bileşenleri, varsayılan olarak null olan bir MutableInteractionSource göstermek üzere güncellendi. Burada anlamsal bir değişiklik yoktur: null göndermek, MutableInteractionSource öğesini kaldırmak istemediğiniz anlamına gelir ve gerekirse bileşen içinde oluşturulur. null olarak değiştirildiğinde bazı bileşenler hiçbir zaman MutableInteractionSource ayırmaz ve diğer bileşenler yalnızca ihtiyaç duyduklarında tembel bir şekilde bir örnek oluşturur. Bu da bu bileşenlerdeki performansı artırır. Bu bileşenlere ilettiğiniz MutableInteractionSource öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I309b4, b/298048146)
  • TV metin bileşeninin TextAlign parametresi artık boş değil (Ib73b1, b/299490814)
  • ParagraphTextStyle öğesinin TextAlign, TextDirection, Hyphens ve LineBreak alanları için özel bir Belirtilmemiş değeri kullanıma sundu (I4197e, b/299490814)

Davranış Değişiklikleri

  • Etkileşimli olmayan Surface için shape parametresinin varsayılan değeri RectangleShape olarak değiştirildi (I1b859cb)
  • Gerekli API'lerin deneysel olması nedeniyle beta lansmanı için bazı bant özellikleri kaldırıldı (I0e755d4)
  • Surface'daki contentColor değiştirildiğinde artık durum arasında animasyon gösterilmiyor (I436e794f)

Sürüm 1.0.0

Sürüm 1.0.0-alpha12

15 Ocak 2025

androidx.tv:tv-foundation:1.0.0-alpha12 yayınlanır. 1.0.0-alpha12 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • tv-foundation'daki yavaş düzenleri temizleyin. tv-foundation'ın yavaş düzenlerinden geçiş yapmak için 1.0.0-alpha11 sürüm notlarına bakın. (I2fdd3, b/358913893)

Sürüm 1.0.0-alpha11

10 Temmuz 2024

androidx.tv:tv-foundation:1.0.0-alpha11 yayınlanır. 1.0.0-alpha11 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Tv Lazy Layouts, tv-foundation kitaplığından kullanımdan kaldırıldı. TV'deki yavaş düzenleri nasıl bırakacağınızı öğrenmek için bu kaydı inceleyin. (I0855f, b/332674072)
  • PlatformImeOptions artık arayüz yerine somut bir sınıftır. (If40a4)

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ı. 1.0.0-alpha10 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • NavigationDrawer ve ModalNavigationDrawer'de kullanılmak üzere NavigationDrawerItem tanıtıldı. (I4b491)
  • Taban profili tv-foundation kitaplığına ekleyin. (2b57fd7)
  • Taban profili tv-material kitaplığına ekleyin. (1711ff5)

API Değişiklikleri

  • NavigationDrawerScope.doesTabRowHaveFocus, NavigationDrawerScope.hasFocus olarak yeniden adlandırıldı. (I8286b)
  • TabRowScope.isActivated, TabRowScope.hasFocus olarak yeniden adlandırıldı. (Ic4273)

Hata Düzeltmeleri

  • Bant'ın, odaklanmayı geri yükleyen API'leri kullanan bitişik öğelerle uyumluluğunu düzeltin. (7b2a7a4)
  • İşletim sistemi tarafından desteklenmediği için 28'den düşük API_LEVEL için parlama göstergesini devre dışı bırakın. (6d3616f)
  • Ters yönde hızlı kaydırırken, tembel kapsayıcılarda öğelerin yanlış yerleştirilmesinden kaynaklanan ANR kilitlenmesi düzeltildi. (642d65c)
  • Modüler gezinme çekmecesinde arka plan dolgusu kaldırıldı. (69965b2)
  • Gezinme çekmecesinde, scrim'in arka plan içeriğinin arkasında değil, üstünde çizilmesi sorunu düzeltildi. (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ı. 1.0.0-alpha09 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Alt bileşimlerin yaşam döngüsünü ve yeniden kullanımını yönetmek için ReusableComposition arayüzü ekleyin. (I812d1, b/252846775)
  • tv-foundation çatalını compose-foundation ile senkronize edin. (I737c3, b/287011882)
  • LazyLayout için aşırı yükleme eklendi. Önceki gibi düz bir nesne değil, LazyLayoutItemProvider lambdası kabul eder. Önceki aşırı yükleme desteği sonlandırıldı. (I42a5a)
  • Geliştiricinin AndroidImeOptions aracılığıyla dokunmatik klavye konumunu yapılandırmasına izin vermek için TvKeyboardAlignment ekleyin. (Idb772)
  • TV İçerik Oluşturma Aracı'na Saver ile CarouselState'ü hatırlamak için rememberCarouselState ekleyin. (Id7275)
  • Kullanıcıların scrim'e degrade eklemesine izin vermek için scrimColor: Color parametresini scrimBrush:Brush parametresine 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 taahhütleri içerir.

Yeni Özellikler

  • TV için Oluştur içeriği için çip bileşenlerini kullanıma sunuyoruz. (I86da4)
  • TV İçerik Oluşturma Materyaline ListItem bileşeni ekleyin. (I3f0b3)
  • TV İçerik Oluşturma Materyaline DenseListItem bileşeni ekleyin. (I536bf)

API Değişiklikleri

  • Herkese açık tv-material API'leri Deneysel olarak işaretlendi. (I632e7)
  • Sekme bileşiği ile TabRow bileşiğindeki durumu paylaşmak için TabRowScope özelliği kullanıma sunuldu ve TabColors özellikleri yeniden adlandırıldı. (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 taahhütleri içerir.

API Değişiklikleri

  • Bileşenlerin ölçek göstergeleri artık ölçeklendirmeyi devre dışı bırakmak için Hiçbiri'yi içeriyor. (I50df5)
  • TV Material Surface, Kartlar ve Düğmeler için uzun tıklama desteği eklendi. (Id2b89)
  • CarouselItem ve CarouselScope kaldırıldı. Slaytta ön planda içerik animasyonu, AnimatedContentScope'ten Modifier.animateEnterExit kullanılarak yapılabilir. (Ic038e)
  • TV materyal yüzeyi için color ve contentColor parametreleri colors olarak birleştirildi. (Ie69eb)
  • TV Materyal'de RadioButton bileşeni kullanıma sunuldu. (I08690)
  • TV Materyal'de Switch bileşeni kullanıma sunuldu. (I45e29)
  • TV Materyal'de Checkbox bileşeni kullanıma sunuldu. (I6a45a)
  • TV materyalinde etkileşime geçilmeyen yüzey kullanıma sunuldu. (Ic5f85)
  • İşaretlerin dahili olmasını sağlayın. (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 taahhütleri içerir.

Yeni Özellikler

  • TV için optimize edilmiş Material 3 kart uygulamaları ekleyin.
    • Temel Kart (I5b701)
    • ClassicCard, CompactCard ve WideClassicCard (I70471)
    • StandardCardLayout ve WideCardLayout (I33fae)
  • TV için optimize edilmiş Material 3 düğme uygulamaları ekleyin.

API Değişiklikleri

  • Carousel'deki CarouselSlide ve slideCount, 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'e odaklanıldığında geri D-pad düğmesini kullanın. (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 taahhütleri içerir.

API Değişiklikleri

  • tv-material'te derlenebilecek Yan Gezinme Çekmecesi ile tanışın. Bu bileşiği nasıl kullanacağınızı öğrenmek için lütfen örneklere bakın. (I12c08)
  • TV Material 3'te Icon composable'i kullanıma sunma (I72db9)
  • Kenarlık, parıltı ve ölçek gibi göstergelerle tv-material için yüzey kompozisyonu kullanıma sunuldu. Bu göstergeler, TV ekranındaki odaklanmış öğeyi net bir şekilde vurgulayan bileşenler oluşturmak için kullanılabilir. (I4a6d8), (Iceea1), (Iee4d4), (I79edf), (Icb376)
  • "Bant" API'sindeki slideCount parametre adıyla eşleşecek şekilde CarouselItem değerini CarouselSlide olarak güncelleyin (Ic4299)

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 taahhütleri içerir.

Yeni Özellikler

  • Yavaş satırlarda, sütunlarda ve ızgaralarda, öğenin tamamının görüntülendiğinden emin olmak için gerekirse pivot geçersiz kılınır. (11d7e40)
  • Farklı durumlarda sekme renklerinin özelleştirilmesini ekleyin. (21b2925)
  • Bant artık ileri ve geri manuel kaydırma için özel animasyonlar kabul ediyor. (431494a)

API Değişiklikleri

  • androidx.tv.material'ü androidx.tv.material3 olarak yeniden adlandırma ve androidx.tv.material3 altında paket yapısını düzleştirme. (I6ca52)
  • Bant göstergesi satırındaki gösterge artık geliştirici tarafından özelleştirilebilecek bir yuvadır. (268af2a)
  • focusableItem, immersiveListItem olarak yeniden adlandırıldı. Kullanıcıların immersiveListItem ile birlikte focusable() veya clickable() değiştiriciyi manuel olarak eklemesi gerekir (5dd5078)(b/263061052)
  • Atlı Karınca bileşeninde timeToDisplayMillis, autoScrollDurationMillis olarak yeniden adlandırıldı. (431494a)
  • CarouselItem artık Carousel'larda kullanımla sınırlandırılmıştır. (431494a)
  • Bant, animasyon tanımı olarak artık EnterTransition ve ExitTransitions yerine ContentTransforms değerini kabul ediyor. (431494a)
  • Mevcut öğenin sabitlenmesine olanak tanıyan yerel bir kompozisyon aracılığıyla, tembel listeler tarafından dağıtılan PinnableContainer api'yi kullanıma sunduk. (Ib8881, b/259274257, b/195049010)
  • mainAxisItemSpacing mülkü TvLazyListLayoutInfo ve TvLazyGridLayoutInfo'ye eklendi (I37765)

Hata Düzeltmeleri

  • Sekme satırını, sekme sayısının 0 veya 1 olduğu durumlarda doğru şekilde işleyeceği şekilde güncelleyin. (I44009), (1c01525), (b/264018028)
  • TvLazyColumn boş TvLazyRow içerdiğinde odak arama kilitlenme sorunu düzeltildi. (e11b4fe), (b/260299091)
  • clickable değiştiricisi artık ImmersiveList ile birlikte kullanılabilir. (5dd5078), (b/263061052)
  • Geri tuşu artık kullanılabiliyor ve öne çıkanlar bandından çıkmak için kullanılıyor. (84c138c)
  • Bant, hızlı bir şekilde birden fazla tuşa basıldığında odağını kaybetmemelidir. (799489f)
  • Bant, uzun süreli tuş basmalarda odağını kaybetmemelidir. (b2cf37e)
  • Banttaki slayt sayısı değiştiğinde yaşanan kilitlenmeler giderildi. (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ı. 1.0.0-alpha03 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • TabRow artık kullanıcıların uygulamalarına üst gezinme çubukları eklemelerine olanak tanıyan deneysel bir API olarak kullanılabilir. Genel olarak TV cihazları, sekme satırında sekme başlığına odaklanıldığında sekmelerin yüklenmesini bekler.
  • Alt çizgi göstergesi ve hap göstergesi gibi TV'ye özgü göstergeler kullanıma hazır olarak sunulur. Örnek kullanımları tv-samples adresinde bulabilirsiniz.

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ı. 1.0.0-alpha02 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Odak 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ı. 1.0.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

İlk alfa sürümünde, TV kullanım alanlarına yönelik bileşenlerin erken önizleme uygulamaları yer alır. Bunlar arasında şunlar bulunur:

  • Satır, sütun, ızgara gibi yavaş kaydırmayan kapsayıcılarda, odaklanan öğenin TV ekranında aynı konumda kalması için kaydırıcı kapsayıcının içeriği kaydırmasına izin vermek üzere scrollableWithPivot değiştiricisi eklendi.
  • Kaydırma kapsayıcısının içeriği kaydırarak odaktaki öğenin TV ekranında aynı konumda kalması için TvLazyRow,TvLazyColumn, TvLazyHorizontalGrid, TvLazyVerticalGrid bileşenleri ekleme.
  • Kullanıcının otomatik kaydırmalı bir banner rulosu oluşturmasına olanak tanıyan, TV için öne çıkanlar rulosu bileşeni eklendi.
  • TV için kullanıcının, odaktaki liste öğesine göre arka planı değiştiren bir Immersive Satır/Sütun/Izgara oluşturmasına olanak tanıyan Immersive Liste bileşeni eklendi.

Bilinen sorunlar

  • Kaydırma kapsayıcısı odak aldığında ilk öğe varsayılan olarak odak almaz.
  • TextField simgesine odaklanmak her zaman klavyeyi açmaz veya odağın diğer alanlara taşınmasını engelleyebilir.
  • LazyRows içeren bir LazyColumn'te dikey kaydırma performansı düşüktür.