Compose Material 3
androidx.compose.material3
(Tüm Compose paketleri için API referans belgelerine bakın)
Son Güncelleme | Kararlı sürüm | Sürüm Adayı | Beta Sürümü | Alfa sürümü |
---|---|---|---|---|
2 Temmuz 2025 | 1.3.2 | - | - | 1.4.0-alpha17 |
Yapı
Compose, androidx
içindeki yedi Maven Group ID'sinin birleşimidir. Her grup, kendi sürüm notları kümesine sahip, hedeflenmiş bir işlevsellik alt kümesi içerir.
Bu tabloda gruplar açıklanmakta ve her bir sürüm notu grubuna bağlantı verilmektedir.
Grup | Açıklama |
---|---|
compose.animation | Kullanıcı deneyimini zenginleştirmek için Jetpack Compose uygulamalarında animasyonlar oluşturun. |
compose.compiler | @Composable işlevlerini dönüştürün ve Kotlin derleyici eklentisiyle 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 adresinde açıklanan bileşenleri sağlamak üzere tasarlanmış, Compose'un daha üst düzey giriş noktasıdır. |
compose.material3 | Materyal Tasarım'ın bir sonraki evrimi olan Materyal Tasarım 3 Bileşenleri ile Jetpack Compose kullanıcı arayüzleri oluşturun. Material 3, güncellenmiş temalar ve bileşenler ile dinamik renk gibi Material You kişiselleştirme özelliklerini içerir. Ayrıca yeni Android 12 görsel stili ve sistem kullanıcı arayüzüyle uyumlu olacak şekilde tasarlanmıştır. |
compose.runtime | Compose'un programlama modeli ve durum yönetiminin temel yapı taşları ve Compose Compiler Plugin'in hedefleyeceği temel çalışma zamanı. |
compose.ui | Düzen, çizim ve giriş dahil olmak üzere cihazla etkileşim kurmak için gereken Compose kullanıcı arayüzünün temel bileşenleri. |
Bağımlılıkları bildirme
Compose'a bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanız veya modülünüz için build.gradle
dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.2" implementation "androidx.compose.material3:material3-window-size-class:1.3.2" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.2") implementation("androidx.compose.material3:material3-window-size-class:1.3.2") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17") } 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ştirmeye yönelik fikirleriniz olursa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.
Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.
Compose Material3 Common Version 1.0
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 commit'leri içerir.
Yeni Özellikler
Material Design bileşenleri oluşturmak için kullanılabilecek temasız bileşenler:
- Tonal Palet
- Simge
- Dokunma hedefi boyutu
Compose Material3 Adaptive Navigation Suite 1.0 sürümü
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ü şu commit'leri içerir.
API Değişiklikleri
- Navigasyon paketi API'lerini deneysel olmayan hale getirme (If62af)
Hata Düzeltmeleri
- İçerik için varsayılan olarak yerleştirilmiş reklamları 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 commit'leri içerir.
API Değişiklikleri
containerColor
vecontentColor
öğeleriniNavigationSuiteScaffoldDefaults
listesine ekleyin. (I64e3a, b/331993720)itemColors
işleviNavigationSuiteDefaults
'e ekleniyor. (Idf719, b/328480012)NavigationSuiteScope
ürününü kapalı hale getirin. (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 commit'leri içerir.
API Değişiklikleri
NavigationSuiteItemColors
oluşturucusunu herkese açık yapın. (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ü şu commit'leri içerir.
Bağımlılık Güncellemeleri
- Material3 uyarlanabilir bağımlılıklarını 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ü şu commit'leri 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 değerini alan, null değer atanabilir birMutableInteractionSource
gösterecek şekilde güncellendi. Burada anlamsal bir değişiklik yoktur: null iletmek,MutableInteractionSource
öğesini yükseltmek istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Değeri null olarak değiştirmek, bazı bileşenlerin hiçbir zamanMutableInteractionSource
ayırmamasına ve diğer bileşenlerin yalnızca ihtiyaç duyduklarında geç oluşturmasına olanak tanır. Bu da bu bileşenlerde performansı artırır. Bu bileşenlere ilettiğinizMutableInteractionSource
değerini kullanmıyorsanız bunun yerine null 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ü şu commit'leri içerir.
Yeni Özellikler
- "Yok"
NavigationSuiteType
seçeneğini ekleyin (If8cb1, b/313688598)
Hata Düzeltmeleri
- Kök yüzeyde
modifier.fillMaxSize
olduğunda gezinme bileşeninin ekranın tamamını doldurması sorunu düzeltildi. (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
iptal edilir. 1.0.0-alpha01 sürümü şu commit'leri içerir.
Yeni Özellikler
Compose Material3 Adaptive Version 1.0
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ü şu commit'leri 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ü şu commit'leri içerir.
Yeni Özellikler
- İskele gezinme ve değer hesaplamada geçmiş farkındalığı desteği (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ü şu commit'leri içerir.
Yeni Özellikler
- Bölme iskelelerinde uçtan uca 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
düzeltmesi yeniden oluşturulmuyor (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ü şu commit'leri içerir.
API Değişiklikleri
- İskele rollerini
ThreePaneScaffoldRole
'nın diğer adları olarak değiştirin. (I65bd1) - İskele rolleri için temel sınıf oluşturma (I4784d)
AnimatedPane
içeriğinden gereksiz parametreyi kaldırma (Ibc73b)collectWindowSizeAsState
öğesini yeniden adlandırır ve bunun yerine ham değerler 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ü şu commit'leri içerir.
API Değişiklikleri
- Gezinme API'lerini uyarlanabilir iskele API'lerinden ayırın. (Ic4045)
GutterSize
sınıfını kaldırın. (I785b3)
Hata Düzeltmeleri
AnimatedPane
kullanılmadığında düzeltme bölmeleri değiştirilmiyor (d88f181)
Sürüm 1.0.0-alpha01
15 Kasım 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
iptal edilir. 1.0.0-alpha01 sürümü şu commit'leri içerir.
Yeni Özellikler
Material3 uyarlanabilir koşul API'leri:
Material3 uyarlanabilir bölme iskele yönergesi API'leri:
Material3 uyarlanabilir bölme iskele API'leri:
- Temel bölme iskeleti API'leri
Compose Material3 1.4 sürümü
Sürüm 1.4.0-alpha17
2 Temmuz 2025
androidx.compose.material3:material3-*:1.4.0-alpha17
iptal edilir. 1.4.0-alpha17 sürümü bu commit'leri içerir.
Yeni Özellikler
- Düğme grubunun animasyonunu, basıldığında değil tıklandığında animasyonun% 75'i kadar olacak şekilde güncelleyin. (593942a, b/423596967)
Hata Düzeltmeleri
- Bazı durumlarda bir carousel öğesinin, düzen hesaplamaları sırasında büyük öğe boyutunu aşarak widget'ın tamamının kesilmesine neden olabilmesi sorunu düzeltildi. (I1c3d7, b/397489534)
- Başlangıç ve bitiş kaydırma uzaklıkları çakışan bantları kaydırırken
beforeContentPadding
işaretinin atlanması sorunu düzeltildi. (c3d5f3a, b/420618979) SwipeToDismiss
'nın etkinleştirilmiş davranışı, mevcut durum yerine yerleşmiş durumu gözlemleyecek şekilde güncellendi. Sabitleme davranışının yalnızca bileşen kapatılmış durumda olduğunda devre dışı bırakıldığı mevcut davranışı geri yükler. (3844e07, b/425006844)ExposedDropdownMenu
simgesinin pop-up menüsü artık klavye girişiyle açılabilir. Ayrıca, düzenlenebilir varyant için menüye klavye üzerinden erişilebilmesi düzeltildi. (46ead03)
Sürüm 1.4.0-alpha16
18 Haziran 2025
androidx.compose.material3:material3-*:1.4.0-alpha16
iptal edilir. 1.4.0-alpha16 sürümü bu commit'leri içerir.
Yeni Özellikler
- Ortaya hizalanmış bir önemli bant bileşeni eklendi (I6f6d3).
API Değişiklikleri
- XR, dikey araç çubuğunu geçersiz kılıyor (Ia1604)
CarouselState
'ya programatik kaydırma işlevleri eklendi (I12f8e)ModalWideNavigationRail
içinComponentOverride
ekleyin (I4f440)WideNavigationRail
içinComponentOverride
ekleyin (I6354f)HorizontalFloatingToolbar
içinComponentOverride
oluşturuluyor (I51116)ShortNavigationBar
içinComponentOverride
oluşturma (I30e24)SwipeToDismissBoxState
ile ilgiliconfirmValueChange
referansları kullanımdan kaldırıldı olarak işaretlendi. Kullanıcılar bunun yerineSwipeToDismissBox
APIonDismissed
geri çağırmasını kullanmalıdır. (Iee780)- Carousel composable'larına userScrollEnabled parametresi eklendi. (I1d4d2)
- Banttaki
currentItem
artıkCarouselState
üzerinden gözlemlenebilir. (Ie87e9)
Hata Düzeltmeleri
FloatingToolbar
öğesine iletilen bir FAB'deki rastgele şeklin gölgesini doğru şekilde uygulamamasına neden olan sorun düzeltildi. (Icdcc9, b/423336922)- Tüm Carousels artık varsayılan olarak Carousel anlamsal rolünü kullanıyor. (I7af12)
- Kaydırma çubuğu durumu
LaunchedEffect
üzerinden güncellendiğinde başparmağın yanlış hareket etmesi sorunu düzeltildi (Id9f31, b/302774166).
Sürüm 1.4.0-alpha15
20 Mayıs 2025
androidx.compose.material3:material3-*:1.4.0-alpha15
iptal edilir. 1.4.0-alpha15 sürümü bu commit'leri içerir.
API Değişiklikleri
MotionTheme.LocalMotionScheme
, kompozisyon yerel ayarı eklendi. Bu,CompositionLocalConsumerModifierNodes
uygulamasındancurrentValueOf(MotionTheme.LocalMotionScheme)
ile tema hareket planına erişilmesine olanak tanır. (I014b1)- Sabit renk rolleri içermeyen
ColorScheme
oluşturucusu artık kullanımdan kaldırıldı. Lütfen sabit roller içeren oluşturucuya geçin. (Iad0ee) - M3 Metin bileşeni artık
TextAutoSize
kodunu destekliyor. (I7f524) - Bölünmüş düğme boyutu varyantları oluşturmak için API ekleyin ve örnekler ekleyin. (Ice30b)
Hata Düzeltmeleri
- Uçtan uca özelliği etkinleştirildiğinde
Snackbar
veFloatingActionButton
simgelerinin yanlış konumlandırılmasına neden olan sorun düzeltildi. İskele artık bu bileşenlere yatay iç boşlukları doğru şekilde uyguluyor. (Ib7c30, b/244400727) BottomSheet
hareketini tamamen genişletilmişten kısmen genişletilmişe düzeltin.BottomSheet
artık gizleme veya daraltma sırasındaMotionScheme
'nin hızlı efektini, genişletme sırasında ise varsayılan uzamsal efekti kullanıyor. (Ifa46f, b/416063171)ColorScheme
oluşturucusu, yüzey kapsayıcı rolleri olmadan gizli olarak işaretlendi ve artık kullanılması önerilmiyor. (Ia7237)- Daha fazla esneklik sağlamak için, daha önce istisna oluşturan bir
CircularWavyProgressIndicator
Size.minDimension > 0
koşulu kaldırıldı. (Ic9418, b/377531195) Text(AnnotatedString)
içindeki köprüler artık varsayılan olarak Material stiline sahip. (I78288, b/339843816)RoundedPolygon
içindekitoShape()
işlevinin bir yolu önbelleğe alıp farklı boyutlarda birden fazlacreateOutline
çağrısı yapıldığında soruna neden olması sorunu düzeltildi. (I4026d)
Sürüm 1.4.0-alpha14
7 Mayıs 2025
androidx.compose.material3:material3-*:1.4.0-alpha14
iptal edilir. 1.4.0-alpha14 sürümü bu commit'leri içerir.
API Değişiklikleri
AppBarRow
ile aynı şekilde çalışan ancak sütun halinde düzenlenmiş içerikler için yeni birAppBarColumn
composable'ı eklendi. (Iaf6bd)AppBarRow
öğesine maksimum öğe sayısı eklendi. Bu, üst uygulama çubukları için malzeme spesifikasyonunu doğru şekilde uygulamak amacıyla gereklidir. (I92ce4)TooltipScope
içinde, bağlantınınlayoutCoordinates
değerini elde etmek için bir yöntem eklendi. Geliştiriciler,drawCaret
yöntemini kullanarak bağlantı sınırlarını elde edebileceğindenlayoutCoordinates
ve şapka işareti içeren uygun bir şekil oluşturabileceğinden bu yeni yöntem kullanıma sunulmuştur. (Ia2e12, b/329470609)java.time
Tarih seçiciler için destek eklendi: java.time nesnelerini (ör. initialLocalDate
,YearMonth
) kabul edenrememberDatePickerState/rememberDateRangePickerState
aşırı yüklemeleri kullanıma sunuldu. Ayrıca,LocalDate
veYearMonth
gibi türleri kullanarak değerleri almak/ayarlamak için durum nesnelerine uzantı işlevleri eklendi. API 26 veya sonraki bir sürüm ya da desugaring gerektirir. (I70f29, b/266202516, b/281859606)- Ortadan başlayan bir parça ile kaydırma çubuğu kullanmaya olanak tanıyan
CenteredTrack
composable'ı eklendi. (I5b1d6)
Hata Düzeltmeleri
- Dalgalı ilerleme göstergelerinin performansı iyileştirildi: Doğrusal türler artık% 11 daha az tahsisle% 8, 5 daha hızlı yükleniyor.Dairesel türlerde ise% 39 daha az tahsisle% 47'lik önemli bir hız artışı görülüyor. (I595d8)
Sürüm 1.4.0-alpha13
23 Nisan 2025
androidx.compose.material3:material3-*:1.4.0-alpha13
iptal edilir. 1.4.0-alpha13 sürümü bu commit'leri içerir.
API Değişiklikleri
isAppearanceLightStatusBars
veisAppearanceLightNavigationBars
,ModalBottomSheetProperties
'a yalnızca Android parametreleri olarak yeniden eklendi. (Id4bc0)- Sınırlarının dışına sığacak öğelerin taşmasını işleyen bir
AppBarRow
composable ekleyin. (I742bd) - Tarih girişi moduna geçildiğinde odaklanma isteğinde bulunmak için
DatePicker
veDateRangePicker
API'sini güncelleyin.requestFocus
boolean parametresini,FocusRequester
alan isteğe bağlıfocusRequester
parametresiyle değiştirdik. (I14b69) - Değiştiriciyi ve etkileşim kaynağını varsayılan tıklanabilir ve açılıp kapatılabilir öğelerden kaldırın. Bunun yerine uygulama ayrıntısı olarak kullanın. (I95ed6)
- Ekrana sığmayacak kadar çok düğme olduğunda
ButtonGroup
simgesi açılır menüye taşacak şekilde güncellendi. (I7b88b)
Hata Düzeltmeleri
- Alt sayfa, geçerli ofsetten daha küçük olduğunda artık üst ekleri kullanıyor. Bu, kullanıcıların genişletilmiş davranış için üst ekler sağlamasına olanak tanır.
BottomSheetDefaults.windowInsets
artıkWindowInsets.safeDrawing.Top
içeriyor. (I0ab67, b/321877275, b/336962418, b/342093067) - Çipteki ön simgeler/avatarlar ve son simgeler eklendiğinde veya kaldırıldığında giriş/çıkış animasyonları (solma/kaydırma) etkinleştirildi. Bu özellikten öncelikle seçilebilir çiplere (filtre, giriş) yararlanılır ancak genel olarak da geçerlidir. (I9af21)
LookaheadScope
nedeniyle oluşan bozuk RTL kaydırma çubuğu davranışını düzeltir. (Ieb152, b/408118041)- Gizli sistem kullanıcı arayüzüyle kaydırma işlemine bağlı olarak ortaya çıkan Bottom
AppBar
kilitlenmesini düzeltir. (Ic6140, b/405996228)
Sürüm 1.4.0-alpha12
9 Nisan 2025
androidx.compose.material3:material3-*:1.4.0-alpha12
iptal edilir. 1.4.0-alpha12 sürümü bu commit'leri içerir.
API Değişiklikleri
ModalBottomSheetProperties
(Iab97f, b/362539765) öğesinden Android'e özgü parametreler kaldırıldı.- Sürükleme tutma kolu boyutu varsayılanları için aşırı yükleme işlevleri kullanıma sunuldu (I0ed0d)
- Yeni düzen türlerini desteklemek ve isteğe bağlı bir birincil işlem içeriği için destek eklemek üzere yeni
NavigationSuiteScaffold
veNavigationSuiteScaffoldLayout
işlevleri ekleyin. (Ib262a, b/353144478) ButtonGroup
uygulamasındaModifier.weight
ile doldurma parametresinin desteğini sonlandırın. Dolgu içermeyen bir sürüm ekleme (Id32bb)xSmall-
vexLarge-
IconButton bileşen varsayılanlarınıextra
olarak yeniden adlandırın. (Ib6e0f)- Yeni düzen türlerini desteklemek için yeni
NavigationSuite
,NavigationSuiteItem
veNavigationSuiteColors
işlevleri ekleyin. (I203d6) - Yeni
NavigationSuiteTypes
ve bu düzen seçeneklerini içeren yeninavigationSuiteType
işlevi ekleyin (If68f9)
Hata Düzeltmeleri
ColorScheme.contentColorFor
artıksurfaceDim
ileonSurface
'yi eşliyor. (I8891a)- Giriş alanının programatik olarak ayarlanan tarihi yansıtmaması sorununu gidermek için
DateInputTextField
uygulaması güncellendi. (I6c8d1, b/401143451) - Gezinme çubuğu ve geniş gezinme çubuğu için TalkBack odak sırası düzeltildi (I6cf6f, b/407048224).
Sürüm 1.4.0-alpha11
26 Mart 2025
androidx.compose.material3:material3-*:1.4.0-alpha11
iptal edilir. 1.4.0-alpha11 sürümü bu commit'leri içerir.
API Değişiklikleri
- Düğme ve açma/kapatma düğmesi için varsayılan nesnelerdeki birleştirilebilir özelliklerin büyük harf kullanımını güncelleyin. Kapsayıcı yüksekliğine bağlı olarak önerilen içerik dolgusu, şekiller, simge boyutu, simge aralığı ve metin stili için
ToggleButtonDefaults
veButtonDefaults
yöntemlerini ekleyin. (Iea69e) - Kullanımdan kaldırılan deneysel işlevler ve sabitler
FloatingToolbar
'dan kaldırıldı. (I8f339) - Yükseklik bileşenleri artık ortak bir arayüzü paylaşıyor ve herkese açık oluşturuculara ve özelliklere sahip. (Ibb172)
animateWidth
değiştiricisiniButtonGroupScope
içine ekleyin. Bu değiştirici, alt öğeleri doğru şekilde animasyonlandırmak için düğme grubunun alt öğeleriyle birlikte kullanılmalıdır. (Ia3bb6)
Hata Düzeltmeleri
- Daraltma sırasında görsel dengeyi sağlamak için kayan araç çubuğu dolgusu düzeltildi ve daha büyük içeriklerde esneklik artırıldı. (I06c00)
Sürüm 1.4.0-alpha10
12 Mart 2025
androidx.compose.material3:material3-*:1.4.0-alpha10
iptal edilir. 1.4.0-alpha10 sürümü bu commit'leri içerir.
API Değişiklikleri
TabRowDefaults.tabIndicatorOffset
desteği sonlandırıldı ve yerineTabIndicatorScope.tabIndicatorOffset
getirildi. (Ib36b3)- Düğme varsayılanlarında küçük içerik dolgusu için yazım hatası düzeltildi. (I19bfe)
TabRow
veScrollableTabRow
, her birinin birincil ve ikincil varyantları lehine kullanımdan kaldırıldı. Birincil ve İkincil sekme satırları daha iyi performans gösteriyor ve spesifikasyona daha uygun. (I918e2)rememberSliderState
verememberRangeSliderState
eklendi. (I8e384)- Otomatik tutturma mekanizmasını kontrol etmek için
shouldAutoSnap
simgesiSliderState
simgesine eklendi. Bu mekanizmayı devre dışı bırakmak özel animasyonlar için faydalı olabilir. (I07745) - Kaydırılabilir sekme satırının minimum sekme genişliği artık bir parametre. Birincil ve İkincil sekme satırı varyantları artık deneysel değildir. (If6f15, b/226665301)
- Sınıfı
ExitAlwaysFloatingToolbarScrollBehavior
herkese açık hale getirdiğinizde kompozisyon olmadan oluşturma işlemine izin verilir. (Ibf31c)
Sürüm 1.4.0-alpha09
26 Şubat 2025
androidx.compose.material3:material3-*:1.4.0-alpha09
iptal edilir. 1.4.0-alpha09 sürümü bu commit'leri içerir.
API Değişiklikleri
- Varsayılan durumdaki
DragHandle
ayar alanlarını yeniden adlandırın, basılı ve sürüklenen durumları ayırın, varsayılan boyutları herkese açık hale getirin. (I787b9) TowRowsTopAppBar
API'sinde yapılan güncellemeler.expanded
lambda parametresi kaldırıldı ve genişletilmiş ve daraltılmış yükseklikler için ayrı parametreler eklendi. (Idd677, b/306697446, b/229134133, b/268068946)
Hata Düzeltmeleri
- Alt uygulama çubukları artık dokunarak keşfetme hizmetini (ör.
TalkBack
) ve hizmet açıkken bunları görünür tutun. (I4b34d)
Sürüm 1.4.0-alpha08
12 Şubat 2025
androidx.compose.material3:material3-*:1.4.0-alpha08
iptal edilir. 1.4.0-alpha08 sürümü şu commit'leri içerir.
Yeni Özellikler
TimePickerDialog
,TimePicker
veyaTimeInput
için ya da değiştirilebilir bir sürüm için kullanılabilecek birTimePickerDialog
API'si eklendi. (Id2d83)Yeni arama çubuğu API'leri:
- Daraltılmış arama çubukları ve genişletilmiş arama "görünümleri" artık ayrı composable'lardır.
SearchBar
, daraltılmış durumdaki bir arama çubuğunu ifade eder.ExpandedFullScreenSearchBar
veExpandedDockedSearchBar
, genişletilmiş durumdaki arama çubuğunu gösterir. Bunlar yeni pencerede açılır.- Arama çubuğunun durumunu kontrol etmek için
SearchBarState
TopSearchBar
ile yerleştirme işleme ve kaydırma davranışı eklemeSearchBarState
kullananInputField
için yeni aşırı yükleme (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)
API Değişiklikleri
- Basıldığında simge düğmelerinin köşe şeklinin değişmesini destekler. (I21843)
- Metin alanı süsleyici/süsleme kutusu API'leri artık deneysel değildir. (I31d95)
ButtonGroup
için bağlı varyantla ilgili örnekler ve varsayılanlar eklendi. (I5c8ce)- Durum parametresini
NavigationSuiteScaffold
veNavigationSuiteScaffoldLayout
içinde son parametre yapın. (I9cc7b)
Hata Düzeltmeleri
FloatingToolbars
uygulamasına özel erişilebilirlik işlemleri eklendi. Böylece, erişilebilirlik hizmetleri artık tümFloatingToolbar
varyasyonlarını genişletebilir veya daraltabilir. FAB'li sürüm bunu FAB'a, FAB'siz sürüm ise ana içeriğe uygular. (I26420)FloatingToolbars
artık dokunarak keşfetme hizmetini (ör. TalkBack) ve hizmet açıkken araç çubuğunu her zaman genişletilmiş ve görünür durumda tutar. (I02172)Float.NaN
ilerleme olarak iletildiğinde ilerleme ve yükleme göstergelerinde yaşanan kilitlenme sorunu düzeltildi. (I4fa96, b/352364576)
Sürüm 1.4.0-alpha07
29 Ocak 2025
androidx.compose.material3:material3-*:1.4.0-alpha07
iptal edilir. 1.4.0-alpha07 sürümü bu commit'leri içerir.
Yeni Özellikler
- Yeni bir API ile onay kutularının görünümünü özelleştirme konusunda daha fazla esneklik sağlandı. Bu API, onay işareti ve onay kutusu ana hattının nasıl oluşturulacağı üzerinde daha fazla kontrol sağlayan Stroke parametreleri sunar. (I65a88)
- İki satırlık üst uygulama çubukları oluşturmak için Medium ve Large uygulama çubuklarına kıyasla daha fazla özelleştirme seçeneği sunan
TwoRowsTopAppBar
API'si eklendi. Geliştiriciler artık hem daraltılmış hem de genişletilmiş durumlarda başlıkların ve altyazıların içeriğini kontrol edebilir. Ayrıca her durum için özelleştirilebilir yükseklikler belirleyebilir. (I0be3c, b/306697446, b/229134133, b/268068946)
API Değişiklikleri
- Deneysel
BottomAppBar
varyasyonunuFlexibleBottomAppBar
olarak yeniden adlandırarak içerik düzenlemesi ve yüksekliği üzerinde daha fazla kontrol sağlandı. (Iaa448) - Button Group varsayılan nesnesindeki özelliklerin adını
CapitalCase
olarak güncelleyin.animateFraction
adını, temsil ettiği davranışa daha uygun olacak şekilde güncelleyin. (I545cd) - Basma etkileşiminde animasyonlu şekillere izin veren yaygın düğmeler için aşırı yüklemeler ekleme. Önbelleğe alınmış düğme şekilleri eklendi. (I5ec20)
- Artık
FloatingToolbarScrollBehavior
sağlayarak FAB içeren birFloatingToolbar
öğesinin kaydırmaya nasıl tepki vereceğini kontrol edebilirsiniz. Orta kenar boyunca (ör. üst veya alt orta) konumlandırılmış araç çubukları için, daha temiz bir görünüm elde etmek amacıyla kaydırma sırasında bileşenin tamamını gizlemek üzere kaydırma davranışı kullanmanızı öneririz. Bu, daraltma içinexpanded
işaretini kullanırken olabilecek bir durum olan KDH'nin merkezden uzaklaşmasını da önler. (I33f67) - Başlık ve alt başlığın hizalaması ayarlanırken özel
TopAppBarTitleAlignment
yerineAlignment.Horizontal
kullanılacak şekilde deneyselTopAppBar
API'leri günceller. (I70ca2) SliderState#onValueChange
, kullanıcılara daha fazla kontrol sağlamak için herkese açık hale getirildi (I104eb)- Gezinme bileşeninin animasyonuna izin vermek için
NavigationSuiteScaffoldState
öğesini kullanıma sunduk. Ayrıca, durum parametresi olanNavigationSuiteScaffold
veNavigationSuiteScaffoldLayout
aşırı yüklemelerini de kullanıma sunun. (I6a8c9, b/328674235)
Hata Düzeltmeleri
IconButtonColors
veIconToggleButtonColors
sınıflarınıIconButtonDefaults.kt
'danIconButton.kt
'a geri taşıyın. (I3c233)
Harici Katkı (External Contribution)
SliderState#isDragging
artık herkese açık. (I8458a)
Sürüm 1.4.0-alpha06
15 Ocak 2025
androidx.compose.material3:material3-*:1.4.0-alpha06
iptal edilir. 1.4.0-alpha06 sürümü bu commit'leri içerir.
Davranış Değişikliği
- İçeriklerin ekran kesimiyle çakışmasını önlemek için, Material bileşenlerinin varsayılan olarak dikkate aldığı iç kısımlar grubuna
displayCutout
eklendi. Bu, yerleştirme alanına duyarlı bileşenlerin ekran kesimi etrafındaki davranışını etkileyecek bir davranış değişikliğidir. Buna, yerleştirme alanına duyarlı Material 3 bileşenleri içinWindowInsets
parametresinin varsayılan değeri ve hem Material 2 hem de Material 3 için bileşen Defaults nesnelerinde sağlananWindowInsets
değerleri dahildir. Bu değişiklik istenmeyen davranışlara neden olursaWindowInsets
parametresini bileşen bazında manuel olarak belirtin. (I43ee9, b/362508045)
API Değişiklikleri
TopAppBar
API'sinde yapılan güncellemeler. Orta ve büyük boyutlu üst uygulama çubuklarını,*FlexibleTopAppBar
altyazısıyla yeniden adlandırın. Renk varyasyonları tek birTopAppBarDefault.topAppBarColors()
işlevinde birleştirildi ve sağlanan altyazı Composable'a uygulanacak birsubtitle
renk parametresi eklendi (I41b65).WideNavigationRailArrangement
API'yi kaldırıpArrangement.Vertical
API'yi kullanma (Id0341)- Yeni bir
VerticalSlider @Composable
ekleyin. (I2bfba) - Özel harici pist köşeleri ve pist simgeleri belirtmeye olanak tanıyan yeni bir pist
@Composable
eklendi. (I436a4) - Kaydırma çubuğu API'lerini, tek bir kapsayıcı rengi yerine
FloatingToolbarColors
nesnesini kullanacak şekilde güncelleyin. (I9a054) - Yeni deneysel ek açıklamayı ekleme ve kullanma
ExperimentalMaterial3ComponentOverrideApi
(Ia1eaf) Modifier.indicatorLine
artık kırpmayı işlemek için metin alanının şeklini alıyor. (I8c5f3, b/380704151)- Deneysel
FloatingAppBar
işlevleriniFloatingToolbar
(I1dbf8) olarak yeniden adlandırın. - Kaydırılabilir bir kapsayıcıya eklenerek kaydırma hareketine dayalı olarak kayan araç çubuğunun genişleme durumunu güncelleyebilen yeni bir
floatingToolbarVerticalNestedScroll
eklendi. (I6d65f) - Ekli kayan işlem düğmesi (KİD) içeren kayan araç çubuğu oluşturmaya yönelik yeni bir API kullanıma sunuldu. API, esnek özelleştirme seçenekleri sunar. Bu sayede araç çubuğunu yatay veya dikey olarak düzenleyebilir ve FAB'ı araç çubuğunun başına ya da sonuna yerleştirebilirsiniz. (I9e350)
Hata Düzeltmeleri
TalkBack
açıkken kapatıldığında kendisini duyurmasına neden olan Snackbar erişilebilirlik sorunu düzeltildi. (/I9db53)
Harici Katkı (External Contribution)
- Temelde
BasicTooltip
, Material 3'te iseBasicTooltip/Tooltip
yaygınlaştırıldı. (Ifc2e6)
Sürüm 1.4.0-alpha05
12 Aralık 2024
androidx.compose.material3:material3-*:1.4.0-alpha05
iptal edilir. 1.4.0-alpha05 sürümü bu commit'leri içerir.
API Değişiklikleri
- Daha iyi okunabilirlik için bir enum'ın
WideNavigationRailState.current/target
değerindeki türü değiştirin (I2d6ab) SplitButton
İkili uyumluluk için Shape API'yi veri sınıfından sınıfa değiştirin. (I53812)- Üreticilerin, kullanıcı araç ipucunun dışını tıkladığında ne olacağına karar verebilmesi için
onDismissRequest
parametresine sahip bir araç ipucu API'si eklendi. Bu yeni parametreyi içermeyen eski API kullanımdan kaldırıldı. (I99aef) opticalCentering
adınıhorizontalCenterOptically
olarak değiştirin. Değiştiriciyi dahili hale getirme Dolgu parametresini maksimum başlangıç ve bitiş uzaklığıyla değiştirin. (I0b904)WideNavigationRailState
değerini mevcut/hedef değer olarak değiştirin, Boole değeri yerine numaralandırılmış değerleri kaldırın. (Idfa29, b/356039090)NavigationBarItemComponentOverride
ekleyin. (I3a06a)
Hata Düzeltmeleri
- İçerik tamamen kaydırıldığında rengin güvenilir bir şekilde değişmesi 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)
- Değiştirici parametresi artık sürükleme davranışı ve semantik gibi dahili değiştiricilerden önce değil, sonra uygulanıyor. Bu durum, değiştiricilerin uygulanma sırasını etkiler. (I8d83f)
- Genişletilmiş alt sayfa, boyut değişikliğinde genişletilmiş olarak kalır. (I2870b, b/324934884)
- Pencere özellikleriyle ilgili durum ve gezinme çubuğu işaretlerini doğru şekilde yönlendirin. (Ie674d, b/362539765)
- Değiştirici parametresini, belgelendiği gibi iskelelerin kök dizinine taşıyın. Bu, uygulamayı M2 ile uyumlu hale getirir. (I0235e, b/372311595)
Harici Katkı (External Contribution)
- Ortak
DatePickerDialog
işlevi. (I7dced)
Sürüm 1.4.0-alpha04
13 Kasım 2024
androidx.compose.material3:material3-*:1.4.0-alpha04
iptal edilir. 1.4.0-alpha04 sürümü bu commit'leri içerir.
Davranış Değişiklikleri
- aosp/3212478'de
iconButtonColors
,iconToggleButtonColors
,outlinedIconButtonColors
,outlinedIconToggleButtonColors
veoutlinedIconToggleButtonBorder
için yapılan renk değişikliklerini geri alın. Artık geri alınan davranışı, döndürülen yüksek kontrastlı renkleri vurgulamak içiniconButtonVibrantColors
ve benzeri adlar verilen yeni bir işlev grubuna taşıdık. (Iffd8d)
Yeni Özellikler
VerticalDragHandle
bileşenini tanıtma (I6c770)
API Değişiklikleri
DismissibleModalWideNavigationRailDefaults
öğesiniModalWideNavigationRailDefaults
olarak yeniden adlandırın. (I8e877)NavigationBarComponentOverrides
ekleyin. (I8a3f3)NavigationRailComponentOverride
ekleyin. (I83e13)WideNavigationRailState
öğesini kullanarak rayın daraltılıp genişletilmesini sağlayın,ModalWideNavigationRail
öğesinin kapatılmasına izin verin veDismissibleModalWideNavigationRail
öğesini silin. (I88568)- xSmall, medium, large ve xLarge boyut varsayılanlarını açma/kapatma düğmesi varsayılanlarına ekleyin. (Ie95d1)
- xSmall, medium, large ve xLarge boyut varsayılanlarını düğme varsayılanlarına ekleyin. (If8b6d)
Hata Düzeltmeleri
- Filtre çipi son simge rengi, spesifikasyona göre birincil renkten
OnSurfaceContainer
rengine güncellendi. Tüm çip dış çizgi renkleri, spesifikasyona göre dış çizgiden dış çizgi varyantına güncellendi. (I68bd4)
Sürüm 1.4.0-alpha03
30 Ekim 2024
androidx.compose.material3:material3-*:1.4.0-alpha03
iptal edilir. 1.4.0-alpha03 sürümü bu commit'leri içerir.
API Değişiklikleri
- Yoğunluk içeren
SheetState
oluşturucunun desteği, konum ve hız eşikleri lehine sonlandırıldı. (Ifd16e) - Güncellenmiş 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 bunlar, sistemin 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ı, anında metin girişi için odaklanacak. 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ı Shape nesnesine önbelleğe alma. Açma/kapatma düğmesi için şekil varsayılanlarını
@Composable
yapma. Varyantlar aynı jeton dosyasına işaret ettiğinden şekiller varsayılan olarak tek bir şekil halinde daraltılır. (Iaa014)
Hata Düzeltmeleri
contentPadding
değiştiğinde gövde içeriğinin her zaman yeniden oluşturulmasını önlemek için ScaffoldcontentPadding
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ş modunda doğrulama hatalarının bileşenin yüksekliğinin değişmesine neden olabildiği
DatePicker
ile ilgili sorun düzeltildi. (I2e229, b/280462363) - Kontrol tuşlarına basıldığında malzeme kaydırma çubuğunun değerini değiştirin. (I1c442)
Sürüm 1.4.0-alpha02
16 Ekim 2024
androidx.compose.material3:material3-*:1.4.0-alpha02
iptal edilir. 1.4.0-alpha02 sürümü bu commit'leri içerir.
API Değişiklikleri
DatePickerState
veyaDateRangePickerState
üzerinden doğrudan bir yerel ayar belirlenirkenDatePicker
veDateRangePicker
genelinde tutarlı yerel ayar kullanımı sağlamak için tarih seçicilerde güncellemeler yapıldı. Yerel ayarları doğrudan duruma ayarlarken başlık ve başlık metinlerinin buna göre yerelleştirildiğinden emin olmanız gerektiğini unutmayın. Bu metinlerin varsayılan metni, varsayılan platform yerel ayarına göre uygulanmaya devam eder. (I37073, b/326490763, b/321657276)SheetState.isAnimationRunning
artık kullanıma sunuluyor. (I9a3d7)DatePickerColors
artık temanın Tipografi metin stillerinde tanımlanan çakışan renklerden doğru şekilde öncelikli olacak. Bu güncellemenin, tarih seçici işlevlerindekicolor
parametresinin konumunu ayarladığını ve başlık ile başlık metni renklerini özelleştirmek içincontentColor
parametresini kullanıma sunduğunu da 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ı. Her iki işlev de artıkMotionScheme
yardımcı nesnesi üzerindenMotionScheme.standard()
veMotionScheme.expressive()
çağrılarıyla kullanılabilir. (Iceccf)- Düz ve zengin ipuçlarına
maxWidth
parametresi ekleniyor. Düz ipuçları için varsayılan tasarım spesifikasyonu 200 dp, zengin ipuçları için ise 320 dp'dir. (I30ce9)
Hata Düzeltmeleri
DatePicker
veDateRangePicker
, durumlarınındisplayedMonthMillis
aracılığıyla ayarlandığında artık görüntülenen ayı doğru şekilde güncelliyor. (If9e47, b/333414302)ModalBottomSheet
içeriği artık içeriği durum çubuğundan uzaklaştırıyor. (I5114c, b/321877275, b/336962418, b/342093067)- [Alt Sayfa] IME klavyesinin önce kapatılmasına izin vermek için geri arama önceliğini
PRIORITY_DEFAULT
olarak değiştirin. (I447fb) - Minimum seçilebilir yıl gelecekteki bir yıl olarak ayarlandığında
DatePicker
veDateRangePicker
bölümlerindeki 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çiciyle ilgili bir sorun 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
iptal edilir. 1.4.0-alpha01 sürümü şu commit'leri içerir.
Davranış Değişiklikleri
- Kitaplık artık
material-icons-core
öğesine bağımlılık eklemiyor. Bu nedenle, projeniz buna bağlıysa bu bağımlılığıbuild.gradle[.kts]
dosyalarınıza açıkça eklemeniz gerekir. (I735ff, b/349894318) - Kullanılabilirliği, renk kontrastını ve sistem içindeki tutarlılığı iyileştirmek için
NavigationBarItem
veNavigationRailItem
'nin etkin etiket rengionSurface
'densecondary
'e değiştirildi (Ibc297). Önceki davranışa geri dönmek için varsayılan renkleri kopyalayın veselectedTextColor
'yiMaterialTheme.colorScheme.onSurface
olarak değiştirin. - Material 3 bileşenleri artık hareketlerini tanımlamak için yeni
MotionScheme
kullanıyor. (Ie0f93) - Belirsiz dairesel ilerleme durumu göstergesi hareket değişiklikleri (I3c07e)
- Daha iyi renk kontrastı için
OutlinedIconButtonColors
veOutlinedIconToggleButtonColors
renklerini güncelleyin. (I2743d) FilledIconToggleButtonColors
veFilledTonalIconToggleButtonColors
için kapsayıcı ve içerik rengi güncellendi. (Ic5d0f)OutlinedButton
kenarlık rengioutline
olarak güncellendi.outlineVariant
(057f00)
API Değişiklikleri
reverseLayout
ile ayarlanan içeriği daha iyi desteklemek içinTopAppBar
'ninenterAlwaysScrollBehavior
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 MaterialTextField
veOutlinedTextField
için yeni aşırı yüklemeler 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, alan odaklanmamış olsa bile bir etiketin ve yer tutucunun aynı anda metin alanında gösterildiği kullanıcı arayüzü kalıbı kullanılabilir. (I1ef2c) - Şifre giriş alanları için
SecureTextField
veOutlinedSecureTextField
materyalleri eklendi. (I7e22d) - Animasyon ilerleme durumunu sorgulamak için metin alanı etiketlerine kapsam eklendi. (If5ec8)
- İpuçlarına
MotionEvent.CLASSIFICATION_DEEP_PRESS
desteği eklenir. (I62e6a) TimePickerState
'nınisAfternoon
değeri, arayüzde var yerine extension val olarak değiştirildi veisPm
olarak yeniden adlandırıldı (I89a97)- Vurgulanmış yazı ölçeklerini desteklemek için tipografi sınıfı güncellendi. (Ifa13c)
ModalWideNavigationRail
API'si eklendi veModalExpandedNavigationRail
API'lerinin adıDismissibleModalWideNavigationRail
olarak değiştirildi. (Ic9118)FloatingAppBarScrollBehavior
,screenOffset
değerini otomatik olarak hesaplayacak ve@Composable
gerektirmeyecek şekilde güncellendi. (Idf349)- Varsayılan nesnesindeki adlandırmayı düzeltmek için
LoadingIndicator
API'sinde güncellemeler yapıldı.PullToRefresh
konumunaLoadingIndicatorElevation
sabiti eklendi. (I1d72b) - Varsayılan nesnesindeki adlandırmayı düzeltmek için
LoadingIndicator
API'sinde güncellemeler yapıldı.PullToRefresh
konumunaLoadingIndicatorElevation
sabiti eklendi. (I1d72b) amplitude
vewaveSpeed
parametreleri,LinearWavyProgressIndicator
veCircularWavyProgressIndicator
'nin belirsiz varyasyonlarına eklendi. (I2a0c5)- Bir simge açma/kapatma düğmesinin şeklinin, basılı veya işaretli durumuna göre değiştirilmesini destekler. (Ibc781)
- Vurgulanmış yazı ölçeklerini desteklemek için tipografi sınıfı güncellendi. (Ifa13c)
SplitButton
şekli, varsayılan / basılı duruma göre değişir.TrailingButton
API aynı özelleştirmeleri sunabildiğindenAnimatedTrailingButton
API kaldırıldı (I95066)- İçerik kaydırıldığında FAB'ın gösterilip gizlenmesini animasyonla göstermek için değiştirici ekleyin. (I8338d)
- Bağlı düğme grubu şekilleri ve aralığı
ButtonGroupDefaults
simgesine eklenerek örnekte kullanılacak. (I68e30) - Bölünmüş düğme, sondaki düğme için yatay dolgu ekler ve başlangıç ile bitiş köşesi farklılıklarından hesaplanan optik ortalamayı etkinleştirir (I122e2).
- Bileşenin hareket şemasının ayarlanmasına olanak tanıyan yeni bir Material
MotionScheme
kullanıma sunuldu. Şema,MaterialTheme
üzerinden ayarlanır. (Id50c2)
Hata Düzeltmeleri
Scaffold
alt composable'larına doğru odak geçişi dizinini uygulayın. SıratopBar
,bottomBar
, fab, content, snackbar şeklindedir. (I5936b)- Belirli yerel ayarlarda ve biçim iskeletlerinde bazı tarih öğelerinin (ör. ay adları) büyük harfle başlamamasına neden olan
DatePicker
veDateRangePicker
ile ilgili sorun düzeltildi. (I1430f) - FAB ve FAB Menü bileşen jetonlarını entegre edin (dolgu ve metinlerde küçük görsel güncellemeler) (Ib57f3)
ModalBottomSheet
artık anlamsal geçiş sırasının başında yer alıyor ve ardından karartma geliyor. (I436f9, b/358594665)- Uçtan uca modda gezinme kapsülü altında kaydırırken alt uygulama çubuğunun tamamen kaybolmaması sorunu düzeltildi (I3ee21).
Compose Material3 1.3 sürümü
Sürüm 1.3.2
9 Nisan 2025
androidx.compose.material3:material3-*:1.3.2
iptal edilir. 1.3.2 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
ListItem
, doğal yükseklik hesaplamasını düzeltir ve artık Layout'ta uygun miktarda alan ayırır.NavigationBarItem
etiketinde fazla olan dolguyu kaldırarak spesifikasyonla doğru şekilde hizalama.- RTL modunda
TabRow
düzenini düzeltir.
Sürüm 1.3.1
30 Ekim 2024
androidx.compose.material3:material3-*:1.3.1
iptal edilir. 1.3.1 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
DatePicker
veDateRangePicker
, durumlarınındisplayedMonthMillis
aracılığıyla ayarlandığında artık görüntülenen ayı doğru şekilde güncelliyor. (If9e47, b/333414302)- Minimum seçilebilir yıl gelecekteki bir yıl olarak ayarlandığında
DatePicker
veDateRangePicker
bölümlerindeki 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çiciyle ilgili bir sorun düzeltildi. (Iad59a, b/290135807, b/339898760) - IME klavyesinin önce kapatılmasına izin vermek için alt sayfalar tarafından kullanılan geri arama önceliğini
PRIORITY_DEFAULT
olarak değiştirin. (I447fb)
Sürüm 1.3.0
4 Eylül 2024
androidx.compose.material3:material3-*:1.3.0
iptal edilir. 1.3.0 sürümü bu commit'leri içerir.
1.2.0 sürümünden beri yapılan önemli değişiklikler
1.3.0 sürümündeki önemli özellikler
Yeni Material Design 3 bileşenleri
- Bant
HorizontalMultiBrowseCarousel
veHorizontalUncontainedCarousel
Mevcut Material Design 3 bileşenlerinde iyileştirmeler.
- [
ModalBottomSheet
] artık U+'ta Tahmini Geri'yi destekliyor (Iccf32, b/281967264, b/304850357) - [
SearchBar
] artık U+ sürümünde tahmin edilen geri gitme özelliğini destekliyor (I657f8) - Gezinme çekmecesi (
ModalDrawerSheet
veDismissibleDrawerSheet
), U+'ta artık isteğe bağlı olarak tahmini geri gitme özelliğini destekliyor (Ie5b0b). DropdownMenu
artık özel renk, şekil, yükseklik ve kenarlığı destekliyor. (I8e981,b/289554448, b/301887035, b/283654243)- Kaydırma çubuğu, boşluk ve durdurma göstergesi eklenerek erişilebilirliği artıracak şekilde güncellendi. (I3058e)
- Boşluk ve durdurma göstergesi eklenerek erişilebilirliği artırmak için
ProgressIndicator
güncellendi. (I21451) - Zengin ipucu için varsayılan şapka işareti eklendi. Sabit nokta
LayoutCoordinates
verildiğinde özel şapka işaretinin çizilmesi desteklenir. (Ifd42c) Zarar Veren Değişiklikler - Yeni çekerek yenileme API'leri:
- Dp birimleri yerine kesirli değerler kullanmak için
PullToRefreshState
basitleştirildi. isRefreshing
durumu,PullToRefreshState
yerine kullanıcı tarafından kontrol edilir.- İç içe yerleştirilmiş kaydırma bağlantısı
PullToRefreshState
'dan ayrıldı. YeniPullToRefreshBox
veyaModifier.pullToRefresh
tarafından işlenir. - Bu güncelleme, önceki deneysel API'lerde uyumluluğu bozan bir değişikliktir. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Görselde Yapılan Önemli Değişiklikler
- Dp birimleri yerine kesirli değerler kullanmak için
- Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
'da yüzey ve arka plan rengi varsayılanlarında küçük düzenlemeler yapıldı. (I9db52)- Yeni Non-Text Contrast spesifikasyonlarına uygun olacak şekilde kaydırma çubuğu ve
ProgressIndicator
renkleri güncellendi. (I26807) - Bileşenler artık
SurfaceContainer
varyantlarını kullanıyor. RengiSurface
veTonalElevation
ile resmi olarak hesaplayan bileşenler artık varsayılan olarakSurfaceContainer
rollerini kullanıyor. Bu roller, tonal yükseltmeden etkilenmez. (b/304584161) - Yüzey ve yüzey kapsayıcı temel rolleri biraz ayarlanarak açık ve koyu temalarda daha fazla renk tonu sağlandı. (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
iptal edilir. 1.3.0-rc01 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
ModalBottomSheet
artık anlamsal geçiş sırasının başında yer alıyor ve ardından karartma geliyor. (I436f9, b/358594665)
Sürüm 1.3.0-beta05
24 Temmuz 2024
androidx.compose.material3:material3-*:1.3.0-beta05
iptal edilir. 1.3.0-beta05 sürümü bu commit'leri içerir.
- Android N ve O'da
BottomSheet
içeriğinin eksik olması veya kesilmesi sorunu düzeltildi (a10a2d). TalkBack
öğesinin, küçük resimlerin etrafındaki odak göstergelerini düzgün şekilde göstermesi için kaydırma çubuğunun semantik sınırları artırıldı. (0b5a1d)
Sürüm 1.3.0-beta04
26 Haziran 2024
androidx.compose.material3:material3-*:1.3.0-beta04
iptal edilir. 1.3.0-beta04 sürümü bu commit'leri içerir.
Sürüm 1.3.0-beta03
12 Haziran 2024
androidx.compose.material3:material3-*:1.3.0-beta03
iptal edilir. 1.3.0-beta03 sürümü bu commit'leri içerir.
Harici Katkı (External Contribution)
- Ortak kaynak kümesinden
androidx.compose.material3.DropdownMenu
kullanılabilir hale getirin. (If62c0)
Sürüm 1.3.0-beta02
29 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-beta02
iptal edilir. 1.3.0-beta02 sürümü bu commit'leri içerir.
API Değişiklikleri
Modifier.pullToRefreshIndicator
, yükseltmeyi destekler. Çekerek yenileme API'lerini, lambda yerine boolean olarak etkinleştirilecek şekilde güncelleyin.PullToRefreshBox
'da içerik hizalamasını destekleme (I75679)TooltipScope
öğesini kapalı bir arayüz haline getirme veTooltipBox
ile Label'da kullanılacak dahili bir uygulama oluşturma. (I3833e)CarouselItemScope
öğesine, bant öğelerine kolayca şekil ve kenarlık eklemek için iki yeni değiştirici (maskClip
vemaskBorder
) eklendi (Id67a1).TimePickerState
artık bir arayüz ve zamanın ayarlanmasına olanak tanıyor (I88546)- Bağlantıları stilize etmek için API güncellendi:
TextLinkStyles
,TextStyle
'ye taşındı veTextDefaults
, materyalden kaldırıldı. (I5477b)
Hata Düzeltmeleri
ModalBottomSheet
durum ve gezinme çubuğu simgeleri artık koyu tema durumuna yanıt veriyor. (Ie1fe7, b/338342149)ModalBottomSheet
scrim'e sayfayı kapatma semantiği eklendi. (0e61cb,b/328801864)
Harici Katkı (External Contribution)
androidx.compose.material3.AlertDialog
, ortak kaynak kümesinde (Ia33f5) kullanılabilirModalBottomSheet
, ortak kaynak grubundan (Id7cc7) kullanılabilir hale getirin.
Sürüm 1.3.0-beta01
14 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-beta01
iptal edilir. 1.3.0-beta01 sürümü bu commit'leri içerir.
API Değişiklikleri
CaretProperties
yerineDpSize
kullanılması.CaretProperties
kaldırılıyor.CaretScope
öğesiniTooltipScope
olarak yeniden adlandırın. (Id9a76)- Metinde Material temalı bağlantıları alma API'si güncellendi. Özellikle, temalı
LinkAnnotations
oluşturmak ve temalı bağlantılarla HTML ayrıştırmak içinTextDefaults
yöntemlerini kaldırdı. Bunun yerine, Text composable'ına parametre olarak bağlantıları stilize etmeye olanak tanıyan birTextLinkStyles
sınıfı eklendi. (I31b93)
Sürüm 1.3.0-alpha06
1 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
iptal edilir. 1.3.0-alpha06 sürümü bu commit'leri içerir.
Zarar Veren Değişiklikler
Yeni yenilemek için çekme API'leri:
- Dp birimleri yerine kesirli değerler kullanmak için
PullToRefreshState
basitleştirildi. isRefreshing
durumu,PullToRefreshState
yerine kullanıcı tarafından kontrol edilir.- İç içe yerleştirilmiş kaydırma bağlantısı
PullToRefreshState
'dan ayrıldı. YeniPullToRefreshBox
veyaModifier.pullToRefresh
tarafından işlenir. - Bu güncelleme, önceki deneysel API'lerde uyumluluğu bozan bir değişikliktir. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Dp birimleri yerine kesirli değerler kullanmak için
API Değişiklikleri
RippleConfiguration#isEnabled
kaldırıldı veLocalRippleConfiguration
boş değer atanabilir hale getirildi. Bir dalgalanmayı devre dışı bırakmak içinRippleConfiguration
ileisEnabled = false
yerinenull
ileLocalRippleConfiguration
'ü sağlayın. (I22725)- Uçtan uca özelliği etkinleştirildiğinde
ModalBottomSheet
, durum çubuğunun üzerine daha doğru bir şekilde karartma çizer. Modal alt sayfa içeriği artık pencere yerleşimlerini kullanabilir ve gezinme çubuğunun üzerinde görünür içeriklere izin verebilir. İç kısımların nereye uygulanacağını belirtmek içinModalBottomSheet
parametresiwindowInsets
,contentWindowInsets
olarak yeniden adlandırıldı. Bu parametreler artık pencere mantığına bağlı değil.contentWindowInsets
türü, yeni penceresinde çözümlenmesine olanak tanımak içinWindowInsets
döndüren bir işlev olarak değiştirildi. (I39630, b/274872542, b/300280229, b/290893168) PrimaryScrollableTabRow
veSecondaryScrollableTabRow
artık alt bileşen yerine özel düzen kullanıyor. Bu da performansı artıracaktır. (I991e0)- Metin bağlantıları, normal stilin yanı sıra fareyle üzerine gelindiğinde ve odaklandığında uygulanan stil seçeneğine de sahiptir.
TextDefaults
yöntemlerinin her birine bunu desteklemek için birpressedStyle
bağımsız değişkeni eklendi. (Ic473f, b/139312671)
Hata Düzeltmeleri
- Gezinme çekmecesi sürükleme tutamaçları artık
drawerContent
genişliğiyle eşleşiyor. (Ibc72f, b/245355396) - Etiket için
OutlinedTextField
üst dolgu artık sistem yazı tipi boyutunu dikkate alıyor. (Idc781) CalendarLocale
olan sabit paket konumu. (Ifa235)- [Tahmine dayalı geri gitme] Tahmine dayalı geri gitme animasyonlarını (0.1, 0.1, 0, 1) enterpolasyon eğrisini kullanacak şekilde güncelleyin (I2591a).
Sürüm 1.3.0-alpha05
17 Nisan 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
iptal edilir. 1.3.0-alpha05 sürümü bu commit'leri içerir.
Yeni Özellikler
SearchBar
veDockedSearchBar
, metin alanı parametresi alan yeni aşırı yüklemelere sahip. Bu sayede, metin alanı arama çubuğunun geri kalanından ayrı olarak stillendirilebilir ve özel metin alanları geçirilebilir. Mevcut uygulamanın metin alanıSearchBarDefaults.InputField
olarak kullanıma sunuldu. (I50c73, b/275074248, b/278773336, b/326627700)- Gerekirse işaretleri özelleştirmek için lambda
drawTick
, herkese açık API'ye eklendi (I0c048).
API Değişiklikleri
- Metin bağlantılarına normal stilin yanı sıra basılı durum stili seçeneği, fareyle üzerine gelme ve odaklanma stilleri eklendi (I5f864, b/139312671)
- Öğenin kırpıldığı maske dikdörtgenini göstermek için
CarouselItemInfo
güncellendi (I785d8) BasicTooltipState
, Material 3 genel API'sinden kaldırıldı. İşlevselliği, Foundation'ınTooltipState
kararlılığı sağlanana kadarBasicTooltip
ile birleştirilir. (Icda29)- Bağlantılara
MaterialTheme
uygulayanLinkAnnotation
oluşturma ve HTML etiketli dizeyi ayrıştırma yöntemlerini içeren birTextDefaults
nesnesi eklendi (I98532, b/139312671). ExposedDropdownMenuBoxScope
artık alt sınıflara izin vermiyor. Gösterilen açılır menülerde artıkMenuAnchorType
var. Bu, daha iyi erişilebilirlik içinmenuAnchor
'ye iletilmelidir. Bu yöntem, artık desteği sonlandırılanfocusable
değeriniExposedDropdownMenu
işlevine iletmek yerine kullanılmalıdır.menuAnchor
,enabled
durumunu kontrol etmek için yeni bir parametreye sahip. (I55ee6, b/257209915, b/308840226)- Devre dışı bırakıldığında
OutlinedButton
öğesinin kenarlık rengi düzeltildi. Etkin durumu alanButtonDefaults.outlinedButtonBorder("enabled")
aşırı yüklemesi eklendi. (Ie650b, b/318461363) - Müşterilerin ürün 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
oluşturucusunun desteği artık sonlandırılmıştır. Lütfen yüzey kapsayıcılarını içeren oluşturucuya geçin. (I35c11) - [Outlined]
TextFieldDefaults
ContainerBox
,Container
olarak yeniden adlandırıldı. (Ie8d3b)
Hata Düzeltmeleri
sheetSwipeEnabled
yanlışsaBottomSheetScaffold
artık iç içe kaydırmadan kaydırılmaz. (I5e1c1, b/306464779)IconButtonSamples.kt
içinde bazıExperimentalMaterial3Api
OptIn 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
iptal edilir. 1.3.0-alpha04 sürümü bu onayları içerir.
Yeni Özellikler
- Material3 Carousel'in iki deneysel sürümü (
HorizontalMultiBrowseCarousel
veHorizontalUncontainedCarousel
) eklendi (I88d64). - Compose M3 Nav Drawer (
ModalDrawerSheet
veDismissibleDrawerSheet
), U+'da isteğe bağlı olarak Tahmini Geri'yi destekleyecek şekilde güncellendi (Ie5b0b). - Yeniden oluşturmayı önlemek için renk tonunun lambda olarak iletilmesine olanak tanıyan yeni bir API, Icon'a eklendi. (I5b5a2)
- Üst uygulama çubuğu API'leri artık hem sabit hem de daraltılabilir bölümler için özel yükseklikleri destekliyor. (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 destekliyor. İçerik kaydırılırken tek satırlık üst uygulama çubuklarının çok fazla kez yeniden oluşturulmasına neden olan sorun düzeltildi.
MediumTopAppBar
simgesinin, büyük yazı tipi/ekran ayarları olan cihazlarda başlıkları kısaltması sorunu düzeltildi. (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şaretleniyor. (I5f000)- Kullanımdan kaldırılan
DismissDirection
veDismissValue
numaralandırmaları ve API'leri kaldırıldı. (I89ccd) - Bantın
CarouselState
yardımcı nesnesine deneysel bir etiket eklendi. (I94154) LocalMinimumInteractiveComponentEnforcement
desteği sonlandırıldı ve yerineLocalMinimumInteractiveComponentSize
kullanıma sunuldu. (I7a7ac)SearchBarColors
oluşturucu artık herkese açık. (I769ca)SwipeToDismissBox
listesinegesturesEnabled
parametresi eklendi. (Idc59f, b/324170119)- Desteği sonlandırılan 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
iptal edilir. 1.3.0-alpha03 sürümü bu commit'leri 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
'da yüzey ve arka plan rengi varsayılanlarında küçük düzenlemeler yapıldı. (I9db52)
Yeni Özellikler
ExposedDropdownMenu
özelleştirmek için parametreler eklendi. Özellikle menülerde artıkfocusable
parametresi (varsayılantrue
) bulunuyor. Bu parametre, düzenlenebilir metin alanlarıyla çalışırkenfalse
olarak ayarlanmalıdır. (I4184c, b/323694447, b/278609042)
API Değişiklikleri
ScaffoldSubcomposeInMeasureFix
işareti kaldırıldı. (Ie2a4b)NavigationRailItemColors
artık@Immutable
olarak işaretleniyor. (If6112, b/327660613)NavigationBarItemColors
artık@Immutable
olarak işaretleniyor. (I42a30, b/298064514)- Slider Track composable'da parametreleri yeniden sıralayın. (I9f315)
ExposedDropdownMenu
artıkPopup
kullanılarak uygulanıyor. Klavye ile yazarken düzenlenebilir metin alanları içeren odaklanılabilir menülerin kapatılması dışında davranış aynı olmalıdır.
Hata Düzeltmeleri
- Yüzey ve yüzey kapsayıcı temel rolleri biraz ayarlanarak açık ve koyu temalarda daha fazla renk tonu sağlandı. (I677a5)
- Yeni Non-Text Contrast spesifikasyonlarına uygun olacak şekilde kaydırma çubuğu ve
ProgressIndicator
renkleri güncellendi. (I26807) - Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
'da yüzey ve arka plan rengi varsayılanlarında küçük düzenlemeler yapıldı. (I9db52)
Sürüm 1.3.0-alpha02
6 Mart 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
iptal edilir. 1.3.0-alpha02 sürümü bu commit'leri içerir.
API Değişiklikleri
- Kaydırma çubuğu durumlarını tekrar kararlı hale getirme.
State.onValueChangeFinished
öğesini tekrar val yapma.onValueChangeFinished
,rememberUpdatedState
içinde sarmalanıyor. (I82ab2, b/322269951) - Gezinme bileşenleri artık yeni
SurfaceContainer
rollerini kullanıyor.DrawerDefaults
artık ayrıstandardContainerColor
vemodalContainerColor
özellikleri sunuyor.DrawerDefaults.ModalDrawerElevation
artık0.dp
. (I7fbac) state.onValueChangeFinished
olan durumuvar
olarak değiştirdiğimiz için@Stable
,Slider
eyaletlerinin durumlarından kaldırılıyor. (Ied34a, b/322269951)ModalBottomSheet
veStandardBottomSheet
animasyon spesifikasyonu artıkTweenSpec
olup yay animasyonundan güncellenmiştir. Bu, görünür aşma sorununu çözer. Yoğunluk içermeyen, desteği sonlandırılmışSheetState
oluşturucular kaldırıldı. (I7babc, b/285847707)
Hata Düzeltmeleri
- Bileşenler artık
SurfaceContainer
varyantlarını kullanıyor. Resmi olarak rengi Surface veTonalElevation
ile hesaplayan bileşenler artık varsayılan olarakSurfaceContainer
rollerini kullanıyor. Bu roller, tonal yükseltmeden etkilenmez. (b/304584161) ElevatedFilterChip
'nın seçilmemiş, devre dışı bırakılmış kapsayıcı renginin siyah olmasına neden olan hata düzeltildi. (I400e6, b/322407043)- İlerleme durumu 0 olduğunda belirsiz ilerleme durumu göstergesini düzeltme (Id6582)
- Sağdan sola düzeninde
Slider
veRangeSlider
ile ilgili sorun düzeltildi (Iab0e1). - Kayan nokta yuvarlama işlemi yanlış olabileceğinden kaydırma çubuğu aralığı hesaplamasına
SliderRangeTolerance
ekleniyor. (Ic918a, b/324934900) DatePickerDialog
,DateRangePicker
öğesi yerleştirilirken veya daha büyük yazı tiplerine sahip küçük ekranlarda herhangi bir tarih seçici görüntülenirken düğmelerini gösterdiğinden emin olun. (Ie4758, b/325107799, b/277768544)Menu
artık kapsayıcı rengi içinSurfaceContainer
rolünü kullanıyor.MenuDefaults.TonalElevation
artık0.dp
. (I135b7)TextField
artık kapsayıcı rengi içinSurfaceContainerHighest
rolünü kullanıyor. (I4dced)- Yükseltilmiş çiplere artık
SurfaceContainerLow
rolü (I7cd2f) atanıyor. DatePicker
kapsayıcı rengi artıkSurfaceContainerHigh
.DatePickerDefaults.TonalElevation
artık0.dp
. (Ida753)- Alt sayfalar kapsayıcısının rengini ve sürükleme tutma yerinin rengini günceller. (I72a0a)
RichTooltip
kapsayıcı rengi artıkSurfaceContainer
. (Ia8b45)SearchBar
kapsayıcı rengi artıkSurfaceContainerHighest
.SearchBarDefaults.TonalElevation
artık0.dp
. (I88604)- Güncellemeler,
SurfaceContainerHighest
renk rolünden yararlanmak için devre dışı bırakılan ve seçimi kaldırılan parçaları/simgeleri devre dışı bırakır. (I7687a) AlertDialog
kapsayıcı rengi artıkSurfaceContainerHigh
. (Ie0433)BottomAppBar
kapsayıcı rengi artıkSurfaceContainer
.TopAppBar
onScroll
rengi artıkSurfaceContainer
. (I41630)ElevatedCard
kapsayıcı rengi artıkSurfaceContainerLow
.FilledCard
adlı kullanıcınınSurfaceContainerHighest
kapsayıcı rengi. (I35141)ElevatedButton
kapsayıcı rengi artıkSurfaceContainerLow
. SeçilmediğindeFilledIconButton
öğeleri artıkSurfaceContainerHighest
kapsayıcı rengine sahip. (I792c9)TimePicker
kapsayıcı rengi ve saat kadranı rengi rolüSurfaceContainerHighest
olarak güncellendi. (I43b93)
Sürüm 1.3.0-alpha01
21 Şubat 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
iptal edilir. 1.3.0-alpha01 sürümü şu commit'leri içerir.
Yeni Özellikler
- Update Compose M3
ModalBottomSheet
to support Predictive Back on U+ (Iccf32, b/281967264, b/304850357) - U+'ta Tahmin Edilen Geri Gitme özelliğini desteklemek için Compose M3
SearchBar
güncellendi (I657f8) - Kaydırma çubuğu, boşluk ve durdurma göstergesi eklenerek erişilebilirliği artıracak şekilde güncellendi. (I3058e)
- Boşluk ve durdurma göstergesi eklenerek erişilebilirliği artırmak için
ProgressIndicator
güncellendi. (I21451) - Zengin ipucu için varsayılan şapka işareti ekleme: Yeni zengin ipucu API'si artık
LayoutCoordinates
sabitleme noktası verildiğinde özel şapka işareti çizilmesine olanak tanıyor. (Ifd42c)
Davranış Değişiklikleri
- Material bileşenleri, yeni dalgalanma API'lerini kullanacak şekilde taşındı ve artık
RippleTheme
sorgulamıyor.
API Değişiklikleri
- Eğlenceli
drawStopIndicator
artık herkese açık. (I3f59f) DatePicker
'nınformatWithSkeleton
işlevini dahili olarak işaretleyin (Ic65dc)DropdownMenu
artık özel renk, şekil, yükseklik ve kenarlığı destekliyor. (I8e981, b/289554448, b/301887035, b/283654243)- API'lerinde
MutableInteractionSource
gösteren Material3 bileşenleri, artık varsayılan olaraknull
değerini alan, boş değer atanabilir birMutableInteractionSource
gösterecek şekilde güncellendi. Burada anlamsal bir değişiklik yoktur: null iletmek,MutableInteractionSource
öğesini yükseltmek istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Değeri null olarak değiştirmek, bazı bileşenlerin hiçbir zamanMutableInteractionSource
ayırmamasına ve diğer bileşenlerin yalnızca ihtiyaç duyduklarında geç oluşturmasına olanak tanır. Bu da bu bileşenlerde performansı artırır. Bu bileşenlere ilettiğinizMutableInteractionSource
değerini kullanmıyorsanız bunun yerine null iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I41abb, b/298048146) - Sabit değerler kullanılarak dalgalanmaların bileşen başına / alt ağaç başına özelleştirilmesine olanak tanımak için
RippleConfiguration
veLocalRippleConfiguration
eklenir. Ö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ış kapısıdır. Daha kapsamlı değişiklikler ve özel tasarım sistemleri için bunun yerinecreateRippleModifierNode
kullanarak kendi dalgalanmanızı oluşturmanız gerekir. (I7b5d6, b/298048146) - Desteği sonlandırılan
rememberRipple
yerine material3'te yeni bir dalgalanma API'si ekler. Ayrıca, Material 3 bileşenlerini desteği sonlandırılanrememberRipple
/RippleTheme
API'lerini kullanmaya geri döndürmek için geçici birCompositionLocal
,LocalUseFallbackRippleImplementation
ekler. Bu özellik, bir sonraki kararlı sürümde kaldırılacak ve yalnızca özel birRippleTheme
sağladığınız durumlarda geçici bir taşıma yardımı olarak kullanılacaktır. (I34cbc, b/298048146)
Hata Düzeltmeleri
- Performansı artırmak için
ModalBottomSheet
içindeki alt bileşen kaldırıldı.ModalBottomSheet
'nınLookaheadScope
ile birlikte kullanıldığı belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (I2a198) - Performansı artırmak için
BottomSheetScaffold
içindeki alt bileşen kaldırıldı.BottomSheetScaffold
'nınLookaheadScope
ile birlikte kullanıldığı belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (Ie6401) - Rozet hizalaması, sağ üst köşeye göre sabit içerik merkezine 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 aktarıldığı
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
iptal edilir. 1.2.1 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Kaydırma çubuğu durumlarını tekrar kararlı hale getirin.
State.onValueChangeFinished
öğesini tekrar val yapma.onValueChangeFinished
,rememberUpdatedState
içinde sarmalanıyor. (Ie8fd0, b/322269951) state.onValueChangeFinished
olan durumuvar
olarak değiştirdiğimiz için@Stable
,Slider
eyaletlerinin durumlarından kaldırılıyor. (I82ba1, b/322269951)- Varsayılanlardan kopyalanacak
NavigationBar
özel renkleri düzeltin. (80a779, b/326894020) ExposedDropdownMenu
'daki regresyonu düzelterek tekrar odaklanılabilir hale getirin (3fcec1, b/323694447)- Düzelt düğmesi renk önbelleğe alma sorunu düzeltildi (3e5bbcb/327371655).
Sürüm 1.2.0
7 Şubat 2024
androidx.compose.material3:material3-*:1.2.0
iptal edilir. 1.2.0 sürümü şu commit'leri içerir.
Bilinen Sorun
PrimaryTabRow
sürümünde, performans iyileştirme değişikliği kapsamında bir View-Compose birlikte çalışabilirlik oluşturma hatası ortaya çıktı. Geçici çözüm olarakTabRow
ileTabRowDefaults.PrimaryIndicator
kullanabilirsiniz.
1.1.0 sürümünden beri yapılan önemli değişiklikler
Yeni Materyal Tasarım 3 Bileşenleri
- Yenilemek için aşağı çekin
- Segmented Button
Mevcut Materyal Tasarım 3 bileşenlerinde iyileştirmeler yapıldı.
- Alt uygulama çubuğu (sağdan sola hizalama, kaydırma sırasında otomatik gizleme)
- Sekmelerin görsel güncellemesi
- Rozet (hizalama güncellemesi)
Deneysel API'leri kararlı sürüme yükselttik.
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
iptal edilir. 1.2.0-rc01 sürümü şu commit'leri içerir.
Hata Düzeltmeleri
mediumTopAppBarColors
parametre sırası hatası düzeltildi. (Ibe64a)1.2.0-beta02
sürümündeCardDefaults.cardColors
'e eklenen vecontentColor
değerinicontainerColor
parametre değerine göre güncellemeyen hata düzeltildi. (Iee041, b/319671246)1.2.0-beta02
sürümündedisabledContentColor
'da 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
iptal edilir. 1.2.0-beta02 sürümü şu commit'leri içerir.
Bilinen hata
IconButtonColors
'daki bir hata, kullanıcı tarafından belirtilencontentColor
yerine varsayılan olarakLocalContentColor
'nin alfa sürümüne (0.38f)disabledContentColor
atar. Geçici çözüm olarakdisabledContentColor
değerini açıkça ayarlayabilirsiniz. Bu sorun, sonraki sürümde düzeltilecektir.
API Değişiklikleri
- Düz
Tooltip
API'leri için ipucu işaretlerini etkinleştirme özelliği eklendi. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
veSwipeToDismissValue
öğelerinin tümü_SwipeToDismissBox_
olacak şekilde yeniden adlandırılır. (I68d6d)
Hata Düzeltmeleri
- Spesifikasyona uygun olması için
ListItem
bitiş dolgu değeri düzeltildi. (Ibd68b, b/305342674) - Ana hatlı kartın ana hat rengi artık
OutlineVariant
ile doğru şekilde eşleniyor. (I75480, b/310979715) - Dinamik renk artık sistem tarafından tanımlanan renk rollerinden alınır. Bu değişiklik, erişilebilir içeriklerde kontrastı iyileştirir ve dinamik rengi Materyal spesifikasyonuyla daha uyumlu hale getirir. (I1de96)
ModalBottomSheet
olduğunda Android T/13+ cihazlardaModalBottomSheet
geri işleme sorunu düzeltildi.android:enableOnBackInvokedCallback="true"
(I728dc, b/306196110)
Sürüm 1.2.0-beta01
13 Aralık 2023
androidx.compose.material3:material3-*:1.2.0-beta01
iptal edilir. 1.2.0-beta01 sürümü şu commit'leri içerir.
API Değişiklikleri
TabIndicatorScope
işlevini deneysel olarak işaretleyin. (I45c88)- İpuçları için kullanımdan kaldırılan deneysel API'ler kaldırıldı. (I438cb)
- Yeni
TabRow
aşırı yüklemelerini alt bileşenleri kullanmayacak şekilde değiştirin. Bu durum, sağlanan özel değiştiricilerleTabRow
göstergelerinin farklı bir şekilde oluşturulmasına neden olur. (Ife741) DismissDirection
veDismissValue
API'lerini kullanımdan kaldırın. Bu değerler,SwipeToDismissValue
ile birleştirildi. Bu değerler,SwipeToDismissBox
öğesinin hem konumunu hem de yönünü gösterir.DismissState.progress
, artık0.0
ile1.0
arasında birFloatRange
olarak işaretleniyor. Kullanımdan kaldırılanDismissState
Saver ve Constructor artık kaldırıldı.SwipeToDismiss
bileşeni, durumu ve varsayılanlar nesnesi deneysel olarak yeniden işaretlendi. (Ib54f2)
Hata Düzeltmeleri
PullToRefresh
için varsayılan gösterge artık dolu üçgen yerine açık ok ucu. (I67be3)
Sürüm 1.2.0-alpha12
29 Kasım 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
iptal edilir. 1.2.0-alpha12 sürümü şu commit'leri içerir.
API Değişiklikleri
RangeSlider
artık Kotlin aralığı (ör.0f..1f
) yerine özel birFloatRange
değer sınıfı kullanın.SnapFlingBehavior.kt
artık Kotlin aralığı da kullanıyor. (I025cb)- Mark Modifier fabrika işlevlerini
@Stable
olarak işaretleyin. (Ib109f)
Sürüm 1.2.0-alpha11
15 Kasım 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
iptal edilir. 1.2.0-alpha11 sürümü şu commit'leri içerir.
Yeni Özellikler
PullToRefreshContainer
vePullToRefreshState
'ü uygular. Bu iki öğe birlikte Material3'te yenilemek için çekme işlevi sağlar. (I16456, b/261760718)
API Değişiklikleri
SwipeToDismissBox
DismissDirection
veDismissValue
'yi deneysel olarak işaretleyin. (I517b0)SwipeToDismiss
öğesiniSwipeToDismissBox
olarak yeniden adlandırın.background
öğesinibackgroundContent
,dismissContent
öğesini ise sondakicontent
lambda olarak yeniden adlandırın. (I7f4d3)ChipElevation
veSelectableChipElevation
için oluşturucuyu herkese açık hale getirin. (Ie0c48, b/308432421)ModalBottomSheetProperties
ekleniyor.securePolicy
,ModalBottomSheetProperties
klasörüne taşınıyor.isFocusable
veshouldDismissOnBackPress
adlı kullanıcılarıModalBottomSheetProperties
adlı gruba ekleme Bu yeni boole değerleri, alttaki modal sayfanın IME etkinliklerini nasıl ele alması gerektiğini belirlemeye yardımcı olur. (Iea56f, b/278216859)RangeSlider
veSlider
durumları,initialOnValueChange
ilk eklerini ve ilgili kdoc'ları kaldıracak şekilde güncellendi. (I57d30)ChipBorder
sınıfı ve ilişkili işlev çağrıları kullanımdan kaldırıldı. Bunun yerine doğrudanBorderStroke
kullanılması önerilir. (I89cc2)- Foundation Tooltip API'leri artık
@ExperimentalFoundationApi
. (I30b0b) TabRow
veScrollableTabRow
artık kullanımdan kaldırılmıyor. Yeni birincil ve ikincil varyantlar deneysel olarak işaretlenir. (I0def6)- Filtre ve giriş çipleri artık doğrudan
BorderStroke
kullanıyor. (I07a8d) SegmentedButton
artıkBorderStroke
'ı doğrudan kullanıyor. (I89b9b)- Genel
AlertDialog
işleviniBasicAlertDialog
olarak yeniden adlandırdık ve önceki işlevin desteğini sonlandırdık. (Idbe52) SwipeToDismiss
API'leriniSwipeDismiss
olarak yeniden adlandırın ve yeniSwipeDismiss
API'lerini kararlı sürüme yükseltin. (I14cbe)- İpucu API'lerine
tonalElevation
veshadowElevation
ekleme. Ayrıca,TooltipBox
,PlainTooltip
veRichTooltip
API'leri yanlışlıkla kararlı olarak yayınlandığından deneysel sürüme geri taşındı. (If0f66, b/293939035) - Deneysel çip API'lerini kararlı sürüme yükseltin. (Iea2c3)
- Material3 tıklanabilir kartlarından
@ExperimentalMaterial3Api
açıklama metni kaldırıldı. (I88dbf)
Hata Düzeltmeleri
- İç içe yerleştirilmiş Lookahead ve Lazy düzenleriyle belirli senaryolarda
SwipeToDismiss
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
iptal edilir. 1.2.0-alpha10 sürümü şu commit'leri içerir.
API Değişiklikleri
Badge
veBadgedBox
'ı kararlı sürüme yükseltme (I67f16, b/261565132)securePolicy
öğesiniModalBottomSheet
öğesine parametre olarak ekleyerek kullanıcılarınWindowManager.LayoutParams.FLAG_SECURE
davranışını tanımlamasına olanak tanır. (Icdac8, b/296250262)LinearProgressIndicator
veCircularProgressIndicator
için,progress
öğesini lambda olarak alan yeni aşırı yüklemeler eklendi. Bu sürümler, önceki sürümlere kıyasla daha iyi performans gösterir. (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 sınırındayken gezinme oku düğmeleri hızlıca tıklandığında yaşanan
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
iptal edilir. 1.2.0-alpha09 sürümü şu commit'leri içerir.
API Değişiklikleri
ModalNavigationDrawer
veDismissibleNavigationDrawer
, yeniAnchoredDraggable
API'lerini kullanacak şekilde taşındı.DrawerState
'nınanimateTo
işlevi, açma ve kapatma yöntemleriyle değiştirildi. Ayrıca, kaydırma artık durum nesnesi yerine kayan nokta olarak gösteriliyor. Telafiye doğrudancurrentOffset
üzerinden erişebilirsiniz. (I0a72c)- Doğrudan
DatePickerState
veDateRangePickerState
oluşturmak için Non-Composable işlevleri eklendi. Bu işlevler, gerektiğinde ComposablerememberDatePickerState
verememberDateRangePickerState
işlevlerine alternatif olarak kullanılabilir. (I70326, b/291524052) - Sabit ve Kaydırılabilir
TabRows
artık Birincil ve İkincil varyantlara sahip. Bunlar, Material3'te tanımlandığı şekilde renk ve gösterge davranışıyla doğru şekilde eşlenir. PrimaryScrollableTabRow
veSecondaryScrollableTabRow
artık kaydırma durumunu gösteriyor. (Iec8f5, b/260572337)- Geliştiricilerin, sayfanın kaplayacağı maksimum genişliği belirtmek için ayarlayabileceği yeni bir
sheetMaxWidth
parametresi eklendi. Ekran genişliğinin tamamını kaplayan bir sayfa isteniyorsa parametre için Dp.Unspecified değeri iletilebilir. (Ifb7c9, b/266697696) PlainTooltipBox
veRichTooltipBox
API'leri, kullanımdan kaldırılmış yöntemler olarak yeniden eklendi. (I246fa)
Hata Düzeltmeleri
DatePicker
, tarih kalıplarına dönüştürüldüğünde aynı kalan belirli tarih iskeletlerine (ör. YY) sahip birDatePickerFormatter
ile başlatıldığında yaşanan kilitlenme düzeltildi. (I01f29)
Sürüm 1.2.0-alpha08
20 Eylül 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
iptal edilir. 1.2.0-alpha08 sürümü şu commit'leri içerir.
Davranışa Zarar Veren Değişiklik
ColorScheme
artık Immutable olduğundan tek tek renk güncellemeleri daha az verimli ancak renklerin daha yaygın kullanımı daha verimli hale geliyor. Bu değişikliğin nedeni, uygulamaların çoğunda tek tek renk güncellemenin temel kullanım alanı olmamasıdır. Bu durum hâlâ mümkündür ancak daha öncekinden daha fazla yeniden oluşturma işlemi yapılacaktır. Bu da tüm Material kodu boyunca durum aboneliklerinin miktarını önemli ölçüde azaltacak ve daha standart kullanım alanlarının başlatma ve çalışma zamanı maliyetini etkileyecektir. (Ic447d, b/297212873)- Ton Yüksekliği, artık spesifikasyona uygun şekilde farklı etkileşim durumlarında animasyonlu olarak gösterilmiyor. (Icdd12)
API Değişiklikleri
- İçerik kaydırıldığında otomatik olarak gizlemek için parametre olarak
BottomAppBarScrollBehavior
alan yeni birBottomAppBar
eklendi. Ayrıca,FabPosition.EndOverlay
eklenerek FAB'ın iskeledeki alt uygulama çubuğunun üzerinde sabitlenmek yerine onunla çakışmasına izin verildi. (Iecb47) BasicTooltipBox
üzerine inşa edilen ve etiketin sınırları dışına 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) - İskele'nin ölçüm sırasında mı yoksa yerleştirme sırasında mı alt öğelerini ölçmesi gerektiğini kontrol etmek için geçici bir işaretçi kullanıma sunuldu. Varsayılan olarak bu, ölçüm biriminde ö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çü kullanılarak
BottomSheet
içinde yatay olarak uçtan uca sabitlenir. (I1df0c, b/299058752) - Sayfayı aşağı kaydırarak kapatırken
ModalBottomSheet
öğesininonDismissedRequest
öğesini çağırmamasına neden olan hata düzeltildi. (Idfdd8)
Sürüm 1.2.0-alpha07
6 Eylül 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
iptal edilir. 1.2.0-alpha07 sürümü şu commit'leri içerir.
Yeni Özellikler
compose material 1.6.0-alpha05
sürümünde otomatik yansıtma simgeleri desteği eklendi. Otomatik yansıtma simgeleriyle ilgili ayrıntılar için lütfen sürüm notlarını inceleyin.
API Değişiklikleri
SliderState
,DraggableState
'yi uyguluyor (I9b116)- Şekli zorunlu bir parametre olarak değiştirin. Şekil yardımcı işlevinde
position
öğesiniindex
olarak yeniden adlandırın. (I34941) DatePicker
formatWithSkeleton
, performans iyileştirmeleri için önbellek olarak kullanılan bir haritayı içerecek şekilde güncellenir. (I3195f)BasicTooltipBox
,compose.foundation
'e eklendi.PlainTooltipBox
veRichTooltipBox
, yeniPlainTooltip
veRichTooltip
composable'ları ileTooltipBox
'i kullanacak şekilde güncellendi. (I79e1d)
Hata Düzeltmeleri
dynamicLightColorScheme
vedynamicDarkColorScheme
artık yüzey vesurfaceContainer
rolleri için daha yüksek kroma renkleri döndürüyor. (I5e901)- Bir
LookaheadScope
içindeki Scaffold'da Subcomposition (ör.BottomSheetScaffold
) kullanan bazı bileşenlerin boyutlarını çok erken okumaya çalışmasına neden olan 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
iptal edilir. 1.2.0-alpha06 sürümü şu commit'leri içerir.
Hata Düzeltmeleri
DropdownMenu
'nınoffset
hesaplaması düzeltildi. Böylece x uzaklıkları yalnızca yerel düzen yönüne bağlı olacak ve menü ekranın alt kısmına yakın olduğunda y uzaklıkları artık tersine çevrilmeyecek. (Iccc74, b/294103942)DropdownMenu
'nınoffset
hesaplaması düzeltildi. Böylece x uzaklıkları yalnızca yerel düzen yönüne bağlı olacak ve menü ekranın alt kısmına yakın olduğunda y uzaklıkları 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
iptal edilir. 1.2.0-alpha05 sürümü şu commit'leri içerir.
API Değişiklikleri
- Onay kutusu ve
TriStateCheckbox
renkleriyle ilgili güncellemeler.CheckboxDefaults.colors()
disabledUncheckedColor
artık yalnızca onay kutusunun kenarlığını etkiliyor. Devre dışı bırakıldığında ve işareti kaldırıldığında 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
iptal edilir. 1.2.0-alpha04 sürümü şu commit'leri içerir.
Yeni Özellikler
- Deneysel Segmented Button API (Ifc8fb)
- Ayırıcılar artık dikey ayırıcıları desteklemek için yönü kontrol etmeye yönelik bir parametreye sahip. (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) - Composables için izin verilen girişleri belirtmek üzere ek açıklamalar (Ief234)
- Segmentli düğmeye simge parametresi ekleyin, segmentli düğmelerin sırasıyla
SelectableSegmentedButtonRow
veToggelableSegmentedButtonRow
ile tek seçim için seçilebilir, çoklu seçim için açılıp kapatılabilir olması amacıyla semantiği bölün. (I38740) - Ayırıcı,
HorizontalDivider
olarak yeniden adlandırıldı.VerticalDivider
işlevi eklendi. (I5975c) - Otomatik kutulama işlemini en aza indirmek için deneysel Material3 API'lerinde
ClosedFloatingPointRange
yerine daha hafif olanFloatRange
kullanın. (I4aab5) FabPosition
için yeni Başlangıç hizalama seçeneği eklendi (Ib7aea, b/170592777)
Hata Düzeltmeleri
ModalBottomSheet
yerel düzen yönüne saygı duyar. (Ib4f44, b/285628622)
Sürüm 1.2.0-alpha03
21 Haziran 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
iptal edilir. 1.2.0-alpha03 sürümü şu commit'leri içerir.
Davranış Değişiklikleri
includeFontPadding
, Material 3 tipografisinde varsayılan olarakfalse
olarak ayarlanmıştır. Varsayılan satır yüksekliği stili deTrim.None
veAlignment.Center
olarak değiştirildi.Typography
öğesininTextStyle
öğelerine açıklineHeight
(sp cinsinden) eklendi. Bu değerleri özelleştirmek istiyorsanız API belgelerine bakın. Bu değişikliklerin ayrıntılı açıklaması için blog yayınını inceleyin. (I6266f, Icabc3)
Yeni Özellikler
- Bileşenin durum bilgisi olan sürümü olan
RangeSlider
için aşırı yükleme eklendi. Mevcut etkin parçanın tüm bilgilerini,RangeSliderState
bileşenlerinin ölçümlerini ve sürükleme ile hareket mantığını içerenRangeSlider
oluşturuldu. (I8c270) - Arama çubuğu artık yeni eklenen
shadowElevation
parametresiyle gölgeleri destekliyor. (Ia5369, b/271040353) ColorScheme
artık yeniSurfaceContainer
rollerini destekliyor.- Yüzeyin ton yüksekliği katmanı artık
LocalTonalElevationEnabled
kompozisyon yereliyle devre dışı bırakılabilir. (Ic203c, b/277774590)
API Değişiklikleri
- Bileşen renkleri oluşturucularını açın. (I8c4a6)
- Geliştiricilerin, dokunma etkinliklerini kullanıp kullanmayacağını belirleyebilmesi için her iki ipucu API'sine de odaklanılabilir parametre eklendi. Bu durumun, erişilebilirlik odağının otomatik olarak geçişini bozabileceğine dikkat edin. (Ie32d8)
- Performans ve bellek ayırmaları için optimize edilmiş erişilebilirlik. (Iede48)
DefaultSizeClasses
işlevini kullanıma sunun veWindowSizeClasses
içinStandardSizeClasses
oluşturun (I91838)WindowWidth/HeightSizeClass
değerini kayan nokta değeri sınıflarıyla (Ie686e) değiştirin.
Hata Düzeltmeleri
- Scaffold'un
contentWindowInsets
parametresi artık kullanılan pencere içlerini dikkate alıyor. Bu parametreler sağlandığındatopBar
vebottomBar
'ye dayalı içerik dolgusunun davranışının değişmediğini unutmayın. (I08b73, b/264601542) - Uzun bir başlığın işlem simgelerinin veya gezinme simgesinin üzerinde oluşturulmaması için ortadaki üst uygulama çubuğunun hizalamasını düzeltin. (I4369f, b/236994621)
- Sekme konumları artık minimum 24 dp içerik genişliğini zorunlu kılıyor. Bu, sekme göstergeleri için erişilebilir bir dokunma hedefi sağlar. (Id8861)
dynamicLightColorScheme
vedynamicDarkColorScheme
'daki dinamik renk paletleri artık yeni yüzey rollerini destekliyor. (I1252e)- Büyük büyük anne/baba ile çakıştığında kırpılmaması için rozet bildirimi hizalaması güncellendi. (Idf75a)
Sürüm 1.2.0-alpha02
24 Mayıs 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
iptal edilir. 1.2.0-alpha02 sürümü şu commit'leri içerir.
API Değişiklikleri
ModalBottomSheet
öğesine pencere iç kenarları parametresini ekleyin.ModalBottomSheet
için yarı saydam katman artıkwindowInsets
sıfıra ayarlanmış durum çubuğunun arkasında çizilebilir.- Varsayılan
ModalBottomSheet
işlevi, gezinme çubuğu da dahil olmak üzere sistem çubuklarının dışında kalacak şekilde güncellendi. - Durum çubuğu yerleştirme işleme, uçtan uca modda sürükleme tutacağıyla sağlanır.
BottomSheetDefaults
,BottomSheetWindow
için pencere yerleştirmelerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
Indicator
desteğini sonlandırın ve M3 özelliklerine uygun olması içinPrimary
/SecondaryIndicator
desteğini ekleyin.PrimaryIndicator
, sekmenin içeriğinin genişliğiyle eşleşirkenSecondaryIndicator
, kullanılabilir 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österilen 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 bilgisi olan sürümü olan
Slider
için aşırı yükleme eklendi. Mevcut etkin parçanın tüm bilgilerini,SliderState
bileşenlerinin ölçümlerini ve sürükleme ile hareket mantığını içerenSlider
oluşturuldu. (I124a5) - Semantik mülk
isContainer
,isTraversalGroup
olarak yeniden adlandırılıyor (I121f6) - Tam parametre listesiyle optimize edilmiş
TextStyle.merge(...)
eklendi. (Iad234, b/246961787) TooltipState
,RichTooltipState
vePlainTooltipState
adlı herkese açık arayüzler oluşturuldu. Varsayılan durumlar içinRichTooltipStateImpl
vePlainTooltipStateImpl
eklendi. Bu uygulanan durumları elde etmek içinremember*State
işlevleri eklendi.TooltipSync
,TooltipDefault.GlobalMutatorMutex
lehine kaldırıldı. (I7813d)DatePickerColors
, tarih seçici ayırıcı, gezinme ve metin girişi alanlarının renkleri için ek özelleştirme seçeneklerini içerecek şekilde güncellendi. (I1a685, b/274626815)DatePickerState
veDateRangePickerState
artıkrememberDatePickerState
verememberDateRangePickerState
tarafından alınabilen varsayılan uygulamalara sahip herkese açık arayüzlerdir. (I71c52)dateValidator
,DatePicker
veDateRangePicker
'den kaldırıldı ve kullanıcı arayüzünde hangi tarihlerin veya yılların seçilebileceğini kontrol etmek için durum üzerinde ayarlanabilen birSelectableDates
arayüzü kullanıma sunuldu. (Ic2fc6)TimePicker
, kararlı API'den kaldırıldı. Durum API'sinde (I3f39a) başka değişiklikler yapılması bekleniyor.ModalBottomSheet
yalnızca Android'e taşındı.ModalBottomSheet
, masaüstü kullanımında önerilmez ve bu işlev etkin olarak desteklenmez. (Ib3778)
Hata Düzeltmeleri
- İşlemler, iletişim kutusunun genişliğine sığmak için üst üste geldiğinde
AlertDialog
kapatma işleminin onay işleminin altında görünmesi sorunu düzeltildi. Bu düzeltme, uygulamayı Materyal Tasarım spesifikasyonuyla uyumlu hale getirir. (I029de, b/235454277) ListItem
içinde üç satır öğesi için yanlış dolgu kullanılmasına neden olan hata düzeltildi. (I6e235)ModalBottomSheet
artık IME klavyesini görüntüleyebilir (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ü şu commit'leri 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ü şu commit'leri içerir.
Hata Düzeltmeleri
- Sabit değiştiricinin iki composable'a yanlış şekilde aktarılması düzeltildi. (b/282761472)
- 23 saatle başlatıldığında
TimePickerState
işlevinin yanlış saat döndürmesi sorunu düzeltildi. (b/278242122) - Öğle ve dakika doğrulama için ilk açma/kapatma durumu düzeltildi. (b/269768197, b/282790635)
state.hour
'ın 23:00 için yanlış değer döndürmesi sorunu düzeltildi. (b/282761472, b/278242122)
Sürüm 1.1.1
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ü şu commit'leri içerir.
Hata Düzeltmeleri
- İkili uyumluluk için
windowInset
parametresi olmadanModalBottomSheet
çağrısı ekler. (Ib7959) ModalBottomSheet
öğesine pencere iç kenarları parametresini ekleyin.ModalBottomSheet
için yarı saydam katman artıkwindowInsets
sıfıra ayarlanmış durum çubuğunun arkasında çizilebilir.- Varsayılan
ModalBottomSheet
işlevi, gezinme çubuğu da dahil olmak üzere sistem çubuklarının dışında kalacak şekilde güncellendi. - Durum çubuğu yerleştirme işleme, uçtan uca modda sürükleme tutacağıyla sağlanır.
BottomSheetDefaults
,BottomSheetWindow
için pencere yerleştirmelerini 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ü şu commit'leri içerir.
1.1.0 sürümündeki başlıca özellikler
Yeni Material Design 3 bileşenleri
Mevcut Materyal Tasarım 3 bileşenlerinde iyileştirmeler yapıldı.
Deneysel API'leri kararlı sürüme yükselttik.
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ü şu commit'leri içerir.
API Değişiklikleri
TimePicker
, kararlı API'den kaldırıldı. Durum API'sinde (I3f39a) başka değişiklikler yapılması bekleniyor.ModalBottomSheet
yalnızca Android'e taşındı.ModalBottomSheet
, masaüstü kullanımında önerilmez ve bu işlev etkin olarak desteklenmez. (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ü şu commit'leri 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 Hidden (Gizli) bağlantı noktasına sahip ancak bu bağlantı noktası varsayılan olarak devre dışıSheetState.requireOffset
doküman güncellendiBottomSheetDefaults.MinimizedShape
,BottomSheetDefaults.HiddenShape
olarak yeniden adlandırıldı (I839f4, b/273870234)
Hata Düzeltmeleri
- Dokunarak keşfetme etkinleştirildiğinde kadranı saatten dakikaya geçirmeyin. (I717d0)
ModalBottomSheet
veBottomSheetScaffold
sürükleme tutacağı semantiği artık birleştirildi. (I05afb)BottomSheetScaffold
değiştiricisi,containerColor
vecontentColor
parametreleri artık yalnızca içeriği etkiliyor. (I992cb)- Sayfa içeriği için
BottomSheetScaffold nestedScroll
artık kaydırma hareketlerini destekliyor. (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ü şu commit'leri içerir.
API Değişiklikleri
TimePicker
composable'a düzen türü parametresi ekleyin. Ekran yapılandırmasına bağlı olarak farklı düzenlerin kullanılmasına olanak tanır (Ia0e16).SearchBarDefaults
, deneysel olarak işaretlendi. (I65561)BottomSheetScaffold
öğesine gölge yüksekliği eklendi (I94e0f)- Tarih seçicilerin üstbilgi kısmı olmadan gösterilmesi için destek eklendi. Tarih seçici oluştururken boş bir başlık iletmeye izin veren API değişiklikleri. Artık başsız seçiciyi görüntülemek için boş başlık, başlık ve
showToggleMode = false
iletebilirsiniz. (Id3f3a, b/266132421, b/267194809)
Hata Düzeltmeleri
- Arama çubukları artık devre dışı bırakıldığında odağı otomatik olarak temizliyor. (I22a7c, b/261444487)
- Başlangıç ve bitiş tarihi aynı olan bir aralığın seçilmesine izin vermek için
DateRangePicker
güncellendi. (I16529, b/272882497) - Metin alanları, yazı tipi boyutu beklenenden küçük olduğunda metin öğelerini artık düzgün şekilde konumlandırıyor. Bu durum, yazı tipi ayarlarına ve komut dosyasına bağlı olarak uygulamalarınızda birkaç piksel değişiklik yapılmasına 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ı. Version 1.1.0-alpha08 contains these commits.
Yeni Özellikler
BottomSheetScaffold
veBottomSheetScaffoldState
için destek eklendi. (I063d4)
API Değişiklikleri
- Durumun ilk oluşturulmasından sonra tarihlerin ayarlanmasına ve boş zaman damgaları ayarlanarak seçimlerin sıfırlanmasına olanak tanımak için
DatePickerState
veDateRangePickerState
işlevleri eklendi. Tarihler manuel olarak ayarlanırken dikkatli olunmalıdır. Sağlanan bir tarih ön koşulu karşılamadığında yenisetSelection
işlevi istisna oluşturur (belgeleri inceleyin). (Ifa645, b/268609314, b/270427389) - Bu durumdaki davranışı daha doğru ve esnek bir şekilde tasvir etmek için Collapsed
SheetValue
öğesiniPartiallyExpanded
olarak yeniden adlandırın. (Ia1491) ListItem
parametre adları _text yerine _content olarak güncellendi. Varsayılan alıcılar artık uygun yerlerdeReadOnlyComposables
. (I69a25)- Etkileşimli Surface API'lerini deneysel aşamadan çıkarma (I90d59, b/261561812)
Hata Düzeltmeleri
ModalBottomSheet
'nınHalfExpanded
durumunun yanlış hesaplanmasına ve sayfanın kayıyormuş gibi görünmesine neden olan sorun düzeltildi. (I45e84, b/268411386)ModalBottomSheet
için scrim dokunmasınaconfirmValueChange
işareti ekleyin. (I2311a, b/270425759)- Anlamsal
BottomSheet
işlemleri sürükleme tutma yerine taşıyın. (I158ba) ModalBottomSheet
artık başlatma sırasında odağı yönetiyor ve geri düğmesini işliyor. (I4d2ab)ModalBottomSheet onDismissRequest
artık iç içe kaydırma hareketleri sırasında da işleniyor. (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ü şu commit'leri içerir.
Yeni Özellikler
rememberTimePickerState()
ile çalışan bir Time Input composable'ı ekleyin. Bu composable, zaman girişi için M3 spesifikasyonunu (Ia4fab) izler.- Tarih aralığı seçmek için Material 3
DateRangePicker
API'si eklendi. (I7a6c3, b/267194809) DateRangePicker
API aracılığıyla 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
parametresinin adıunfocusedTextColor
olarak,placeholderColor
parametresinin adı iseunfocusedPlaceholderColor
olarak değiştirildi. - Yeni
errorContainerColor
parametresiyle hata durumuna göre doldurulmuş metin alanlarının kapsayıcı rengi.
- Odak ve hata durumuna göre giriş alanı ve yer tutucu metin renkleri.
- Açığa çıkarılan açılır menü metin alanı renkleri, yeni önek ve sonek 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 küçük resim ve parça içeren yeni deneysel Slider ile kapsanan gereksiz Slider aşırı yüklemelerini kaldırma.
RangeSlider
sürümünün kararlı olması için yükseltiliyor. (Ie8fbd) - Çipin yükseltme işlevlerinde
defaultElevation
,elevation
olarak yeniden adlandırıldı. (I0f872) - Şu 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ıyor (I18856)- İskelet API'lerinden deneysel not kaldırıldı. (Ibb51e, b/261565765, b/261436953)
Hata Düzeltmeleri
ModalBottomSheet
varsayılan şekli artık her zamanSheetDefaults.ExpandedShape
'dir. (I0dfca)- Material 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 anlamsal roller kaldırıldı, bunları kullanan bileşenler modifier.semantics kullanarak rolleri ayarlayacak şekilde 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ü şu commit'leri içerir.
Yeni Özellikler
- Metin alanları artık ön ek ve son ek metinlerini (Ia8578, b/179884561) destekliyor.
TimePicker
işlevi eklendi. Bu işlev, Material 3 spesifikasyonuna uygun bir zaman seçici göstermek içinTimePickerState
ve kolaylık yöntemirememberTimePickerState
ile birlikte kullanılır (I71910).- Tarih girişi artık
DatePicker
konumunda bir görüntüleme modudur. 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 sayfa bileşenlerinde kullanılabilecekSheetState
verememberSheetState
'yi de kullanıma sunar. (I0853a, b/244189383)
API Değişiklikleri
- API'yi kararlı hale getirme
showSnackbar
(I195c2, b/261424370) - Yardım çipi ve öneri çipi için API'leri kararlılık kazandırın (Ibb67b, b/261424370)
ListItem
,ListItemDefaults
veListItemColors
API'lerinin deneysel olmayan sürümlerini kullanıma sunma (I7e7fa, b/261438882)SliderPositions
,SliderDefaults.Thumb
veSliderDefaults.Track
'yi kararlı sürüme yükseltme ve özel küçük resimler ile parça içeren deneysel olmayanSlider
veRangeSlider
API'lerini ekleme. Ayrıca öncekiSlider
veRangeSlider
API'lerinin desteği de sonlandırılacak. (Ie5ea6, b/261566890)- Geliştiricilerin uzun basıldığında ipucu gösterilmesi gerektiğini belirtmek için sabitleyiciye iletebilmesi amacıyla
Modifier.tooltipAnchor()
herkese açık hale getirildi.PlainTooltipBox
API'si,TooltipState
değerinin artık boş bırakılamayacak şekilde güncellendi ve varsayılan bir değere sahip. (Ie2fb7) ProgressIndicatorDefaults.circularTrackColor
, tutarlılık için@Composable
olarak işaretlendi. (Id29cc)- Geri yüklenen özellik alıcı
LocalMinimuTouchTargetEnforcement
, desteği sonlandırılmış olarak işaretlenir veLocalMinimumInteractiveComponentEnforcement
adresine yönlendirilir. (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ı. Version 1.1.0-alpha05 contains these commits.
Yeni Özellikler
DatePickerDialog
ve erişilebilirlik desteğiRangeSlider
öğesine ö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ü şu commit'leri içerir.
Yeni Özellikler
- Takvim kullanıcı arayüzü üzerinden tek bir tarih seçmek için ilk
DatePicker
API. Bu API'de değişiklikler yapılmaya devam ediyor. (I722b9) PlainTooltipBox
aracılığıyla düz ipuçları için destek eklendi. (I0cdfb)- Arama çubuğu (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
API Değişiklikleri
- Yüzeylerde
IsContainer
semantik özelliği eklendi. Bu özellik, yüzeyler gibi öğelerin anlamsal anlamına göre geçiş sırasını belirleyen sonraki bir değişiklikte kullanılacaktır. (I63379) - Gezinme çekmecesiyle ilgili API'leri kararlı olarak işaretleyin. (Iab01e, b/261439597)
- Dairesel ilerleme durumu göstergeleri için parça rengi parametresi, hem dairesel hem de doğrusal ilerleme durumu göstergeleri için ise fırça ucu parametresi eklendi. (Ie668c, b/216325962, b/222964817)
- Kullanımdan kaldırılan ve gizlenen işlevlerin daha fazla dönüş türü null olabilir (Ibf7b0)
Modifier.minimumInteractiveComponentSize
ekleyin. Öğe daha küçük ölçülürse dokunma etkileşimlerini netleştirmek için en az 48 dp boyutunda alan ayırmak üzere kullanılabilir. (I33f58, b/258495559)AlertDialog
içerik yuvası olan composable için deneysel API eklendi. (Iec4a2)
Hata Düzeltmeleri
- İlerleme durumu göstergelerindeki ilerleme durumu artık beklenen aralıkla düzgün şekilde sınırlanıyor. (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. Sorun burada ilk olarak bildirildi. Düzeltme gönderildi ve bir sonraki Oluşturma güncellemesinde kullanıma sunulacak. Geçici çözüm olarakandroidx.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ü şu commit'leri içerir.
API Değişiklikleri
consumedWindowInsets()
,consumeWindowInsets()
olarak,withConsumedWindowInsets()
iseonConsumedWindowInsetsChanged()
olarak yeniden adlandırıldı ve değiştiriciler herkese açık hâle getirildi. (Ie44e1)- Kullanılacak simge içeren metin düğmesi için yeni varsayılan içerik dolgusu ekleyin. (I8f662)
- Gezinme çubuğu ve ray için devre dışı renkler eklendi. (Ia7892, b/258867034)
- Üst öğelerin kaydırma bilgilerini sorgulamak için bir Modifier API eklendi. (I2ba9d, b/203141462)
- Hareketler kaydırma etkinliğine dönüşebildiğinde, basma etkileşimlerini doğru şekilde geciktirmek için
Clickable
içinde kullanılır. Clickables
öğesinin,Scrollable ViewGroup
içinde kullanıldığında dalgalanmaları doğru şekilde geciktirmemesi sorunu düzeltildi.- Hareketlerin kaydırma etkinliğine dönüşebileceği durumlarda basma işlemlerini doğru şekilde geciktirmek için çekmeceler ve sayfalar güncellendi.
Bağımlılık Güncellemeleri
Compose UI
veCompose Material
artık Lifecycle 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ü şu commit'leri içerir.
API Değişiklikleri
awaitFirstDown
vewaitForUpOrCancellation
artık daha fazla esneklik içinPointerEventPass
kabul ediyor (Ayrıca, kaydırma sırasında menü gösterenExposedDropdownMenuBox
düzeltildi).(I7579a, b/212091796)- Materyal ve Material3 Text,
minLines
veTextField
'eOutlinedTextField
parametresi eklendi. Bu parametre, bileşenin minimum yüksekliğinin satır sayısı cinsinden ayarlanmasına olanak tanır (I4af1d). TopAppBarDefaults smallTopAppBarColors
işlevini,TopAppBar
oluşturulurken kullanılması gereken yeni birtopAppBarColors
işlevi lehine kullanımdan kaldırma. (Ie6cb9)BasicText
veBasicTextField
parametrelerineminLines
parametresi eklendi. Bu composable'ların minimum yüksekliğini satır sayısı cinsinden ayarlamaya olanak tanır (I24294, b/122476634).
Hata Düzeltmeleri
- Material3
IconButton
veIconToggleBotton
öğelerinin içeriğini bileşenin durum katmanı şekline (ör. dairesel şekil) kırpın. (I9da8f) - Material3 Medium ve Large üst uygulama çubuklarını, tüm yüzeylerinde aynı arka plan rengini uygulayacak ve varsayılan renklerin şeffaf renk değerleriyle geçersiz kılınmasına izin verecek şekilde günceller. (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ü şu commit'leri içerir.
Hata Düzeltmeleri
- Başlık, TextStyle ve Brush ile uygulandığında üst uygulama çubuğundaki sorunlar düzeltildi. (If667e)
Sürüm 1.0
Sürüm 1.0.1
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ü şu commit'leri içerir.
Hata Düzeltmeleri
- Material3 Medium ve Large üst uygulama çubuklarını, tüm yüzeylerinde aynı arka plan rengini uygulayacak ve varsayılan renklerin şeffaf renk değerleriyle geçersiz kılınmasına izin verecek şekilde günceller. (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ü şu commit'leri içerir.
1.0.0 sürümünün temel özellikleri
Bu, Compose Material 3'ün ilk kararlı sürümüdür.
Material Design 3 temalandırma ve Material You dinamik renk
Material Design 3 bileşenleri
- Rozet
- Alt uygulama çubuğu
- Düğmeler
- FAB ve genişletilmiş FAB
- Kartlar
- Onay kutusu
- Chips
- İletişim kutuları
- Ayırı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
- Surface
- 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. Bu kitaplık, yeniden boyutlandırılabilir uygulama düzenlerini tasarlamanız, geliştirmeniz ve test etmeniz için kullanabileceğiniz, görüntü alanı kesme noktalarıyla ilgili bir dizi görüş içerir.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. Örneğin, daha büyük pencere boyutlarında alt gezinme yerine gezinme çubuğu gösterebilirsiniz. Daha fazla bilgi ve örnek kullanım içinWindowSizeClass
ile ilgili API referans belgelerine 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ü şu commit'leri içerir.
API Değişiklikleri
- Metin alanına metin API'sini desteklemek için yuva 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ü şu commit'leri içerir.
API Değişiklikleri
ExposedDropdownMenuDefaults
artık menü öğeleri için bir dolgu değeri sunuyor. (I34ee1)ExposedDropdownMenuBoxScope
artıkModifier.menuAnchor()
değiştiricisine sahip. Bu değiştirici, uygun a11y davranışı için metin alanına iletilmelidir. (I27fa3)- Kullanıcıların kaydırma çubuğunu doldurmak için bir başparmak veya parça geçirmesine olanak tanımak üzere mevcut Slider API'ye iki aşırı yüklenmiş yöntem ekleme. (I21c00)
Hata Düzeltmeleri
- Hata durumunda kapsayıcı için koyu tema renk eşlemesi 90 tonu (Ic5612) olarak güncellendi.
- Küçük Materyal 3 üst uygulama çubukları için şeffaf arka plan ayarlanmasına izin verme düzeltmesi yapıldı. (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ü şu commit'leri içerir.
API Değişiklikleri
- beta01 sürümündeki m3 bileşenlerinde kullanıma sunulan varsayılan bileşen iç kısımları artık IME iç kısımlarını hesaba katmıyor.
- Material3 Scaffold bileşeninde artık
contentWindowInsets
parametresi var. Bu parametre, içerik yuvası için işlenecek yerleşim miktarlarını belirtmenize olanak tanır. (Icf11a, b/243713323) - Deneysel Material 3
SmallTopAppBar
işlevini kullanımdan kaldırır ve eşdeğer birTopAppBar
işlevi sunar. Lütfen kullanımınızı yeni sürüme taşıyın. (I74404, b/226918634) - Üst uygulama çubuğunun kaydırma ve tutturma davranışları üzerinde kontrol sağlar. (I15c81)
- Divider'dan startIndent'i kaldırır, rengi son parametreye taşır. (If7be2)
Hata Düzeltmeleri
- İletişim kutularının, gösterildiklerinde "İletişim kutusu" kelimesini duyurarak TalkBack kullanıcılarına kendilerini tanıtmasını sağlayın. (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ü şu commit'leri içerir.
API Referansı
En yeni tema oluşturma, bileşen ve diğer composable'ları görmek için Compose Material 3 API referansına genel bakış konusuna göz atın.
API Değişiklikleri
- Material 3 üst uygulama çubuğu, tamamen daraltılmış durumdan tamamen genişletilmiş duruma geçecek şekilde güncellendi. Ayrıca,
TopAppBarDefaults
davranış işlevi, Composables olacak ve üst uygulama çubuğu durumu ile animasyon spesifikasyonu için varsayılan değerler sağlayacak şekilde güncellendi. (I642b3) - Yüzey API'siyle eşleşmesi için güncellenen FAB bileşen imzaları (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 ekleri otomatik olarak işler. Not: Bu değişiklik, durum çubuğu simgelerinin ve durum ile gezinme çubuklarının şeffaflığının otomatik olarak işlenmesini sağlamaz. En iyi uçtan uca deneyimi sağlamak için lütfen manuel olarak yapmaya devam edin. (I7e4e6, b/183161866)
- Gelecekteki esneklik ve performans iyileştirmeleri için API yüzeyini azaltmak üzere bileşen varsayılanları güncellendi. (I31820)
- API'de tutarlılığı korumak için çip ve gezinme çekmecesi sayfası parametreleri yeniden sıralandı (I45d0b).
- Ayırıcıdan
startIndent
kaldırıldı ve renk son parametre olarak 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ü şu commit'leri içerir.
Yeni Özellikler
- Gezinme çekmecesinde özel genişlik belirtme desteği. (Ia7f10)
API Değişiklikleri
- API'de tutarlılığı korumak için Sekmeyi Yeniden Sırala ve Önde Gelen simge sekmesi parametreleri (Ie2637)
BadgeDefaults
deneysel olarak işaretlendi. (I98ef3)- Kullanımdan kaldırılan gezinme çekmecesi işlevini kaldırdık. (I4f2db)
- API'de tutarlılığı korumak için Material 3'teki Slider parametrelerini yeniden sıralayın (I0aee7).
- API'de tutarlılığı korumak için
NavigationBar
veNavigationRail
parametrelerini yeniden sıralayın (I51cda). - API genelinde tutarlılığı korumak için Material 3'teki parametreleri yeniden sıralayın. (If4ae1)
- API'de tutarlılığı korumak için Material 3'teki kaydırma çubuğu parametrelerini yeniden sıralayın (I62673).
- Üst uygulama çubuğuyla tutarlı olması için simgeler parametresinin adı işlemler olarak değiştirildi (Id75be).
- Sabit hizalama hala değişmekte olduğundan
Badge
veBadgedBox
öğelerini 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ğini, üzerinde özel bir genişlik belirtmeyi desteklemek için kendi composable'ına ayırdı. (Ia7f10)
Divider
,MenuDefaults
veTabDefaults
'den kaldırılıyor (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ı. Version 1.0.0-alpha15 contains these commits.
Yeni Özellikler
- Üst uygulama çubuğunun doğrudan çubuktan sürüklenmesine izin verin. (I65c00, b/205873416)
API Değişiklikleri
FilterChip
veElevatedFilterChip
API'lerinde,selectedIcon
yuvasını kaldırmak ve seçili bir durumu göstermek içinleadingIcon
öğesinin yeniden kullanılmasını teşvik etmek üzere güncellemeler yapıldı. (Ie5dc2)- Scrim ve ana hat varyantı renk rolleri ekleyin. (Id6d54)
- Birleştirilebilir varsayılanlar için adlandırma kurallarını düzeltin. (I62b27)
ListItemDefaults
veListItemColors
'yi deneysel olarak işaretleyin. (I1f3ec)- Durum özelliklerinin anlamını daha iyi yansıtmak için üst uygulama çubuğu API'sinde yapılan değişiklikler. Ayrıca, üst uygulama çubuğu API'sini deneysel olarak işaretleyin. (Ic0ad8)
- Metin seçimi renkleri, daha iyi keşfedilebilirlik için
TextFieldColors
'ya 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)
@ExperimentalMaterial3Api
ek açıklamasınıCheckbox
işlevinden kaldırdı. (I5eefc)@ExperimentalMaterial3Api
ek açıklamasınıRadioButton
işlevinden kaldırdı. (I17e2a)- Etkileşimli olmayan kartlardan
@ExperimentalMaterial3Api
açıklamasını kaldırdık. (I9bd49) - Çeşitli bileşen varsayılan nesnelerini renkler, şekiller 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 çalışmayan sondaki simgeler kaldırıldı. (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ü şu commit'leri içerir.
Yeni Özellikler
- M3 listesi uygulaması eklendi. Örnek kullanım için dokümanlara bakın (Id7a20).
API Değişiklikleri
RangeSlider
içinde parametre adını değerlerden değere değiştirme (I3b79a)- Material Design spesifikasyonuna göre seçilebilir bir durumu desteklemek için
InputChip
uygulamasında API değişiklikleri yapıldı. Devre dışı bırakılmış seçili durum içinFilterChip
renklerinde ek destek sunuldu. (I55244, b/235792432) BottomAppBar
varsayılan FAB'ı ekleyin (Ida4c8)ColorScheme.surfaceColorAtElevation
eklendi (Id41af)- Compose kitaplıklarındaki arayüzler artık jdk8 varsayılan arayüz yöntemleri kullanılarak oluşturuluyor (I5bcf1).
WindowWidthSizeClass
veWindowHeightSizeClass
artık Comparable'ı uyguluyor. Bu nedenle, operatörler (<, <=, >=, >) ve diğer API'ler kullanılarak karşılaştırılabilirler. (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 durumu 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ü şu commit'leri içerir.
API Değişiklikleri
- Yapılandırma değişikliğinde ü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ü şu commit'leri içerir.
Hata Düzeltmeleri
- Kaydırma çubuğu ü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ü şu commit'leri içerir.
Yeni Özellikler
- Material 3'e
RangeSlider
eklendi (I18e38) - Material3
AssistChip
veInputChip
desteği eklendi (I0d25a) - Material3
FilterChip
veSuggestionChip
desteği eklendi (I9fdf3)
API Değişiklikleri
TextFieldDefaults.BorderStroke
adlı,OutlinedTextField
içinde kenarlık konturu çizen composable işleviTextFieldDefaults.BorderBox
olarak yeniden adlandırıldı. (I5f295)- Switch m3 görsel değişiklikleri (Iab30e)
- Renklerin standart simge düğmelerine aktarılmasına izin verin. (Ia2445)
Hata Düzeltmeleri
- İç dolgunun kullanıldığından emin olmak 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ı. Version 1.0.0-alpha10 contains these commits.
Yeni Özellikler
material3-window-size-class
, pencere boyutu sınıfları için destek sağlayan yeni bir kitaplıktır. Bu kitaplık, yeniden boyutlandırılabilir uygulama düzenlerini tasarlamanız, geliştirmeniz ve test etmeniz için kullanabileceğiniz, görüntü alanı kesme noktalarıyla ilgili bir dizi görüş içerir.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. Örneğin, daha büyük pencere boyutlarında alt gezinme yerine gezinme çubuğu gösterebilirsiniz. Daha fazla bilgi ve örnek kullanım içinWindowSizeClass
ile ilgili API referans belgelerine 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 kılavuza bakın.
API Değişiklikleri
BottomAppBar
için varsayılan FAB yüksekliğini ekler, FAB ileBottomAppBar
öğesinden sondaki lambda'yı kaldırır. (I92c47)- Material3
FilledIconButton
,FilledTonalIconButton
veOutlinedIconButton
'yi ekler. (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)
PointerInputChange
sürümünde kullanımdan kaldırıldı. Değişikliği tamamen kullanmak içinconsume()
öğesini kullanabilirsiniz. Başka bir kullanıcının değişikliği daha önce kullanıp kullanmadığını belirlemek içinisConsumed
simgesini kullanabilirsiniz. PointerInputChange::copy()
artık her zaman yüzeysel bir kopya oluşturur. Bu,PointerInputChange
kopyalarından biri kullanıldığında diğer kopyaların da kullanılacağı anlamına gelir. Sınırsız birPointerInputChange
oluşturmak istiyorsanız bunun yerine oluşturucuyu kullanın. (Ie6be4, b/225669674)- Kapsayıcı ve içerik renklerini
CardColors
arayüzü üzerinden almak için Kartlar API'sinde yapılan değişiklikler ve tıklanabilir kartlar için devre dışı durumu desteği. (I927df) - Diğer bileşenlerle tutarlılığı artırmak için Material 3 metin alanlarında
backgroundColor
parametresinin adıcontainerColor
olarak değiştirildi. (I6fbd9)
Hata Düzeltmeleri
- Standart
IconButton
, Material3 spesifikasyonuyla uyumlu olacak şekilde güncellendi. (I09eab) - Material3 Scaffold'un üst çubuğunun yüksekliğini içeriğe iletilen dolguya taşıyarak içeriğin üst uygulama çubuğunun altında oluşturulmasına olanak tanır.
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
iptal edilir. Version 1.0.0-alpha09 contains these commits.
Yeni Özellikler
- Material 3 Switch API'si (I2c3ad) eklendi.
API Değişiklikleri
- Metin alanları içeren açılır menüler (diğer adıyla "gösterilen açılır menüler" veya "birleşik kutular") için destek eklendi. (I1b832)
- MaterialTheme ve Shape alt sistemine şekil parametresi eklendi. (I37426)
ExtendedFloatingActionButton
öğesine, her durum arasında animasyonlarla birlikte, FAB'ın genişletilip daraltılacağını kontrol etmek için genişletilmiş bir parametre eklendi. Simge içermeyen ExtendedFAB'ler için sondaki metin içeren ExtendedFAB'ler için Extended 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
iptal edilir. Version 1.0.0-alpha08 contains these commits.
Yeni Özellikler
- Material 3 metin alanları için destek eklendi. (I795cc, b/199377790)
API Değişiklikleri
- Menü için varsayılan ayırıcı ekleme (I01374)
surfaceTint
sınıfınaColorScheme
renk parametresi eklendi. (I2f558)
Hata Düzeltmeleri
- Varsayılan metin stili değerini MaterialTheme'den okumak için Material3 Button'da düzeltme yapın. (Ie62fc)
Sürüm 1.0.0-alpha07
9 Mart 2022
androidx.compose.material3:material3:1.0.0-alpha07
iptal edilir. 1.0.0-alpha07 sürümü şu commit'leri 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çılıp kapatılabilir yüzeyleri destekleyen bir işlev ekleyen Material 3 Surface API'de güncellemeler. (I4bf18)
LazyVerticalGrid
veLazyHorizontalGrid
artık kararlı. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
ve ilgili tüm API'ler .grid alt paketine taşındı. Lütfen androidx.compose.foundation.lazy.grid'e aktarımlarınızı androidx.compose.foundation.lazy'den güncelleyin. (I2d446)- Yalnızca bir Görünüm'e güvenmeye yönelik önceki değişiklik geri alındı ve bazı pencere işaretlerini yönetmek için gerekli olan bir Pencere tekrar zorunlu kılındı.
WindowInsetsControllerCompat
Doğru pencerenin kullanıldığından emin olmak içinViewCompat.getWindowInsetsController
yerineWindowCompat.getInsetsController
kullanılması önerilir (ör. Görünüm bir iletişim kutusundaysa). (I660ae, b/219572936) - Çapraz eksen boyutlarını tanımlamak için yeni bir
LazyVerticalGrid
API eklendi (I17723).
Hata Düzeltmeleri
- Surface API'deki (I3c8b9) değişiklikleri takip etmek için Card API'de yapılan güncellemeler
Sürüm 1.0.0-alpha06
23 Şubat 2022
androidx.compose.material3:material3:1.0.0-alpha06
iptal edilir. 1.0.0-alpha06 sürümü şu commit'leri içerir.
API Değişiklikleri
- Çekmecelerdeki tek bir hedefi temsil eden
NavigationDrawerItem
eklenir (Ic396f, b/218286829) PermanentNavigationDrawer
veDismissibleNavigationDrawer
deneysel API'ler olarak eklendi. Bu çekmeceler, büyük ekranlı cihazlar için uygundur. (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ım için dokümanlara bakın (Ie0146).
Hata Düzeltmeleri
TalkBack
Ekran okuyucu doğrusal gezinme özelliğinin boş bir üst uygulama çubuğu başlığı seçmesine neden olan sorun düzeltildi. (Id4690)FloatingActionButtonDefaults
listesineIconSize
eklendi. (Ia71cf)LazyColumn
ile uzun bir metin eklendiğindeAlertDialog
düğmelerinin gizlenmesiyle ilgili hata düzeltildi. (Ib2cc9, b/216663029)
Sürüm 1.0.0-alpha05
9 Şubat 2022
androidx.compose.material3:material3:1.0.0-alpha05
iptal edilir. 1.0.0-alpha05 sürümü şu commit'leri içerir.
Yeni Özellikler
Material Design 3 bileşenleri eklendi
- Açılır menü
- Kartlar
API Değişiklikleri
- onClick geri çağırma işlevini alan, desteği sonlandırılan
Surface
işlevi. Tıklanabilir yüzeylerInteractionSource
veModifier.clickable()
ile oluşturulmalıdır. (I211c6) - FAB için basılı ve odaklanılmış yükseklik desteği eklendi. (Ibb584)
Surface
API'si, farklı durumlarda görünümünün kontrol edilmesini sağlayan bir InteractionSource alacak şekilde değiştirildi. (Iafbc8)
Hata Düzeltmeleri
- Dinamik renk şemalarına eksik olan üçüncü renkler eklendi (I456c4, b/214588434)
Sürüm 1.0.0-alpha04
26 Ocak 2022
androidx.compose.material3:material3:1.0.0-alpha04
iptal edilir. 1.0.0-alpha04 sürümü şu commit'leri içerir.
API Değişiklikleri
- Karmaşık mantık içermeyen mevcut yöntemlerin aşırı yüklenmesi olan yöntemlere
NonRestartableComposable
eklendi. Bu, çağrılan iç işlevde tekrarlanan tüm parametreler için derleyici tarafından oluşturulan memoization kontrollerini (eşittir) azaltır. (I90490) - 3. materyal için ayırıcı eklendi. (Ica5fc)
- Onay kutusunu ve radyo düğmesini deneysel API ek açıklamasıyla 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 olacak şekilde güncelleme (I6b248, b/213339737)
Sürüm 1.0.0-alpha03
12 Ocak 2022
androidx.compose.material3:material3:1.0.0-alpha03
iptal edilir. 1.0.0-alpha03 sürümü şu commit'leri içerir.
Hata Düzeltmeleri
- Material 3'ün
MaterialTheme
öğesineLocalIndication
ekleyin. (I7ce4e) - Onay kutularına 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
'e bağlıdır.
Sürüm 1.0.0-alpha02
1 Aralık 2021
androidx.compose.material3:material3:1.0.0-alpha02
iptal edilir. 1.0.0-alpha02 sürümü şu commit'leri içerir.
Yeni Özellikler
- Onay kutusu ve radyo düğmesi için destek eklendi.
- Kotlin ile uyumlu olacak şekilde güncellendi
1.6.0
API Değişiklikleri
- Çekmeceyi Material 3'ün iskeletinden kaldırın. (I04f51)
- Material 3
Checkbox
desteği eklenir. (Id5542) - Material 3
RadioButton
desteği eklenir. (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ı yolu,compose.material
(I30b03) olarak değişir.- Her zaman etkin olacak şekilde kodlanmış düğme düzeltildi. (Iea832, b/205335456)
Sürüm 1.0.0-alpha01
27 Ekim 2021
androidx.compose.material3:material3:1.0.0-alpha01
iptal edilir. 1.0.0-alpha01 sürümü şu commit'leri içerir.
Yeni Özellikler
Material Design 3 temalandırma ve Material You dinamik renk
Material Design 3 bileşenleri
- Düğmeler
- FAB ve genişletilmiş FAB
- İletişim kutuları
- Gezinme çubuğu
- Gezinme çekmecesi
- Gezinme çubuğu
- Üst uygulama çubuğu
- Rozet
- Simge
- Metin
- Surface
- Düzen
- İçerik rengi
Daha fazla bilgi için Compose'da Materyal Temalandırma kılavuzundaki Material Design 3 ve Material You bölümüne göz atın.