tv
| Son Güncelleme | Kararlı Sürüm | Sürüm Adayı | Beta Sürümü | Alfa Sürümü |
|---|---|---|---|---|
| 11 Mart 2026 | 1.0.1 | - | 1.1.0-beta01 | - |
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 veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapıtların bağımlılıklarını ekleyin:
Eski
dependencies { implementation "androidx.tv:tv-foundation:1.0.0-beta01" implementation "androidx.tv:tv-material:1.1.0-beta01" }
Kotlin
dependencies { implementation("androidx.tv:tv-foundation:1.0.0-beta01") implementation("androidx.tv:tv-material:1.1.0-beta01") }
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ştirmeye yönelik fikirleriniz olursa lütfen bize bildirin. Yeni bir sorun 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 Issue Tracker belgelerini inceleyin.
Bu yapıyla ilgili sürüm notu yok.
Tv-Material Version 1.1
Sürüm 1.1.0-beta01
11 Mart 2026
androidx.tv:tv-material:1.1.0-beta01 iptal edilir. 1.1.0-beta01 sürümü bu commit'leri içerir.
API Değişiklikleri
- Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürümün kullanılması gerekir (Idb6b5, b/344563182).
Harici Katkı (External Contribution)
androidx.compose.ui.graphics.NativePainttypealias desteği sonlandırıldı. Bunun yerine doğrudanandroid.graphics.Paintkullanın (I6303c, b/477394763)- Platform türünün
typealiasüzerindencommonMainkaynak kümesine aktarılmasını önlemek içinPaint.asFrameworkPaint()uzantısınıPaint.nativePaintile değiştirin (I6303c, b/477394763).
Sürüm 1.1.0-alpha01
15 Ocak 2025
androidx.tv:tv-material:1.1.0-alpha01 iptal edilir. 1.1.0-alpha01 sürümü bu commit'leri içerir.
API Değişiklikleri
FocusEnterExitScope.cancelFocus()öğesinicancelFocusChange()olarak değiştirin(I89959)FocusProperties.enterveFocusProperties.exit,FocusDirectionparametresi yerine alıcı kapsamı kullanılarak sırasıylaonEnterveonExitile değiştirildi. (I6e667)
Hata Düzeltmeleri
- Ölçeklendirme sırasında titrek metni düzeltmek için
CompositingStrategy.OffScreen, Yüzey'den Metin'e taşındı. (I92b15f17) - Banttaki bozuk odak yönetimi düzeltildi (Ie508b721375)
- Yüzey (etkileşimli olmayan), etkileşimli olanlara kıyasla daha basit bir uygulamaya sahiptir. (I7ea545150)
Tv-Material Version 1.0
Sürüm 1.0.1
16 Temmuz 2025
androidx.tv:tv-material:1.0.1 iptal edilir. 1.0.1 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
NavigationDrawerItemyüksekliği, spesifikasyonlarla eşleşecek şekilde güncellendi. (cf9a3ce)- Birleştirme stratejisi yapılandırması, Surface composable'dan Text composable'a taşındı. Bu düzeltme, Exoplayer'ın daha düşük Android API sürümlerinde Surface composable'larında oluşturulmamasına neden olan hatayı düzeltir. (9858ffb)
Sürüm 1.0.0
21 Ağustos 2024
androidx.tv:tv-material:1.0.0 iptal edilir. 1.0.0 sürümü, androidx.tv:tv-material'nı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 iptal edilir. 1.0.0-rc02 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Surface composable'da titrek metin animasyonu sorunu düzeltildi. (3163319)
Sürüm 1.0.0-rc01
10 Temmuz 2024
androidx.tv:tv-material:1.0.0-rc01 iptal edilir. 1.0.0-rc01 sürümü bu commit'leri içerir.
Sürüm 1.0.0-beta01
1 Mayıs 2024
androidx.tv:tv-material:1.0.0-beta01 iptal edilir. 1.0.0-beta01 sürümü bu commit'leri içerir.
API Değişiklikleri
ColorSchemeve yardımcı işlevleri artık kararlı. (If34fa)LocalContentColorartık kararlı sürümde (I60ee2)TypographyAPI artık kararlı (I088d6)- Şekiller API'leri artık kararlı sürümde (I0f5f4)
- Border API artık kararlı sürümde (I69281)
- Glow API artık kararlı (Iea5f1)
- Simge bileşeni artık kararlı (I62c2d)
LocalTextStylesAPI artık kararlı (Iaded8)MaterialThemeAPI artık kararlı (I2f541)- Metin bileşeni artık kararlı (Ib9e31)
RadioButtonbileşeni artık kararlı (Ia03c8)- Switch bileşeni artık kararlı sürümde (I6cea3)
Checkboxbileşenleri artık kararlı (I7eafc)- Yüzey bileşenleri artık kararlı sürümde (I58758, I04aca)
NonInteractiveSurfaceDefaultsadlı öğeyiSurfaceDefaults,NonInteractiveSurfaceColorsadlı öğeyi iseSurfaceColorsolarak yeniden adlandırdı (I0812e)- Seçilebilir yüzeyler artık "işaretle" yerine "seç" terminolojisini kullanıyor. Bunun nedeni, her ikisinin de farklı semantik anlamlara sahip olmasıdır (I5a206).
NavigationDrawerveNavigationDrawerScopeartık kararlı (I249c1)NavigationDrawerItembileşeni artık kararlı (Id6986)- Sekme ve
TabRowbileşenleri artık kararlı (I92d92) Button,OutlinedButton,IconButton,OutlinedIconButtonveWideButtonbileşenleri artık kararlı (Ib4de8)Card,ClassicCard,CompactCard,WideClassicCard,StandardCardContainerveWideCardContainerbileşenleri artık kararlı (I34390)StandardCardLayoutadlı öğeyiStandardCardContainer,WideCardLayoutadlı öğeyi iseWideCardContainerolarak yeniden adlandırdı (I08883)CardContainerDefaults.ImageCardkaldırıldı veCardDefaults.ContainerGradient,CardDefaults.ScrimBrush(I6adfe) olarak yeniden adlandırıldı. Kart kapsayıcılarınızdaCardContainerDefaults.ImageCardyerineCardkullanabilirsiniz.ListItemveDenseListItemartık kararlı (Idebd9)ListItemDefaults.ListItemShape,ListItemDefaults.FocusedDisabledBorderveListItemDefaults.SelectedContainerColorOpacityartık gizli (I5d533)ListItemparametreleri yeniden düzenlendi veListItemDefaults.ListItemElevation,ListItemDefaults.TonalElevationolarak yeniden adlandırıldı (Id6841).headlineContentparametresi, composable'ın en üstüne taşındı. Daha önce,headlineContentdeğerini iletmek için Kotlin'in sondaki lambda söz diziminden yararlanabiliyordunuz. Şimdi,headlineContentdeğerini sağlamak için adlandırılmış parametre söz dizimini kullanmanız gerekir.LocalAbsoluteTonalElevationartık dahili (Ibfc65)ImmersiveListbileşeni kaldırıldı. Kendiniz nasıl oluşturacağınızı öğrenmek için bu örneğe göz atın. (Id48da)- API'lerinde
MutableInteractionSourcedeğerini gösteren tv-material bileşenleri, artık varsayılan olarak null değerini gösteren ve null değer atanabilen birMutableInteractionSourcedeğerini gösterecek şekilde güncellendi. Burada semantik değişiklik yoktur: Null iletmek,MutableInteractionSourceöğesini yükseltmek istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Boş değere geçiş, bazı bileşenlerin hiçbir zamanMutableInteractionSourceayırmamasına ve diğer bileşenlerin yalnızca ihtiyaç duyduklarında geç oluşturmasına olanak tanır. Bu da bu bileşenlerde performansı artırır. Bu bileşenlere ilettiğinizMutableInteractionSourcedeğerini kullanmıyorsanız bunun yerine null iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I309b4, b/298048146) - TV Metni bileşeninin
TextAlignparametresi artık boş olmayan bir değerdir (Ib73b1, b/299490814) ParagraphTextStyle'inTextAlign,TextDirection,HyphensveLineBreakalanları için (I4197e, b/299490814) yerine geçecek özel bir Belirtilmemiş değeri kullanıma sunuldu.
Davranış Değişiklikleri
- Etkileşimli olmayan
Surfaceiçinshapeparametresinin varsayılan değeriRectangleShapeolarak değiştirildi (I1b859cb) - Gerekli API'ler deneysel olduğu için (I0e755d4) beta lansmanında bazı carousel özellikleri kullanılamaz.
SurfaceiçindekicontentColordeğiştirildiğinde artık durumlar arasında animasyon oluşturulmuyor (I436e794f)
Sürüm 1.0.0
Sürüm 1.0.0-beta01
11 Mart 2026
androidx.tv:tv-foundation:1.0.0-beta01 iptal edilir. 1.0.0-beta01 sürümü bu commit'leri içerir.
API Değişiklikleri
- Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürümün kullanılması gerekir (Idb6b5, b/344563182).
Sürüm 1.0.0-alpha12
15 Ocak 2025
androidx.tv:tv-foundation:1.0.0-alpha12 iptal edilir. 1.0.0-alpha12 sürümü bu commit'leri içerir.
API Değişiklikleri
- tv-foundation'daki tembel düzenleri temizleyin. tv-foundation tembel 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 iptal edilir. 1.0.0-alpha11 sürümü bu commit'leri içerir.
API Değişiklikleri
- Tv Lazy Layouts, tv-foundation kitaplığından kaldırıldı. TV'de geç yüklenen düzenlerden nasıl geçeceğinizi öğrenmek için bu bileti inceleyin. (I0855f, b/332674072)
PlatformImeOptionsartık arayüz yerine somut bir sınıf. (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ü şu commit'leri içerir.
Yeni Özellikler
NavigationDrawerveModalNavigationDraweriçinde kullanılmak üzereNavigationDrawerItemözelliği kullanıma sunuldu. (I4b491)- tv-foundation kitaplığına temel profil ekleyin. (2b57fd7)
- tv-material kitaplığına temel profil ekleyin. (1711ff5)
API Değişiklikleri
NavigationDrawerScope.doesTabRowHaveFocus,NavigationDrawerScope.hasFocusolarak yeniden adlandırıldı. (I8286b)TabRowScope.isActivated,TabRowScope.hasFocusolarak yeniden adlandırıldı. (Ic4273)
Hata Düzeltmeleri
- Carousel'in, odak geri yükleme API'lerini kullanan bitişik öğelerle uyumluluğu düzeltildi. (7b2a7a4)
- API_LEVEL 28'den düşük olduğunda parıltı göstergesini devre dışı bırakın. Bu özellik işletim sistemi tarafından desteklenmez. (6d3616f)
- Ters yönde hızlı kaydırma sırasında öğelerin tembel kapsayıcılara uygunsuz yerleştirilmesinden kaynaklanan ANR kilitlenmesi düzeltildi. (642d65c)
- Kalıcı gezinme çekmecesinde arka plan dolgusu kaldırıldı. (69965b2)
- Gezinme çekmecesindeki karartma, arka plan içeriğinin arkasında değil üzerinde çizilecek şekilde 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ü şu commit'leri içerir.
API Değişiklikleri
- Alt bileşenlerin yaşam döngüsünü ve yeniden kullanımını yönetmek için
ReusableCompositionarayüzü eklendi. (I812d1, b/252846775) - tv-foundation fork'unu compose-foundation ile senkronize edin. (I737c3, b/287011882)
LazyLayoutaşırı yüklemesi eklendi. Artık daha önce olduğu gibi düz bir nesne değil,LazyLayoutItemProviderlambda'sı kabul ediyor. Önceki aşırı yükleme kullanımdan kaldırıldı. (I42a5a)- Geliştiricinin
AndroidImeOptionsaracılığıyla dokunmatik klavye konumunu yapılandırmasına izin vermek içinTvKeyboardAlignmentekleyin. (Idb772) - TV Compose Material ile
CarouselStateöğesiniSaverile hatırlamak içinrememberCarouselStateöğesini ekleyin. (Id7275) - Kullanıcıların scrim'e gradyan eklemesine izin vermek için
scrimColor: ColorparametresiniscrimBrush:Brushparametresiyle 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ı. Version 1.0.0-alpha08 contains these commits.
Yeni Özellikler
- TV için Compose materyali için Chip bileşenlerini kullanıma sunma. (I86da4)
- TV Compose Material'a
ListItembileşenini ekleyin. (I3f0b3) - TV Compose Material'a
DenseListItembileşenini ekleyin. (I536bf)
API Değişiklikleri
- Herkese açık TV materyali API'leri deneysel olarak işaretlendi. (I632e7)
TabRowcomposable'dan durumu Tab composable ile paylaşmak içinTabRowScopetanıtıldı veTabColorsö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ü şu commit'leri içerir.
API Değişiklikleri
- Bileşenlerin ölçek göstergelerine artık ölçeklendirmeyi devre dışı bırakmak için Yok seçeneği de dahil ediliyor. (I50df5)
- TV'de Materyal Yüzey, Kartlar ve Düğmeler için uzun tıklama desteği eklendi. (Id2b89)
CarouselItemveCarouselScopekaldırıldı. Slaytta ön plan içeriği animasyonu,AnimatedContentScopeiçindenModifier.animateEnterExitkullanılarak elde edilebilir. (Ic038e)- TV Materyal Yüzeyi için
colorvecontentColorparametrelericolorsolarak birleştirildi. (Ie69eb) - TV Material'da
RadioButtoncomposable'ı kullanıma sunduk. (I08690) - TV Material'da
Switchcomposable'ı kullanıma sunduk. (I45e29) - TV Material'da
Checkboxcomposable'ı kullanıma sunduk. (I6a45a) - TV materyalinde etkileşime girilemeyen yüzey tanıtıldı. (Ic5f85)
- Göstergeleri dahili hale getirin. (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ü şu commit'leri içerir.
Yeni Özellikler
- TV için optimize edilmiş Material 3 kart uygulamaları ekleyin.
- TV için optimize edilmiş Material 3 düğme uygulamaları ekleyin.
API Değişiklikleri
CarouseliçindekiCarouselSlideveslideCount,CarouselItemveitemCountolarak yeniden adlandırıldı. (Ie554c)forwardvebackwardContentTransforms,StartToEndveEndToStartolarak yeniden adlandırıldı. (Ie554c)
Hata Düzeltmeleri
NavigationDraweröğesine odaklanıldığında geri DPAD düğmesini işleyin. (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ü şu commit'leri içerir.
API Değişiklikleri
tv-materialiçine yerleştirilebilen yan gezinme çekmecesini kullanıma sunuyoruz. Bu composable'ı nasıl kullanacağınızı öğrenmek için lütfen örneklere bakın. (I12c08)- TV Material 3'te Icon composable'ı kullanıma sunma (I72db9)
- Border, Glow ve Scale gibi göstergelerle
tv-materialiçin Surface composable'ı kullanıma sunuyoruz. Bu göstergeler, TV ekranında odaklanılan öğeyi net bir şekilde vurgulayan bileşenler oluşturmak için kullanılabilir. (I4a6d8), (Iceea1), (Iee4d4), (I79edf), (Icb376) - "Bant" API'sindeki
slideCountparametre adıyla eşleşmesi içinCarouselItemparametresiniCarouselSlideolarak 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ü şu commit'leri içerir.
Yeni Özellikler
- Tembel satırlarda, sütunlarda ve ızgaralarda, öğenin tamamının görünür hale gelmesi için gerekirse pivot geçersiz kılınır. (11d7e40)
- Sekme renklerinin farklı durumlarda özelleştirilmesini ekleyin. (21b2925)
- Carousel artık ileri ve geri manuel kaydırma için özel animasyonları kabul ediyor. (431494a)
API Değişiklikleri
androidx.tv.materialöğesiniandroidx.tv.material3olarak yeniden adlandırma veandroidx.tv.material3altındaki paket yapısını düzleştirme. (I6ca52)- Carousel Indicator satırındaki gösterge artık geliştirici tarafından özelleştirilebilen bir alan. (268af2a)
focusableItem,immersiveListItemolarak yeniden adlandırıldı. Kullanıcılarınfocusable()veyaclickable()değiştiricisiniimmersiveListItemile birlikte manuel olarak eklemesi gerekir (5dd5078)(b/263061052)- Atlı Karınca bileşeninde
timeToDisplayMillis,autoScrollDurationMillisolarak yeniden adlandırıldı. (431494a) CarouselItemartık yalnızcaCarouseliçinde kullanılabilir. (431494a)- Carousel artık
EnterTransitionveExitTransitionsyerine animasyon tanımı olarakContentTransformsdeğerini kabul ediyor. (431494a) - Mevcut öğenin sabitlenmesine olanak tanıyan bir kompozisyon yereli aracılığıyla
PinnableContainerAPI'si, tembel listeler tarafından yaygınlaştırıldı. (Ib8881, b/259274257, b/195049010) mainAxisItemSpacingözelliğiTvLazyListLayoutInfoveTvLazyGridLayoutInforeklam gruplarına eklendi (I37765)
Hata Düzeltmeleri
- 0 veya 1 sekme sayısını doğru şekilde işlediğinden emin olmak için sekme satırını güncelleyin. (I44009), (1c01525), (b/264018028)
TvLazyColumnboşTvLazyRowiçerdiğinde odak-arama kilitlenmesi düzeltildi. (e11b4fe), (b/260299091)clickabledeğiştiricisi artıkImmersiveListile çalışıyor. (5dd5078), (b/263061052)- Geri tuşu artık işleniyor ve Öne Çıkan Öğeler Karuselinden çıkmak için kullanılıyor. (84c138c)
- Carousel, tuşlara hızlıca birden fazla kez basıldığında odağını kaybetmiyor. (799489f)
- Dönen öğe, tuşlara uzun basıldığında odağını kaybetmiyor. (b2cf37e)
- Carousel slayt sayısı değiştiğinde yaşanan kilitlenme sorunları 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ü şu commit'leri içerir.
Yeni Özellikler
TabRowartık deneysel bir API olarak kullanılabiliyor. Bu API sayesinde kullanıcılar, uygulamalarına üst gezinme çubukları ekleyebiliyor. Genellikle TV cihazları, sekme satırında sekme başlığına odaklanıldığında sekmelerin yüklenmesini bekler.- Alt çizgi göstergesi ve kapsül göstergesi gibi TV'ye özel göstergeler kutudan çıktığı gibi sunulur. Kullanım örneklerini tv-samples içinde 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ü şu commit'leri içerir.
Hata Düzeltmeleri
- Odak arama alanını küçülterek
TvLazyRows/TvLazyColumnskoleksiyonunda gezinirken kaydırma performansını iyileştirme.(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ü şu commit'leri içerir.
Yeni Özellikler
İlk alfa sürümünde, aşağıdakiler de dahil olmak üzere TV kullanım alanlarına yönelik bileşenlerin erken önizleme uygulamaları yer almaktadır:
- Row, Column, Grid gibi tembel olmayan kaydırma kapsayıcılarının, kaydırma kapsayıcısının içeriği kaydırarak odaklanılan öğenin TV ekranında aynı konumda kalmasını sağlamak için değiştirici
scrollableWithPivoteklendi. - Kaydırma kapsayıcısının, odaklanılan öğe TV ekranında aynı konumda kalacak şekilde içeriği kaydırması için
TvLazyRow,TvLazyColumn,TvLazyHorizontalGrid,TvLazyVerticalGridcomposable'larını ekleme. - Kullanıcının otomatik kaydırma özelliğine sahip banner rulosu oluşturmasına olanak tanıyan, TV için Öne Çıkan Rulo composable'ı eklendi.
- TV için Immersive List composable'ı ekleyin. Bu composable, kullanıcının odaklanılan liste öğesine göre arka planı değiştiren bir Immersive Row/Column/Grid oluşturmasına olanak tanır.
Bilinen sorunlar
- Kaydırma kapsayıcısı odaklandığında ilk öğe varsayılan olarak odaklanmaz.
TextFieldöğesine odaklanıldığında klavye her zaman açılmaz veya odağın diğer alanlara taşınması engellenebilir.LazyRowsiçeren birLazyColumniçinde dikey olarak kaydırma işlemi düşük performansla yapılıyor.