Materyal 3 oluşturma
androidx.compose.material3
(Tüm oluşturma paketleri için API referans belgelerine bakın)
Son Güncelleme | Kararlı Sürüm | Yayın Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
4 Eylül 2024 | 1.3.0 | - | - | - |
Yapı
Oluşturma, androidx
içindeki yedi Maven grubu kimliğinin kombinasyonundan oluşur. Her Grup
Her biri kendi sürüm kümesine sahip olan, hedeflenmiş bir işlev alt kümesi içerir
notlar.
Bu tabloda, gruplar ve her sürüm notu grubunun bağlantıları açıklanmaktadır.
Grup | Açıklama |
---|---|
compose.animation | Jetpack Compose uygulamalarında animasyonlar oluşturarak kullanıcı deneyimini zenginleştirin. |
compose.derleyici | @Composable işlevlerini dönüştürün ve Kotlin derleyici eklentisiyle optimizasyonları etkinleştirin. |
compose.temel | 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şenleri ile Jetpack Compose kullanıcı arayüzleri oluşturun. Bu, Compose'un www.material.io adresinde açıklananlarla eşleşen bileşenleri sağlamak üzere tasarlanmış üst düzey giriş noktasıdır. |
compose.material3 | Materyal Tasarım'ın yeni evrimi olan Materyal Tasarım 3 Bileşenleriyle Jetpack Compose kullanıcı arayüzleri oluşturun. Güncellenmiş tema ve bileşenler ile dinamik renk gibi Material You kişiselleştirme özellikleri içeren Material 3, yeni Android 12 görsel stili ve sistem kullanıcı arayüzüyle uyumlu olacak. |
compose.runtime | Compose'un programlama modelinin ve durum yönetiminin temel yapı taşları ve Compose Compiler eklentisinin hedefleyeceği temel çalışma zamanı. |
compose.ui | Düzen, çizim ve giriş de dahil olmak üzere cihazla etkileşimde bulunmak için gereken yazma 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 belirler. Google'ın Maven deposunu okuyun konulu videomuzu izleyin.
build.gradle
dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin.
uygulamanız veya modülünüz:
Eski
dependencies { implementation "androidx.compose.material3:material3:1.3.0" implementation "androidx.compose.material3:material3-window-size-class:1.3.0" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.0") implementation("androidx.compose.material3:material3-window-size-class:1.3.0") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Bağımlılıklar hakkında daha fazla bilgi edinmek için Derleme bağımlılıkları ekleme bölümüne bakın.
Geri bildirim
Geri bildiriminiz Jetpack'i iyileştirmemize yardımcı olacaktır. Yeni sorunlarla karşılaşırsanız veya fikir edinebilirsiniz. Daha fazla bilgi için lütfen mevcut sorunlar tıklayın. Oyunuzu mevcut bir soruna eklemek için yıldız düğmesini tıklayın.
Sorun İzleyici dokümanlarına bakın konulu videomuzu izleyin.
Compose Material3 Ortak Sürüm 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
serbest bırakıldı. Sürüm 1.0.0-alpha01 bu kaydetmeleri içerir.
Yeni Özellikler
Materyal Tasarım bileşenleri oluşturmak için kullanılabilecek temasız bileşenler:
- Ton Paleti
- Simge
- Dokunma hedefi boyutu
Material3 Uyarlanabilir Gezinme Paketi 1.0 Sürümü Oluşturma
Sürüm 1.0.0-alpha07
1 Mayıs 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
serbest bırakıldı. Sürüm 1.0.0-alpha07 bu kaydetmeleri içerir.
API Değişiklikleri
- Gezinme paketi API'lerini deneysel olmayan hale getirin (If62af)
Hata Düzeltmeleri
- İçerik için ek öğeleri varsayılan olarak kullan (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
serbest bırakıldı. Sürüm 1.0.0-alpha06 bu kaydetmeleri içerir.
API Değişiklikleri
NavigationSuiteScaffoldDefaults
grubunacontainerColor
vecontentColor
ekleyin. (I64e3a, b/331993720)itemColors
işleviNavigationSuiteDefaults
işlevine ekleniyor. (Idf719, b/328480012)NavigationSuiteScope
cihazını mühürlü 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
serbest bırakıldı. Sürüm 1.0.0-alpha05 bu kaydetmeleri içerir.
API Değişiklikleri
NavigationSuiteItemColors
oluşturucuyu herkese açık yap. (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
serbest bırakıldı. 1.0.0-alpha04 sürümü bu kaydetmeleri içerir.
Bağımlılık Güncellemeleri
- Material3 uyarlanabilir bağımlılıklarını yeni modül yollarına güncelleyin. (Ibc421)
- Pencere boyutu sınıflarının Window Manager sürümünü kullanmak için geçiş yapın. (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
serbest bırakıldı. 1.0.0-alpha03 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Paket adını gezinme paketinden (I7eff7) navigasyon paketi olarak güncelleme
- API'lerinde
MutableInteractionSource
açığa çıkaran Material3 bileşenleri, artık varsayılan olarak null değerine ayarlanmış null değer içeren birMutableInteractionSource
gösterecek şekilde güncellendi. Burada herhangi bir anlamsal değişiklik yoktur: null değerinin geçirilmesi,MutableInteractionSource
öğesini kaldırmak istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Null değerine geçmek, bazı bileşenlerin hiçbir zaman birMutableInteractionSource
ayırmamasına izin verir ve diğer bileşenlerin yalnızca gerektiğinde geç bir şekilde örnek oluşturmasına olanak tanır. Böylece bu bileşenler genelinde performans artar. Bu bileşenlere ilettiğinizMutableInteractionSource
öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I41abb, b/298048146)
Sürüm 1.0.0-alpha02
13 Aralık 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
serbest bırakıldı. 1.0.0-alpha02 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- "Yok" yazın
NavigationSuiteType
(If8cb1, b/313688598)
Hata Düzeltmeleri
- Kök yüzeyinde
modifier.fillMaxSize
olduğunda ekranın tamamını dolduran gezinme bileşeni 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
yayınlandı. 1.0.0-alpha01 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
Material3 Uyarlanabilir Sürüm 1.0 Oluşturma
Sürüm 1.0.0-alpha06
7 Şubat 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
serbest bırakıldı. 1.0.0-alpha06 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
ThreePaneScaffoldNavigator
geri gitme menüsü için ek davranış seçenekleri eklendi. (I858aa)- Gezinme geçmişine isteğe bağlı hedef içeriği 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
serbest bırakıldı. 1.0.0-alpha05 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Yapı iskelesinde 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
serbest bırakıldı. 1.0.0-alpha04 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Bölme iskelelerine uçtan uca destek eklendi (I1b462)
API Değişiklikleri
- Duruş bölümündeki menteşe sınırı özellikleri, menteşe bilgileri listesine taşındı (I24f90)
Hata Düzeltmeleri
AnimatedPane
sorununun yeniden oluşturulmaması sorununu düzeltme (c3f573d)
Sürüm 1.0.0-alpha03
13 Aralık 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
serbest bırakıldı. 1.0.0-alpha03 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- İskele rollerini
ThreePaneScaffoldRole
takma adları ile değiştirin. (I65bd1) - Yapı iskelesi rolleri için bir temel sınıf oluşturun (I4784d)
AnimatedPane
kullanıcısının içeriğinden gereksiz parametreyi kaldırın (Ibc73b)collectWindowSizeAsState
öğesini yeniden adlandırır ve bunun yerine ham değerleri döndürür (I480f4)
Sürüm 1.0.0-alpha02
29 Kasım 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
serbest bırakıldı. 1.0.0-alpha02 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Uyarlanabilir iskele API'lerinden bölünmüş gezinme API'leri. (Ic4045)
GutterSize
sınıfı kaldır. (I785b3)
Hata Düzeltmeleri
AnimatedPane
kullanılmadığında bölmelerin değiştirilmemesi sorununu düzeltme (d88f181)
Sürüm 1.0.0-alpha01
15 Kasım 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
Material3 uyarlanabilir koşul API'leri:
Malzeme3 uyarlanabilir bölme yapı iskelet yönergesi API'leri:
Material3 uyarlanabilir pencere yapı API'leri:
- Bölme iskele temel API'leri
Oluşturma Material3 Sürüm 1.3
Sürüm 1.3.0
4 Eylül 2024
androidx.compose.material3:material3-*:1.3.0
yayınlandı. Sürüm 1.3.0 bu taahhütleri içerir.
1.2.0'dan bu yana önemli değişiklikler
1.3.0'ın önemli özellikleri
Yeni Materyal Tasarım 3 bileşenleri
- Bant
HorizontalMultiBrowseCarousel
veHorizontalUncontainedCarousel
Mevcut Material Design 3 bileşenlerinde yapılan geliştirmeler.
- [
ModalBottomSheet
] artık U+'da Tahmine Dayalı Geri Dönmeyi destekliyor (Iccf32, b/281967264, b/304850357) - [
SearchBar
] artık U+ sürümünde (I657f8) Tahmine Dayalı Geri'yi destekliyor - Gezinme Çekmecesi (
ModalDrawerSheet
veDismissibleDrawerSheet
) artık U+'da etkinleştirme olarak Tahmine Dayalı Geri'yi desteklemektedir (Ie5b0b) DropdownMenu
artık özel renk, şekil, yükseklik ve kenarlığı destekliyor. (I8e981,b/289554448, b/301887035, b/283654243)- Kaydırma çubuğu, bir boşluk ve durma göstergesi ekleyerek erişilebilirliği iyileştirmek için güncellendi. (I3058e)
- Boşluk ve durdurma göstergesi ekleyerek erişilebilirliği iyileştirmek için
ProgressIndicator
güncellendi. (I21451) - Zengin ipucu için varsayılan bir düzeltme işareti eklendi.
LayoutCoordinates
bağlayıcısı ile çizilecek özel imleç desteklenir. (Ifd42c) Zarar Veren Değişiklikler - Yeni yenilemek için çekme API'leri:
- Dp birimleri yerine kesirli değerlerin kullanılacağı
PullToRefreshState
basitleştirildi. isRefreshing
durumuPullToRefreshState
yerine kullanıcı tarafından kontrol ediliyor.- İç içe kaydırma bağlantısı
PullToRefreshState
öğesinden ayrıldı. YeniPullToRefreshBox
veyaModifier.pullToRefresh
tarafından işlenir. - Bu güncelleme, önceki deneysel API'lerde zarar veren bir değişikliktir. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Zarar veren görsel değişiklikler
- Dp birimleri yerine kesirli değerlerin kullanılacağı
- Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
ürünlerinde yüzey ve arka plan rengi varsayılanlarında küçük ayarlamalar yapıldı. (I9db52)- Kaydırma çubuğu ve
ProgressIndicator
renkler, yeni Metin Olmayan Kontrast özelliklerine uyacak şekilde güncellendi. (I26807) SurfaceContainer
varyant artık bileşenler tarafından kullanılıyor.Surface
veTonalElevation
ile resmi olarak renk hesaplaması yapılan bileşenler, artık varsayılan olarakSurfaceContainer
rollerini kullanıyor. Bu roller ton yüksekliğinden etkilenmiyor. (b/304584161)- Yüzey ve Yüzey container'ı referans rolleri, açık ve koyu temalarda daha fazla tonlama sağlamak üzere biraz düzenlenmiştir. (I677a5)
- Deneysel API'ler kararlı sürüme geçirildi.
- Performans iyileştirmeleri
Sürüm 1.3.0-rc01
21 Ağustos 2024
androidx.compose.material3:material3-*:1.3.0-rc01
yayınlandı. Sürüm 1.3.0-rc01 bu kayıtları içerir.
Hata Düzeltmeleri
ModalBottomSheet
şimdi anlamsal geçiş sırasında ilk sırada ve ardından kırpma geliyor. (I436f9, b/358594665)
Sürüm 1.3.0-beta05
24 Temmuz 2024
androidx.compose.material3:material3-*:1.3.0-beta05
yayınlandı. Sürüm 1.3.0-beta05 bu taahhütleri içerir.
- Android N ve O'da
BottomSheet
içeriğinin eksik olması veya kesilmesi sorunu düzeltildi (a10a2d) - Kaydırma çubuğunun anlam sınırları artırıldı. Böylece,
TalkBack
, başparmakların etrafındaki odak göstergelerini düzgün şekilde gösterebilecek. (0b5a1d)
Sürüm 1.3.0-beta04
26 Haziran 2024
androidx.compose.material3:material3-*:1.3.0-beta04
yayınlandı. Sürüm 1.3.0-beta04 bu taahhütleri içerir.
Sürüm 1.3.0-beta03
12 Haziran 2024
androidx.compose.material3:material3-*:1.3.0-beta03
yayınlandı. Sürüm 1.3.0-beta03 bu taahhütleri içerir.
Harici Katkı
androidx.compose.material3.DropdownMenu
öğesini ortak kaynak kümesinden kullanılabilir hale getirin. (If62c0)
Sürüm 1.3.0-beta02
29 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-beta02
yayınlandı. Sürüm 1.3.0-beta02 bu taahhütleri içerir.
API Değişiklikleri
Modifier.pullToRefreshIndicator
, yükseltmeyi destekler. Yenilemek için Çekme API'lerini, lambda yerine boole olacak şekilde güncelleyin.PullToRefreshBox
ürününde içerik uyumu desteği (I75679)TooltipScope
, mühürlü bir arayüz haline getiriliyor veTooltipBox
ile Etiket'te kullanılmak üzere dahili bir uygulama oluşturuluyor. (I3833e)- Herhangi bir bant öğesine (Id67a1) kolayca şekil ve kenarlık eklemek için
CarouselItemScope
öğesine (maskClip
vemaskBorder
) iki yeni değiştirici eklendi TimePickerState
artık bir arayüz ve saat ayarlanmasına olanak tanıyor (I88546)- Bağlantıların stil özelliklerini ayarlama API'sı güncellendi:
TextLinkStyles
öğesiTextStyle
öğesine taşındı veTextDefaults
öğesi 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
özet akışına yakın sayfa semantiği eklendi. (0e61cb,b/328801864)
Harici Katkı
androidx.compose.material3.AlertDialog
öğesini ortak kaynak kümesinden (Ia33f5) kullanılabilir hale getirinModalBottomSheet
öğesini, ortak kaynak kümesinden (Id7cc7) kullanılabilir hale getirin
Sürüm 1.3.0-beta01
14 Mayıs 2024
androidx.compose.material3:material3-*:1.3.0-beta01
yayınlandı. Sürüm 1.3.0-beta01 bu taahhütleri içerir.
API Değişiklikleri
CaretProperties
yerineDpSize
kullanılıyor.CaretProperties
kaldırılıyor.CaretScope
listesinin adınıTooltipScope
olarak değiştir. (Id9a76)- Metinde Materyal temalı bağlantılar almaya yönelik API güncellendi. Özellikle, temalı
LinkAnnotations
oluşturma ve temalı bağlantılara sahip HTML ayrıştırma yöntemleriTextDefaults
öğesinden kaldırıldı. Bunun yerine, bağlantıları metin composable'a parametre olarak biçimlendirmeye 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
yayınlandı. Sürüm 1.3.0-alpha06 bu kaydetmeleri içerir.
Çarpıcı Değişiklikler
Yeni yenilemek için çekme API'leri:
- Dp birimleri yerine kesirli değerlerin kullanılacağı
PullToRefreshState
basitleştirildi. isRefreshing
durumuPullToRefreshState
yerine kullanıcı tarafından kontrol ediliyor.- İç içe kaydırma bağlantısı
PullToRefreshState
öğesinden ayrıldı. YeniPullToRefreshBox
veyaModifier.pullToRefresh
tarafından işlenir. - Bu güncelleme, önceki deneysel API'lerde zarar veren bir değişikliktir. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Dp birimleri yerine kesirli değerlerin kullanılacağı
API Değişiklikleri
RippleConfiguration#isEnabled
kaldırıldı veLocalRippleConfiguration
geçersiz kılınabilir hale getirildi. Dalgayı devre dışı bırakmak içinisEnabled = false
ileRippleConfiguration
sağlamak yerineLocalRippleConfiguration
öğesinenull
sağlayın. (I22725)- Kenardan kenara etkinleştirildiğinde
ModalBottomSheet
, durum çubuğunun üzerine kaydırmayı daha doğru bir şekilde çizer. Kalıcı alt sayfa içeriği artık pencere eklerini tüketebilir ve böylece gezinme çubuğunun üzerinde görünür içeriğe olanak tanıyabilir.ModalBottomSheet
parametresiwindowInsets
, eklerin uygulanacağı yeri belirtmek içincontentWindowInsets
olarak yeniden adlandırıldı. Bu parametreler artık pencere mantığına bağlı değildir.contentWindowInsets
türü, yeni pencerede çözülmesine olanak tanımak içinWindowInsets
değerini döndüren bir işleve dönüştürüldü. (I39630, b/274872542, b/300280229, b/290893168) PrimaryScrollableTabRow
veSecondaryScrollableTabRow
artık alt bileşen yerine özel düzen kullanıyor. Bu durum, performansı artırmanızı sağlar. (I991e0)- Metin bağlantılarına, normal stile ek olarak basılı durum stil seçeneği eklendi, imleçle üzerine gelindi ve odaklanıldı.
TextDefaults
yöntemlerin her biri bunu desteklemek içinpressedStyle
bağımsız değişken aldı. (Ic473f, b/139312671)
Hata Düzeltmeleri
- Gezinme çekmecesi sürükleme bağlantıları artık
drawerContent
genişliğiyle eşleşiyor. (Ibc72f, b/245355396) OutlinedTextField
etiketinin üst dolgusu artık sistem yazı tipi boyutunu dikkate alıyor. (Idc781)CalendarLocale
sabit paket konumu. (Ifa235)- [Tahmine Dayalı Geri] Tahmine dayalı geri animasyonlarını, (0,1, 0,1, 0, 1) (I2591a) interpolasyon eğrisini kullanacak şekilde güncelleyin
Sürüm 1.3.0-alpha05
17 Nisan 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
yayınlandı. Sürüm 1.3.0-alpha05 bu kaydetmeleri içerir.
Yeni Özellikler
SearchBar
veDockedSearchBar
, metin alanı parametresi alan yeni aşırı yüklemelere sahip. Bu, metin alanının, arama çubuğunun geri kalanından ayrı olarak biçimlendirilmesini ve özel metin alanlarının iletilmesini sağlar. Mevcut uygulamanın metin alanı,SearchBarDefaults.InputField
olarak kullanıma sunulmuştur. (I50c73, b/275074248, b/278773336, b/326627700)- Gerekirse değer çizgilerinin özelleştirilmesi için genel API'ye
drawTick
lambda eklendi (I0c048)
API Değişiklikleri
- Metin bağlantılarına, normal stile ek olarak basılı durum stil seçeneği eklendi, imleçle üzerine gelindi ve odaklanıldı (I5f864, b/139312671)
CarouselItemInfo
, öğenin kırpıldığı Dikdörtgen maskesini (I785d8) ortaya çıkaracak şekilde güncellendiBasicTooltipState
, Material 3 herkese açık API'sinden kaldırıldı. TemelinBasicTooltip
özelliği dengeye oturana kadar işleviTooltipState
ile birleştirilir. (Icda29)LinkAnnotation
oluşturma ve bağlantılaraMaterialTheme
(I98532, b/139312671) uygulayan HTML etiketli dizeyi ayrıştırma yöntemleri içeren birTextDefaults
nesnesi eklendiExposedDropdownMenuBoxScope
artık alt sınıflara izin vermiyor. Gösterilen açılır menülerde artık daha iyi a11y desteği içinmenuAnchor
öğesine iletilmesi gereken birMenuAnchorType
var. Artık desteği sonlandırılanExposedDropdownMenu
öğesinefocusable
iletmek yerine bu 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
kenarlık rengi düzeltildi. Etkin durumdakiButtonDefaults.outlinedButtonBorder("enabled")
aşırı yüklemesi eklendi. (Ie650b, b/318461363) - Müşterilerin, öğe bedenleri 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şturucunun desteği sonlandırıldı. Lütfen yüzey container'larını içeren oluşturucuya geçiş yapın. (I35c11) - [Outlines]
TextFieldDefaults
ContainerBox
,Container
olarak yeniden adlandırıldı. (Ie8d3b)
Hata Düzeltmeleri
sheetSwipeEnabled
yanlış değerine ayarlanırsaBottomSheetScaffold
artık iç içe yerleştirilmiş kaydırmadan kaydırma yapmaz. (I5e1c1, b/306464779)IconButtonSamples.kt
içindeki bazıExperimentalMaterial3Api
Etkinleştirme ek açıklamaları kaldırıldı. (I111d1)
Sürüm 1.3.0-alpha04
3 Nisan 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
yayınlandı. Sürüm 1.3.0-alpha04 bu kaydetmeleri içerir.
Yeni Özellikler
- Materyal3 Bant'ın iki deneysel sürümü (
HorizontalMultiBrowseCarousel
veHorizontalUncontainedCarousel
) eklendi (I88d64) - Compose M3 Gezinme Çekmecesi (
ModalDrawerSheet
veDismissibleDrawerSheet
), U+'da kayıt olarak tahmine dayalı geri gitmeyi destekleyecek şekilde güncellendi (Ie5b0b) - Simgeye, yeniden derlemeyi önlemek için renk tonunun lambda olarak geçirilmesini sağlayan yeni bir API 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ı üst uygulama çubuklarının çok fazla kez yeniden oluşturulmasına neden olan bir sorun düzeltildi. Büyük yazı tipi/görüntüleme ayarlarına sahip cihazlarda başlıkların
MediumTopAppBar
kısaltılmasına neden olan sorun düzeltildi. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButton
ve ilişkili API'ler artık kararlı durumda (I8a158)SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
veSwipeToDismissBoxValue
kararlı olarak işaretlendi. (I5f000)- Kullanımdan kaldırılan
DismissDirection
veDismissValue
sıralamaları ve API'leri kaldırıldı. (I89ccd) - Bant'ın
CarouselState
tamamlayıcı nesnesine deneysel bir etiket eklendi. (I94154) LocalMinimumInteractiveComponentEnforcement
kullanımdan kaldırıldı ve yerineLocalMinimumInteractiveComponentSize
kullanılmaya başlandı. (I7a7ac)SearchBarColors
oluşturucu artık herkese açık. (I769ca)SwipeToDismissBox
öğesine birgesturesEnabled
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
yayınlandı. Sürüm 1.3.0-alpha03 bu kaydetmeleri içerir.
Çarpıcı Görsel Değişiklikler
- Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
ürünlerinde yüzey ve arka plan rengi varsayılanlarında küçük ayarlamalar yapıldı. (I9db52)
Yeni Özellikler
ExposedDropdownMenu
eklentisini özelleştirmek için parametreler eklendi. Özellikle, menülerde artık düzenlenebilir metin alanlarıyla çalışırkenfalse
olarak ayarlanması gereken birfocusable
parametresi (varsayılantrue
) bulunuyor. (I4184c, b/323694447, b/278609042)
API Değişiklikleri
ScaffoldSubcomposeInMeasureFix
işareti kaldırıldı. (Ie2a4b)NavigationRailItemColors
artık@Immutable
olarak işaretlendi. (If6112, b/327660613)NavigationBarItemColors
artık@Immutable
olarak işaretlendi. (I42a30, b/298064514)- Slider Track composable'daki parametreleri yeniden sıralayın. (I9f315)
ExposedDropdownMenu
, artıkPopup
kullanılarak uygulanır. Düzenlenebilir metin alanları içeren odaklanılabilir menüler klavyede yazarken kapatılabilir ancak bu davranış aynı olmalıdır.
Hata Düzeltmeleri
- Yüzey ve Yüzey container'ı referans rolleri, açık ve koyu temalarda daha fazla tonlama sağlamak üzere biraz düzenlenmiştir. (I677a5)
- Kaydırma çubuğu ve
ProgressIndicator
renkler, yeni Metin Olmayan Kontrast özelliklerine uyacak şekilde güncellendi. (I26807) - Yeterli renk kontrastı sağlamak için odak durumu yer paylaşımını 0,1f olarak güncelleyin. (I7ea77)
lightColorScheme
vedarkColorScheme
ürünlerinde yüzey ve arka plan rengi varsayılanlarında küçük ayarlamalar yapıldı. (I9db52)
Sürüm 1.3.0-alpha02
6 Mart 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
yayınlandı. Sürüm 1.3.0-alpha02 bu kaydetmeleri içerir.
API Değişiklikleri
- Kaydırma çubuğu durumları tekrar sabit hale getiriliyor.
State.onValueChangeFinished
değeri tekrar ayarlanıyor.onValueChangeFinished
,rememberUpdatedState
içinde sarmalanıyor. (I82ab2, b/322269951) - Gezinme bileşenleri artık yeni
SurfaceContainer
rollerini kullanıyor.DrawerDefaults
, artık farklıstandardContainerColor
vemodalContainerColor
özellikleri sunuyor.DrawerDefaults.ModalDrawerElevation
artık0.dp
. (I7fbac) state.onValueChangeFinished
değerinivar
olarak değiştirdiğimiz için@Stable
,Slider
durumlarından kaldırılıyor. (Ied34a, b/322269951)ModalBottomSheet
veStandardBottomSheet
animasyon spesifikasyonu artıkTweenSpec
olarak değiştirildi ve ilkbahardaki animasyondan güncellendi. Bu işlem, görünür bir aşırı çekim sorunu olan sorunu çözer. Desteği sonlandırılan ve yoğunluk bilgisi olmayanSheetState
oluşturucuları kaldırıldı. (I7babc, b/285847707)
Hata Düzeltmeleri
SurfaceContainer
varyant artık bileşenler tarafından kullanılıyor. Surface veTonalElevation
ile resmi olarak renk hesaplanan bileşenler, artık varsayılan olarakSurfaceContainer
rollerini kullanıyor ve bu roller ton yüksekliğinden etkilenmiyor. (b/304584161)ElevatedFilterChip
ürünü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 göstergesini düzelt (Id6582)
- RTL düzeninde (Iab0e1)
Slider
veRangeSlider
ile ilgili bir sorun düzeltildi - Kayan noktalı yuvarlama yanlış olabileceğinden kaydırma aralığı hesaplamasına
SliderRangeTolerance
eklenmesi. (Ic918a, b/324934900) - Bir
DateRangePicker
öğesini iç içe yerleştirirken veya daha büyük yazı tiplerine sahip küçük ekranlarda herhangi bir tarih seçiciyi gösterirkenDatePickerDialog
öğesinin düğmelerini gösterdiğinden emin olun. (Ie4758, b/325107799, b/277768544) Menu
, kapsayıcı rengi için artıkSurfaceContainer
rolünden yararlanıyor.MenuDefaults.TonalElevation
artık0.dp
. (I135b7)TextField
, kapsayıcı rengi için artıkSurfaceContainerHighest
rolünden yararlanıyor. (I4dced)- Yükseltilmiş çipler artık
SurfaceContainerLow
rolünden (I7cd2f) yararlanıyor DatePicker
kapsayıcı rengi artıkSurfaceContainerHigh
oldu.DatePickerDefaults.TonalElevation
artık0.dp
. (Ida753)- Alt Sayfalar kapsayıcı rengi ve sürükleme tutamacı rengi güncellenir. (I72a0a)
RichTooltip
kapsayıcı rengi artıkSurfaceContainer
oldu. (Ia8b45)SearchBar
kapsayıcı rengi artıkSurfaceContainerHighest
oldu.SearchBarDefaults.TonalElevation
artık0.dp
. (I88604)- Güncellemeler,
SurfaceContainerHighest
renk rolünden yararlanmak için devre dışı ve seçili olmayan parçalar/simgeler arasında geçiş yapar. (I7687a) AlertDialog
kapsayıcı rengi artıkSurfaceContainerHigh
oldu. (Ie0433)BottomAppBar
kapsayıcı rengi artıkSurfaceContainer
oldu.TopAppBar
onScroll
rengi artıkSurfaceContainer
. (I41630)ElevatedCard
kapsayıcı rengi artıkSurfaceContainerLow
oldu.FilledCard
adlı reklamın kapsayıcı rengi:SurfaceContainerHighest
. (I35141)ElevatedButton
kapsayıcı rengi artıkSurfaceContainerLow
oldu.FilledIconButton
öğesinin seçimi kaldırıldığında artık kapsayıcı rengiSurfaceContainerHighest
olur. (I792c9)TimePicker
kapsayıcı rengi ve saat kadranı rengi rolünüSurfaceContainerHighest
olarak günceller. (I43b93)
Sürüm 1.3.0-alpha01
21 Şubat 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
yayınlandı. 1.3.0-alpha01 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- U+'da Tahmini Geri'yi desteklemek için Oluşturma M3
ModalBottomSheet
sürümünü güncelleyin (Iccf32, b/281967264, b/304850357) - U+ sürümünde (I657f8) Tahmine Dayalı Geri'yi desteklemek için Oluşturma M3
SearchBar
sürümü güncellendi - Kaydırma çubuğu, bir boşluk ve durma göstergesi ekleyerek erişilebilirliği iyileştirmek için güncellendi. (I3058e)
- Boşluk ve durdurma göstergesi ekleyerek erişilebilirliği iyileştirmek için
ProgressIndicator
güncellendi. (I21451) - Zengin ipucu için varsayılan bir düzeltme işareti eklenen yeni zengin ipucu API'si, artık
LayoutCoordinates
bağlayıcısıyla özel düzeltme işareti çizilmesine olanak tanıyor. (Ifd42c)
Davranış Değişiklikleri
- Malzeme bileşenleri, yeni ripple API'lerini kullanmak için taşındı ve artık
RippleTheme
sorgusu gerçekleştirmiyor.
API Değişiklikleri
- Eğlenceli
drawStopIndicator
etkinliği artık herkese açık. (I3f59f) DatePicker
işlevininformatWithSkeleton
işlevini dahili (Ic65dc) olarak işaretleyinDropdownMenu
artık özel renk, şekil, yükseklik ve kenarlığı destekliyor. (I8e981, b/289554448, b/301887035, b/283654243)- API'lerinde
MutableInteractionSource
açığa çıkaran Material3 bileşenleri, artık varsayılan olaraknull
değerine sahip null değer içeren birMutableInteractionSource
gösterecek şekilde güncellendi. Burada herhangi bir anlamsal değişiklik yoktur: null değerinin geçirilmesi,MutableInteractionSource
öğesini kaldırmak istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Null değerine geçmek, bazı bileşenlerin hiçbir zaman birMutableInteractionSource
ayırmamasına izin verir ve diğer bileşenlerin yalnızca gerektiğinde geç bir şekilde örnek oluşturmasına olanak tanır. Böylece bu bileşenler genelinde performans artar. Bu bileşenlere ilettiğinizMutableInteractionSource
öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I41abb, b/298048146) - Sabit değerler kullanarak dalgaların bileşen başına / alt ağaç özelleştirilmesine olanak tanımak için
RippleConfiguration
veLocalRippleConfiguration
ekler. Örneğin, kontrol etmediğiniz bir bileşenin rengini değiştirmek veya bir bileşende dalgayı devre dışı bırakmak için kullanılır. Çoğu durumda varsayılan değerler kullanılmalıdır: Bu API'ler, bağımsız bileşenlerin / sınırlı alt ağaçların özelleştirilmesi için bir çıkış yoludur. Daha geniş kapsamlı değişiklikler ve özel tasarım sistemleri içincreateRippleModifierNode
kullanarak kendi dalganızı oluşturmanız gerekir. (I7b5d6, b/298048146) - Materyal3'e, desteği sonlandırılmış
rememberRipple
API'sinin yerini alan yeni ripple API'si ekler. Ayrıca, malzeme3 bileşenlerini kullanımdan kaldırılanrememberRipple
/RippleTheme
API'lerinin kullanımına geri döndürmek için geçici birCompositionLocal
,LocalUseFallbackRippleImplementation
ekler. Bu özellik bir sonraki kararlı sürümde kaldırılacaktır ve yalnızca özel birRippleTheme
sağladığınız durumlarda geçici bir taşıma yardımı sunmak için tasarlanmıştır. (I34cbc, b/298048146)
Hata Düzeltmeleri
- Performansı artırmak için
ModalBottomSheet
içindeki alt beste kaldırıldı.LookaheadScope
ile birlikte belirli senaryolardaModalBottomSheet
uygulamasının kilitlenmesine neden olan sorun düzeltildi. (I2a198) - Performansı artırmak için
BottomSheetScaffold
içindeki alt beste kaldırıldı.LookaheadScope
ile birlikte belirli senaryolardaBottomSheetScaffold
uygulamasının kilitlenmesine neden olan sorun düzeltildi. (Ie6401) - Rozet hizalaması, sağ üst köşeye göre sabit içeriğin ortasına daha yakın olacak şekilde ayarlanır. (I18a28)
- Ay-Yıl metin başlığının ekran okuyucu, anahtar erişimi ve sesli erişim kullanıcılarına işlem yapılabilir olarak sunulduğu
DateRangePicker
ile ilgili a11y sorunu düzeltildi. (I2ac55) mediumTopAppBarColors
parametre sırası hatası düzeltildi. (Ibe64a)
Sürüm 1.2
Sürüm 1.2.1
6 Mart 2024
androidx.compose.material3:material3-*:1.2.1
yayınlandı. Sürüm 1.2.1 bu taahhütleri içerir.
Hata Düzeltmeleri
- Kaydırma çubuğu durumlarını tekrar sabit hale getirin.
State.onValueChangeFinished
değeri tekrar ayarlanıyor.onValueChangeFinished
,rememberUpdatedState
içinde sarmalanıyor. (Ie8fd0, b/322269951) state.onValueChangeFinished
değerinivar
olarak değiştirdiğimiz için@Stable
,Slider
durumlarından kaldırılıyor. (I82ba1, b/322269951)- Varsayılanlardan kopyalanacak
NavigationBar
özel rengi düzeltin. (80a779, b/326894020) - Tekrar odaklanılabilir hale getirmek için
ExposedDropdownMenu
işlevindeki regresyonu düzeltin (3fcec1, b/323694447) - Düğme rengi önbelleğe alma sorununu düzeltme (3e5bbcb/327371655)
Sürüm 1.2.0
7 Şubat 2024
androidx.compose.material3:material3-*:1.2.0
yayınlandı. 1.2.0 sürümü bu kaydetmeleri içerir.
Bilinen Sorun
- Performans iyileştirme değişikliği kapsamında,
PrimaryTabRow
sürümünde View-Compose birlikte çalışabilirlik oluşturma hatası sunuldu. Geçici çözüm,TabRow
özelliğiniTabRowDefaults.PrimaryIndicator
ile kullanmaktır
1.1.0'dan bu yana önemli değişiklikler
Yeni Materyal Tasarım 3 Bileşenleri
- Yenilemek için çekin
- Segmentlere Ayrılmış Düğme
Mevcut Materyal Tasarım 3 bileşenlerinde yapılan geliştirmeler.
- Alt uygulama çubuğu (RTL hizalaması, kaydırma sırasında otomatik gizle)
- Sekmelerin görsel güncellemesi
- Rozet (hizalama güncellemesi)
Deneysel API'leri kararlı sürüme geçirdim.
Performans iyileştirmeleri
- Daha fazla bilgi için lütfen bu blog yayınına göz atın!
Sürüm 1.2.0-rc01
24 Ocak 2024
androidx.compose.material3:material3-*:1.2.0-rc01
yayınlandı. Sürüm 1.2.0-rc01 bu kaydetmeleri içerir.
Hata Düzeltmeleri
mediumTopAppBarColors
parametre sırası hatası düzeltildi. (Ibe64a)containerColor
parametre değerine dayanarakCardDefaults.cardColors
politikasında1.2.0-beta02
içinde karşılaşılan vecontentColor
değerini güncellemeyen bir hata düzeltildi. (Iee041, b/319671246)1.2.0-beta02
sürümünde tanıtılan birdisabledContentColor
hatası düzeltildi ve küçük optimizasyonlar eklendi. (I6dda1, b/318428829)
Sürüm 1.2.0-beta02
10 Ocak 2024
androidx.compose.material3:material3-*:1.2.0-beta02
yayınlandı. Sürüm 1.2.0-beta02 bu kaydetmeleri içerir.
Bilinen Hata
IconButtonColors
ürünündeki bir hata, varsayılan olarakdisabledContentColor
öğesini,LocalContentColor
tarafından belirtilencontentColor
yerine alfa (0.38f) sürümüne atar. Geçici çözüm,disabledContentColor
öğesinin açıkça ayarlanmasıdır. Bu sorun bir sonraki sürümde düzeltilecektir.
API Değişiklikleri
- Düz
Tooltip
API'leri için ipucu düzeltme işaretlerini etkinleştirme özelliği eklendi. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
veSwipeToDismissValue
,_SwipeToDismissBox_
olacak şekilde yeniden adlandırıldı. (I68d6d)
Hata Düzeltmeleri
- Spesifikasyonla uyumlu olacak şekilde
ListItem
bitiş dolgusu değeri düzeltildi. (Ibd68b, b/305342674) - Dış çizgili kartın dış çizgi rengi artık
OutlineVariant
ile doğru şekilde eşlendi. (I75480, b/310979715) - Dinamik renk artık sistem tarafından tanımlanan renk rollerinden alınıyor. Bu, erişilebilir içerik için kontrastı iyileştirir ve dinamik rengi Malzeme spesifikasyonuyla daha uyumlu hale getirir. (I1de96)
- Android T/13 ve sonraki sürümlerde
android:enableOnBackInvokedCallback="true"
olduğundaModalBottomSheet
geri işleme sorunu düzeltildi. (I728dc, b/306196110)
Sürüm 1.2.0-beta01
13 Aralık 2023
androidx.compose.material3:material3-*:1.2.0-beta01
yayınlandı. Sürüm 1.2.0-beta01 bu kaydetmeleri içerir.
API Değişiklikleri
TabIndicatorScope
adresini deneysel olarak işaretleyin. (I45c88)- İpucu için desteği sonlandırılmış deneysel API'ler kaldırılıyor. (I438cb)
- Yeni
TabRow
aşırı yüklemelerini, alt bileşimleri kullanmayacak şekilde değiştirin. Bu, özel değiştiricilerleTabRow
göstergelerinin oluşturulması için farklı bir yol sunar. (Ife741) DismissDirection
veDismissValue
API'lerini kullanımdan kaldırın. Bunlar, değerleriSwipeToDismissBox
öğesinin konumunu ve yönünü belirtenSwipeToDismissValue
ile birleştirildi.DismissState.progress
artık0.0
ile1.0
arasındaFloatRange
olarak işaretli. Desteği sonlandırılanDismissState
Tasarrufu ve Oluşturucu kaldırıldı.SwipeToDismiss
bileşeni, durum ve varsayılanlar nesnesi deneysel olarak işaretlendi. (Ib54f2)
Hata Düzeltmeleri
PullToRefresh
için varsayılan gösterge artık kesintisiz bir üçgen yerine açık bir ok ucudur. (I67be3)
Sürüm 1.2.0-alpha12
29 Kasım 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
yayınlandı. 1.2.0-alpha12 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
RangeSlider
artık Kotlin aralığı (ör.0f..1f
) inceleyebilirsiniz.FloatRange
SnapFlingBehavior.kt
artık Kotlin aralığı da kullanıyor. (I025cb)- Değiştirici 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
yayınlandı. Sürüm 1.2.0-alpha11 bu kaydetmeleri içerir.
Yeni Özellikler
- Birlikte Material3'teki yenileme için pull uygulaması sağlayan
PullToRefreshContainer
vePullToRefreshState
uygular. (I16456, b/261760718)
API Değişiklikleri
SwipeToDismissBox
DismissDirection
veDismissValue
öğelerini deneysel olarak işaretleyin. (I517b0)SwipeToDismiss
listesinin adınıSwipeToDismissBox
olarak değiştir.background
öğesinin adınıbackgroundContent
vedismissContent
öğesinin adını soncontent
lambda olarak değiştirin. (I7f4d3)ChipElevation
veSelectableChipElevation
için oluşturucuyu herkese açık hale getirin. (Ie0c48, b/308432421)ModalBottomSheetProperties
ekleniyor.securePolicy
,ModalBottomSheetProperties
hedefine taşınıyor.isFocusable
veshouldDismissOnBackPress
,ModalBottomSheetProperties
klasörüne ekleniyor. Bu yeni boole değerleri, kalıcı alt sayfanın IME etkinliklerini nasıl ele alması gerektiğini belirlemeye yardımcı olur. (Iea56f, b/278216859)initialOnValueChange
, ilk önekler ve uygun kdocs'ları kaldırmak içinRangeSlider
veSlider
durumları güncellendi. (I57d30)ChipBorder
sınıfını ve ilişkili işlev çağrılarını kullanımdan kaldırın. Bunun yerine doğrudanBorderStroke
kullanılmasını öneririz. (I89cc2)- Foundation Tooltip API'leri artık
@ExperimentalFoundationApi
oldu. (I30b0b) TabRow
veScrollableTabRow
desteği sonlandırıldı. Yeni Birincil ve İkincil varyantlar deneysel olarak işaretlenmiştir. (I0def6)- Filtre ve giriş çipleri artık doğrudan
BorderStroke
çiplerini kullanıyor. (I07a8d) SegmentedButton
, artık doğrudanBorderStroke
kullanıyor. (I89b9b)- Genel
AlertDialog
işleviBasicAlertDialog
olarak yeniden adlandırıldı ve önceki işlev kullanımdan kaldırıldı. (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
ekleniyor. Ayrıca, yanlışlıkla kararlı olarak yayınlandıkları içinTooltipBox
,PlainTooltip
veRichTooltip
API'leri tekrar deneysel sürüme taşınıyor. (If0f66, b/293939035) - Deneysel çip API'lerini kararlı sürüme geçirin. (Iea2c3)
- Material3 tıklanabilir kartlarından
@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I88dbf)
Hata Düzeltmeleri
- İç içe yerleştirilmiş Look ilerihead ve Geç düzenlerde
SwipeToDismiss
öğesinin belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (Ica8d1, b/297226562)
Sürüm 1.2.0-alpha10
18 Ekim 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
yayınlandı. 1.2.0-alpha10 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
Badge
veBadgedBox
sürümleri kararlı sürüme yükseltiliyor. (I67f16, b/261565132)- Kullanıcıların
WindowManager.LayoutParams.FLAG_SECURE
davranışını tanımlayabilmesi içinModalBottomSheet
parametresinesecurePolicy
parametresi ekleniyor. (Icdac8, b/296250262) progress
değerini lambda olarak alan yeniLinearProgressIndicator
veCircularProgressIndicator
aşırı yüklemeleri eklendi. Bu uygulamaların, önceki sürümlerden daha iyi performans göstermesi beklenir. (I824e6, b/295616656)StandardSizeClasses
listesinin adıAllSizeClasses
olarak değiştirilir. (I8cb07)- Pencere boyutu sınıflarının hesaplama fonksiyonlarını birleştirin. (Iad935)
Hata Düzeltmeleri
- Gösterilen ay izin verilen yıl aralığının sınırına ulaştığında gezinme ok düğmeleri hızlı bir şekilde tıklandığında
DatePicker
kilitlenmesi düzeltildi. (I46f36, b/290954897, b/297002119) - [Gezinme rayı/çubuk] Gösterge için şeffaf renk desteği. (Ie0a9b, b/267289987)
Sürüm 1.2.0-alpha09
4 Ekim 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
yayınlandı. Sürüm 1.2.0-alpha09 bu kaydetmeleri içerir.
API Değişiklikleri
- Yeni
AnchoredDraggable
API'lerini kullanmak içinModalNavigationDrawer
veDismissibleNavigationDrawer
taşındı.DrawerState
öğesininanimateTo
değeri, açma ve kapatma yöntemleriyle değiştirildi ve ofset artık durum nesnesi yerine kayan noktalı olarak gösteriliyor. Ofsete doğrudancurrentOffset
üzerinden erişebilirsiniz. (I0a72c) - Doğrudan
DatePickerState
veDateRangePickerState
oluşturmak için Oluşturulamayan işlevler eklendi. Bu işlevler, gerektiğinde OluşturulabilirrememberDatePickerState
verememberDateRangePickerState
işlevlerine alternatif olarak kullanılabilir. (I70326, b/291524052) - Sabit ve Kaydırılabilir
TabRows
artık Birincil ve İkincil varyantlarına sahip. Bunlar, Material3'te tanımlanan renk ve gösterge davranışıyla doğru şekilde eşlenir. PrimaryScrollableTabRow
veSecondaryScrollableTabRow
artık kaydırma durumunu gösteriyor. (Iec8f5, b/260572337)- Sayfanın kaplayacağı maksimum genişliği belirtmek için geliştiricilerin ayarlayabileceği yeni bir
sheetMaxWidth
parametresi ekleniyor. Dp.Ekran genişliğini tamamen kaplayan bir sayfa isteniyorsa parametre için belirtilmedi olarak aktarılabilir. (Ifb7c9, b/266697696) PlainTooltipBox
veRichTooltipBox
API'leri, kullanımdan kaldırılan yöntemler olarak yeniden ekleniyor. (I246fa)
Hata Düzeltmeleri
DatePicker
, tarih kalıplarına dönüştürüldüğünde (ör. YY) aynı kalan tarih iskeletlerine sahip birDatePickerFormatter
ile başlatıldığında meydana gelen kilitlenmeyi düzeltir. (I01f29)
Sürüm 1.2.0-alpha08
20 Eylül 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
yayınlandı. 1.2.0-alpha08 sürümü bu kaydetmeleri içerir.
Davranış Kırıcı Değişim
ColorScheme
artık sabit. özelliği sayesinde tek tek renk güncellemelerini daha az verimli hale getiriyor ve renklerin daha yaygın şekilde kullanılmasını daha verimli hale getiriyor. Bu değişikliğin nedeni, uygulamaların çoğunun ana kullanım alanı olarak renkleri ayrı ayrı güncellememesidir. Bu mümkün olsa da eskiye kıyasla daha fazla yeniden düzenleme yapmak mümkün. Bunun sonucunda, Materyal kodu ile durum aboneliği sayısını önemli ölçüde azaltacağız. Ayrıca, daha standart kullanım alanlarının başlatma işlemi ve çalışma zamanı maliyetini de etkileyecekler. (Ic447d, b/297212873)- Tonal Rakım, artık spesifikasyonla eşleşecek şekilde farklı etkileşim durumlarında canlandırılmıyor. (Icdd12)
API Değişiklikleri
- İçerik kaydırıldığında otomatik olarak gizlenmesi için
BottomAppBarScrollBehavior
parametresi olarak alan yeni birBottomAppBar
eklendi. AyrıcaFabPosition.EndOverlay
eklendi. Bu sayede FAB'nin, üstüne sabitlenmek yerine alt uygulama çubuğuyla yer paylaşımlı olarak sığması sağlanır. (Iecb47) - Etiket sınırlarının dışına dokunulduğunda kapanmayan ve
BasicTooltipBox
öğesinin üzerine kurulan 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 veya yerleştirme sırasında alt öğelerini ölçmesi gerekip gerekmediğini kontrol etmek için geçici bir işaretleme eklendi. Varsayılan olarak bu, ölçümde ölçülür. Yeni davranışla ilgili sorun yaşıyorsanız lütfen sorun bildirin. (I0b354)
- Cihaz ekran genişliği için doğru ölçüm kullanılarak
BottomSheet
cihazında yatay Kenardan Kenara sabitlendi. (I1df0c, b/299058752) ModalBottomSheet
ürününün, sayfayı aşağı kaydırarak kapatırkenonDismissedRequest
öğ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
yayınlandı. 1.2.0-alpha07 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
compose material 1.6.0-alpha05
sürümüne otomatik yansıtma simgeleri desteği eklendi. Otomatik yansıtma simgeleri hakkında ayrıntılı bilgi için lütfen sürüm notlarına bakın.
API Değişiklikleri
SliderState
,DraggableState
öğesini (I9b116) uygular- Şekli gerekli bir parametre olacak şekilde değiştirin. Şekil yardımcı işlevinde
position
öğesiniindex
olarak yeniden adlandırın. (I34941) DatePicker
formatWithSkeleton
özelliğini, performans iyileştirmeleri için önbellek olarak kullanılan bir haritayı içerecek şekilde günceller. (I3195f)BasicTooltipBox
,compose.foundation
paketine eklendi vePlainTooltipBox
ileRichTooltipBox
,TooltipBox
öğeleri yeniPlainTooltip
veRichTooltip
composable'larla kullanılacak şekilde güncellendi. (I79e1d)
Hata Düzeltmeleri
dynamicLightColorScheme
vedynamicDarkColorScheme
artık yüzey vesurfaceContainer
rolleri için daha yüksek renk renkleri döndürüyor. (I5e901)LookaheadScope
içindeki bir Yapı İskelesi içinde Alt Bileşimi kullanan bazı bileşenlerin (ör.BottomSheetScaffold
) boyutlarını çok erken okumaya çalışmasıyla ilgili sorun düzeltildi. (I297b4, I871f1, b/295536718)
Sürüm 1.2.0-alpha06
23 Ağustos 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
yayınlandı. 1.2.0-alpha06 sürümü bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Menü ekranın alt kısmına yakın olduğunda x ofsetlerinin yalnızca yerel düzen yönüne bağlı olması ve y ofsetlerinin artık geri alınmaması için
DropdownMenu
ürünününoffset
hesaplaması düzeltildi. (Iccc74, b/294103942) - Menü ekranın alt kısmına yakın olduğunda x ofsetlerinin yalnızca yerel düzen yönüne bağlı olması ve y ofsetlerinin artık geri alınmaması için
DropdownMenu
ürünününoffset
hesaplaması düzeltildi. (Ib87a2, b/294103942)
Sürüm 1.2.0-alpha05
9 Ağustos 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
yayınlandı. 1.2.0-alpha05 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Onay kutusu ve
TriStateCheckbox
renklerde yapılan 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 dahili kutu rengini ayarlamanızı gerektiren özel durumlarda, istenen renk değerlerine sahip özel olarak oluşturulmuş birCheckboxColors
örneği gerekir. (I77d17, b/291943198)
Sürüm 1.2.0-alpha04
26 Temmuz 2023
androidx.compose.material3:material3-*:1.2.0-alpha04
yayınlandı. 1.2.0-alpha04 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Deneysel Segmentlere Ayrılmış Düğme API'si (Ifc8fb)
- Ayırıcılar, artık dikey ayırıcıları desteklemek üzere yönü kontrol eden bir parametreye sahiptir. (I4c899, b/288438593)
API Değişiklikleri
- Yoğunluk bağımlılığını bileşen düzeyine taşıyoruz. Bu, şu bileşenler için geçerlidir:
SwipeToDismiss
ve e-tablo tabanlı bileşenler. Lütfen yoğunluk parametresi olan, sağlanan yeni aşırı yükü kullanın. (I1846e) - composable'lar için izin verilen girişleri belirtmek amacıyla ek ek açıklamalar (Ief234)
- Bölümlendirilmiş düğmeye bir simge parametresi ekleyin, segmentlere ayrılmış düğmelerin tekli seçim uygulamak üzere seçilebilmesini ve çoklu seçimin
SelectableSegmentedButtonRow
veToggelableSegmentedButtonRow
ile uygulanmasını sağlamak için segmentlere ayrılmış düğmelerin anlamlarını ayırın. (I38740) - Ayırıcı,
HorizontalDivider
olarak yeniden adlandırıldı.VerticalDivider
işlevi eklendi. (I5975c) - Otomatik kutulamayı en aza indirmek amacıyla, deneysel Material3 API'lerinde daha hafif
FloatRange
içinClosedFloatingPointRange
kullanımını değiştirin. (I4aab5) FabPosition
için yeni Başlangıç hizalaması eklendi (Ib7aea, b/170592777)
Hata Düzeltmeleri
ModalBottomSheet
, yerel düzen yönüne uyar. (Ib4f44, b/285628622)
Sürüm 1.2.0-alpha03
21 Haziran 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
yayınlandı. 1.2.0-alpha03 sürümü bu kaydetmeleri içerir.
Davranış Değişiklikleri
includeFontPadding
artık Materyal 3 tipografisinde varsayılan olarakfalse
oldu. Varsayılan satır yüksekliği stili deTrim.None
veAlignment.Center
olarak değiştirildi. AyrıcaTypography
öğesininTextStyle
öğelerine açıkçalineHeight
(sp cinsinden) eklendi. Bu değerleri özelleştirmek isterseniz API belgelerine bakın ve bu değişiklikleri ayrıntılı bir şekilde açıklamak için blog yayınını inceleyin. (I6266f, Icabc3)
Yeni Özellikler
- Bileşenin durum bilgili sürümü olan
RangeSlider
için aşırı yükleme eklendi. Mevcut etkin kanala ait tüm bilgileri,RangeSlider
bileşenlerinin ölçümlerini, sürükle ve hareket mantığını barındıranRangeSliderState
oluşturuldu. (I8c270) - Arama çubuğu artık yeni eklenen
shadowElevation
parametresi üzerinden gölgeleri destekliyor. (Ia5369, b/271040353) ColorScheme
artık yeniSurfaceContainer
rollerini destekliyor.- Yüzey ton yüksekliği yer paylaşımı, artık yerel
LocalTonalElevationEnabled
bileşimiyle devre dışı bırakılabilir. (Ic203c, b/277774590)
API Değişiklikleri
- Bileşen renkleri oluşturucularını açın. (I8c4a6)
- Geliştiricilerin, ipucunun dokunma etkinliklerini kullanıp kullanmamasını sağlamak için her iki ipucu API'sine de odaklanılabilir parametre ekleme. Bu durumun, erişilebilirlik odağının otomatik geçişini kesintiye uğratabileceğine dikkat edin. (Ie32d8)
- Performans ve bellek ayırmaları için optimize edilmiş erişilebilirlik. (Iede48)
DefaultSizeClasses
özelliğini kullanıma sunun veWindowSizeClasses
(I91838) içinStandardSizeClasses
oluşturun.WindowWidth/HeightSizeClass
değerini kayan değer sınıflarıyla değiştirin (Ie686e)
Hata Düzeltmeleri
- İskelenin
contentWindowInsets
parametresi artık tüketilen pencere iç içe aktarmalarına uyuyor. Bu parametreler sağlandığında,topBar
vebottomBar
'a göre içerik dolgusu davranışının değişmediğini unutmayın. (I08b73, b/264601542) - İşlem simgelerinin veya gezinme simgesinin üzerinde uzun bir başlığın görüntülenmemesi için orta üst uygulama çubuğunun hizalamasını düzeltin. (I4369f, b/236994621)
- Sekme konumları için artık minimum 24.dp içerik genişliği uygulanmaktadır. Bu, sekme göstergeleri için erişilebilir bir dokunma hedefi sağlar. (Id8861)
dynamicLightColorScheme
vedynamicDarkColorScheme
ürünlerindeki dinamik renk paletleri artık yeni yüzey rollerini destekliyor. (I1252e)- Rozet bildirimi hizalaması büyük büyükanne veya büyükanne ile çakıştığında kırpılmayacak şekilde güncelleniyor. (Idf75a)
Sürüm 1.2.0-alpha02
24 Mayıs 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
yayınlandı. 1.2.0-alpha02 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
ModalBottomSheet
öğesine pencere iç içe aktarma parametresi ekleyin.ModalBottomSheet
için Scrum,windowInsets
sıfıra ayarlanmış bir şekilde durum çubuğunun gerisinde çizilebilir- Gezinme de dahil olmak üzere sistem çubuklarının dışında kalacak şekilde varsayılan
ModalBottomSheet
işlevi güncellendi - Durum çubuğu iç içe aktarma işlemi, uçtan uca modda sürükleme tutamacıyla sağlanır.
BottomSheetDefaults
,BottomSheetWindow
için pencere eklerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/264)b/265
Indicator
desteğini sonlandırın ve M3 özellikleriyle eşleşecek şekildePrimary
/SecondaryIndicator
ekleyin.PrimaryIndicator
sekme içeriğinin genişliğiyle eşleşir,SecondaryIndicator
ise mevcut tüm genişliği kaplar.SecondaryIndicator
, desteği sonlandırılanIndicator
ile eşdeğerdir ve doğrudan bunun yerine kullanılabilir. (I27604)- Görüntülenen menü öğelerinin dikey kaydırma durumunu kontrol etmek için
DropdownMenu
veyaExposedDropdownMenu
oluştururkenScrollState
içinde geçiş yapma seçeneği eklendi. (Ia0734, b/185304441) - Bileşenin durum bilgili sürümü olan
Slider
için aşırı yükleme eklendi. Mevcut etkin kanala ait tüm bilgileri,Slider
bileşenlerinin ölçümlerini, sürükle ve hareket mantığını barındıranSliderState
oluşturuldu. (I124a5) isContainer
anlamsal özelliğiisTraversalGroup
(I121f6) olarak yeniden adlandırılıyor- Tam parametre listesiyle optimize edilmiş
TextStyle.merge(...)
eklendi. (Iad234, b/246961787) TooltipState
,RichTooltipState
vePlainTooltipState
herkese açık arayüz oluşturuldu. Varsayılan durumlar içinRichTooltipStateImpl
vePlainTooltipStateImpl
eklendi. Uygulanan bu durumları elde etmek içinremember*State
işlevleri eklendi.TooltipDefault.GlobalMutatorMutex
adınaTooltipSync
kaldırıldı. (I7813d)DatePickerColors
; tarih seçici ayırıcı, gezinme ve metin giriş alanı renkleri için ek özelleştirme seçenekleri içerecek şekilde güncellendi. (I1a685, b/274626815)DatePickerState
veDateRangePickerState
artıkrememberDatePickerState
verememberDateRangePickerState
tarafından alınabilen varsayılan uygulamalara sahip herkese açık arayüzlerdir. (I71c52)DatePicker
veDateRangePicker
ürünlerindendateValidator
kaldırıldı ve kullanıcı arayüzünde hangi tarihlerin veya yılların seçilebileceğini kontrol etmek için durumda ayarlanabilecek birSelectableDates
arayüzü kullanıma sunuldu. (Ic2fc6)TimePicker
, kararlı API'den kaldırıldı. Durum API'sinde (I3f39a) daha fazla değişiklik yapılması bekleniyorModalBottomSheet
yalnızca Android'e taşındı.ModalBottomSheet
, masaüstü kullanımı için önerilmez ve işlevselliği etkin bir şekilde korunmaz. (Ib3778)
Hata Düzeltmeleri
- İşlemler iletişim kutusunun genişliğine sığacak şekilde birbirinin üzerine yığıldığında
AlertDialog
kapatma işlemi, onaylama işleminin altında görünecek şekilde düzeltildi. Bu düzeltme, uygulamanın Materyal Tasarım spesifikasyonuyla uyumlu olmasını sağlar. (I029de, b/235454277) - Üç satırlı öğeler için yanlış dolgu kullanan
ListItem
hatası düzeltildi. (I6e235) ModalBottomSheet
artık IME klavyesini (Idc508, b/262140644, b/268380384, b/272483584) görüntüleyebilir.
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
serbest bırakıldı. Sürüm 1.2.0-alpha01 bu kaydetmeleri 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
serbest bırakıldı. Sürüm 1.1.2 bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Değiştiricinin iki composable'a yanlış şekilde geçirilmesi sorunu düzeltildi. (b/282761472)
- Düzeltilmiş
TimePickerState
, 23 saat ile başlatıldığında yanlış saat döndürür. (b/278242122) - Öğle ve dakika doğrulaması için ilk açma/kapatma durumu düzeltildi. (b/269768197, b/282790635)
state.hour
işlevinin 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
serbest bırakıldı. Sürüm 1.1.1 bu kaydetmeleri içerir.
Hata Düzeltmeleri
- İkili program uyumluluğu için
windowInset
parametresi olmadanModalBottomSheet
çağrısı ekler. (Ib7959) ModalBottomSheet
öğesine pencere iç içe aktarma parametresi ekleyin.ModalBottomSheet
için Scrum,windowInsets
sıfıra ayarlanmış bir şekilde durum çubuğunun gerisinde çizilebilir- Gezinme de dahil olmak üzere sistem çubuklarının dışında kalacak şekilde varsayılan
ModalBottomSheet
işlevi güncellendi - Durum çubuğu iç içe aktarma işlemi, uçtan uca modda sürükleme tutamacıyla sağlanır.
BottomSheetDefaults
,BottomSheetWindow
için pencere eklerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/264)b/265
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
serbest bırakıldı. 1.1.0 sürümü bu kaydetmeleri içerir.
1.1.0'ın temel özellikleri
Yeni Materyal Tasarım 3 bileşenleri
Mevcut Materyal Tasarım 3 bileşenlerinde yapılan geliştirmeler.
Deneysel API'leri kararlı sürüme geçirdim.
Daha ayrıntılı bilgi edinmek 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
serbest bırakıldı. Sürüm 1.1.0-rc01 bu kaydetmeleri içerir.
API Değişiklikleri
TimePicker
, kararlı API'den kaldırıldı. Durum API'sinde (I3f39a) daha fazla değişiklik yapılması bekleniyorModalBottomSheet
yalnızca Android'e taşındı.ModalBottomSheet
, masaüstü kullanımı için önerilmez ve işlevselliği etkin bir şekilde korunmaz. (Ib3778)
Sürüm 1.1.0-beta02
5 Nisan 2023
androidx.compose.material3:material3:1.1.0-beta02
ve androidx.compose.material3:material3-window-size-class:1.1.0-beta02
serbest bırakıldı. Sürüm 1.1.0-beta02 bu kaydetmeleri 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 varsayılan olarak devre dışı bırakılsa da tanımlı bir Gizli sabite sahipSheetState.requireOffset
belgeleri 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 değiştirmeyin. (I717d0)
ModalBottomSheet
veBottomSheetScaffold
sürükleme tutamacı anlamları birleştirildi. (I05afb)BottomSheetScaffold
değiştiricisi,containerColor
vecontentColor
parametreleri artık yalnızca içerikleri etkiliyor. (I992cb)- Sayfa içeriği için
BottomSheetScaffold nestedScroll
artık hızlı kaydırmalar uyguluyor. (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
serbest bırakıldı. Sürüm 1.1.0-beta01 bu kaydetmeleri içerir.
API Değişiklikleri
TimePicker
composable'a düzen türü parametresi ekle. Ekran yapılandırmasına bağlı olarak farklı düzenler kullanılmasına olanak tanır (Ia0e16)SearchBarDefaults
, deneysel olarak işaretlendi. (I65561)BottomSheetScaffold
değerine gölge yüksekliği eklendi (I94e0f)- Tarih seçicileri başlık bölümü olmadan görüntüleme desteği eklendi. Tarih seçici oluşturulurken boş başlık iletmeye olanak tanıyan API değişiklikleri. Gözetimsiz seçici görüntülemek için artık boş başlık, başlık ve
showToggleMode = false
iletebilirsiniz. (Id3f3a, b/266132421, b/267194809)
Hata Düzeltmeleri
- Arama çubukları devre dışı bırakıldığında artık odağı otomatik olarak temizliyor. (I22a7c, b/261444487)
DateRangePicker
, başlangıç ve bitiş tarihleri aynı olan bir aralığın seçilmesine izin verecek şekilde güncellendi. (I16529, b/272882497)- Metin alanları, artık yazı tipi boyutu beklenenden küçük olduğunda metin öğelerini düzgün konumlandırıyor. Bu durum, yazı tipi ayarlarına ve komut dosyasına bağlı olarak uygulamalarınızda birkaç piksel değişikliğine neden olabilir. (I8b8d0)
- Alt sayfa semantik işlemlerinde artık etiketler var. (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
serbest bırakıldı. 1.1.0-alpha08 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
BottomSheetScaffold
veBottomSheetScaffoldState
için destek eklendi. (I063d4)
API Değişiklikleri
- Eyaletin ilk oluşturulmasından sonra tarihlerin ayarlanmasına olanak tanımanın yanı sıra boş zaman damgaları ayarlayarak seçimleri sıfırlamaya olanak tanıyan
DatePickerState
veDateRangePickerState
işlevleri eklendi. Tarihleri manuel olarak ayarlamak dikkatli bir şekilde yapılmalıdır. Ayrıca, sağlanan bir tarihin bir ön koşulda başarısız olması durumunda yenisetSelection
işlevi istisna atar (belgelere bakın). (Ifa645, b/268609314, b/270427389) - Bu durumdaki davranışı daha doğru ve esnek bir şekilde göstermek için Daraltılmış
SheetValue
özelliğiniPartiallyExpanded
olarak yeniden adlandırın. (Ia1491) ListItem
parametre adları _text yerine _content olarak güncellendi. Varsayılan alıcılar, uygun olduğu durumlarda artıkReadOnlyComposables
. (I69a25)- Deneysel sürümden etkileşimli Surface API'lerini kullanın. (I90d59, b/261561812)
Hata Düzeltmeleri
ModalBottomSheet
adlı öğrencininHalfExpanded
durumunun yanlış hesaplanmasına ve sayfanın kayan gibi görünmesine neden olan sorun düzeltildi. (I45e84, b/268411386)ModalBottomSheet
için dokunmaya dokunmak içinconfirmValueChange
işareti ekleyin. (I2311a, b/270425759)- Tutamacı sürüklemek için anlamsal
BottomSheet
işlemlerini taşıyın. (I158ba) ModalBottomSheet
artık başlatmaya odaklanır, geri düğmesini işler. (I4d2ab)ModalBottomSheet onDismissRequest
, artık iç içe yerleştirilmiş 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
serbest bırakıldı. 1.1.0-alpha07 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
rememberTimePickerState()
ile çalışan bir Zaman Girişi composable'ı ekleyin. Bu composable, zaman girişi için M3 spesifikasyonuna (Ia4fab) uyar.- Tarih aralığı seçmek için Material 3
DateRangePicker
API 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ştirmeye olanak tanıyor:
- Odak ve hata durumuna dayalı giriş alanı ve yer tutucu metin renkleri.
textColor
parametresiunfocusedTextColor
,placeholderColor
parametresi iseunfocusedPlaceholderColor
olarak yeniden adlandırıldı. - Yeni
errorContainerColor
parametresiyle birlikte hata durumuna göre doldurulmuş metin alanlarının kapsayıcı rengi.
- Odak ve hata durumuna dayalı giriş alanı ve yer tutucu metin renkleri.
- Gösterilen açılır menünün metin alanı renkleri, yeni önek ve sonek API'sini desteklemek için parametrelerle güncellendi. (I9c8b4, b/254284181, b/264766350)
API Değişiklikleri
- Bazı Slider API sürümleri geri döndürülüyor ve özel küçük resim ve izleme işleviyle yeni deneysel kaydırma çubuğu tarafından kapsanan gereksiz Slider aşırı yüklemeleri kaldırılıyor.
RangeSlider
, kararlı olarak yükseltiliyor. (Ie8fbd) - Çipin yükseltme işlevlerinde
defaultElevation
,elevation
olarak yeniden adlandırıldı. (I0f872) - Şu Materyal 3 metin alanı API'leri artık deneysel değil:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. (Ieb5c0, b/261561819) TimePickers
is24Hour
, sistem ayarını (I18856) kullanıyor- Deneysel ek açıklama, iskele API'lerinden kaldırıldı. (Ibb51e, b/261565765, b/261436953)
Hata Düzeltmeleri
ModalBottomSheet
varsayılan şekli artık her zamanSheetDefaults.ExpandedShape
oldu. (I0dfca)- Materyal 3
DatePicker
veDateRangePicker
için erişilebilirlik iyileştirmeleri. (I5087e) - Maksimum yükseklik kısıtlamasının yayıldığı ve kilitlenebileceği hata düzeltildi. (I30d8c)
- Tıklanabilir ve seçilebilir yüzeylerden anlamsal roller kaldırıldı, değiştirici.semantiği kullanarak rolleri ayarlamak için bunları kullanan bileşenler 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
serbest bırakıldı. 1.1.0-alpha06 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Metin alanları artık ön ek ve son eki (Ia8578, b/179884561) destekliyor
TimePickerState
ve kolaylık yöntemirememberTimePickerState
(I71910) ile birlikte kullanılan, Materyal 3 spesifikasyonuna uygun bir zaman seçiciyi göstermek içinTimePicker
işlevi eklendiDatePicker
konumunda tarih girişi artık görüntüleme modu oldu. Tarih seçici ve tarih giriş modları arasında geçiş yapma desteği eklendi. (Ieeff7)RichTextTooltips
için API eklendi. (I58ef3)ModalBottomSheet
veModalBottomSheetDefaults
dahil olmak üzere Materyal 3 için kalıcı alt sayfa uygulaması. Ayrıca, gelecekteki e-tablo bileşenleri için kullanılabilecekSheetState
verememberSheetState
özelliklerini de sunar. (I0853a, b/244189383)
API Değişiklikleri
- API'yi sabitleyin
showSnackbar
(I195c2, b/261424370) - Yardım çipi ve öneri çipi için API'leri sabitleyin (Ibb67b, b/261424370)
- Deneysel olmayan uygulamalara
ListItem
,ListItemDefaults
veListItemColors
API'yi tanıtır (I7e7fa, b/261438882) SliderPositions
,SliderDefaults.Thumb
veSliderDefaults.Track
, kararlı sürüme yükseltiliyor ve deneysel olmayan, özel küçük resim ve parça içerenSlider
veRangeSlider
API'leri ekleniyor. Ayrıca, öncekiSlider
veRangeSlider
API'leri de kullanımdan kaldırılıyor. (Ie5ea6, b/261566890)Modifier.tooltipAnchor()
herkese açık hale getirildi. Böylece geliştiriciler, uzun basıldığında bir ipucunun görüntülenmesi gerektiğini belirtmek için bunu bağlantıya iletebilirler.PlainTooltipBox
API'si,TooltipState
artık boş değer atanmayacak ve varsayılan değerine sahip olacak şekilde güncellendi. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColor
, tutarlılık için@Composable
olarak işaretlendi. (Id29cc)LocalMinimuTouchTargetEnforcement
özelliği geri yüklendi, desteği sonlandırıldı olarak işaretleyin veLocalMinimumInteractiveComponentEnforcement
adresine yönlendiriliyor. (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
serbest bırakıldı. 1.1.0-alpha05 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
DatePickerDialog
ve erişilebilirlik desteğiRangeSlider
koleksiyonuna Özel küçük resim ve parça eklendi.
Bağımlılık Güncellemeleri
Compose UI
veCompose Material
artık Yaşam Döngüsü 2.6.0'ı kullanıyor.
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
serbest bırakıldı. 1.1.0-alpha04 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Takvim kullanıcı arayüzü aracılığıyla tek bir tarih seçmek için ilk
DatePicker
API. Bu API'de hâlâ değişiklik yapılıyor. (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
- Platformlarda
IsContainer
anlamsal özelliğine eklendi. Bu özellik, yüzeyler gibi öğelerin anlamlarına dayalı olarak geçiş sırasını belirleyen daha sonraki bir değişiklikte kullanılacaktır. (I63379) - Gezinme çekmecesiyle ilgili API'leri kararlı olarak işaretleyin. (Iab01e, b/261439597)
- Dairesel ilerleme göstergeleri için bir parkur rengi parametresi, hem dairesel hem de doğrusal ilerleme göstergeleri için bir çizgi sınırı parametresi eklendi. (Ie668c, b/216325962, b/222964817)
- Desteği sonlandırılan gizli işlevlerin (Ibf7b0) daha fazla dönüş türü null değeri
Modifier.minimumInteractiveComponentSize
ekleyin. Öğe daha küçükse dokunma etkileşimlerini netleştirmek için en az 48 dp boyutunda ayırmak amacıyla kullanılabilir. (I33f58, b/258495559)AlertDialog
composable için içerik alanı olan deneysel API eklendi. (Iec4a2)
Hata Düzeltmeleri
- İlerleme göstergeleri için ilerleme durumu, artık beklenen aralığa doğru şekilde sınırlandı. (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üncellerkenjava.lang.NoSuchFieldError
hatasıyla karşılaşabilirsiniz. Sorun ilk olarak burada bildirilmiştir. Bir düzeltme gönderildi. Bir sonraki Oluştur güncellemesinde kullanıma sunulacak. Geçici bir çö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ü 1.4.0-alpha03 sürümüne geçirin.
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
serbest bırakıldı. 1.1.0-alpha03 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
consumedWindowInsets()
öğesiconsumeWindowInsets()
vewithConsumedWindowInsets()
olarak yeniden adlandırılıponConsumedWindowInsetsChanged()
olarak değiştirildi ve Değiştiriciler herkese açık hale getirildi. (Ie44e1)- Simge içeren metin düğmesi için yeni varsayılan içerik dolgusu ekleyin. (I8f662)
- Gezinme çubuğu ve reklam sütunu için devre dışı bırakılan renkler eklendi. (Ia7892, b/258867034)
- Üst öğelerin kaydırma bilgilerini sorgulamak için Değiştirici API eklendi. (I2ba9d, b/203141462)
- Hareketler kaydırma etkinliklerine dönüştüğünde, basma etkileşimlerini doğru şekilde ertelemek için
Clickable
ürününde kullanılır. Clickables
öğesinin,Scrollable ViewGroup
içinde kullanıldığında dalgaları doğru şekilde geciktirmemesi düzeltildi.- Hareketlerin kaydırma etkinliklerine dönüşmesi durumunda basmaları doğru şekilde geciktirmek için Çekmeceler ve E-Tablolar güncellendi.
Bağımlılık Güncellemeleri
Compose UI
veCompose Material
artık Yaşam Döngüsü 2.5.1'i kullanıyor. (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
serbest bırakıldı. 1.1.0-alpha02 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Daha fazla esneklik için
awaitFirstDown
vewaitForUpOrCancellation
artıkPointerEventPass
kabul ediyor (ayrıcaExposedDropdownMenuBox
kaydırma sırasında menünün gösterilmesiyle ilgili düzeltme).(I7579a, b/212091796) - Malzeme ve malzeme3 Metin,
TextField
veOutlinedTextField
özelliklerineminLines
parametresi eklendi. Bu parametre, satır sayısı açısından bileşenin minimum yüksekliğinin ayarlanmasına olanak tanır (I4af1d) TopAppBar
oluşturulurken kullanılması gereken yeni birtopAppBarColors
işlevi içinTopAppBarDefaults smallTopAppBarColors
işlevini kullanımdan kaldırın. (Ie6cb9)BasicText
veBasicTextField
bölümlerineminLines
parametresi eklendi. Bu composable'ların minimum yüksekliğinin ne kadarının satır sayısı (I24294, b/122476634)
Hata Düzeltmeleri
- Bir Material3
IconButton
veIconToggleBotton
içeriğini, bileşenin durum katmanı şeklinde (ör. yuvarlak şekil) kırpın. (I9da8f) - Tüm yüzeye aynı arka plan rengini uygulamak ve şeffaf renk değerleriyle varsayılan renklerin geçersiz kılınmasına izin vermek için Malzeme3 Orta ve Büyük üst uygulama çubuklarını 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
serbest bırakıldı. Sürüm 1.1.0-alpha01 bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Başlık, TextStyle ve Fırça ile uygulandığında üst uygulama çubuğunda 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
serbest bırakıldı. Sürüm 1.0.1 bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Tüm yüzeye aynı arka plan rengini uygulamak ve şeffaf renk değerleriyle varsayılan renklerin geçersiz kılınmasına izin vermek için Malzeme3 Orta ve Büyük üst uygulama çubuklarını 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
serbest bırakıldı. 1.0.0 sürümü bu kaydetmeleri içerir.
1.0.0'ın temel özellikleri
Bu, Compose Material 3'ün ilk kararlı sürümüdür.
Materyal Tasarım 3 teması ve Material You dinamik rengi
Materyal Tasarım 3 bileşenleri
- Rozet
- Alt Uygulama Çubuğu
- Düğmeler
- FAB ve genişletilmiş FAB
- Kartlar
- Onay kutusu
- Yongalar
- Diyaloglar
- 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
- Değiştir
- Sekmeler
- Metin Alanları
- Üst uygulama çubuğu
- Simge
- Kısa mesaj gönder
- Platform
- Düzen
- İçerik rengi
- LocalContentColor (Yerel İçerik Rengi)
Pencere Boyutu Sınıfı
material3-window-size-class
, yeniden boyutlandırılabilen uygulama düzenlerini tasarlamanız, geliştirmeniz ve test etmeniz için pencere boyutu sınıflarını destekleyen yeni bir kitaplıktır. Bir pencere boyutu sınıfı örneği almak içincalculateWindowSizeClass
kullanabilirsiniz. Bu örneği, daha büyük pencere boyutları için alt gezinme yerine gezinme çubuğu yerine kullanıcı arayüzünün nasıl görünmesi gerektiğini belirlemek için kullanabilirsiniz. Daha fazla bilgi ve örnek kullanım içinWindowSizeClass
ile ilgili API referans dokümanlarını inceleyin.Daha ayrıntılı bilgi edinmek 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
serbest bırakıldı. Sürüm 1.0.0-rc01 bu kaydetmeleri içerir.
API Değişiklikleri
- Metin alanı API'sine destekleyici metin için alan 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
serbest bırakıldı. Sürüm 1.0.0-beta03 bu kaydetmeleri içerir.
API Değişiklikleri
ExposedDropdownMenuDefaults
artık menü öğeleri için dolgu değeri gösteriyor. (I34ee1)ExposedDropdownMenuBoxScope
artık doğru a11y davranışı için metin alanına iletilmesi gereken birModifier.menuAnchor()
değiştiricisine sahip. (I27fa3)- Mevcut Slider API'ye, kullanıcıların kaydırma çubuğunu doldurmak üzere bir başparmak veya parça iletebilmesi için iki aşırı yükleme yöntemi ekleniyor. (I21c00)
Hata Düzeltmeleri
- Hata Kapsayıcısı'nda ton 90 (Ic5612) için koyu tema renk eşlemesi güncellendi
- Küçük Material 3 üst uygulama çubuklarında şeffaf arka plan ayarlamaya izin vermek için sorunları giderin. (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
serbest bırakıldı. Sürüm 1.0.0-beta02 bu kaydetmeleri içerir.
API Değişiklikleri
- Beta01 sürümündeki m3 bileşenlerinde sunulan varsayılan bileşen ekleri artık IME eklerini dikkate almamaktadır.
- Malzeme3 İskele bileşeni artık, içerik alanı için işlenecek ek öğe miktarının belirtilmesine olanak tanıyan bir
contentWindowInsets
parametresine sahip. (Icf11a, b/243713323) - Deneysel Material 3
SmallTopAppBar
işlevini kullanımdan kaldırır ve eşdeğerTopAppBar
işlevini kullanıma sunar. Lütfen hale getirebilirsiniz. (I74404, b/226918634) - Üst uygulama çubuğu hızlıca kaydırma ve tutturma davranışları üzerinde kontrol ekler. (I15c81)
- Bölen'deki startIndent değerini kaldırır, rengi son parametreye taşır. (If7be2)
Hata Düzeltmeleri
- İletişim Kutularının, kullanıcılar gösterildiğinde "Dialog" kelimesini duyurarak 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
serbest bırakıldı. Sürüm 1.0.0-beta01 bu kaydetmeleri içerir.
API Referansı
En yeni tema, bileşen ve diğer composable'ları görmek için Compose Material 3 API referansına genel bakış bölümüne göz atın.
API Değişiklikleri
- Material 3 üst uygulama çubuğu, tamamen daraltılmış duruma gelecek şekilde güncellendi. Ayrıca,
TopAppBarDefaults
davranış işlevi Özelleştirilebilir olarak güncellendi ve üst uygulama çubuğu durumu ile animasyon özellikleri için varsayılan değerler sağlandı. (I642b3) - FAB bileşeni imzaları, yüzey API'siyle (I3afaa) eşleşecek şekilde güncellendi
- Üst uygulama çubukları, çekmeceler, gezinme çubuğu ve ray için yerleşik destek eklendi. Bu bileşenler, ayrı olarak veya İskele ile birlikte kullanıldığında inset öğelerini geliştiriciler için otomatik olarak işler. Not: Bu değişiklik, durum çubuğu simgelerinin otomatik olarak işlenmesini ve durum ile gezinme çubuklarının şeffaflığını eklemez. En iyi uçtan uca deneyim için lütfen bu işlemi 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 içinde tutarlılığı korumak için yeniden sıralanan çip ve gezinme çekmecesi sayfası parametreleri (I45d0b)
startIndent
, Bölen'den kaldırıldı ve renk son parametre olacak şekilde taşındı.(If7be2)
Sürüm 1.0.0-alpha16
10 Ağustos 2022
androidx.compose.material3:material3:1.0.0-alpha16
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
serbest bırakıldı. 1.0.0-alpha16 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Gezinme çekmecesinde özel genişlik belirtme desteği. (Ia7f10)
API Değişiklikleri
- API içinde tutarlılığı korumak için sekme ve lider simge sekme parametrelerini yeniden sıralama (Ie2637)
BadgeDefaults
, deneysel olarak işaretlendi. (I98ef3)- Desteği sonlandırılan gezinme çekmecesi işlevini kaldırın. (I4f2db)
- API (I0aee7) içinde tutarlılığı korumak için Materyal 3'teki Kaydırma Çubuğu parametrelerini yeniden sıralayın
- API (I51cda) içinde tutarlılığı korumak için
NavigationBar
veNavigationRail
parametrelerini yeniden sıralayın. - API genelinde tutarlılığı korumak için Materyal 3'teki parametreleri yeniden sıralayın. (If4ae1)
- API içinde tutarlılığı korumak için Materyal 3'teki Kaydırma Çubuğu parametrelerini yeniden sıralayın (I62673)
- Simgeler parametresi, üst uygulama çubuğu (Id75be) ile tutarlı olacak şekilde işlemlerle yeniden adlandırıldı
- Bağlayıcı hizalaması hâlâ değişken olduğundan
Badge
veBadgedBox
öğelerini deneme amaçlı olarak işaretleyin. (I1712e, b/236524516) - Simge düğmesi varyantlarındaki
@ExperimentalMaterial3Api
ek açıklamalarını@OptIn
(I070b5) olarak değiştirin - Bir gezinme çekmecesinin içeriği, üzerinde özel bir genişlik belirtilmesini desteklemek için kendi composable'ına ayrıldı. (Ia7f10)
Divider
öğesiniMenuDefaults
veTabDefaults
öğelerinden kaldırır (I4e33c)
Sürüm 1.0.0-alpha15
27 Temmuz 2022
androidx.compose.material3:material3:1.0.0-alpha15
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
serbest bırakıldı. 1.0.0-alpha15 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Üst uygulama çubuğunu çubuğun kendisinden sürüklemeye izin verin. (I65c00, b/205873416)
API Değişiklikleri
FilterChip
veElevatedFilterChip
API'lerinde yapılan güncellemelerleselectedIcon
alanının kaldırılması ve seçili durumun gösterilmesi içinleadingIcon
öğesinin yeniden kullanılmasının teşvik edilmesi sağlandı. (Ie5dc2)- Çerçeve ve dış çizgi varyantı renk rollerini ekleyin. (Id6d54)
- Varsayılan composable için adlandırma kurallarını düzeltin. (I62b27)
ListItemDefaults
veListItemColors
adreslerini 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)
- Daha iyi bulunabilirlik için metin seçimi renkleri artık
TextFieldColors
uygulamasına eklendi. (Iba1b8) - Simge içeren düğmelerle kullanılmak üzere
ButtonDefault.ButtonWithIconContentPadding
ekleniyor. (I2bf9c) - Gelecekteki API değişikliklerinde daha fazla esneklik sağlamak için metin alanları deneysel olarak işaretlendi. (I127b5)
Checkbox
işlevinden@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I5eefc)RadioButton
işlevinden@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (I17e2a)- Etkileşimsiz Kartlardan
@ExperimentalMaterial3Api
ek açıklaması kaldırıldı. (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ı karıştırmamak için giriş çipi örneklerindeki çalışmayan 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
serbest bırakıldı. 1.0.0-alpha14 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- M3 listesi uygulaması eklendi, örnek kullanımla ilgili dokümanlara bakın (Id7a20)
API Değişiklikleri
- Değer olan parametre adını
RangeSlider
hücresinde değer olarak değiştir (I3b79a) - Materyal Tasarım özelliklerine göre seçilebilir bir durumu desteklemek amacıyla
InputChip
uygulamasında yapılan API değişiklikleri. Seçilen devre dışı durum içinFilterChip
renklerde ek destek. (I55244, b/235792432) BottomAppBar
varsayılan FAB'sini (Ida4c8) ekleyinColorScheme.surfaceColorAtElevation
eklendi (Id41af)- Oluşturma kitaplıklarındaki arayüzler artık jdk8 kullanılarak oluşturulmuştur. varsayılan arayüz yöntemleri (I5bcf1)
WindowWidthSizeClass
veWindowHeightSizeClass
artık Comparable'ı uyguluyor. Böylece, operatörler (<, <=, >=, >) ve diğer API'ler kullanılarak karşılaştırılabilir. (I747d0)
Hata Düzeltmeleri
- Daha anlamlı içerik açıklamaları sağlamak için rozet örneğini güncelleyin. (I10b9d)
- Materyal 3 kataloğunun tema seçicisine sistem yazı tipi boyutunu kullanma seçeneği ekler. (I10605)
- Rozet ve belirsiz ilerleme göstergeleri için örnek kod ekler. (I8fbe0)
Sürüm 1.0.0-alpha13
1 Haziran 2022
androidx.compose.material3:material3:1.0.0-alpha13
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
serbest bırakıldı. 1.0.0-alpha13 sürümü bu kaydetmeleri 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
serbest bırakıldı. 1.0.0-alpha12 sürümü bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Kaydırma çubuğunun üst öğesi artık 0 genişliğe sahip olabilir. (b/231707291)
Sürüm 1.0.0-alpha11
11 Mayıs 2022
androidx.compose.material3:material3:1.0.0-alpha11
ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
serbest bırakıldı. Sürüm 1.0.0-alpha11 bu kaydetmeleri içerir.
Yeni Özellikler
RangeSlider
, Materyal 3'e eklendi (I18e38)- Material3
AssistChip
veInputChip
desteği ekler (I0d25a) - Material3
FilterChip
veSuggestionChip
desteği ekler (I9fdf3)
API Değişiklikleri
OutlinedTextField
içinde kenarlık çizgisi çizenTextFieldDefaults.BorderStroke
composable,TextFieldDefaults.BorderBox
olarak yeniden adlandırıldı. (I5f295)- m3 görsel değişikliklerini değiştirme (Iab30e)
- Standart simge düğmelerine renk iletilmesine izin verin. (Ia2445)
Hata Düzeltmeleri
- İç dolgunun kullanıldığından emin olmak için malzeme3/Scaffold'e 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
serbest bırakıldı. 1.0.0-alpha10 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
material3-window-size-class
, yeniden boyutlandırılabilen uygulama düzenlerini tasarlamanız, geliştirmeniz ve test etmeniz için pencere boyutu sınıflarını destekleyen yeni bir kitaplıktır. Bir pencere boyutu sınıfı örneği almak içincalculateWindowSizeClass
kullanabilirsiniz. Bu örneği, daha büyük pencere boyutları için alt gezinme yerine gezinme çubuğu yerine kullanıcı arayüzünün nasıl görünmesi gerektiğini belirlemek için kullanabilirsiniz. Daha fazla bilgi ve örnek kullanım içinWindowSizeClass
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ılavuzu inceleyin.
API Değişiklikleri
BottomAppBar
için varsayılan FAB yükseltmesini ekler, sondaki lambdayı FAB ileBottomAppBar
içinden kaldırır. (I92c47)- Material3
FilledIconButton
,FilledTonalIconButton
veOutlinedIconButton
ekler. (Ib2bda) - İsteğe bağlı işlem ve kapatma işlemi için renk değerlerini kabul etmek üzere Material 3 Snackbar API'yi günceller. (Ibe4b4)
PointerInputChange
için kısmi tüketim (aşağı VEYA konum) kullanımdan kaldırıldı. Değişikliği tamamen kullanmak içinconsume()
kullanabilirsiniz. Başka birinin daha önce değişikliği yapıp yapmadığını belirlemek içinisConsumed
kullanabilirsiniz.PointerInputChange::copy()
artık her zaman yüzeysel bir kopya oluşturuyor. Bu,PointerInputChange
kopyalarının, kopyalardan biri kullanıldığında tüketileceği anlamına gelir. Bağlı olmayan birPointerInputChange
oluşturmak istiyorsanız bunun yerine oluşturucu kullanın. (Ie6be4, b/225669674)- Bir
CardColors
arayüzü üzerinden kapsayıcı ve içerik renklerini almak ve tıklanabilir kartlar. (I927df) backgroundColor
parametresi, diğer bileşenlerle daha fazla tutarlılık sağlamak için Materyal 3 metin alanlarındacontainerColor
olarak yeniden adlandırıldı. (I6fbd9)
Hata Düzeltmeleri
- Material3 spesifikasyonuyla uyumlu hale getirmek için standart
IconButton
güncellendi. (I09eab) - Malzeme3 İskele, içeriğe iletilen dolgunun içine yerleştirilerek içeriğin üst uygulama çubuğunun altında oluşturulmasına izin verilir.
PaddingValues
yoksayılırsa içeriğin üst çubuk tarafından görülmesi engellenebilir. (I83cbc, b/217776202)
Sürüm 1.0.0-alpha09
6 Nisan 2022
androidx.compose.material3:material3:1.0.0-alpha09
yayınlandı. Sürüm 1.0.0-alpha09 bu kaydetmeleri içerir.
Yeni Özellikler
- Material 3 Switch API (I2c3ad) eklendi
API Değişiklikleri
- Metin alanları içeren açılır menüler için destek eklendi (diğer adıyla "açık açılır menüler" veya "kombo kutular"). (I1b832)
- MaterialTheme ve Şekil alt sistemine şekil parametresi eklendi. (I37426)
- FAB'nin genişletilmiş mi yoksa daraltılmış mı olduğunu kontrol etmek için
ExtendedFloatingActionButton
işlevine genişletilmiş bir parametre eklendi. Simgesiz ExtendedFAB'ler için sondaki metinle birlikte genişletilmiş FAB'ler için genişletilmiş FAB aşırı yüklemesi eklendi. (Iba7f1)
Sürüm 1.0.0-alpha08
23 Mart 2022
androidx.compose.material3:material3:1.0.0-alpha08
yayınlandı. 1.0.0-alpha08 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Materyal 3 metin alanları için destek eklendi. (I795cc, b/199377790)
API Değişiklikleri
- Menü için varsayılan ayırıcı ekleme (I01374)
ColorScheme
sınıfınasurfaceTint
renk parametresi eklendi. (I2f558)
Hata Düzeltmeleri
- Varsayılan metin stili değerini okumak için Material3 Düğmesinde düzeltme farklı bir şey. (Ie62fc)
Sürüm 1.0.0-alpha07
9 Mart 2022
androidx.compose.material3:material3:1.0.0-alpha07
yayınlandı. 1.0.0-alpha07 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Material 3 Surface API'de yapılan güncellemelerle tıklanabilir yüzeyler için aşırı yüklenmiş işlevler ve ayrıca, etkinleştirilebilir. (I4bf18)
LazyVerticalGrid
veLazyHorizontalGrid
artık kararlı. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
ve ilgili tüm API'ler .grid alt paketine taşındı. Lütfen içe aktarma işlemlerinizi androidx.compose.foundation.lazy adresinden androidx.compose.foundation.lazy.grid olarak güncelleyin. (I2d446)- Şu kadar süre boyunca yalnızca Görünüme dayalı olma şeklinde yapılan önceki değişiklik geri alındı:
WindowInsetsControllerCompat
ve ardından şu kadar aralık gerekir: bazı pencere işaretlerini yönetmek için gereken bir gerekliliktir.ViewCompat.getWindowInsetsController
desteği sonlandırıldığından Doğru Pencerenin seçildiğinden emin olmak içinWindowCompat.getInsetsController
kullanılır (örneğin, 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'daki değişiklikleri takip etmek için Card API'de yapılan güncellemeler API (I3c8b9)
Sürüm 1.0.0-alpha06
23 Şubat 2022
androidx.compose.material3:material3:1.0.0-alpha06
yayınlandı. 1.0.0-alpha06 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Çekmeceler içindeki tek bir hedefi temsil eden
NavigationDrawerItem
eklendi (Ic396f, b/218286829) PermanentNavigationDrawer
veDismissibleNavigationDrawer
deneysel API olarak eklendi. Bunlar, büyük ekranlı cihazlar için uygun çekmecelerdir. (I5f8ab, b/218286829)- Material 3 alt uygulama çubuğu desteği ekler (Ic432a)
NavigationDrawer
,ModalNavigationDrawer
olarak yeniden adlandırıldı (I1807d, b/218286829)- Malzeme 3 Kaydırma Çubuğu sınıfı ve jetonları (I1ccee) eklendi
- Sekme uygulaması eklendi, örnek kullanım dokümanlarına bakın (Ie0146)
Hata Düzeltmeleri
TalkBack
ekran okuyucunun doğrusal gezinme işlevinin boş bir üst uygulama çubuğu başlığı seçmesine neden olan sorun düzeltildi. (Id4690)IconSize
,FloatingActionButtonDefaults
koleksiyonuna eklendi. (Ia71cf)LazyColumn
ile uzun bir metin eklendiğinde gizliAlertDialog
düğmeleri için hata düzeltmesi. (Ib2cc9, b/216663029)
Sürüm 1.0.0-alpha05
9 Şubat 2022
androidx.compose.material3:material3:1.0.0-alpha05
yayınlandı. 1.0.0-alpha05 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
Materyal Tasarım 3 bileşenleri eklendi
- Açılır menü
- Kartlar
API Değişiklikleri
- onClick işlemi alan
Surface
işlevi kullanımdan kaldırıldı geri arama. Tıklanabilir yüzeyler,InteractionSource
ile oluşturulmalıdır veModifier.clickable()
. (I211c6) - FAB için basılmış ve odaklanılmış yükseltme desteği eklendi. (Ibb584)
Surface
API, şunlara izin veren bir EngagementSource alacak şekilde değiştirildi: kontrol eden bir anahtar kelime olabilir. (Iafbc8)
Hata Düzeltmeleri
- Dinamik renk şemalarında eksik üçüncül renkler eklendi (I456c4, b/214588434)
Sürüm 1.0.0-alpha04
26 Ocak 2022
androidx.compose.material3:material3:1.0.0-alpha04
yayınlandı. 1.0.0-alpha04 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Aşırı yükleme olan yöntemlere
NonRestartableComposable
eklendi mevcut yöntemlerin toplamıdır. Bu, derleyiciyi azaltır oluşturulan not denetimlerine eşittir (eşittir) çağrılan iç fonksiyonda tekrarlanır. (I90490) - Malzeme 3 ayırıcı eklendi. (Ica5fc)
- Onay Kutusu ve RadioButton öğesini deneysel bir API ile işaretleyin ek açıklaması da yer alır. (Ie44bb)
- Materyal 3 ilerleme göstergeleri için destek eklendi. (Iff232, b/205023841)
Hata Düzeltmeleri
- Devre dışı bırakılan bir
TextButton's
kapsayıcısının 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
yayınlandı. 1.0.0-alpha03 sürümü bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Materyal 3'ün
MaterialTheme
özelliğineLocalIndication
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
bağlı.
Sürüm 1.0.0-alpha02
1 Aralık 2021
androidx.compose.material3:material3:1.0.0-alpha02
yayınlandı. 1.0.0-alpha02 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- Onay kutusu ve radyo düğmesi için destek ekleyin.
- Kotlin
1.6.0
ile uyumlu olacak şekilde güncellendi
API Değişiklikleri
- Çekmeceyi Malzeme 3'ün iskelesinden çıkarın. (I04f51)
- Material 3
Checkbox
desteği ekler. (Id5542) - Material 3
RadioButton
desteği ekler. (I20334)
Hata Düzeltmeleri
IconButton
dalga yarıçapını 40 dp'den 20 dp'ye indirin. (I68bbe, b/206674345)compose.material
tarihinden itibarenText
değişiklikleri için bağlantı noktası dizesi hızlı yolu (I30b03)- Düzeltildi, ancak kodu gömülü düğme her zaman etkin olacak. (Iea832, b/205335456)
Sürüm 1.0.0-alpha01
27 Ekim 2021
androidx.compose.material3:material3:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
Materyal Tasarım 3 teması ve Material You dinamik rengi
Materyal Tasarım 3 bileşenleri
- Düğmeler
- FAB ve genişletilmiş FAB
- Diyaloglar
- Gezinme çubuğu
- Gezinme çekmecesi
- Gezinme çubuğu
- Üst uygulama çubuğu
- Rozet
- Simge
- Kısa mesaj gönder
- Platform
- Düzen
- İçerik rengi
Daha fazla bilgi için Compose'da Materyal Tema oluşturma rehberinin Material Design 3 and Material You bölümüne göz atın.