3. Materyal Oluşturma
androidx.compose.material3
(Tüm compose paketleri için API referans dokümanlarına bakın)
Son Güncelleme | Kararlı Sürüm | Sürüm Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
12 Aralık 2024 | 1.3.1 | - | - | 1.4.0-alpha05 |
Yapı
Oluşturma, androidx
içindeki yedi Maven grup kimliğinin birleşimidir. Her grup, kendi sürüm notlarına sahip hedeflenen bir işlev alt kümesi içerir.
Bu tabloda, gruplar ve her sürüm notları grubunun bağlantıları açıklanmaktadır.
Grup | Açıklama |
---|---|
compose.animation | Kullanıcı deneyimini zenginleştirmek için Jetpack Compose uygulamalarında animasyon oluşturabilirler. |
compose.compiler | @Composable işlevlerini dönüştürün ve Kotlin derleyici eklentisi ile optimizasyonları etkinleştirin. |
compose.foundation | Kullanıma hazır yapı taşlarıyla Jetpack Compose uygulamaları yazın ve kendi tasarım sistemi parçalarınızı oluşturmak için temeli genişletin. |
compose.material | Kullanıma hazır Materyal Tasarım bileşenleriyle Jetpack Compose kullanıcı arayüzleri oluşturun. Bu, www.material.io'da açıklananlarla eşleşen bileşenler sağlamak için tasarlanmış Compose'un üst düzey giriş noktasıdır. |
compose.material3 | Materyal Tasarım'ın bir sonraki aşaması olan Materyal Tasarım 3 bileşenleriyle Jetpack Compose kullanıcı arayüzleri oluşturun. Güncellenen temalar ve bileşenler ile dinamik renk gibi Material You kişiselleştirme özelliklerini içeren Material 3, yeni Android 12 görsel stili ve sistem kullanıcı arayüzüyle uyumlu olacak şekilde tasarlanmıştır. |
compose.runtime | Compose'un programlama modelinin ve durum yönetiminin temel yapı taşları ve Compose Derleyici Eklentisi'nin hedeflemesi gereken temel çalışma zamanı. |
compose.ui | Düzen, çizim ve giriş dahil olmak üzere cihazla etkileşimde bulunmak için gereken oluşturma kullanıcı arayüzünün temel bileşenleri. |
Bağımlılıkları beyan etme
Compose'a bağımlı eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.
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:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.1" implementation "androidx.compose.material3:material3-window-size-class:1.3.1" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha04" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.1") implementation("androidx.compose.material3:material3-window-size-class:1.3.1") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha04") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
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.
Daha fazla bilgi için Sorun İzleyici belgelerine bakın.
Material3 Ortak Sürümü 1.0'ı Oluşturma
Sürüm 1.0.0-alpha01
17 Nisan 2024
androidx.compose.material3:material3-common:1.0.0-alpha01
, androidx.compose.material3:material3-common-android:1.0.0-alpha01
ve androidx.compose.material3:material3-common-desktop:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
Material Design bileşenleri oluşturmak için kullanılabilecek temasız bileşenler:
- Ton Paleti
- Simge
- Dokunma hedefi boyutu
Material3 Uyarlanabilir Gezinme Paketi 1.0 Sürümü'nü Oluşturma
Sürüm 1.0.0-alpha07
1 Mayıs 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
yayınlandı. 1.0.0-alpha07 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Gezinme paketi API'lerini deneysel olmayan hale getirme (If62af)
Hata Düzeltmeleri
- İçerik için varsayılan olarak içe yerleştirilen öğeleri kullanma (50266df)
Sürüm 1.0.0-alpha06
17 Nisan 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu taahhütleri içerir.
API Değişiklikleri
NavigationSuiteScaffoldDefaults
içincontainerColor
vecontentColor
ekler. (I64e3a, b/331993720)itemColors
işleviNavigationSuiteDefaults
'a eklendi. (Idf719, b/328480012)NavigationSuiteScope
'yi mühürleyin. (Iefa57)
Sürüm 1.0.0-alpha05
6 Mart 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu taahhütleri içerir.
API Değişiklikleri
NavigationSuiteItemColors
yapıcısını herkese açık hale getirin. (Ica83a, b/324886877)
Sürüm 1.0.0-alpha04
21 Şubat 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04
yayınlandı. 1.0.0-alpha04 sürümü bu taahhütleri içerir.
Bağımlılık Güncellemeleri
- Material3 uyarlanabilir bağımlılıkları yeni modül yollarıyla güncelleyin. (Ibc421)
- Pencere boyutu sınıflarının Pencere Yöneticisi sürümünü kullanmaya geçin. (I3794d)
Sürüm 1.0.0-alpha03
7 Şubat 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
yayınlandı. 1.0.0-alpha03 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Paket adını navigation-suite yerine navigationsuite olarak güncelleyin (I7eff7)
- API'lerinde
MutableInteractionSource
gösteren Material3 bileşenleri, artık varsayılan olarak null olan birMutableInteractionSource
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şenlerin hiçbir zamanMutableInteractionSource
ayırmaması ve diğer bileşenlerin yalnızca ihtiyaç duyduklarında tembel bir şekilde örnek oluşturması sağlanır. Bu da bu bileşenlerdeki performansı artırır. Bu bileşenlere ilettiğinizMutableInteractionSource
öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I41abb, b/298048146)
Sürüm 1.0.0-alpha02
13 Aralık 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
yayınlandı. 1.0.0-alpha02 sürümü bu taahhütleri içerir.
Yeni Özellikler
- "Yok"
NavigationSuiteType
ekleyin (If8cb1, b/313688598)
Hata Düzeltmeleri
- Kök yüzeyde
modifier.fillMaxSize
olduğunda gezinme bileşeninin ekranın tamamını doldurmasını düzeltin. (c9cf250, b/312664933)
Sürüm 1.0.0-alpha01
15 Kasım 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
Material3 Uyarlanabilir Sürümü 1.0'u Oluşturma
Sürüm 1.0.0-alpha06
7 Şubat 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu taahhütleri içerir.
Yeni Özellikler
ThreePaneScaffoldNavigator
geri gezinme için ek davranış seçenekleri eklendi. (I858aa)- Gezinme geçmişine isteğe bağlı hedef içerik eklendi. (Ibd7e6)
Sürüm 1.0.0-alpha05
24 Ocak 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu taahhütleri içerir.
Yeni Özellikler
- İskelet gezinme ve değer hesaplamasında geçmiş farkındalığını destekleyin (I71d46)
Sürüm 1.0.0-alpha04
10 Ocak 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04
yayınlandı. 1.0.0-alpha04 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Pencere iskeletlerinde kenardan kenara destek eklendi (I1b462)
API Değişiklikleri
- Duruştaki menteşe sınırları özellikleri, menteşe bilgileri listesine taşındı (I24f90)
Hata Düzeltmeleri
AnimatedPane
yeniden derlenmiyor sorununu düzeltme (c3f573d)
Sürüm 1.0.0-alpha03
13 Aralık 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
yayınlandı. 1.0.0-alpha03 sürümü bu taahhütleri içerir.
API Değişiklikleri
- İskelet rollerini
ThreePaneScaffoldRole
takma adlarıyla değiştirin. (I65bd1) - İskelet rolleri için temel sınıf oluşturma (I4784d)
AnimatedPane
'nin içeriğinden gereksiz parametreyi kaldırın (Ibc73b)collectWindowSizeAsState
değerini yeniden adlandırır ve bunun yerine ham değerleri döndürür (I480f4)
Sürüm 1.0.0-alpha02
29 Kasım 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
yayınlandı. 1.0.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Gezinme API'lerini, uyarlanabilir iskelet API'lerinden ayırın. (Ic4045)
GutterSize
sınıfını kaldırın. (I785b3)
Hata Düzeltmeleri
AnimatedPane
kullanılmadığında sekmelerin değiştirilmemesi sorununu düzeltme (d88f181)
Sürüm 1.0.0-alpha01
15 Kasım 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
Material3 uyarlanabilir koşul API'leri:
Material3 uyarlanabilir panel iskelesi yönerge API'leri:
Material3 uyarlanabilir panel iskeleti API'leri:
- Panel iskeleti temel API'leri
Compose Material3 Sürüm 1.4
Sürüm 1.4.0-alpha05
12 Aralık 2024
androidx.compose.material3:material3-*:1.4.0-alpha05
yayınlanır. 1.4.0-alpha05 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Daha iyi okunabilirlik için
WideNavigationRailState.current/target
değerindeki türü bir enum ile değiştirin (I2d6ab) SplitButton
Shape API'yi ikili uyumluluk için veri sınıfından sınıfa değiştirin. (I53812)- İçerik üreticilerin, kullanıcılar ipucu dışında bir yeri tıkladığında ne olacağına karar verebilmesi için
onDismissRequest
parametresi içeren bir ipucu API'si eklendi. Bu yeni parametreyi içermeyen eski API kullanımdan kaldırıldı. (I99aef) opticalCentering
için kullanılanhorizontalCenterOptically
türünühorizontalCenterOptically
olarak değiştirin. Değiştiriciyi dahili hale getirme. padding parametresini maksimum başlangıç ve bitiş ofsetiyle değiştirin. (I0b904)WideNavigationRailState
değerini mevcut/hedef değer olacak şekilde değiştirin, enum'ları kaldırıp yerine boole değerini kullanın. (Idfa29, b/356039090)NavigationBarItemComponentOverride
ekleyin. (I3a06a)
Hata Düzeltmeleri
- İçerik en alta kaydırıldığında renklerin güvenilir bir şekilde değişmesini sağlamak için üst ve alt uygulama çubuğu davranışlarını düzeltin. (Idc4e8, b/293665988)
- Üst ve alt uygulama çubukları için kaydırma davranışı işlevleri artık yeniden oluşturma işlemlerinde daha iyi performans göstermek için hatırlanan bir davranış döndürüyor. (I0fdbe, b/207957336)
- Düzenleyici parametresi artık sürükleme davranışı ve anlambilim gibi dahili düzenleyicilerden önce değil, sonra uygulanır. Bu durum, değiştiricilerin uygulanma sırasını etkiler. (I8d83f)
- Genişletilmiş alt sayfa, boyut değiştirildiğinde genişletilmiş olarak kalır. (I2870b, b/324934884)
- Windows mülkleri için durum ve gezinme çubuğu işaretlerini doğru şekilde yönlendirin. (Ie674d, b/362539765)
- Değiştirici parametresini, dokümanda belirtildiği gibi iskele köküne taşıyın. Bu, uygulamayı M2 ile uyumlu hale getirir. (I0235e, b/372311595)
Harici Katkı
- Ortak
DatePickerDialog
işlevi. (I7dced)
Sürüm 1.4.0-alpha04
13 Kasım 2024
androidx.compose.material3:material3-*:1.4.0-alpha04
yayınlanır. 1.4.0-alpha04 sürümü bu taahhütleri içerir.
Davranış Değişiklikleri
- aosp/3212478 sürümünde yapılan renk değişikliklerini
iconButtonColors
,iconToggleButtonColors
,outlinedIconButtonColors
,outlinedIconToggleButtonColors
veoutlinedIconToggleButtonBorder
olarak geri alın. Döndürülen davranışı, döndürülen yüksek kontrastlı renkleri vurgulamak içiniconButtonVibrantColors
ve benzeri yeni bir işlev grubuna taşıdık. (Iffd8d)
Yeni Özellikler
VerticalDragHandle
bileşenini (I6c770) tanıtın
API Değişiklikleri
DismissibleModalWideNavigationRailDefaults
'üModalWideNavigationRailDefaults
olarak yeniden adlandırın. (I8e877)NavigationBarComponentOverrides
ekleyin. (I8a3f3)NavigationRailComponentOverride
ekleyin. (I83e13)WideNavigationRailState
'ü tanıtarak çubuğu daraltma/genişletme işlemini yönetin,ModalWideNavigationRail
'un kapatılmasına izin verin veDismissibleModalWideNavigationRail
'yi silin. (I88568)- Açma/kapatma düğmesi varsayılanlarına çok küçük, orta, büyük ve çok büyük boyut varsayılanlarını ekleyin. (Ie95d1)
- Düğme varsayılanlarına çok küçük, orta, büyük ve çok büyük boyut varsayılanlarını ekleyin. (If8b6d)
Hata Düzeltmeleri
- Filtre çipi sonundaki simge rengi, spesifikasyona göre Ana Renk'ten
OnSurfaceContainer
olarak güncellendi. Tüm çip dış çizgi renkleri, spesifikasyona göre Dış Çizgi'den Dış Çizgi Varyantı olarak güncellendi. (I68bd4)
Sürüm 1.4.0-alpha03
30 Ekim 2024
androidx.compose.material3:material3-*:1.4.0-alpha03
yayınlanır. 1.4.0-alpha03 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Yoğunluk içeren
SheetState
kurucusunun desteği, konumsal ve hız eşikleri lehine sonlandırıldı. (Ifd16e) - Güncellenmiş bir konumlandırma mantığı içeren
rememberTooltipPositionProvider
eklendi.rememberPlainTooltipPositionProvider
verememberRichTooltipPositionProvider
desteği sonlandırıldı. (Ie66e2) - Ek
ModalBottomSheetProperties
, durum ve gezinme çubuğu renklerinin özelleştirilmesine olanak tanır. Varsayılan olarak bu öğeler, sistem koyu tema durumuna göre değil, içerik rengine göre güncellenir. (Ib874e, b/362539765) - Tarih seçiciler için giriş deneyimi iyileştirildi: Giriş modundayken tarih metin alanına odaklanarak anında metin girebilirsiniz. Bu değişiklik,
DatePicker
veDateRangePicker
parametrelerine birrequestFocus
parametresi ekler.false
değerini ileterek odaklanmayı önleyebilirsiniz. (I12d09, b/286399710, b/340102743) - Şekil varsayılanlarını Şekil nesnesine önbelleğe alma. Açma/kapatma düğmesi için şeklin varsayılan olarak
@Composable
olmasını sağlama. Varyantlar aynı jeton dosyasını işaret ettiğinden şekiller varsayılan olarak tek bir şekle daraltılır. (Iaa014)
Hata Düzeltmeleri
contentPadding
değiştiğinde her zaman gövde içeriğinin yeniden derlenmesini önlemek içincontentPadding
iskelet davranışını optimize edin. (I8c8e2, b/373904168)TextFieldLabelScope
progress
,labelMinimizedProgress
olarak yeniden adlandırıldıTextFieldLabelPosition
Default
,Attached
olarak yeniden adlandırıldı. Arayüz üyeleri kaldırıldı. (If75c6)- Giriş modundaki
DatePicker
ile ilgili, doğrulama hatalarının bileşenin yüksekliğinin değişmesine neden olabileceği bir sorun düzeltildi. (I2e229, b/280462363) - Kontrol tuşlarına basıldığında malzeme kaydırma çubuğunun değerini değiştirmesini sağlayın. (I1c442)
Sürüm 1.4.0-alpha02
16 Ekim 2024
androidx.compose.material3:material3-*:1.4.0-alpha02
yayınlanır. 1.4.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Doğrudan bir
DatePickerState
veyaDateRangePickerState
aracılığıyla yerel ayar ayarlarkenDatePicker
veDateRangePicker
genelinde tutarlı yerel ayar kullanımı sağlamak için tarih seçicilerde yapılan güncellemeler. Yerel ayarları doğrudan eyalete ayarlarken, varsayılan metinleri varsayılan platform yerel ayarına göre uygulanmaya devam edeceğinden, başlık ve başlık metinlerinin buna göre yerelleştirilmesini sağlamanın size ait olduğunu unutmayın. (I37073, b/326490763, b/321657276) SheetState.isAnimationRunning
artık yayınlanıyor. (I9a3d7)DatePickerColors
artık temanın Yazı Tipi metin stillerinde tanımlanan tüm çakışan renklere göre öncelikli olarak uygulanıyor. Ayrıca bu güncellemenin,color
parametresinin tarih seçici işlevlerindeki konumunu ayarladığını ve üstbilgi ile başlık metin renklerini özelleştirmek için bircontentColor
parametresi sunduğunu unutmayın. (I30d03, b/347031394)SplitButton
öğesiniSplitButtonLayout
olarak yeniden adlandırın veSplitButton
renk varyantları API'lerini kaldırın. Varyantlar,SplitButtonDefaults
tarafından sağlanan düğme varyantları yeniden kullanılarak elde edilir. (I44c36)ModalBottomSheet
artıksheetGestureEnabled
parametresine sahip (I856cb, b/288211587)standardMotionScheme
veexpressiveMotionScheme
, standart ve etkileyici olarak yeniden adlandırıldı. Artık her iki işleve deMotionScheme
tamamlayıcı nesnesi üzerindenMotionScheme.standard()
veMotionScheme.expressive()
çağrılarak erişilebilir. (Iceccf)- Basit ve zengin ipuçlarına
maxWidth
parametresi ekleniyor. Varsayılan olarak, düz ipuçları için 200 dp ve zengin ipuçları için 320 dp'lik tasarım spesifikasyonu kullanılır. (I30ce9)
Hata Düzeltmeleri
DatePicker
veDateRangePicker
, eyaletlerinindisplayedMonthMillis
aracılığıyla ayarlandığında artık gösterilen ayı doğru şekilde güncelliyor. (If9e47, b/333414302)ModalBottomSheet
içeriği artık durum çubuğundan kaldırıldı. (I5114c, b/321877275, b/336962418, b/342093067)- [Alt Sayfa] IME klavyenin önce kapatılmasına izin vermek için geri çağırma önceliğini
PRIORITY_DEFAULT
olarak değiştirin. (I447fb) - Seçilebilir minimum yıl gelecek bir yıla ayarlandığında
DatePicker
veDateRangePicker
'te yaşanan kilitlenmeler düzeltildi. (I78656, b/319395747) - Güncellenmiş bir
SelectableDates
örneği uygulandığında kullanıcı arayüzünü güncellemek için tarih seçici sorunu düzeltildi. (Iad59a, b/290135807, b/339898760)
Sürüm 1.4.0-alpha01
2 Ekim 2024
androidx.compose.material3:material3-*:1.4.0-alpha01
yayınlanır. 1.4.0-alpha01 sürümü bu taahhütleri içerir.
Davranış Değişiklikleri
- Kitaplık artık
material-icons-core
'e bağımlılık eklemiyor. Bu nedenle, projeniz bu bağımlılığı kullanıyorsabuild.gradle[.kts]
dosyalarınıza bu bağımlılığı açıkça eklemeniz gerekir. (I735ff, b/349894318) - Kullanılabilirliği, renk kontrastını ve sistemdeki tutarlılığı iyileştirmek için
NavigationBarItem
veNavigationRailItem
'un etkin etiket rengionSurface
yerinesecondary
olarak değiştirildi (Ibc297). Önceki davranışa dönmek için varsayılan renkleri kopyalayın veselectedTextColor
yerineMaterialTheme.colorScheme.onSurface
yazın. - Material 3 bileşenleri artık hareketlerini tanımlamak için yeni
MotionScheme
özelliğini kullanıyor. (Ie0f93) - Belirsiz dairesel ilerleme durumu göstergesi hareket değişiklikleri (I3c07e)
- Daha iyi renk kontrastı için
OutlinedIconButtonColors
veOutlinedIconToggleButtonColors
değerlerini güncelleyin. (I2743d) FilledIconToggleButtonColors
veFilledTonalIconToggleButtonColors
için kapsayıcı ve içerik rengi güncellendi. (Ic5d0f)OutlinedButton
kenarlığı rengioutline
yerineoutlineVariant
olarak güncellendi. (057f00)
API Değişiklikleri
reverseLayout
ile ayarlanan içeriği daha iyi desteklemek içinTopAppBar
'unenterAlwaysScrollBehavior
işlevine isteğe bağlı birreverseLayout
parametresi eklendi. (I4e0e5)SegmentedButton
artıkcontentPadding
bağımsız değişkenini destekliyor. (I5ad91, b/358414376)PullToRefreshState
artıkisAnimating
için varsayılan uygulamaya sahip değil (I6a593)TextFieldState
kullanan yeniTextField
veOutlinedTextField
materyal aşırı yüklemeleri eklendi.TextFieldDecorator
ile uyumlu dekorasyon kutusu API'leri eklendi. (If13a1)- Metin alanının
labelPosition
özelliğini kontrol etmek için parametre eklendi.alwaysMinimize
kullanıldığında, kullanıcı arayüzü kalıbı, alan odağa alınmadığında bile metin alanında bir etiket ve yer tutucu aynı anda gösterilmesine olanak tanır. (I1ef2c) - Şifre giriş alanları için
SecureTextField
veOutlinedSecureTextField
materyalleri eklendi. (I7e22d) - Animasyon ilerleme durumunu sorgulamak için metin alanı etiketlerine bir kapsam eklendi. (If5ec8)
- İpuçlarına
MotionEvent.CLASSIFICATION_DEEP_PRESS
desteği eklendi. (I62e6a) TimePickerState
'ninisAfternoon
değeri, arayüzde var yerine uzantı değeri olarak değiştirildi veisPm
olarak yeniden adlandırıldı (I89a97)- Yazı biçimi sınıfı, vurgulanmış yazı ölçeklerini desteklemek için güncellendi. (Ifa13c)
ModalWideNavigationRail
API eklendi veModalExpandedNavigationRail
API'leriDismissibleModalWideNavigationRail
olarak yeniden adlandırıldı. (Ic9118)FloatingAppBarScrollBehavior
,screenOffset
'u otomatik olarak hesaplayacak ve@Composable
gerektirmeyecek şekilde güncellendi. (Idf349)- Varsayılanlar nesnesinde adlandırmayı düzeltmek için
LoadingIndicator
API'sinde yapılan güncellemeler.PullToRefresh
konumuna birLoadingIndicatorElevation
sabit değeri eklendi. (I1d72b) - Varsayılanlar nesnesinde adlandırmayı düzeltmek için
LoadingIndicator
API'sinde yapılan güncellemeler.PullToRefresh
konumuna birLoadingIndicatorElevation
sabit değeri eklendi. (I1d72b) LinearWavyProgressIndicator
veCircularWavyProgressIndicator
öğelerinin belirsiz varyasyonlarına biramplitude
ve birwaveSpeed
parametresi eklendi. (I2a0c5)- Simge açma/kapatma düğmesinin şeklinin, basılı veya işaretli durumuna göre değiştirilmesi desteklenir. (Ibc781)
- Yazı biçimi sınıfı, vurgulanmış yazı ölçeklerini desteklemek için güncellendi. (Ifa13c)
SplitButton
şekil, varsayılan / basılı duruma göre değişir.TrailingButton
API'si aynı özelleştirmeleri sunabildiği içinAnimatedTrailingButton
API'si kaldırıldı (I95066)- FAB'ın gösterilmesini ve gizlenmesini animasyonlu hale getirmek için değiştirici ekleyin (ör. içerik kaydırıldığında). (I8338d)
- Bir örnekte kullanılacak
ButtonGroupDefaults
öğesine bağlı düğme grubu şekilleri ve boşluk ekleme. (I68e30) - Bölünmüş düğme, son düğme için yatay dolgu ekler ve başlangıç ile bitiş köşesi farklılıklarından hesaplanan optik merkezlemeyi etkinleştirir (I122e2)
- Bileşenin hareketi için bir şema ayarlamanıza olanak tanıyan yeni bir Material
MotionScheme
kullanıma sunuldu. Şema,MaterialTheme
üzerinden ayarlanır. (Id50c2)
Hata Düzeltmeleri
Scaffold
alt Composables'a doğru odak geçiş dizini uygulayın. Sıralama:topBar
,bottomBar
, fab, içerik, snackbar. (I5936b)- Belirli yerel ayarlarda ve biçim iskeletlerinde tarih öğelerinin (ör. ay adları) bazılarının büyük harfle başlamadığı
DatePicker
veDateRangePicker
sorunlarını düzelttik. (I1430f) - FAB ve FAB Menü bileşeni jetonlarını entegre etme (dolgular ve metinde küçük görsel güncellemeler) (Ib57f3)
ModalBottomSheet
artık semantik tarama sırasına göre ilk sırada, ardından scrim yer alır. (I436f9, b/358594665)- Kenardan kenara modunda gezinme hapının altında kaydırırken alt uygulama çubuğunun tamamen kaybolmaması sorunu düzeltildi (I3ee21)
Material3 1.3 sürümü için içerik oluşturma
1.3.1 sürümü
30 Ekim 2024
androidx.compose.material3:material3-*:1.3.1
yayınlanır. 1.3.1 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
DatePicker
veDateRangePicker
, eyaletlerinindisplayedMonthMillis
aracılığıyla ayarlandığında artık gösterilen ayı doğru şekilde güncelliyor. (If9e47, b/333414302)- Seçilebilir minimum yıl gelecek bir yıla ayarlandığında
DatePicker
veDateRangePicker
'te yaşanan kilitlenmeler düzeltildi. (I78656, b/319395747) - Güncellenmiş bir
SelectableDates
örneği uygulandığında kullanıcı arayüzünü güncellemek için tarih seçici sorunu düzeltildi. (Iad59a, b/290135807, b/339898760) - IME klavyesinin önce kapatılmasına izin vermek için alt sayfalar tarafından kullanılan geri çağırma önceliğini
PRIORITY_DEFAULT
olarak değiştirin. (I447fb)
1.3.0 sürümü
4 Eylül 2024
androidx.compose.material3:material3-*:1.3.0
yayınlanır. 1.3.0 sürümü bu taahhütleri içerir.
1.2.0 sürümünden bu yana yapılan önemli değişiklikler
1.3.0 sürümünün önemli özellikleri
Yeni Material Design 3 bileşenleri
- Bant
HorizontalMultiBrowseCarousel
veHorizontalUncontainedCarousel
Mevcut Materyal Tasarım 3 bileşenlerinde iyileştirmeler.
- [
ModalBottomSheet
] artık U+'de Tahmini Geri özelliğini destekliyor (Iccf32, b/281967264, b/304850357) - [
SearchBar
] artık U+'ta Tahmin Edilen Geri Gitme'yi destekliyor (I657f8) - Gezinme Çekmecesi (
ModalDrawerSheet
veDismissibleDrawerSheet
), U+'ta etkinleştirilebilir olarak Tahmini Geri özelliğini artık desteklemektedir (Ie5b0b) DropdownMenu
artık özel renk, şekil, yükseklik ve kenarlığı desteklemektedir. (I8e981,b/289554448, b/301887035, b/283654243)- Aralık ve durak göstergesi ekleyerek erişilebilirliği iyileştirmek için kaydırma çubuğu güncellendi. (I3058e)
- Boşluk ve durak göstergesi ekleyerek erişilebilirliği iyileştirmek için
ProgressIndicator
güncellendi. (I21451) - Zengin ipucu için varsayılan bir yer işaretçisi eklendi.
LayoutCoordinates
adlı bir ankraj verildiğinde özel yer işaretçisinin çizilmesini destekler. (Ifd42c) Zararlı Değişiklikler - Yeni sürükle ve yenile API'leri:
PullToRefreshState
, Dp birimleri yerine kesirli değerler kullanacak şekilde basitleştirildi.isRefreshing
durumu,PullToRefreshState
yerine kullanıcı tarafından kontrol edilir.- İç içe yerleştirilmiş kaydırma bağlantısı
PullToRefreshState
'ten ayrıldı. Bu işlem yeniPullToRefreshBox
veyaModifier.pullToRefresh
tarafından yönetilir. - Bu güncelleme, önceki deneysel API'lerde yapılan önemli bir değişikliktir. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Görsel Değişikliklerden Etkilenen Kullanıcılar
- Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
'teki yüzey ve arka plan renginin varsayılan ayarlarında küçük düzenlemeler. (I9db52)- Kaydırma çubuğu ve
ProgressIndicator
renkleri, yeni metin dışı kontrast özelliklerine uygun olacak şekilde güncellendi. (I26807) SurfaceContainer
varyantları artık bileşenler tarafından kullanılıyor. RenkleriSurface
veTonalElevation
ile resmi olarak hesaplayan bileşenler artık varsayılan olarakSurfaceContainer
rollerini kullanır. Bu roller, ton yükseltmesinden etkilenmez. (b/304584161)- Yüzey ve Yüzey kapsayıcı ana rolü, açık ve koyu temalarda daha fazla renk tonu sağlamak için biraz ayarlandı. (I677a5)
- Deneysel API'ler kararlı sürüme yükseltildi.
- Performans iyileştirmeleri
Sürüm 1.3.0-rc01
21 Ağustos 2024
androidx.compose.material3:material3-*:1.3.0-rc01
yayınlanır. 1.3.0-rc01 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
ModalBottomSheet
artık semantik tarama sırasına göre ilk sırada, ardından scrim yer alır. (I436f9, b/358594665)
Sürüm 1.3.0-beta05
24 Temmuz 2024
androidx.compose.material3:material3-*:1.3.0-beta05
yayınlanır. 1.3.0-beta05 sürümü bu taahhütleri içerir.
- Android N ve O (a10a2d) sürümlerinde
BottomSheet
içeriğinin eksik veya kesilmiş olması sorunu düzeltildi TalkBack
'ün, başparmakların etrafındaki odak göstergelerini düzgün şekilde göstermesi için kaydırma çubuğunun anlamsal sınırlarını artırdık. (0b5a1d)
Sürüm 1.3.0-beta04
26 Haziran 2024
androidx.compose.material3:material3-*:1.3.0-beta04
yayınlanır. 1.3.0-beta04 sürümü bu taahhütleri içerir.
Sürüm 1.3.0-beta03
12 Haziran 2024
androidx.compose.material3:material3-*:1.3.0-beta03
yayınlanır. 1.3.0-beta03 sürümü bu taahhütleri içerir.
Harici Katkı
androidx.compose.material3.DropdownMenu
'ü ortak kaynak kümesinden kullanılabilir hale getirin. (If62c0)
Sürüm 1.3.0-beta02
29 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-beta02
yayınlanır. 1.3.0-beta02 sürümü bu taahhütleri içerir.
API Değişiklikleri
Modifier.pullToRefreshIndicator
yüksekliği destekler, Ekranı Kaydırarak Yenile API'lerini lambda yerine doğru/yanlış değerini döndürecek şekilde güncelleyin.PullToRefreshBox
'te içerik uyumluluğunu destekleme (I75679)TooltipScope
'ü kapalı bir arayüz haline getirin veTooltipBox
ile Etiket'te kullanılacak dahili bir uygulama oluşturun. (I3833e)- Herhangi bir bant öğesine kolayca şekil ve kenar eklemek için
CarouselItemScope
'e iki yeni değiştirici (maskClip
vemaskBorder
) eklendi (Id67a1) TimePickerState
artık bir arayüzdür ve saati ayarlamaya olanak tanır (I88546)- Bağlantıların stilini belirlemek için API güncellendi:
TextLinkStyles
,TextStyle
alanına taşındı veTextDefaults
, materyalden kaldırıldı. (I5477b)
Hata Düzeltmeleri
ModalBottomSheet
durumu ve gezinme çubuğu simgeleri artık koyu tema durumuna göre değişiyor. (Ie1fe7, b/338342149)ModalBottomSheet
scrim'e sayfayı kapatma semantikleri eklendi. (0e61cb,b/328801864)
Harici Katkı
androidx.compose.material3.AlertDialog
'ü ortak kaynak kümesinden (Ia33f5) kullanılabilir hale getirmeModalBottomSheet
'ü ortak kaynak grubundan (Id7cc7) kullanılabilir hale getirme
Sürüm 1.3.0-beta01
14 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-beta01
yayınlanır. 1.3.0-beta01 sürümü bu taahhütleri içerir.
API Değişiklikleri
CaretProperties
yerineDpSize
kullanmakCaretProperties
kaldırılıyor.CaretScope
'üTooltipScope
olarak yeniden adlandırın. (Id9a76)- Metinde Materyal temalı bağlantılar almak için API güncellendi. Özellikle, temalı
LinkAnnotations
oluşturmak ve temalı bağlantılarla HTML'yi ayrıştırmak içinTextDefaults
'ten yöntemler kaldırıldı. Bunun yerine, bağlantılara stil uygulamak için metin bileşenine parametre olarakTextLinkStyles
sınıfı eklendi. (I31b93)
Sürüm 1.3.0-alpha06
1 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
yayınlanır. 1.3.0-alpha06 sürümü bu taahhütleri içerir.
Zararlı Değişiklikler
Yeni, kaydırarak yenileme API'leri:
PullToRefreshState
, Dp birimleri yerine kesirli değerler kullanacak şekilde basitleştirildi.isRefreshing
durumu,PullToRefreshState
yerine kullanıcı tarafından kontrol edilir.- İç içe yerleştirilmiş kaydırma bağlantısı
PullToRefreshState
'ten ayrıldı. Bu işlem yeniPullToRefreshBox
veyaModifier.pullToRefresh
tarafından yönetilir. - Bu güncelleme, önceki deneysel API'lerde yapılan önemli bir değişikliktir. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
API Değişiklikleri
RippleConfiguration#isEnabled
kaldırıldı veLocalRippleConfiguration
boş değer kabul edecek şekilde ayarlandı. Bir dalgalanmayı devre dışı bırakmak içinisEnabled = false
ileRippleConfiguration
yerinenull
ileLocalRippleConfiguration
sağlayın. (I22725)ModalBottomSheet
, kenardan kenara modu etkinleştirildiğinde durum çubuğu üzerinde daha doğru bir şekilde scrim çizer. Modal alt sayfa içeriği artık pencere içe eklemelerini kullanabilir. Bu sayede gezinme çubuğunun üzerinde görünür içerikler gösterilebilir.ModalBottomSheet
parametresiwindowInsets
, iç içe yerleştirilmelerin nereye uygulanacağını belirtmek içincontentWindowInsets
olarak yeniden adlandırıldı. Bu parametreler artık pencere mantığına bağlı değildir.contentWindowInsets
türü, yeni penceresinde çözülmesine olanak tanımak içinWindowInsets
döndüren bir işlevle değiştirildi. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRow
veSecondaryScrollableTabRow
artık alt kompozisyon yerine özel düzen kullanıyor. Bu da performansı artıracaktır. (I991e0)- Metin bağlantıları, normal stilin yanı sıra fareyle üzerine gelinen ve odaklanan stil seçeneklerine de sahip oldu.
TextDefaults
yöntemlerinin her biri bunu desteklemek için birpressedStyle
bağımsız değişkenine sahiptir. (Ic473f, b/139312671)
Hata Düzeltmeleri
- Gezinme çekmecesi sürükleme sabit noktaları artık
drawerContent
'ün genişliğiyle eşleşiyor. (Ibc72f, b/245355396) OutlinedTextField
etiketi için üst dolgu artık sistem yazı tipi boyutunu hesaba katıyor. (Idc781)CalendarLocale
olan sabit paket konumu. (Ifa235)- [Tahmine Dayalı Geri Gitme] Tahmine dayalı geri gitme animasyonları, (0,1, 0, 1) kesme noktaları aralığıyla kullanılacak şekilde güncellendi (I2591a)
Sürüm 1.3.0-alpha05
17 Nisan 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
yayınlanır. 1.3.0-alpha05 sürümü bu taahhütleri içerir.
Yeni Özellikler
SearchBar
veDockedSearchBar
, metin alanı parametresi alan yeni aşırı yüklemelere sahiptir. Bu sayede, metin alanını arama çubuğunun geri kalanından ayrı olarak biçimlendirebilir ve özel metin alanları iletebilirsiniz. Mevcut uygulamanın metin alanıSearchBarDefaults.InputField
olarak kullanıma sunuldu. (I50c73, b/275074248, b/278773336, b/326627700)- Gerekirse onay işaretlerini özelleştirmek için herkese açık API'ye lambda
drawTick
eklendi (I0c048)
API Değişiklikleri
- Metin bağlantıları, normal stilin yanı sıra fareyle üzerine gelindiğinde ve odaklanıldığında basılı durum stili seçeneğini aldı (I5f864, b/139312671)
CarouselItemInfo
, öğenin kırpıldığı bir maske dikdörtgeni göstermek için güncellendi (I785d8)BasicTooltipState
, Material 3 herkese açık API'sinden kaldırıldı. Foundation'ınBasicTooltip
kararlı hale gelene kadar işleviTooltipState
ile birleştirilir. (Icda29)- Bağlantılara
MaterialTheme
uygulayanLinkAnnotation
oluşturma ve HTML etiketli dizeyi ayrıştırma yöntemleri içeren birTextDefaults
nesnesi eklendi (I98532, b/139312671) ExposedDropdownMenuBoxScope
artık alt sınıflara izin vermiyor. Açık açılır menülerde artık erişilebilirlik özelliklerini daha iyi desteklemek içinmenuAnchor
adresine iletilmesi gereken birMenuAnchorType
var.focusable
değeriniExposedDropdownMenu
değerine iletmek yerine bu yöntem kullanılmalıdır.ExposedDropdownMenu
için artık destek sunulmamaktadır.menuAnchor
,enabled
durumunu kontrol etmek için yeni bir parametreye sahiptir. (I55ee6, b/257209915, b/308840226)- Devre dışıyken
OutlinedButton
kenarlık rengi düzeltildi. Etkin durumu alanButtonDefaults.outlinedButtonBorder("enabled")
aşırı yüklemesi eklendi. (Ie650b, b/318461363) - Müşterilerin öğe boyutları hakkında bilgi edinmesine yardımcı olmak için yeni bir
CarouselItemInfo
sınıfı eklendi. (I9070c) - Yüzey kapsayıcıları olmayan
ColorScheme
kurucusunun desteği sonlandırıldı. Lütfen yüzey kapsayıcıları içeren yapıcıya geçin. (I35c11) - [Dış çizgili]
TextFieldDefaults
ContainerBox
,Container
olarak yeniden adlandırıldı. (Ie8d3b)
Hata Düzeltmeleri
sheetSwipeEnabled
yanlışsaBottomSheetScaffold
artık iç içe yerleştirilmiş kaydırmadan kaydırma yapmaz. (I5e1c1, b/306464779)IconButtonSamples.kt
'teki bazıExperimentalMaterial3Api
etkinleştirme ek açıklamaları kaldırıldı. (I111d1)
Sürüm 1.3.0-alpha04
3 Nisan 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
yayınlanır. 1.3.0-alpha04 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Material3 bandının iki deneysel sürümü eklendi:
HorizontalMultiBrowseCarousel
veHorizontalUncontainedCarousel
(I88d64) - M3 Oluştur gezinme çekmecesi (
ModalDrawerSheet
veDismissibleDrawerSheet
), U+'da etkinleştirilebilir olarak Tahmini Geri özelliğini desteklemek için güncellendi (Ie5b0b) - Yeniden oluşturma işlemini önlemek için renk tonunun lambda olarak iletilmesine olanak tanıyan yeni bir API, simge işlevine eklendi. (I5b5a2)
- Üst uygulama çubuğu API'leri artık hem sabit hem de daraltılabilir bölümler için özel yükseklikleri desteklemektedir. (Ib8b0c, b/323403446)
API Değişiklikleri
- Üst uygulama çubuğu API'leri artık hem sabit hem de daraltılabilir bölümler için özel yükseklikleri desteklemektedir. İçerik kaydırıldığında tek satırlık üst uygulama çubuklarının çok fazla kez yeniden oluşturulmasına neden olan sorun düzeltildi.
MediumTopAppBar
'ün, büyük yazı tipi/görüntüleme ayarlarına sahip cihazlarda başlıkları kısaltmasına neden olan sorun çözüldü. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButton
ve ilişkili API'ler artık kararlı (I8a158)SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
veSwipeToDismissBoxValue
artık kararlı olarak işaretlendi. (I5f000)- Desteği sonlandırılan
DismissDirection
veDismissValue
enum'leri ve API'leri kaldırıldı. (I89ccd) - Bant'ın
CarouselState
tamamlayıcı nesnesine deneysel bir etiket eklendi. (I94154) LocalMinimumInteractiveComponentEnforcement
kullanımdan kaldırıldı ve yerineLocalMinimumInteractiveComponentSize
kullanıma sunuldu. (I7a7ac)SearchBarColors
oluşturucu artık herkese açık. (I769ca)SwipeToDismissBox
alanınagesturesEnabled
parametresi eklendi. (Idc59f, b/324170119)- Desteği sonlandırılmış ve deneysel olarak işaretlenen metin alanı API'leri kaldırıldı. (I1305f)
Sürüm 1.3.0-alpha03
20 Mart 2024
androidx.compose.material3:material3-*:1.3.0-alpha03
yayınlanır. 1.3.0-alpha03 sürümü bu taahhütleri içerir.
Görsel Zarar Veren Değişiklikler
- Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
'teki yüzey ve arka plan renginin varsayılan ayarlarında küçük düzenlemeler. (I9db52)
Yeni Özellikler
ExposedDropdownMenu
parametresini özelleştirmek için parametreler eklendi. Özellikle menülerde artık, düzenlenebilir metin alanlarıyla çalışırkenfalse
olarak ayarlanması gereken birfocusable
parametresi (varsayılantrue
) bulunuyor. (I4184c, b/323694447, b/278609042)
API Değişiklikleri
ScaffoldSubcomposeInMeasureFix
işareti kaldırıldı. (Ie2a4b)NavigationRailItemColors
artık@Immutable
olarak işaretlendi. (If6112, b/327660613)NavigationBarItemColors
artık@Immutable
olarak işaretlendi. (I42a30, b/298064514)- Kaydırma çubuğu parçasını oluşturan öğedeki parametreleri yeniden sıralama. (I9f315)
ExposedDropdownMenu
artıkPopup
kullanılarak uygulanıyor. Davranış aynıdır ancak klavyede yazarken düzenlenebilir metin alanlarına sahip odaklanılabilir menüler kapatılabilir.
Hata Düzeltmeleri
- Yüzey ve Yüzey kapsayıcı ana rolü, açık ve koyu temalarda daha fazla renk tonu sağlamak için biraz ayarlandı. (I677a5)
- Kaydırma çubuğu ve
ProgressIndicator
renkleri, yeni metin dışı kontrast özelliklerine uygun olacak şekilde güncellendi. (I26807) - Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
'teki yüzey ve arka plan renginin varsayılan ayarlarında küçük düzenlemeler. (I9db52)
Sürüm 1.3.0-alpha02
6 Mart 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
yayınlanır. 1.3.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Kaydırma çubuğunun durumlarını tekrar kararlı hale getirme.
State.onValueChangeFinished
için tekrar bir değer oluşturuyoruz.onValueChangeFinished
öğesinirememberUpdatedState
içine sarmalama. (I82ab2, b/322269951) - Gezinme bileşenleri artık yeni
SurfaceContainer
rollerini kullanıyor.DrawerDefaults
artık farklıstandardContainerColor
vemodalContainerColor
özellikleri sağlar.DrawerDefaults.ModalDrawerElevation
artık0.dp
. (I7fbac) state.onValueChangeFinished
'yivar
olarak değiştirdiğimiz için@Stable
,Slider
eyaletlerinden kaldırılıyor. (Ied34a, b/322269951)ModalBottomSheet
veStandardBottomSheet
animasyon özelliği, yay animasyonundan güncellenen birTweenSpec
olarak değişti. Bu işlem, görünür aşırı aşma sorununu çözer. Yoğunluk içermeyen desteği sonlandırılmışSheetState
kurucuları kaldırıldı. (I7babc, b/285847707)
Hata Düzeltmeleri
SurfaceContainer
varyantları artık bileşenler tarafından kullanılıyor. Renkleri resmi olarak Yüzey veTonalElevation
ile hesaplayan bileşenler artık varsayılan olarakSurfaceContainer
rollerini kullanıyor. Bu roller, ton yükseltmesinden etkilenmez. (b/304584161)ElevatedFilterChip
'ün seçilmemiş, devre dışı kapsayıcı renginin siyah olmasına neden olan hata düzeltildi. (I400e6, b/322407043)- İlerleme 0 olduğunda belirsiz ilerleme göstergesini düzeltme (Id6582)
- RTL düzeninde
Slider
veRangeSlider
ile ilgili sorun düzeltildi (Iab0e1) - Kayan aralık hesaplaması için
SliderRangeTolerance
eklenir. Çünkü kayan noktalı sayı yuvarlama işlemi hatalı olabilir. (Ic918a, b/324934900) DatePickerDialog
,DateRangePicker
'yi iç içe yerleştirirken veya küçük ekranlarda daha büyük yazı tipleriyle herhangi bir tarih seçiciyi gösterirken düğmelerini gösterdiğinden emin olun. (Ie4758, b/325107799, b/277768544)Menu
artık kapsayıcı rengi içinSurfaceContainer
rolünden yararlanıyor.MenuDefaults.TonalElevation
artık0.dp
. (I135b7)TextField
artık kapsayıcı rengi içinSurfaceContainerHighest
rolünden yararlanıyor. (I4dced)- Üst düzey çipler artık
SurfaceContainerLow
rolünden (I7cd2f) yararlanıyor DatePicker
kapsayıcı rengiSurfaceContainerHigh
olarak değiştirildi.DatePickerDefaults.TonalElevation
artık0.dp
. (Ida753)- Alt sayfalar kapsayıcısının ve sürükle düğmesinin rengini günceller. (I72a0a)
RichTooltip
kapsayıcı rengiSurfaceContainer
olarak değiştirildi. (Ia8b45)SearchBar
kapsayıcı rengiSurfaceContainerHighest
olarak değiştirildi.SearchBarDefaults.TonalElevation
artık0.dp
. (I88604)SurfaceContainerHighest
renk rolünden yararlanmak için devre dışı bırakılan anahtarı ve seçili olmayan parçaları/simgeleri günceller. (I7687a)AlertDialog
kapsayıcı rengiSurfaceContainerHigh
olarak değiştirildi. (Ie0433)BottomAppBar
kapsayıcı rengiSurfaceContainer
olarak değiştirildi.TopAppBar
onScroll
rengi artıkSurfaceContainer
. (I41630)ElevatedCard
kapsayıcı rengiSurfaceContainerLow
olarak değiştirildi.FilledCard
adlı kullanıcının kapsayıcı rengiSurfaceContainerHighest
. (I35141)ElevatedButton
kapsayıcı rengiSurfaceContainerLow
olarak değiştirildi. SeçilmemişFilledIconButton
'lerin kapsayıcı rengi artıkSurfaceContainerHighest
. (I792c9)TimePicker
kapsayıcı rengi ve saat kadranı rengi rolüSurfaceContainerHighest
olarak güncellenir. (I43b93)
Sürüm 1.3.0-alpha01
21 Şubat 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
yayınlanır. 1.3.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Oluşturma M3
ModalBottomSheet
'ü, U+'da Tahmini Geri özelliğini desteklemek için güncelleme (Iccf32, b/281967264, b/304850357) - Compose M3
SearchBar
, U+'ta Tahmin Edilen Geri Gitme özelliğini desteklemek için güncellendi (I657f8) - Kaydırma çubuğu, boşluk ve durak göstergesi ekleyerek erişilebilirliği iyileştirmek için güncellendi. (I3058e)
- Boşluk ve durak göstergesi ekleyerek erişilebilirliği iyileştirmek için
ProgressIndicator
güncellendi. (I21451) - Zengin ipucu için varsayılan bir ok ekleyerek yeni zengin ipucu API'si artık
LayoutCoordinates
sabitleme noktası verildiğinde özel ok çizilmesine olanak tanır. (Ifd42c)
Davranış Değişiklikleri
- Materyal bileşenleri, yeni dalga API'lerini kullanacak şekilde taşındı ve artık
RippleTheme
'yi sorgulamaz.
API Değişiklikleri
- Eğlenceli
drawStopIndicator
artık herkese açık. (I3f59f) DatePicker
'ninformatWithSkeleton
işlevini dahili olarak işaretleyin (Ic65dc)DropdownMenu
artık özel renk, şekil, yükseklik ve kenarlığı desteklemektedir. (I8e981, b/289554448, b/301887035, b/283654243)- API'lerinde
MutableInteractionSource
gösteren Material3 bileşenleri, varsayılan olaraknull
olan, boş değer atanabilir birMutableInteractionSource
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şenlerin hiçbir zamanMutableInteractionSource
ayırmaması ve diğer bileşenlerin yalnızca ihtiyaç duyduklarında tembel bir şekilde örnek oluşturması sağlanır. Bu da bu bileşenlerdeki performansı artırır. Bu bileşenlere ilettiğinizMutableInteractionSource
öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I41abb, b/298048146) - Sabit değerler kullanılarak dalgaların bileşen başına / alt ağaç başına özelleştirilmesine olanak tanımak için
RippleConfiguration
veLocalRippleConfiguration
ekler. Örneğin, kontrol etmediğiniz bir bileşenin rengini değiştirmek veya bir bileşenin dalgalanmasını devre dışı bırakmak için. Çoğu durumda varsayılan değerler kullanılmalıdır: Bu API'ler, tek tek bileşenlerin / sınırlı alt ağaçların özelleştirilmesi için bir çıkış yoludur. Daha geniş kapsamlı değişiklikler ve özel tasarım sistemleri içincreateRippleModifierNode
kullanarak kendi dalganızı oluşturmanız gerekir. (I7b5d6, b/298048146) - material3'e, desteği sonlandırılan
rememberRipple
'ün yerini alan yeni ripple API'yi ekler. Ayrıca, material3 bileşenlerini desteği sonlandırılanrememberRipple
/RippleTheme
API'lerini kullanmaya döndürmek için geçici birCompositionLocal
,LocalUseFallbackRippleImplementation
ekler. Bu özellik, sonraki kararlı sürümde kaldırılacaktır. ÖzelRippleTheme
sağladığınız durumlarda geçici bir taşıma yardımı olarak tasarlanmıştır. (I34cbc, b/298048146)
Hata Düzeltmeleri
- Performansı iyileştirmek için
ModalBottomSheet
içindeki alt kompozisyon kaldırıldı.ModalBottomSheet
'ün,LookaheadScope
ile birlikte belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (I2a198) - Performansı iyileştirmek için
BottomSheetScaffold
içindeki alt kompozisyon kaldırıldı.BottomSheetScaffold
'ünLookaheadScope
ile birlikte belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (Ie6401) - Rozet hizalaması, sağ üst köşeye göre sabitlenen içeriğin ortasına daha yakın olacak şekilde ayarlanır. (I18a28)
- Ay-Yıl metin başlığının ekran okuyucu, Anahtar Erişimi ve Sesli Erişim kullanıcılarına işlem yapılabilir olarak iletilmesine neden olan
DateRangePicker
ile ilgili erişilebilirlik sorunu düzeltildi. (I2ac55) mediumTopAppBarColors
parametre sırası hatası düzeltildi. (Ibe64a)
Sürüm 1.2
Sürüm 1.2.1
6 Mart 2024
androidx.compose.material3:material3-*:1.2.1
yayınlanır. 1.2.1 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
- Kaydırma çubuğu durumlarını tekrar kararlı hale getirin.
State.onValueChangeFinished
için tekrar bir değer oluşturuyoruz.onValueChangeFinished
öğesinirememberUpdatedState
içine sarmalama. (Ie8fd0, b/322269951) state.onValueChangeFinished
'yivar
olarak değiştirdiğimiz için@Stable
,Slider
eyaletlerinden kaldırılıyor. (I82ba1, b/322269951)- Varsayılanlardan kopyalanacak
NavigationBar
özel renkleri düzeltin. (80a779, b/326894020) ExposedDropdownMenu
'teki gerileme sorununu düzelterek tekrar odaklanabilir hale getirin (3fcec1, b/323694447)- Düğme rengi önbelleğe alma sorununu düzeltme (3e5bbcb/327371655)
Sürüm 1.2.0
7 Şubat 2024
androidx.compose.material3:material3-*:1.2.0
yayınlanır. 1.2.0 sürümü bu taahhütleri içerir.
Bilinen Sorun
- Performans iyileştirmesi değişikliği kapsamında
PrimaryTabRow
sürümünde bir Görünüm-Oluşturma birlikte çalışabilirlik oluşturma hatası kullanıma sunulmuştur. Geçici çözüm,TabRow
'üTabRowDefaults.PrimaryIndicator
ile kullanmaktır.
1.1.0 sürümünden bu yana yapılan önemli değişiklikler
Yeni Materyal Tasarım 3 Bileşeni
- Yenilemek için aşağı çekin
- Segmented Button
Mevcut Materyal Tasarım 3 bileşenlerinde iyileştirmeler
- Alt uygulama çubuğu (RTL hizalama, kaydırıldığında otomatik olarak gizleme)
- Sekmelerin görsel güncellemesi
- Rozet (hizalama güncellemesi)
Deneysel API'ler kararlı sürüme yükseltildi.
Performans iyileştirmeleri
- Daha fazla bilgi için lütfen bu blog yayınını inceleyin.
Sürüm 1.2.0-rc01
24 Ocak 2024
androidx.compose.material3:material3-*:1.2.0-rc01
yayınlanır. 1.2.0-rc01 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
mediumTopAppBarColors
parametre sırası hatası düzeltildi. (Ibe64a)CardDefaults.cardColors
sürümündeki1.2.0-beta02
sürümündecontainerColor
parametre değerine görecontentColor
değerinin güncellenmemesine neden olan bir hata düzeltildi. (Iee041, b/319671246)1.2.0-beta02
sürümündedisabledContentColor
'te ortaya çıkan bir hata düzeltildi ve küçük bir optimizasyon eklendi. (I6dda1, b/318428829)
Sürüm 1.2.0-beta02
10 Ocak 2024
androidx.compose.material3:material3-*:1.2.0-beta02
yayınlanır. 1.2.0-beta02 sürümü bu taahhütleri içerir.
Bilinen Hata
IconButtonColors
'teki bir hata, varsayılan olarakdisabledContentColor
'yi kullanıcı tarafından belirtilencontentColor
yerineLocalContentColor
'nin alfa değerine (0,38f) atar. Geçici çözüm,disabledContentColor
değerini açıkça ayarlamaktır. Bu sorun, sonraki sürümde düzeltilecektir.
API Değişiklikleri
- Basit
Tooltip
API'leri için ipucu imlecini etkinleştirme özelliği eklendi. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
veSwipeToDismissValue
'nin tümü_SwipeToDismissBox_
olarak yeniden adlandırıldı. (I68d6d)
Hata Düzeltmeleri
ListItem
son dolgu değeri, spesifikasyona uygun olacak şekilde düzeltildi. (Ibd68b, b/305342674)- Ana hatları kalınlaştırılmış kartın ana hat rengi artık
OutlineVariant
ile doğru şekilde eşlendi. (I75480, b/310979715) - Dinamik renk artık sistem tarafından tanımlanan renk rollerinden alınır. Bu, erişilebilir içeriklerin kontrastını iyileştirir ve dinamik rengi Material spesifikasyonuna daha yakın hale getirir. (I1de96)
android:enableOnBackInvokedCallback="true"
olduğunda Android T/13 ve sonraki sürümlerdeModalBottomSheet
geri işlemenin yapılması sorunu düzeltildi. (I728dc, b/306196110)
Sürüm 1.2.0-beta01
13 Aralık 2023
androidx.compose.material3:material3-*:1.2.0-beta01
yayınlanır. 1.2.0-beta01 sürümü bu taahhütleri içerir.
API Değişiklikleri
TabIndicatorScope
adlı kişiyi deneme aşamasında olarak işaretleyin. (I45c88)- İpucu için desteği sonlandırılan deneysel API'ler kaldırılıyor. (I438cb)
- Yeni
TabRow
aşırı yüklemelerini alt bileşimler kullanmayacak şekilde değiştirin. Bu, özel değiştiriciler sağlanarakTabRow
göstergelerinin farklı bir şekilde oluşturulmasına neden olur. (Ife741) DismissDirection
veDismissValue
API'lerinin desteği sonlandırılacak. Bunlar, değerleriSwipeToDismissBox
'un hem konumunu hem de yönünü belirtenSwipeToDismissValue
ile birleştirilmiştir.DismissState.progress
,0.0
ile1.0
arasındaFloatRange
olarak işaretlenir.DismissState
desteği sonlandırılan Tasarruf ve Oluşturucu artık kaldırıldı.SwipeToDismiss
bileşeni, durum ve varsayılanlar nesnesi deneysel olarak işaretlendi. (Ib54f2)
Hata Düzeltmeleri
PullToRefresh
için varsayılan gösterge artık dolu üçgen yerine açık ok ucu şeklindedir. (I67be3)
Sürüm 1.2.0-alpha12
29 Kasım 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
yayınlanır. 1.2.0-alpha12 sürümü bu taahhütleri içerir.
API Değişiklikleri
RangeSlider
artık Kotlin aralığı (ör.0f..1f
) kullanın.FloatRange
SnapFlingBehavior.kt
artık Kotlin aralığı da kullanıyor. (I025cb)- İşaretçi Değiştirici fabrika işlevleri
@Stable
olarak çalışır. (Ib109f)
Sürüm 1.2.0-alpha11
15 Kasım 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
yayınlanır. 1.2.0-alpha11 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Material3'te yenilemek için aşağı çekme özelliğini sağlayan
PullToRefreshContainer
vePullToRefreshState
öğelerini uygular. (I16456, b/261760718)
API Değişiklikleri
SwipeToDismissBox
DismissDirection
veDismissValue
öğelerini deneysel olarak işaretleyin. (I517b0)SwipeToDismiss
'üSwipeToDismissBox
olarak yeniden adlandırın.background
dosyasınıbackgroundContent
,dismissContent
dosyasını ise sonunacontent
lambda ekleyerek yeniden adlandırın. (I7f4d3)ChipElevation
veSelectableChipElevation
için kurucuyu herkese açık hale getirin. (Ie0c48, b/308432421)ModalBottomSheetProperties
ekleniyor.securePolicy
,ModalBottomSheetProperties
klasörüne taşınıyor.ModalBottomSheetProperties
içinisFocusable
veshouldDismissOnBackPress
ekler. Bu yeni doğru/yanlış değerler, modal alt sayfanın IME etkinliklerini nasıl işleyeceğini belirlemeye yardımcı olur. (Iea56f, b/278216859)RangeSlider
veSlider
durumlarını,initialOnValueChange
, ilk ön ekler ve uygun kdocs'leri kaldıracak şekilde güncelledik. (I57d30)ChipBorder
sınıfı ve ilişkili işlev çağrıları için desteği sonlandırın, bunun yerine doğrudanBorderStroke
kullanmanızı önerin. (I89cc2)- Foundation Tooltip API'leri artık
@ExperimentalFoundationApi
olarak adlandırılıyor. (I30b0b) TabRow
veScrollableTabRow
artık kullanımdan kaldırılmadı. Yeni birincil ve ikincil varyantlar deneysel olarak işaretlenir. (I0def6)- Filtre ve giriş çipleri artık doğrudan
BorderStroke
kullanır. (I07a8d) SegmentedButton
artık doğrudanBorderStroke
kullanıyor. (I89b9b)- Genel
AlertDialog
işleviBasicAlertDialog
olarak yeniden adlandırıldı ve önceki işlevin desteği sonlandırıldı. (Idbe52) SwipeToDismiss
API'leriniSwipeDismiss
olarak yeniden adlandırın ve yeniSwipeDismiss
API'lerini kararlı olarak tanıtın. (I14cbe)- İpucu API'lerine
tonalElevation
veshadowElevation
ekleme. Ayrıca,TooltipBox
,PlainTooltip
veRichTooltip
API'leri, yanlışlıkla kararlı olarak yayınlandıkları için deneysel sürüme geri taşındı. (If0f66, b/293939035) - Deneysel çip API'lerini kararlı hale getirin. (Iea2c3)
- Material3 tıklanabilir kartlarından
@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I88dbf)
Hata Düzeltmeleri
- İç içe yerleştirilmiş önizleme ve yavaş düzenler içeren belirli senaryolarda
SwipeToDismiss
'ün kilitlenmesine neden olan sorun düzeltildi. (Ica8d1, b/297226562)
Sürüm 1.2.0-alpha10
18 Ekim 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
yayınlanır. 1.2.0-alpha10 sürümü bu taahhütleri içerir.
API Değişiklikleri
Badge
veBadgedBox
sürümlerini kararlı sürüme yükseltme. (I67f16, b/261565132)- Kullanıcıların
WindowManager.LayoutParams.FLAG_SECURE
için davranışı tanımlayabilmesi amacıylaModalBottomSheet
parametresi olaraksecurePolicy
eklenir. (Icdac8, b/296250262) progress
değerini lambda olarak alan yeniLinearProgressIndicator
veCircularProgressIndicator
aşırı yüklemeleri eklendi. Bu sürümler önceki sürümlere kıyasla daha yüksek performanslıdır. (I824e6, b/295616656)StandardSizeClasses
öğesiniAllSizeClasses
olarak yeniden adlandırır. (I8cb07)- Pencere boyutu sınıflarının hesaplama işlevlerini birleştirin. (Iad935)
Hata Düzeltmeleri
- Gösterilen ay, izin verilen yıl aralığının kenarındayken gezinme ok düğmeleri hızlıca tıklandığında
DatePicker
kilitlenme sorunu düzeltildi. (I46f36, b/290954897, b/297002119) - [Gezinme çubuğu] Gösterge için şeffaf renk desteği. (Ie0a9b, b/267289987)
Sürüm 1.2.0-alpha09
4 Ekim 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
yayınlanır. 1.2.0-alpha09 sürümü bu taahhütleri içerir.
API Değişiklikleri
ModalNavigationDrawer
veDismissibleNavigationDrawer
, yeniAnchoredDraggable
API'lerini kullanacak şekilde taşındı.DrawerState
'ninanimateTo
yöntemi, open ve close yöntemleriyle değiştirildi ve ofset artık bir durum nesnesi yerine kayan nokta olarak gösteriliyor. Ofsete doğrudancurrentOffset
üzerinden erişebilirsiniz. (I0a72c)- Doğrudan
DatePickerState
veDateRangePickerState
oluşturmak için birleştirilemez işlevler eklendi. Bu işlevler, gerektiğinde ComposablerememberDatePickerState
verememberDateRangePickerState
işlevlerine alternatif olarak kullanılabilir. (I70326, b/291524052) - Sabit ve Kaydırılabilir
TabRows
'lerin artık birincil ve ikincil varyantları var. Bunlar, Material3'te tanımlanan renk ve gösterge davranışıyla doğru şekilde eşleştirilir. PrimaryScrollableTabRow
veSecondaryScrollableTabRow
artık kaydırma durumunu gösterir. (Iec8f5, b/260572337)- Geliştiricilerin, e-tablonun kapladığı maksimum genişliği belirtmek için ayarlayabileceği yeni bir
sheetMaxWidth
parametresi eklendi. Ekranın tüm genişliğini kaplayan bir sayfa isteniyorsa parametre için Dp.Unspecified iletilebilir. (Ifb7c9, b/266697696) - Desteği sonlandırılan yöntemler olarak
PlainTooltipBox
veRichTooltipBox
API'lerini geri ekleme. (I246fa)
Hata Düzeltmeleri
DatePicker
, tarih kalıplarına (ör. YY) dönüştürüldüğünde aynı kalan belirli tarih iskeletlerine sahip birDatePickerFormatter
ile başlatıldığında kilitlenme düzeltildi. (I01f29)
Sürüm 1.2.0-alpha08
20 Eylül 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
yayınlanır. 1.2.0-alpha08 sürümü bu taahhütleri içerir.
Davranışta Değişiklik Yapan Değişiklik
ColorScheme
artık Değişmez. Bu durum, tek tek renk güncellemelerinin daha az verimli olmasına neden olur ancak renklerin daha yaygın kullanımını daha verimli hale getirir. Bu değişikliğin nedeni, uygulamaların büyük çoğunluğunda ana kullanım alanı olarak tek tek renkleri güncellemek olmamasıdır. Bu işlem hâlâ mümkün olsa da daha önce olduğundan daha fazla yeniden derleme yapılacak. Bu da tüm Material kodunda durum aboneliklerinin miktarını önemli ölçüde azaltacak ve daha standart kullanım alanlarının ilklendirme ve çalışma zamanı maliyetini etkileyecektir. (Ic447d, b/297212873)- Ton yükseltmesi artık spesifikasyona uyacak şekilde farklı etkileşim durumlarında animasyon oluşturmuyor. (Icdd12)
API Değişiklikleri
- İçerik kaydırıldığında otomatik olarak gizlenmesi için parametre olarak
BottomAppBarScrollBehavior
alan yeni birBottomAppBar
eklendi. Ayrıca, FAB'ın, iskeledeki alt uygulama çubuğunun üzerine sabitlenmesi yerine üzerine sabitlenmesine olanak tanıyanFabPosition.EndOverlay
özelliği de eklendi. (Iecb47) BasicTooltipBox
bileşeninin üzerine inşa edilen ve etiketin sınırları dışında dokunulduğunda kapatılmayan basit bir etiket bileşeni eklendi. (I821f9)
Hata Düzeltmeleri
- İpuçları için
rememberSaveable
kullanımı kaldırıldı. (Icc131, b/299500338) - İskeletin alt öğelerini ölçüm sırasında mı yoksa yerleşim sırasında mı ölçmesi gerektiğini kontrol etmek için geçici bir işaret eklendi. Bu, varsayılan olarak ölçümde ölçülür. Yeni davranışla ilgili sorun yaşıyorsanız lütfen sorun kaydı oluşturun. (I0b354)
- Cihaz ekran genişliği için doğru ölçüm kullanılarak
BottomSheet
'te yatay kenardan kenara sabitlendi. (I1df0c, b/299058752) - Sayfada aşağı kaydırarak kapatıldığında
ModalBottomSheet
'ünonDismissedRequest
'u çağırmaması sorunu düzeltildi. (Idfdd8)
Sürüm 1.2.0-alpha07
6 Eylül 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
yayınlanır. 1.2.0-alpha07 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Simgelerin otomatik olarak aynalanması desteği
compose material 1.6.0-alpha05
sürümüne eklendi. Simgelerin otomatik olarak aynalanması hakkında ayrıntılı bilgi için lütfen sürüm notlarına bakın.
API Değişiklikleri
SliderState
,DraggableState
'u uygular (I9b116)- Shape parametresini zorunlu hale getirin. Şekil yardımcısı işlevinde
position
değeriniindex
olarak yeniden adlandırın. (I34941) DatePicker
formatWithSkeleton
öğesini, performans iyileştirmeleri için önbellek olarak kullanılan bir harita içerecek şekilde günceller. (I3195f)compose.foundation
'aBasicTooltipBox
eklendi vePlainTooltipBox
ileRichTooltipBox
,TooltipBox
'i yeniPlainTooltip
veRichTooltip
bileşenleriyle kullanacak şekilde güncellendi. (I79e1d)
Hata Düzeltmeleri
dynamicLightColorScheme
vedynamicDarkColorScheme
artık yüzey vesurfaceContainer
rolleri için daha yüksek renk doygunluğuna sahip renkler döndürüyor. (I5e901)LookaheadScope
içinde bir İskelet içinde alt kompozisyon (ör.BottomSheetScaffold
) kullanan bazı bileşenlerin boyutlarını çok erken okumaya çalıştığı sorun düzeltildi. (I297b4, I871f1, b/295536718)
Sürüm 1.2.0-alpha06
23 Ağustos 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
yayınlanır. 1.2.0-alpha06 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
DropdownMenu
'ninoffset
hesaplaması düzeltildi. Böylece x ofsetleri yalnızca yerel düzen yönüne bağlı olacak ve menü ekranın alt kısmına yakın olduğunda y ofsetleri artık tersine çevrilmeyecek. (Iccc74, b/294103942)DropdownMenu
'ninoffset
hesaplaması düzeltildi. Böylece x ofsetleri yalnızca yerel düzen yönüne bağlı olacak ve menü ekranın alt kısmına yakın olduğunda y ofsetleri artık tersine çevrilmeyecek. (Ib87a2, b/294103942)
Sürüm 1.2.0-alpha05
9 Ağustos 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
yayınlanır. 1.2.0-alpha05 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Onay kutusu ve
TriStateCheckbox
renklerinde güncellemeler yapıldı.CheckboxDefaults.colors()
disabledUncheckedColor
artık yalnızca onay kutusunun kenarlığını etkiler. Devre dışı ve işaretsizken iç kutu rengini ayarlamanızı gerektiren özel durumlarda, istenen renk değerlerine sahip özel olarak oluşturulmuş birCheckboxColors
örneği gerekir. (I77d17, b/291943198)
Sürüm 1.2.0-alpha04
26 Temmuz 2023
androidx.compose.material3:material3-*:1.2.0-alpha04
yayınlanır. 1.2.0-alpha04 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Deneysel Segmented Button API (Ifc8fb)
- Bölücüler artık dikey bölücüleri desteklemek için yönü kontrol eden bir parametreye sahiptir. (I4c899, b/288438593)
API Değişiklikleri
- Yoğunluk bağımlılığını bileşen düzeyine taşıyoruz. Bu, aşağıdaki bileşenler için geçerlidir:
SwipeToDismiss
ve E-Tablo tabanlı bileşenler. Lütfen yoğunluğun parametre olduğu durumlarda sağlanan yeni aşırı yüklemeyi kullanın. (I1846e) - Birleştirilebilir öğelere izin verilen girişleri belirtmek için ek ek açıklamalar (Ief234)
- Segmentli düğmeye bir simge parametresi ekleyin, segmentli düğmelerin tek seçim için seçilebilir ve çoklu seçim için
SelectableSegmentedButtonRow
veToggelableSegmentedButtonRow
ile değiştirilebilir olması için anlamları bölün. (I38740) - Bölme çizgisi
HorizontalDivider
olarak yeniden adlandırıldı.VerticalDivider
işlevi eklendi. (I5975c) - Otomatik kutucuklama özelliğini en aza indirmek için deneysel Material3 API'lerinde
ClosedFloatingPointRange
yerine daha hafifFloatRange
kullanın. (I4aab5) FabPosition
(Ib7aea, b/170592777) için yeni Başlangıç hizası eklendi
Hata Düzeltmeleri
ModalBottomSheet
yerel düzen yönüne uyar. (Ib4f44, b/285628622)
Sürüm 1.2.0-alpha03
21 Haziran 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
yayınlanır. 1.2.0-alpha03 sürümü bu taahhütleri içerir.
Davranış Değişiklikleri
- Material 3 yazı tipinde
includeFontPadding
artık varsayılan olarakfalse
olarak kullanılıyor. Varsayılan satır yüksekliği stili deTrim.None
veAlignment.Center
olarak değiştirildi veTypography
'ınTextStyle
'larına açıklineHeight
(sp cinsinden) eklendi. Bu değerleri özelleştirmek istiyorsanız API dokümanlarına göz atın ve bu değişikliklerle ilgili ayrıntılı açıklama için blog yayınını inceleyin. (I6266f, Icabc3)
Yeni Özellikler
- Bileşenin durum bilgisine sahip bir sürümü olan
RangeSlider
için aşırı yükleme eklendi. Mevcut etkin parçanın tüm bilgilerini,RangeSlider
bileşenlerinin ölçümlerini ve sürükleme ve hareket mantığını içerenRangeSliderState
oluşturuldu. (I8c270) - Arama çubuğu artık yeni eklenen
shadowElevation
parametresi aracılığıyla gölgeleri destekliyor. (Ia5369, b/271040353) ColorScheme
artık yeniSurfaceContainer
rollerini desteklemektedir.- Yüzey tonlu yükseklik yer paylaşımı artık
LocalTonalElevationEnabled
kompozisyon yereliyle devre dışı bırakılabilir. (Ic203c, b/277774590)
API Değişiklikleri
- Bileşen renkleri yapıcılarını açın. (I8c4a6)
- Geliştiricilerin ipucu dokunma etkinliklerini kullanabilmesi veya kullanamaması için her iki ipucu API'sine de focusable parametresi eklendi. Bu işlemin erişilebilirlik odağının otomatik olarak atlanması özelliğini bozabileceğine dikkat edin. (Ie32d8)
- Performans ve bellek atamalarına göre optimize edilmiş erişilebilirlik. (Iede48)
DefaultSizeClasses
'ü kullanıma sunma veWindowSizeClasses
içinStandardSizeClasses
oluşturma (I91838)WindowWidth/HeightSizeClass
değerini kayan nokta değer sınıflarına (Ie686e) değiştirme
Hata Düzeltmeleri
- İskeletin
contentWindowInsets
parametresi artık kullanılan pencere içlerine uyuyor. Bu parametreler sağlandığındatopBar
vebottomBar
'ye dayalı içerik doldurma davranışının değişmeyeceğini unutmayın. (I08b73, b/264601542) - Uzun bir başlığın işlem simgelerinin veya gezinme simgesinin üzerine gelmemesini sağlamak için orta üst uygulama çubuğunun hizalamasını düzeltin. (I4369f, b/236994621)
- Sekme konumları artık minimum 24 dp içerik genişliği zorunlu kılar. Bu, sekme göstergeleri için erişilebilir bir dokunma hedefi sağlar. (Id8861)
dynamicLightColorScheme
vedynamicDarkColorScheme
'teki dinamik renk paletleri artık yeni yüzey rollerini destekliyor. (I1252e)- Büyük büyük ebeveynle çarpıştığında kırpılmaması için rozet bildirimi hizalamasını güncelleme. (Idf75a)
Sürüm 1.2.0-alpha02
24 Mayıs 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
yayınlanır. 1.2.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
ModalBottomSheet
parametresine pencere içe eklemeleri ekleyin.ModalBottomSheet
için ekran koruyucu artıkwindowInsets
sıfıra ayarlandığında durum çubuğunun arkasında çizilebilir- Varsayılan
ModalBottomSheet
işlevi, gezinme dahil olmak üzere sistem çubuklarının dışında kalacak şekilde güncellendi - Durum çubuğu içe yerleştirilmesi, kenardan kenara modunda sürükle tuşu ile sağlanır.
BottomSheetDefaults
,BottomSheetWindow
için pencere içe eklemelerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- M3 özelliklerine uyacak şekilde
Indicator
desteğini sonlandırın vePrimary
/SecondaryIndicator
ekleyin.PrimaryIndicator
, sekme içeriğinin genişliğiyle eşleşirkenSecondaryIndicator
, mevcut genişliğin tamamını kaplar.SecondaryIndicator
, artık kullanımdan kaldırılanIndicator
ile eşdeğerdir ve doğrudan değiştirilebilir. (I27604) - Görüntülenen menü öğelerinin dikey kaydırma durumunu kontrol etmek için
DropdownMenu
veyaExposedDropdownMenu
oluştururkenScrollState
iletme seçeneği eklendi. (Ia0734, b/185304441) - Bileşenin durum bilgisine sahip bir sürümü olan
Slider
için aşırı yükleme eklendi. Mevcut etkin parçanın tüm bilgilerini,Slider
bileşenlerinin ölçümlerini ve sürükleme ve hareket mantığını içerenSliderState
oluşturuldu. (I124a5) isContainer
olan anlambilim mülkünün adınıisTraversalGroup
olarak değiştirme (I121f6)- Tam parametre listesi içeren optimize edilmiş
TextStyle.merge(...)
eklendi. (Iad234, b/246961787) TooltipState
,RichTooltipState
vePlainTooltipState
'yi herkese açık arayüzler haline getirdi. Varsayılan durumlar içinRichTooltipStateImpl
vePlainTooltipStateImpl
eklendi. Bu uygulanmış durumları elde etmek içinremember*State
işlevleri eklendi.TooltipSync
,TooltipDefault.GlobalMutatorMutex
ile değiştirildi. (I7813d)DatePickerColors
, tarih seçici bölme çizgisi, gezinme ve metin giriş alanı renkleri için ek özelleştirme seçenekleri içerecek şekilde güncellendi. (I1a685, b/274626815)DatePickerState
veDateRangePickerState
artıkrememberDatePickerState
verememberDateRangePickerState
tarafından alınabilecek varsayılan uygulamaları olan herkese açık arayüzlerdir. (I71c52)DatePicker
veDateRangePicker
'dendateValidator
kaldırıldı ve kullanıcı arayüzünde hangi tarihlerin veya yılların seçilebileceğini kontrol etmek için eyalette ayarlanabilen birSelectableDates
arayüzü kullanıma sunuldu. (Ic2fc6)TimePicker
kararlı API'den kaldırıldı, durum API'sinde daha fazla değişiklik bekleniyor (I3f39a)ModalBottomSheet
yalnızca Android'e taşındı.ModalBottomSheet
masaüstü kullanımı için önerilmez ve bu işlev etkin olarak korunmaz. (Ib3778)
Hata Düzeltmeleri
- İşlemler iletişim kutusunun genişliğine sığmak için üst üste yığıldığında
AlertDialog
kapatma işleminin onay işleminin altında görünmesi düzeltildi. Bu düzeltme, uygulamayı Materyal Tasarım spesifikasyonuyla uyumlu hale getirir. (I029de, b/235454277) - Üç satırlık öğeler için yanlış dolgu kullanan
ListItem
'teki hata düzeltildi. (I6e235) ModalBottomSheet
artık IME klavyesini gösterebilir (Idc508, b/262140644, b/268380384, b/272483584)
Sürüm 1.2.0-alpha01
10 Mayıs 2023
androidx.compose.material3:material3:1.2.0-alpha01
ve androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
yayınlandı. 1.2.0-alpha01 sürümü bu taahhütleri içerir.
Sürüm 1.1
Sürüm 1.1.2
20 Eylül 2023
androidx.compose.material3:material3:1.1.2
ve androidx.compose.material3:material3-window-size-class:1.1.2
yayınlandı. 1.1.2 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
- Değiştiricinin iki bileşene yanlış şekilde iletilmesi düzeltildi. (b/282761472)
TimePickerState
, 23 saatle başlatıldığında yanlış saatler döndürüyordu. Bu sorun düzeltildi. (b/278242122)- Öğle ve dakika doğrulaması için ilk açma/kapatma durumu düzeltildi. (b/269768197, b/282790635)
- 23:00 için yanlış değer döndüren
state.hour
düzeltildi. (b/282761472, b/278242122)
1.1.1 sürümü
21 Haziran 2023
androidx.compose.material3:material3:1.1.1
ve androidx.compose.material3:material3-window-size-class:1.1.1
yayınlandı. 1.1.1 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
- İkili uyumluluk için
windowInset
parametresi olmadanModalBottomSheet
çağrısı ekler. (Ib7959) ModalBottomSheet
parametresine pencere içe eklemeleri ekleyin.ModalBottomSheet
için ekran koruyucu artıkwindowInsets
sıfıra ayarlandığında durum çubuğunun arkasında çizilebilir- Varsayılan
ModalBottomSheet
işlevi, gezinme dahil olmak üzere sistem çubuklarının dışında kalacak şekilde güncellendi - Durum çubuğu içe yerleştirilmesi, kenardan kenara modunda sürükle tuşu ile sağlanır.
BottomSheetDefaults
,BottomSheetWindow
için pencere içe eklemelerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
Sürüm 1.1.0
10 Mayıs 2023
androidx.compose.material3:material3:1.1.0
ve androidx.compose.material3:material3-window-size-class:1.1.0
yayınlandı. 1.1.0 sürümü bu taahhütleri içerir.
1.1.0'un önemli özellikleri
Yeni Material Design 3 bileşenleri
Mevcut Materyal Tasarım 3 bileşenlerinde iyileştirmeler
Deneysel API'ler kararlı sürüme yükseltildi.
Daha fazla bilgi için lütfen bu blog yayınını inceleyin.
Sürüm 1.1.0-rc01
19 Nisan 2023
androidx.compose.material3:material3:1.1.0-rc01
ve androidx.compose.material3:material3-window-size-class:1.1.0-rc01
yayınlandı. 1.1.0-rc01 sürümü bu taahhütleri içerir.
API Değişiklikleri
TimePicker
kararlı API'den kaldırıldı, durum API'sinde daha fazla değişiklik bekleniyor (I3f39a)ModalBottomSheet
yalnızca Android'e taşındı.ModalBottomSheet
masaüstü kullanımı için önerilmez ve bu işlev etkin olarak korunmaz. (Ib3778)
Sürüm 1.1.0-beta02
5 Nisan 2023
androidx.compose.material3:material3:1.1.0-beta02
ve androidx.compose.material3:material3-window-size-class:1.1.0-beta02
yayınlandı. 1.1.0-beta02 sürümü bu taahhütleri içerir.
API Değişiklikleri
SheetState
artık isteğe bağlıskipHiddenState
parametresine sahiprememberStandardBottomSheetState
artık isteğe bağlıskipHiddenState
parametresine sahipBottomSheetScaffold
artık tanımlanmış bir Gizli ankraja sahip ancak varsayılan olarak devre dışıdırSheetState.requireOffset
dokümanları güncellendiBottomSheetDefaults.MinimizedShape
,BottomSheetDefaults.HiddenShape
olarak yeniden adlandırıldı (I839f4, b/273870234)
Hata Düzeltmeleri
- Dokunarak keşif etkinken kadran yüzünü saatten dakikaya geçirmeyin. (I717d0)
ModalBottomSheet
veBottomSheetScaffold
sürükle tutamacını semantikleri artık birleştirildi. (I05afb)BottomSheetScaffold
değiştirici,containerColor
vecontentColor
parametreleri artık yalnızca içeriği etkiler. (I992cb)- E-tablo içeriği için
BottomSheetScaffold nestedScroll
artık fırlatmalar uygular. (I992cb)
Sürüm 1.1.0-beta01
22 Mart 2023
androidx.compose.material3:material3:1.1.0-beta01
ve androidx.compose.material3:material3-window-size-class:1.1.0-beta01
yayınlandı. 1.1.0-beta01 sürümü bu taahhütleri içerir.
API Değişiklikleri
TimePicker
kompozit öğesine düzen türü parametresi ekleyin. Ekran yapılandırmasına bağlı olarak farklı düzenler kullanmaya olanak tanır (Ia0e16)SearchBarDefaults
deneysel olarak işaretlendi. (I65561)BottomSheetScaffold
(I94e0f) için gölge yüksekliği eklendi- Tarih seçicileri üstbilgi bölümü olmadan görüntüleme desteği eklendi. API, tarih seçici oluştururken null bir başlık iletmeye izin verecek şekilde değiştirildi. Artık başlıksız bir seçici görüntülemek için null başlık, başlık ve
showToggleMode = false
iletebilirsiniz. (Id3f3a, b/266132421, b/267194809)
Hata Düzeltmeleri
- Arama çubukları artık etkin olmadığında otomatik olarak odaktan çıkar. (I22a7c, b/261444487)
DateRangePicker
, başlangıç ve bitiş tarihleri aynı olan bir aralık seçilmesine izin verecek şekilde güncellendi. (I16529, b/272882497)- Metin alanları artık yazı tipi boyutu beklenenden küçük olduğunda metin öğelerini düzgün şekilde konumlandırıyor. Bu, yazı tipi ayarlarına ve komut dosyasına bağlı olarak uygulamalarınızda birkaç piksellik bir değişikliğe neden olabilir. (I8b8d0)
- Alt sayfadaki anlamsal işlemler artık etiketlere sahip. (I277b0)
Sürüm 1.1.0-alpha08
8 Mart 2023
androidx.compose.material3:material3:1.1.0-alpha08
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
yayınlandı. 1.1.0-alpha08 sürümü bu taahhütleri içerir.
Yeni Özellikler
BottomSheetScaffold
veBottomSheetScaffoldState
için destek eklendi. (I063d4)
API Değişiklikleri
- Durum ilk oluşturulduktan sonra tarihleri ayarlama ve ayrıca zaman damgaları geçersiz olarak ayarlayarak seçimleri sıfırlama olanağı sağlamak için
DatePickerState
veDateRangePickerState
işlevlerine işlev eklendi. Tarihler manuel olarak dikkatli bir şekilde ayarlanmalıdır. YenisetSelection
işlevi, sağlanan tarih bir ön koşulu karşılamıyorsa istisna oluşturur (dokümanlara bakın). (Ifa645, b/268609314, b/270427389) - Bu durumdaki davranışı daha doğru ve esnek bir şekilde göstermek için Daraltılmış
SheetValue
'üPartiallyExpanded
olarak yeniden adlandırın. (Ia1491) ListItem
parametre adları, _text yerine _content olarak güncellendi. Varsayılan alıcı işlevleri artık uygun olduğundaReadOnlyComposables
değerini döndürüyor. (I69a25)- Etkileşimli Surface API'lerini deneysel aşamadan çıkarın. (I90d59, b/261561812)
Hata Düzeltmeleri
ModalBottomSheet
'ninHalfExpanded
durumunun yanlış hesaplanması ve sayfanın yüzen görünmesine neden olan sorun düzeltildi. (I45e84, b/268411386)ModalBottomSheet
içinconfirmValueChange
kontrolünü ekleyin. (I2311a, b/270425759)- Anlamsal
BottomSheet
işlemlerini sürükle ve bırak düğmesine taşıyın. (I158ba) ModalBottomSheet
artık başlatma sırasında odağı komuta ediyor ve geri düğmesini yönetiyor. (I4d2ab)ModalBottomSheet onDismissRequest
artık iç içe yerleştirilmiş kaydırma hareketleri sırasında da ele alınıyor. (I655c5, b/268433166)
Sürüm 1.1.0-alpha07
22 Şubat 2023
androidx.compose.material3:material3:1.1.0-alpha07
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
yayınlandı. 1.1.0-alpha07 sürümü bu taahhütleri içerir.
Yeni Özellikler
rememberTimePickerState()
ile çalışan ve zaman girişi için M3 spesifikasyonunu (Ia4fab) izleyen bir Zaman Girişi bileşeni ekleyin.- Tarih aralığı seçmek için bir Material 3
DateRangePicker
API eklendi. (I7a6c3, b/267194809) DateRangePicker
API üzerinden tarih aralıkları seçmek için Material 3 giriş modu desteği eklendi. (Ifdbc4)- Metin alanı renkleri artık özelleştirilebilir:
- Odak ve hata durumuna göre giriş alanı ve yer tutucu metin renkleri.
textColor
parametresiunfocusedTextColor
olarak,placeholderColor
iseunfocusedPlaceholderColor
olarak yeniden adlandırıldı. - Yeni
errorContainerColor
parametresi ile hata durumuna göre doldurulmuş metin alanları için kapsayıcı rengi.
- Odak ve hata durumuna göre giriş alanı ve yer tutucu metin renkleri.
- Görünen açılır menü metin alanı renkleri, yeni ön ek ve son ek API'sini destekleyecek parametrelerle güncellendi. (I9c8b4, b/254284181, b/264766350)
API Değişiklikleri
- Bazı Slider API sürümlerini geri alma ve özel kaydırma çubuğu ve kaydırma çubuğu yolu içeren yeni deneysel Slider tarafından kapsanan gereksiz Slider aşırı yüklemelerini kaldırma.
RangeSlider
sürümünü kararlı sürüme yükseltme. (Ie8fbd) - Çipin yükseklik işlevlerinde
defaultElevation
,elevation
olarak yeniden adlandırıldı. (I0f872) - Aşağıdaki Material 3 metin alanı API'leri artık deneysel değildir:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. (Ieb5c0, b/261561819) TimePickers
is24Hour
sistem ayarını kullanır (I18856)- Deneysel ek açıklama, iskelet API'lerinden kaldırıldı. (Ibb51e, b/261565765, b/261436953)
Hata Düzeltmeleri
ModalBottomSheet
varsayılan şekli artık her zamanSheetDefaults.ExpandedShape
'dır. (I0dfca)- Materyal 3
DatePicker
veDateRangePicker
için erişilebilirlik iyileştirmeleri. (I5087e) - Maksimum yükseklik kısıtlamasının yayılmasına ve kilitlenmeye neden olan hata düzeltildi. (I30d8c)
- Tıklanabilir ve seçilebilir yüzeylerden semantik roller kaldırıldı, bunları rol ayarlamak için kullanan bileşenler modifier.semantics kullanılarak güncellendi (I793d9)
Sürüm 1.1.0-alpha06
8 Şubat 2023
androidx.compose.material3:material3:1.1.0-alpha06
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
yayınlandı. 1.1.0-alpha06 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Metin alanları artık ön ek ve son ek metnini destekliyor (Ia8578, b/179884561)
- Material 3 spesifikasyonuna uygun bir zaman seçici göstermek için
TimePicker
işlevi eklendi. Bu işlev,TimePickerState
ve kolaylık yöntemirememberTimePickerState
ile birlikte kullanılır (I71910) - Tarih girişi artık
DatePicker
alanında bir görüntüleme modu olarak kullanılmaktadır. Tarih seçici ve tarih girişi modları arasında geçiş yapma desteği eklendi. (Ieeff7) RichTextTooltips
için API eklendi. (I58ef3)ModalBottomSheet
veModalBottomSheetDefaults
dahil olmak üzere Material 3 için kalıcı alt sayfa uygulaması. Ayrıca, gelecekteki e-tablo bileşenleri için kullanılabilecekSheetState
verememberSheetState
özelliklerini de kullanıma sunar. (I0853a, b/244189383)
API Değişiklikleri
- API'yi sabitleme
showSnackbar
(I195c2, b/261424370) - Yardım çipi ve öneri çipi için API'leri sabitleme (Ibb67b, b/261424370)
ListItem
,ListItemDefaults
veListItemColors
API'yi deneysel olmayan olarak tanıtıyor (I7e7fa, b/261438882)SliderPositions
,SliderDefaults.Thumb
veSliderDefaults.Track
API'lerini kararlı sürüme geçirme ve özel küçük resimler ve parça içeren deneysel olmayanSlider
veRangeSlider
API'leri ekleme. Ayrıca öncekiSlider
veRangeSlider
API'leri de kullanımdan kaldırılıyor. (Ie5ea6, b/261566890)Modifier.tooltipAnchor()
'ü herkese açık hale getirdik. Böylece geliştiriciler, uzun basıldığında bir ipucu gösterilmesi gerektiğini belirtmek için bunu ankara aktarabilir.PlainTooltipBox
API'si,TooltipState
için artık boş değer kabul etmeyecek şekilde güncellendi ve varsayılan bir değer eklendi. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColor
, tutarlılık için@Composable
olarak işaretlendi. (Id29cc)LocalMinimuTouchTargetEnforcement
mülk alıcısını geri yükleyin, desteği sonlandırıldı olarak işaretleyin veLocalMinimumInteractiveComponentEnforcement
adresine yönlendirin. (I60dd5)
Sürüm 1.1.0-alpha05
26 Ocak 2023
androidx.compose.material3:material3:1.1.0-alpha05
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
yayınlandı. 1.1.0-alpha05 sürümü bu taahhütleri içerir.
Yeni Özellikler
DatePickerDialog
ve erişilebilirlik desteğiRangeSlider
videosuna özel küçük resim ve parça eklendi.
Bağımlılık Güncellemeleri
Compose UI
veCompose Material
artık Lifecycle 2.6.0'a bağlıdır.
Sürüm 1.1.0-alpha04
11 Ocak 2023
androidx.compose.material3:material3:1.1.0-alpha04
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha04
yayınlandı. 1.1.0-alpha04 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Takvim kullanıcı arayüzü üzerinden tek bir tarih seçmek için ilk
DatePicker
API. Bu API'de hâlâ değişiklikler yapılmaktadır. (I722b9) PlainTooltipBox
aracılığıyla düz ipucu desteği eklendi. (I0cdfb)- Arama çubuğu (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
API Değişiklikleri
- Surfaces'te
IsContainer
semantik özelliğine eklendi. Bu özellik, yüzeyler gibi öğelerin anlamsal anlamına göre gezinme sırasını belirleyen daha sonraki bir değişiklikte kullanılır. (I63379) - Gezinme çekmecesine ait API'leri kararlı olarak işaretleyin. (Iab01e, b/261439597)
- Dairesel ilerleme durumu göstergeleri için bir parça rengi parametresi ve hem dairesel hem de doğrusal ilerleme durumu göstergeleri için bir fırça kapağı parametresi eklendi. (Ie668c, b/216325962, b/222964817)
- Kullanımdan kaldırılan ve gizlenen işlevlerin daha fazla dönüş türü için boş değer kabul edilebilirlik durumu (Ibf7b0)
Modifier.minimumInteractiveComponentSize
ekleyin. Öğenin boyutu daha küçükse dokunma etkileşimlerinin anlamını açıklığa kavuşturmak için en az 48.dp boyutunda yer ayırmak amacıyla kullanılabilir. (I33f58, b/258495559)- İçerik yuvası içeren
AlertDialog
bileşeni için deneysel API eklendi. (Iec4a2)
Hata Düzeltmeleri
- İlerleme durumu göstergelerinin ilerleme durumu artık beklenen aralıkla düzgün şekilde sınırlandırılmıştır. (I8a7eb, b/262262727)
Bilinen Sorun
androidx.compose.foundation:1.4.0-alpha03
sürümündenandroidx.compose.foundation:1.4.0-alpha04
sürümüne güncelleme yaparkenjava.lang.NoSuchFieldError
hatasıyla karşılaşabilirsiniz. Sorunun ilk olarak bildirildiği yer burada. Gönderilen düzeltme, bir sonraki Oluştur güncellemesinde kullanıma sunulacaktır. Bu sorunu geçici olarak çözmek içinandroidx.compose.material
veandroidx.compose.material3
kitaplıklarınızı en son sürüme(1.1.0-alpha04) güncelleyin veyaandroidx.compose.foundation
sürümünüzü 1.4.0-alpha03'e düşürün.
Sürüm 1.1.0-alpha03
7 Aralık 2022
androidx.compose.material3:material3:1.1.0-alpha03
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
yayınlandı. 1.1.0-alpha03 sürümü bu taahhütleri içerir.
API Değişiklikleri
consumedWindowInsets()
consumeWindowInsets()
,withConsumedWindowInsets()
onConsumedWindowInsetsChanged()
olarak yeniden adlandırıldı ve değiştiriciler herkese açık hale getirildi. (Ie44e1)- Kullanılacak simgeyle metin düğmesi için yeni varsayılan içerik dolgusu ekleyin. (I8f662)
- Gezinme çubuğu ve çubuğu için devre dışı bırakılmış renkler eklendi. (Ia7892, b/258867034)
- Üst öğelerin kaydırma bilgilerini sorgulamak için bir Değiştirici API eklendi. (I2ba9d, b/203141462)
- Hareketlerin kaydırma etkinlikleri haline gelebileceği durumlarda, basma etkileşimlerini doğru şekilde geciktirmek için
Clickable
içinde kullanılır. Clickables
öğesinin,Scrollable ViewGroup
içinde kullanıldığında dalgaların doğru şekilde geciktilmemesi sorunu düzeltildi.- Çekme panelleri ve sayfalar, hareketlerin kaydırma etkinliklerine dönüşebileceği durumlarda basmaları doğru şekilde geciktirmek için güncellendi.
Bağımlılık Güncellemeleri
Compose UI
veCompose Material
artık Yaşam Döngüsü 2.5.1'e bağlıdır. (I05ab0, b/258038814)
Sürüm 1.1.0-alpha02
9 Kasım 2022
androidx.compose.material3:material3:1.1.0-alpha02
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
yayınlandı. 1.1.0-alpha02 sürümü bu taahhütleri içerir.
API Değişiklikleri
awaitFirstDown
vewaitForUpOrCancellation
artık daha fazla esneklik içinPointerEventPass
değerini kabul ediyor (ayrıca kaydırma sırasındaExposedDropdownMenuBox
menüsünün gösterilmesi sorunu da düzeltildi).(I7579a, b/212091796)- material ve material3 metinlerine
minLines
parametresi eklendi. Bu parametre, bileşenin minimum yüksekliğini satır sayısı açısından ayarlamanıza olanak tanır (I4af1d)TextField
OutlinedTextField
TopAppBarDefaults smallTopAppBarColors
işlevi kullanımdan kaldırılacak veTopAppBar
oluşturulurken kullanılması gereken yeni birtopAppBarColors
işlevi eklenecek. (Ie6cb9)BasicText
veBasicTextField
öğesineminLines
parametresi eklendi. Bu birleştirme öğelerinin minimum yüksekliğini satır sayısı açısından ayarlamanıza olanak tanır (I24294, b/122476634)
Hata Düzeltmeleri
- Bir Material3
IconButton
veIconToggleBotton
içeriğini bileşenin durum katmanı şekline (ör. dairesel şekil) kırpın. (I9da8f) - Material3 orta ve büyük üst uygulama çubukları, tüm yüzeylerinde aynı arka plan renginin uygulanması ve varsayılan renklerin şeffaf renk değerleriyle geçersiz kılınmasına izin verecek şekilde güncellendi. (I67659, b/249688556, b/250838918)
Sürüm 1.1.0-alpha01
24 Ekim 2022
androidx.compose.material3:material3:1.1.0-alpha01
ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
yayınlandı. 1.1.0-alpha01 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
- Başlık, TextStyle ve Brush ile uygulandığında üst uygulama çubuğunda düzeltmeler yapıldı. (If667e)
Sürüm 1.0
1.0.1 sürümü
9 Kasım 2022
androidx.compose.material3:material3:1.0.1
ve androidx.compose.material3:material3-window-size-class:1.0.1
yayınlandı. 1.0.1 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
- Material3 orta ve büyük üst uygulama çubukları, tüm yüzeylerinde aynı arka plan renginin uygulanması ve varsayılan renklerin şeffaf renk değerleriyle geçersiz kılınmasına izin verecek şekilde güncellendi. (I67659, b/249688556, b/250838918)
Sürüm 1.0.0
24 Ekim 2022
androidx.compose.material3:material3:1.0.0
ve androidx.compose.material3:material3-window-size-class:1.0.0
yayınlandı. 1.0.0 sürümü bu taahhütleri içerir.
1.0.0 sürümünün önemli özellikleri
Bu, Compose Material 3'ün ilk kararlı sürümüdür.
Materyal Tasarım 3 temaları ve Material You dinamik rengi
Materyal Tasarım 3 bileşenleri
- Rozet
- Alt Uygulama Çubuğu
- Düğmeler
- FAB ve genişletilmiş FAB
- Kartlar
- Onay kutusu
- Çipler
- Sohbet
- Bölücü
- Açılır Menü
- Liste
- Gezinme çubuğu
- Gezinme çekmecesi
- Gezinme çubuğu
- İlerleme Göstergesi
- Radyo Düğmesi
- Kaydırma çubuğu
- Geçiş
- Sekmeler
- Metin Alanları
- Üst uygulama çubuğu
- Simge
- Metin
- Yüzey
- Düzen
- İçerik rengi
Pencere Boyutu Sınıfı
material3-window-size-class
, pencere boyutu sınıfları için destek sağlayan yeni bir kitaplıktır: yeniden boyutlandırılabilir uygulama düzenleri tasarlamanız, geliştirmeniz ve test etmeniz için bir dizi görüşlü görüntü alanı kesme noktasıdır.calculateWindowSizeClass
kullanarak bir pencere boyutu sınıfı örneği alabilirsiniz. Bu örneği, kullanıcı arayüzünüzün nasıl görüneceğini belirlemek için kullanabilirsiniz (ör. daha büyük pencere boyutları için alt gezinme yerine gezinme çubuğu gösterme). Daha fazla bilgi ve örnek kullanım içinWindowSizeClass
API referans dokümanlarına bakın.Daha fazla bilgi için lütfen bu blog yayınını inceleyin.
Sürüm 1.0.0-rc01
5 Ekim 2022
androidx.compose.material3:material3:1.0.0-rc01
ve androidx.compose.material3:material3-window-size-class:1.0.0-rc01
yayınlandı. 1.0.0-rc01 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Metni metin alanına API'ye destek vermek için slot parametresi eklendi (Iaac0d, b/227146125)
Sürüm 1.0.0-beta03
21 Eylül 2022
androidx.compose.material3:material3:1.0.0-beta03
ve androidx.compose.material3:material3-window-size-class:1.0.0-beta03
yayınlandı. 1.0.0-beta03 sürümü bu taahhütleri içerir.
API Değişiklikleri
ExposedDropdownMenuDefaults
artık menü öğeleri için bir dolgu değeri gösterir. (I34ee1)ExposedDropdownMenuBoxScope
artık doğru erişilebilirlik davranışı için metin alanına iletilmesi gereken birModifier.menuAnchor()
değiştiriciye sahip. (I27fa3)- Kullanıcıların kaydırma çubuğunu doldurmak için bir başparmak veya parça iletmesine olanak tanımak amacıyla mevcut Slider API için iki aşırı yüklenmiş yöntem eklendi. (I21c00)
Hata Düzeltmeleri
- Hata Kapsamı için koyu tema renk eşlemesi 90 tonu (Ic5612) olarak güncellendi
- Küçük Material 3 üst uygulama çubukları için şeffaf arka plan ayarlama özelliğini etkinleştiren düzeltme. (I645e2, b/245575782)
Sürüm 1.0.0-beta02
7 Eylül 2022
androidx.compose.material3:material3:1.0.0-beta02
ve androidx.compose.material3:material3-window-size-class:1.0.0-beta02
yayınlandı. 1.0.0-beta02 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Beta01 sürümündeki m3 bileşenlerinde kullanıma sunulan varsayılan bileşen iç içe yerleştirilmeleri artık IME iç içe yerleştirilmelerini hesaba katmıyor.
- Material3 Scaffold bileşeninde artık içerik yuvası için kullanılacak içe yerleştirilme miktarını belirtmenize olanak tanıyan bir
contentWindowInsets
parametresi bulunmaktadır. (Icf11a, b/243713323) - Deneysel Material 3
SmallTopAppBar
işlevi kullanımdan kaldırıldı ve eşdeğer birTopAppBar
işlevi kullanıma sunuldu. Lütfen kullanımınızı yeni hesaba taşıyın. (I74404, b/226918634) - Üst uygulama çubuğu fırlatma ve sabitleme davranışları üzerinde kontrol ekler. (I15c81)
- Bölücünün startIndent özelliğini kaldırır, rengi son parametreye taşır. (If7be2)
Hata Düzeltmeleri
- İletişim kutuları, gösterildiğinde "İletişim kutusu" kelimesini söyleyerek kendileri hakkında bilgi verebilir. (I857ef)
Sürüm 1.0.0-beta01
24 Ağustos 2022
androidx.compose.material3:material3:1.0.0-beta01
ve androidx.compose.material3:material3-window-size-class:1.0.0-beta01
yayınlandı. 1.0.0-beta01 sürümü bu taahhütleri içerir.
API Referansı
Kullanılabilir en son temaları, bileşenleri ve diğer derlenebilir öğeleri görmek için Compose Material 3 API referansına genel bakış başlıklı makaleyi inceleyin.
API Değişiklikleri
- Material 3 üst uygulama çubuğu, tamamen daraltılmış durumdan tamamen genişletilmiş duruma hızlıca geçecek şekilde güncellendi. Ayrıca,
TopAppBarDefaults
davranış işlevi Composables olarak güncellendi ve üst uygulama çubuğu durumu ile animasyon spesifikasyonu için varsayılan değerler sağlandı. (I642b3) - FAB bileşeni imzaları, yüzey API'siyle eşleşecek şekilde güncellendi (I3afaa)
- Üst uygulama çubukları, çekmeceler, gezinme çubuğu ve ray için yerleşik destek eklendi. Bu bileşenler, ayrı olarak veya Scaffold ile kullanıldığında geliştiriciler için iç içe yerleştirilmeleri otomatik olarak yönetir. Not: Bu değişiklik, durum çubuğu simgelerinin otomatik olarak işlenmesini ve durum ile gezinme çubuklarının şeffaflığını sağlamaz. En iyi kenardan kenara deneyimi için lütfen bunu manuel olarak yapmaya devam edin. (I7e4e6, b/183161866)
- Gelecekteki esneklik ve performans iyileştirmeleri için API yüzeyini azaltmak amacıyla bileşen varsayılanları güncellendi. (I31820)
- API'de tutarlılığı sağlamak için çip ve gezinme çekmecesi sayfası parametreleri yeniden sıralandı (I45d0b)
- Bölücünün
startIndent
parametresi kaldırıldı ve renk son parametre olacak şekilde taşındı.(If7be2)
Sürüm 1.0.0-alpha16
10 Ağustos 2022
androidx.compose.material3:material3:1.0.0-alpha16
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
yayınlandı. 1.0.0-alpha16 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Gezinme çekmecesinde özel genişlik belirtme desteği. (Ia7f10)
API Değişiklikleri
- API'de tutarlılık sağlamak için Sekme ve Baştaki simge sekmesi parametrelerini yeniden sıralama (Ie2637)
BadgeDefaults
deneysel olarak işaretlendi. (I98ef3)- Desteği sonlandırılan gezinme çekmecesi işlevini kaldırın. (I4f2db)
- API'de tutarlılığı korumak için Material 3'te kaydırma çubuğu parametrelerini yeniden sıralama (I0aee7)
- API'de tutarlılığı sağlamak için
NavigationBar
veNavigationRail
parametrelerini yeniden sıralama (I51cda) - API'de tutarlılığı korumak için Material 3'teki parametreleri yeniden sıralayın. (If4ae1)
- API'de tutarlılığı korumak için Material 3'te kaydırma çubuğu parametrelerini yeniden sıralama (I62673)
- Üst uygulama çubuğuyla tutarlı olması için simgeler parametresi, işlemler olarak yeniden adlandırıldı (Id75be)
- Sabitleme hizası hâlâ değiştiği için
Badge
veBadgedBox
'ü deneysel olarak işaretleyin. (I1712e, b/236524516) - Simge düğmesi varyantlarındaki
@ExperimentalMaterial3Api
ek açıklamalarını@OptIn
olarak değiştirin (I070b5) - Gezinme çekmecesinin içeriği, özel bir genişlik belirtmeyi desteklemek için kendi derlenebilir öğesine ayrıldı. (Ia7f10)
Divider
öğesiniMenuDefaults
veTabDefaults
'den kaldırır (I4e33c)
Sürüm 1.0.0-alpha15
27 Temmuz 2022
androidx.compose.material3:material3:1.0.0-alpha15
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
yayınlandı. 1.0.0-alpha15 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Üst uygulama çubuğunu çubuktan sürükleme özelliğini etkinleştirin. (I65c00, b/205873416)
API Değişiklikleri
selectedIcon
yuvasını kaldırmak ve seçili bir durumu görüntülemek içinleadingIcon
'ın yeniden kullanılmasını teşvik etmek amacıylaFilterChip
veElevatedFilterChip
API'lerinde yapılan güncellemeler. (Ie5dc2)- Gölge ve ana hat varyant renk rolleri ekleyin. (Id6d54)
- Derlenebilir varsayılanlar için adlandırma kurallarını düzeltin. (I62b27)
ListItemDefaults
veListItemColors
'yi deneme olarak işaretleyin. (I1f3ec)- Üst uygulama çubuğu API'sinde, durum özelliklerinin anlamını daha iyi yansıtacak şekilde değişiklikler yapıldı. Ayrıca, üst uygulama çubuğu API'sini deneysel olarak işaretleyin. (Ic0ad8)
- Daha iyi bulunabilirlik için
TextFieldColors
'e metin seçimi renkleri eklendi. (Iba1b8) - Simge içeren düğmelerle kullanılacak
ButtonDefault.ButtonWithIconContentPadding
ekleme. (I2bf9c) - Metin alanları, gelecekteki API değişikliklerinde daha fazla esneklik sağlamak için deneysel olarak işaretlendi. (I127b5)
Checkbox
işlevinden@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I5eefc)RadioButton
işlevinden@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I17e2a)- Etkileşimli olmayan kartlardan
@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I9bd49) - Çeşitli bileşen varsayılan nesnelerini renk, şekil vb. içerecek şekilde günceller. (I96e11)
Hata Düzeltmeleri
- Katalog uygulamasında kullanıcıların kafasının karışmasını önlemek için giriş çipi örneklerinden işlevsel olmayan son simgeleri kaldırdık. (I9846a)
Sürüm 1.0.0-alpha14
29 Haziran 2022
androidx.compose.material3:material3:1.0.0-alpha14
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
yayınlandı. 1.0.0-alpha14 sürümü bu taahhütleri içerir.
Yeni Özellikler
- M3 listesi uygulaması eklendi. Örnek kullanım dokümanlarına bakın (Id7a20).
API Değişiklikleri
RangeSlider
(I3b79a) parametre adının values yerine value olarak değiştirilmesi- API, Material Design spesifikasyonuna göre seçilebilir bir durumu desteklemek için
InputChip
uygulamasında değiştirildi. Seçili devre dışı durum içinFilterChip
renklerinde ek destek sağlandı. (I55244, b/235792432) BottomAppBar
varsayılan FAB'ı ekleyin (Ida4c8)ColorScheme.surfaceColorAtElevation
eklendi (Id41af)- Oluşturma kitaplarındaki arayüzler artık jdk8 varsayılan arayüz yöntemleri (I5bcf1) kullanılarak oluşturuluyor
WindowWidthSizeClass
veWindowHeightSizeClass
artık Comparable'ı uyguladığından operatörler (<, <=, >=, >) ve diğer API'ler kullanılarak karşılaştırılabilir. (I747d0)
Hata Düzeltmeleri
- Rozet örneğini, daha anlamlı bir içerik açıklaması sağlayacak şekilde güncelleyin. (I10b9d)
- Material 3 kataloğunun tema seçicisine sistem yazı tipi boyutunu kullanma seçeneği eklendi. (I10605)
- Rozet ve belirsiz ilerleme göstergeleri için örnek kod ekler. (I8fbe0)
Sürüm 1.0.0-alpha13
1 Haziran 2022
androidx.compose.material3:material3:1.0.0-alpha13
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
yayınlandı. 1.0.0-alpha13 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Yapılandırmanın değiştirilmesi durumunda üst uygulama çubuğu konumunun korunmasını destekler. (I10459, b/216160958)
Sürüm 1.0.0-alpha12
18 Mayıs 2022
androidx.compose.material3:material3:1.0.0-alpha12
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
yayınlandı. 1.0.0-alpha12 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
- Kaydırma çubuğunun üst öğesi artık 0 genişliğe sahip olabilir. (b/231707291)
Sürüm 1.0.0-alpha11
11 Mayıs 2022
androidx.compose.material3:material3:1.0.0-alpha11
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
yayınlandı. 1.0.0-alpha11 sürümü bu taahhütleri içerir.
Yeni Özellikler
- 3. materyale (I18e38)
RangeSlider
eklendi - Material3
AssistChip
veInputChip
desteği ekler (I0d25a) - Material3
FilterChip
veSuggestionChip
desteği ekler (I9fdf3)
API Değişiklikleri
OutlinedTextField
'te kenar çizgisi çizenTextFieldDefaults.BorderStroke
kompozit öğesiTextFieldDefaults.BorderBox
olarak yeniden adlandırıldı. (I5f295)- m3 görsel değişikliklerini değiştirme (Iab30e)
- Standart simge düğmelerine renk iletme (Ia2445)
Hata Düzeltmeleri
- İç dolgunun kullanılmasını sağlamak için material3/Scaffold'a lint kontrolü ekleyin (I72293, b/226951418)
Sürüm 1.0.0-alpha10
20 Nisan 2022
androidx.compose.material3:material3:1.0.0-alpha10
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
yayınlandı. 1.0.0-alpha10 sürümü bu taahhütleri içerir.
Yeni Özellikler
material3-window-size-class
, pencere boyutu sınıfları için destek sağlayan yeni bir kitaplıktır: yeniden boyutlandırılabilir uygulama düzenleri tasarlamanız, geliştirmeniz ve test etmeniz için bir dizi görüntü alanı kesme noktasıdır.calculateWindowSizeClass
kullanarak bir pencere boyutu sınıfı örneği alabilirsiniz. Bu örneği, kullanıcı arayüzünüzün nasıl görüneceğini belirlemek için kullanabilirsiniz (ör. daha büyük pencere boyutları için alt gezinme yerine gezinme çubuğu gösterme). Daha fazla bilgi ve örnek kullanım içinWindowSizeClass
API referans dokümanlarına bakın. Pencere boyutu sınıfı tanımları hakkında daha fazla bilgi için farklı ekran boyutlarını desteklemeyle ilgili herkese açık yönergelere bakın.
API Değişiklikleri
BottomAppBar
için varsayılan FAB yüksekliği ekler, FAB ileBottomAppBar
'ten son lambdayı kaldırır. (I92c47)- Material3
FilledIconButton
,FilledTonalIconButton
veOutlinedIconButton
eklenir. (Ib2bda) - Material 3 Snackbar API'yi, isteğe bağlı işlem ve kapatma işlemi için renk değerlerini kabul edecek şekilde günceller. (Ibe4b4)
- Kısmi tüketim (aşağı VEYA konum) özelliği
PointerInputChange
sürümünde kullanımdan kaldırıldı. Değişikliği tamamen kullanmak içinconsume()
kullanabilirsiniz. Değişikliğin daha önce başka bir kullanıcı tarafından tüketilip tüketilmediğini belirlemek içinisConsumed
değerini kullanabilirsiniz. PointerInputChange::copy()
artık her zaman yüzeysel bir kopya oluşturuyor. Bu,PointerInputChange
kopyalarının, kopyalardan biri tüketildikten sonra tüketileceği anlamına gelir. Bağlantısız birPointerInputChange
oluşturmak istiyorsanız bunun yerine kurucuyu kullanın. (Ie6be4, b/225669674)- Kapsayıcı ve içerik renklerini
CardColors
arayüzü üzerinden almak ve tıklanabilir kartlar için devre dışı durumu desteklemek amacıyla Cards API'de yapılan değişiklikler. (I927df) - Diğer bileşenlerle daha tutarlı olması için
backgroundColor
parametresi, Malzeme 3 metin alanlarındacontainerColor
olarak yeniden adlandırıldı. (I6fbd9)
Hata Düzeltmeleri
IconButton
standardında Material3 spesifikasyonuyla uyumlu olacak şekilde yapılan güncellemeler. (I09eab)- material3 Scaffold'ın üst çubuğunun yüksekliğini, içeriğe iletilen dolguya taşıyarak içeriğin üst uygulama çubuğunun altında oluşturulmasını sağlayın.
PaddingValues
yoksayılırsa içerik üst çubuk tarafından gizlenebilir. (I83cbc, b/217776202)
Sürüm 1.0.0-alpha09
6 Nisan 2022
androidx.compose.material3:material3:1.0.0-alpha09
yayınlanır. 1.0.0-alpha09 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Material 3 Switch API (I2c3ad) eklendi
API Değişiklikleri
- Metin alanları içeren açılır menüler (diğer adıyla "açık açılır menüler" veya "karma kutular") için destek eklendi. (I1b832)
- MaterialTheme ve Shape alt sistemine şekil parametresi eklendi. (I37426)
- FAB'ın genişletilip daraltıldığını kontrol etmek için
ExtendedFloatingActionButton
parametresine genişletilmiş parametresi eklendi. Bu parametre, her durum arasında animasyonlar gösterir. Simgesiz genişletilmiş FAB'lar için sonuna metin eklenmiş genişletilmiş FAB'lar için genişletilmiş FAB aşırı yüklemesi eklendi. (Iba7f1)
Sürüm 1.0.0-alpha08
23 Mart 2022
androidx.compose.material3:material3:1.0.0-alpha08
yayınlanır. 1.0.0-alpha08 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Material 3 metin alanları için destek eklendi. (I795cc, b/199377790)
API Değişiklikleri
- Menü için varsayılan bölücü ekleme (I01374)
ColorScheme
sınıfınasurfaceTint
renk parametresi eklendi. (I2f558)
Hata Düzeltmeleri
- Material3 düğmesinde, varsayılan metin stili değerini MaterialTheme'den okumak için düzeltme yapın. (Ie62fc)
Sürüm 1.0.0-alpha07
9 Mart 2022
androidx.compose.material3:material3:1.0.0-alpha07
yayınlanır. 1.0.0-alpha07 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Tıklanabilir yüzeyler için aşırı yüklenmiş işlevleri geri getiren ve seçilebilir ve açma/kapatma düğmeli yüzeyleri destekleyen bir işlev ekleyen Material 3 Surface API güncellemeleri. (I4bf18)
LazyVerticalGrid
veLazyHorizontalGrid
artık kararlı. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
ve ilgili tüm API'ler .grid alt paketine taşındı. Lütfen içe aktarmalarınızı androidx.compose.foundation.lazy yerine androidx.compose.foundation.lazy.grid olarak güncelleyin. (I2d446)WindowInsetsControllerCompat
için yalnızca bir Görünümü temel alan önceki değişikliği geri aldık ve bazı pencere işaretçilerini yönetmek için gereken bir Pencere'yi tekrar zorunlu kıldık. Doğru pencerenin kullanılmasını sağlamak içinViewCompat.getWindowInsetsController
desteği sonlandırıldı (ör. görünüm bir iletişim kutusundaysa).WindowCompat.getInsetsController
(I660ae, b/219572936)- Eksenler arası boyutları tanımlamak için yeni bir
LazyVerticalGrid
API eklendi (I17723)
Hata Düzeltmeleri
- Surface API'deki değişiklikleri takip etmek için Card API'de yapılan güncellemeler (I3c8b9)
Sürüm 1.0.0-alpha06
23 Şubat 2022
androidx.compose.material3:material3:1.0.0-alpha06
yayınlanır. 1.0.0-alpha06 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Çekmeceler içindeki tek bir hedefi temsil eden
NavigationDrawerItem
eklenir (Ic396f, b/218286829) PermanentNavigationDrawer
veDismissibleNavigationDrawer
deneysel API'ler olarak eklendi. Bunlar, büyük ekranlı cihazlar için uygun çekmecelerdir. (I5f8ab, b/218286829)- Materyal 3 alt uygulama çubuğu desteği eklendi (Ic432a)
NavigationDrawer
,ModalNavigationDrawer
olarak yeniden adlandırıldı (I1807d, b/218286829)- Material 3 Slider sınıfı ve jetonları eklendi (I1ccee)
- Sekme uygulaması eklendi. Örnek kullanımla ilgili dokümanlara bakın (Ie0146).
Hata Düzeltmeleri
TalkBack
ekran okuyucusunun doğrusal gezinme özelliğinin, üst uygulama çubuğu başlığını boş seçmesine neden olan sorun düzeltildi. (Id4690)IconSize
,FloatingActionButtonDefaults
grubuna eklendi. (Ia71cf)LazyColumn
ile uzun bir metin eklendiğinde gizliAlertDialog
düğmeleri için hata düzeltmesi. (Ib2cc9, b/216663029)
Sürüm 1.0.0-alpha05
9 Şubat 2022
androidx.compose.material3:material3:1.0.0-alpha05
yayınlanır. 1.0.0-alpha05 sürümü bu taahhütleri içerir.
Yeni Özellikler
Materyal Tasarım 3 bileşeni eklendi
- Açılır menü
- Kartlar
API Değişiklikleri
- onClick geri çağırma işlevi alan
Surface
işlevi kullanımdan kaldırıldı. Tıklanabilir yüzeyler, birInteractionSource
ve birModifier.clickable()
ile oluşturulmalıdır. (I211c6) - FAB için basılı ve odaklanmış yükseklik desteği eklendi. (Ibb584)
Surface
API'si, farklı durumlarda görünümünü kontrol etmeye olanak tanıyan bir InteractionSource alacak şekilde değiştirildi. (Iafbc8)
Hata Düzeltmeleri
- Dinamik renk şemalarında eksik olan üçüncül renkler eklendi (I456c4, b/214588434)
Sürüm 1.0.0-alpha04
26 Ocak 2022
androidx.compose.material3:material3:1.0.0-alpha04
yayınlanır. 1.0.0-alpha04 sürümü bu taahhütleri içerir.
API Değişiklikleri
- Karmaşık mantık içermeyen mevcut yöntemlerin aşırı yüklenmeleri olan yöntemlere
NonRestartableComposable
eklendi. Bu, çağrılan iç işlevde tekrarlanan tüm parametreler için derleyici tarafından oluşturulan hafıza önbelleğe alma kontrollerini (eşit) azaltır. (I90490) - 3. malzeme bölücü eklendi. (Ica5fc)
- Onay kutusunu ve radyo düğmesini deneysel API notuyla işaretleyin. (Ie44bb)
- Material 3 ilerleme durumu göstergeleri için destek eklendi. (Iff232, b/205023841)
Hata Düzeltmeleri
- Devre dışı bırakılmış bir
TextButton's
kapsayıcı rengini şeffaf olarak güncelleme (I6b248, b/213339737)
Sürüm 1.0.0-alpha03
12 Ocak 2022
androidx.compose.material3:material3:1.0.0-alpha03
yayınlanır. 1.0.0-alpha03 sürümü bu taahhütleri içerir.
Hata Düzeltmeleri
LocalIndication
'ü 3. malzemeninMaterialTheme
alanına ekleyin. (I7ce4e)- Onay kutuları için uygulanan köşe yarıçapını düzeltin (I38b03, b/175198975, b/202309440)
Bağımlılık Güncellemeleri
- Artık Kotlin
1.6.10
sürümüne bağlıdır.
Sürüm 1.0.0-alpha02
1 Aralık 2021
androidx.compose.material3:material3:1.0.0-alpha02
yayınlanır. 1.0.0-alpha02 sürümü bu taahhütleri içerir.
Yeni Özellikler
- Onay kutusu ve radyo düğmesi desteği ekleyin.
- Kotlin
1.6.0
ile uyumlu olacak şekilde güncellendi
API Değişiklikleri
- Çekmeceyi, Materyal 3'ün iskeletinden kaldırın. (I04f51)
- 3. malzeme
Checkbox
desteği eklendi. (Id5542) - 3. malzeme
RadioButton
desteği eklendi. (I20334)
Hata Düzeltmeleri
IconButton
dalgalanma yarıçapını 40 dp'den 20 dp'ye düşürün. (I68bbe, b/206674345)Text
için bağlantı noktası dizesi hızlı yolucompose.material
olarak değişti (I30b03)- Düzeltildi ancak bu sabit kodlu düğme her zaman etkin olacak. (Iea832, b/205335456)
Sürüm 1.0.0-alpha01
27 Ekim 2021
androidx.compose.material3:material3:1.0.0-alpha01
yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.
Yeni Özellikler
Materyal Tasarım 3 temaları ve Material You dinamik rengi
Materyal Tasarım 3 bileşenleri
- Düğmeler
- FAB ve genişletilmiş FAB
- Sohbet
- Gezinme çubuğu
- Gezinme çekmecesi
- Gezinme çubuğu
- Üst uygulama çubuğu
- Rozet
- Simge
- Metin
- Yüzey
- Düzen
- İçerik rengi
Daha fazla bilgi için Oluşturma'da Materyal Temalar kılavuzundaki Materyal Tasarım 3 ve Material You bölümüne göz atın.