Materyal 3 Oluşturma

Materyal Tasarımın yeni evrimi olan Materyal Tasarım 3 Bileşenler ile Jetpack Compose kullanıcı arayüzleri derleyin. Material 3, güncellenmiş tema ve bileşenlerin yanı sıra dinamik renk gibi Material You kişiselleştirme özellikleri içerir ve yeni Android 12 görsel stili ve sistem kullanıcı arayüzüyle uyumlu olacak şekilde tasarlanmıştır.
Son Güncelleme Kararlı Sürüm Serbest Bırakma Adayı Beta Sürümü Alfa Sürümü
21 Şubat 2024 1.2.0 - - 1.3.0-alpha01

Yapı

Oluşturma işlemi, androidx içindeki 7 Maven Grup Kimliğinin birleşiminden oluşur. Her Grup, her biri kendi sürüm notlarına sahip olan hedeflenmiş bir işlev alt kümesi içerir.

Bu tabloda, gruplar ve her sürüm notları grubunun bağlantıları açıklanmaktadır.

GruplandırAçıklama
compose.animationKullanıcı deneyimini zenginleştirmek için Jetpack Compose uygulamalarında animasyonlar oluşturun.
compose.derleyici@Composable işlevlerini dönüştürün ve Kotlin derleyici eklentisiyle optimizasyonları etkinleştirin.
compose.temelKullanı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.materialKullanıma hazır Materyal Tasarım Bileşenleriyle Jetpack Compose kullanıcı arayüzleri derleyin. Bu, Compose'un daha üst düzey giriş noktasıdır ve www.material.io adresinde açıklananlarla eşleşen bileşenleri sağlamak için tasarlanmıştır.
compose.material3Materyal Tasarımın yeni evrimi olan Materyal Tasarım 3 Bileşenler ile Jetpack Compose kullanıcı arayüzleri derleyin. Material 3, güncellenmiş tema ve bileşenlerin yanı sıra dinamik renk gibi Material You kişiselleştirme özellikleri içerir ve yeni Android 12 görsel stili ve sistem kullanıcı arayüzüyle uyumlu olacak şekilde tasarlanmıştır.
compose.runtimeCompose'un programlama modeli ve durum yönetiminin temel yapı taşları ve Compose Compiler Eklentisi'nin hedeflemesi için temel çalışma zamanı.
compose.uiDüzen, çizim ve giriş de dahil olmak üzere cihazla etkileşimde bulunmak için gereken 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ın veya modülünüz için build.gradle dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:

Modern

dependencies {
    implementation "androidx.compose.material3:material3:1.2.0"
    implementation "androidx.compose.material3:material3-window-size-class:1.2.0"
    implementation "androidx.compose.material3:material3-adaptive:1.0.0-alpha06"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.2.0")
    implementation("androidx.compose.material3:material3-window-size-class:1.2.0")
    implementation("androidx.compose.material3:material3-adaptive:1.0.0-alpha06")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04")
}

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 konusuna bakın.

Geri bildirim

Geri bildiriminiz Jetpack'i daha iyi hale getirmemize yardımcı oluyor. Yeni sorunlar keşfederseniz veya bu kitaplığı nasıl geliştirebileceğimizle ilgili fikirleriniz varsa 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.

Yeni sayı oluşturma

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

Material3 Uyarlanabilir Gezinme Paketi Sürüm 1.0 Oluştur

Sürüm 1.0.0-alpha03

7 Şubat 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 ve androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Paket adını Navigation Suite'ten Navigationsuite olarak güncelleyin (I7eff7)
  • API'lerinde bir MutableInteractionSource gösteren Material3 bileşenleri, artık varsayılan olarak null değerine sahip boş değer atanabilir bir MutableInteractionSource gösterecek şekilde güncellenmiştir. Burada anlamsal değişiklik yok: null değerinin geçirilmesi, MutableInteractionSource öğesini kaldırmak istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Null değişikliği, bazı bileşenlerin hiçbir zaman MutableInteractionSource tahsis etmemesine izin verir ve diğer bileşenlerin gerektiğinde yalnızca geç bir şekilde örnek oluşturmasına olanak tanır. Bu da bu bileşenlerin performansını artırır. Bu bileşenlere ilettiğiniz MutableInteractionSource öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Ayrıca, 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ı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.

Yeni Özellikler

Hata Düzeltmeleri

  • Kök yüzeyinde modifier.fillMaxSize olduğunda tüm ekranı 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 kayıtları 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 yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları 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ç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 yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.

Yeni Özellikler

  • Yapısal gezinme ve değer hesaplamasında geçmiş farkındalığını destekleyin (I71d46)

Sürüm 1.0.0-alpha04

10 Ocak 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 yayınlandı. Sürüm 1.0.0-alpha04 bu kayıtları içerir.

Yeni Özellikler

  • Bölme iskelelerinde uçtan uca destek eklendi (I1b462)

API Değişiklikleri

  • Posture'daki menteşe bağlantısı özellikleri, menteşe bilgileri listesine taşındı (I24f90)

Hata Düzeltmeleri

  • AnimatedPane yeniden oluşturulmadı (c3f573d) sorununu düzeltme

Sürüm 1.0.0-alpha03

13 Aralık 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03 ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • ThreePaneScaffoldRole hesabının takma adları ile ilgili yapı rollerini değiştirin. (İ65bd1)
  • Yapı rolleri için temel sınıf oluşturma (I4784d)
  • AnimatedPane içeriğinden gereksiz parametreyi kaldırın (Ibc73b)
  • collectWindowSizeAsState adını değiştirir ve bunun yerine ham değerleri döndürür (I480f4)

Sürüm 1.0.0-alpha02

29 Kasım 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 ve androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.

API Değişiklikleri

  • Uyarlanabilir iskele API'lerinden gezinme API'lerini ayırın. (Ic4045)
  • GutterSize sınıfı kaldır. (I785b3)

Hata Düzeltmeleri

  • AnimatedPane kullanılmadığında düzeltme bölmeleri değiştirilmez (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 kayıtları içerir.

Yeni Özellikler

Material3 uyarlanabilir koşul API'leri:

Material3 uyarlanabilir bölme yapı yönergesi API'leri:

Material3 uyarlanabilir bölme iskelesi API'leri:

Material3 Sürüm 1.3 Oluşturma

Sürüm 1.3.0-alpha01

21 Şubat 2024

androidx.compose.material3:material3-*:1.3.0-alpha01 yayınlandı. Sürüm 1.3.0-alpha01 bu kayıtları içerir.

Yeni Özellikler

  • Compose M3 ModalBottomSheet'ü U+'da tahmini geri almayı destekleyecek şekilde güncelleme (Iccf32, b/281967264, b/304850357)
  • Compose M3 SearchBar, U+ üzerinde tahmini geri desteği desteklemek için güncellendi (I657f8)
  • Boşluk ve durma göstergesi ekleyerek erişilebilirliği iyileştirmek için Kaydırma Çubuğu 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 eklenerek, yeni zengin ipucu API'si artık LayoutCoordinates bağlayıcısı için özel düzeltme işareti oluşturulmasına olanak tanıyor. (Ifd42c)

Davranış Değişiklikleri

  • Materyal bileşenler, yeni Ripple API'leri kullanmak için taşındı ve artık RippleTheme sorgusunda yer almıyor.

API Değişiklikleri

  • Eğlenceli drawStopIndicator artık herkese açık. (I3f59f)
  • DatePicker işlevinin formatWithSkeleton 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 bir MutableInteractionSource gösteren Material3 bileşenleri, artık varsayılan olarak null değerine sahip boş değer atan bir MutableInteractionSource öğesi gösterecek şekilde güncellenmiştir. Burada anlamsal değişiklik yok: null değerinin geçirilmesi, MutableInteractionSource öğesini kaldırmak istemediğiniz anlamına gelir ve gerekirse bileşenin içinde oluşturulur. Null değişikliği, bazı bileşenlerin hiçbir zaman MutableInteractionSource tahsis etmemesine izin verir ve diğer bileşenlerin gerektiğinde yalnızca geç bir şekilde örnek oluşturmasına olanak tanır. Bu da bu bileşenlerin performansını artırır. Bu bileşenlere ilettiğiniz MutableInteractionSource öğesini kullanmıyorsanız bunun yerine null değerini iletmeniz önerilir. Ayrıca, kendi bileşenlerinizde de benzer değişiklikler yapmanız önerilir. (I41abb, b/298048146)
  • Sabit değerler kullanarak dalgaların bileşen / alt ağaç bazında özelleştirilmesine olanak tanımak için RippleConfiguration ve LocalRippleConfiguration ekler. Örneğin, kontrol etmediğiniz bir bileşenin rengini değiştirebilir veya bir bileşen için dalgayı devre dışı bırakabilirsiniz. Ç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 çözüm yoludur. Daha kapsamlı değişiklikler ve özel tasarım sistemleri için bunun yerine createRippleModifierNode kullanarak kendi dalganızı oluşturmanız gerekir. (I7b5d6, b/298048146)
  • Material3'e, kullanımdan kaldırılan rememberRipple API'sinin yerini alan yeni Ripple API eklenir. Ayrıca, materyaller3 bileşenlerini kullanımdan kaldırılan rememberRipple / RippleTheme API'lerini kullanmaya geri döndürmek için geçici bir CompositionLocal (LocalUseFallbackRippleImplementation) ekler. Bu, bir sonraki kararlı sürümde kaldırılacaktır ve yalnızca özel RippleTheme sağladığınız durumlarda taşımaya geçici bir yardımcı olmak için tasarlanmıştır. (I34cbc, b/298048146)

Hata Düzeltmeleri

  • Performansı artırmak için ModalBottomSheet içindeki alt kompozisyon kaldırıldı. ModalBottomSheet ürününün LookaheadScope ile birlikte belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (I2a198)
  • Performansı artırmak için BottomSheetScaffold içindeki alt kompozisyon kaldırıldı. BottomSheetScaffold ürününün LookaheadScope ile birlikte belirli senaryolarda 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)
  • DateRangePicker ile ilgili, 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 şekilde aktarıldığı bir a11y sorunu düzeltildi. (I2ac55)
  • mediumTopAppBarColors parametre sırası hatası düzeltildi. (Ibe64a)

Sürüm 1.2

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 kayıtları içerir.

Bilinen Sorun

  • Bir performans iyileştirme değişikliği kapsamında PrimaryTabRow sürümünde bir View-Compose birlikte çalışma oluşturma hatası kullanıma sunuldu. Geçici çözüm, TabRow parametresini TabRowDefaults.PrimaryIndicator ile kullanmaktır.

1.1.0'dan sonraki önemli değişiklikler

Yeni Materyal Tasarım 3 Bileşeni

Mevcut Materyal Tasarım 3 bileşenlerinde geliştirmeler.

Deneysel API'leri kararlı sürüme yükseltti.

Performans iyileştirmeleri

Sürüm 1.2.0-rc01

24 Ocak 2024

androidx.compose.material3:material3-*:1.2.0-rc01 yayınlandı. 1.2.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • mediumTopAppBarColors parametre sırası hatası düzeltildi. (Ibe64a)
  • CardDefaults.cardColors içinde 1.2.0-beta02 ürününde kullanıma sunulan ve contentColor parametresinin containerColor param değerine göre güncellenmediği bir hata düzeltildi. (Iee041, b/319671246)
  • disabledContentColor ürününde 1.2.0-beta02 ürününde kullanıma sunulan ve küçük optimizasyon eklenen bir hata düzeltildi. (I6dda1, b/318428829)

Sürüm 1.2.0-beta02

10 Ocak 2024

androidx.compose.material3:material3-*:1.2.0-beta02 yayınlandı. 1.2.0-beta02 sürümü bu kayıtları içerir.

Bilinen Hata

  • IconButtonColors hizmetindeki bir hata, varsayılan olarak disabledContentColor öğesini, belirtilen kullanıcının contentColor yerine LocalContentColor alfa (0.38f) değerine atar. Çözüm, disabledContentColor özelliğini açık bir şekilde ayarlamaktır. Bu durum 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 ekleniyor. (Ibf767)
  • SwipeToDismissState, rememberSwipeToDismiss ve SwipeToDismissValue, _SwipeToDismissBox_ olarak yeniden adlandırıldı. (I68d6d)

Hata Düzeltmeleri

  • ListItem uç dolgusu değeri spesifikasyonla uyumlu olacak şekilde 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 tanımlı renk rollerinden veri alıyor. Bu özellik, erişilebilir içerik için kontrastı iyileştirir ve dinamik rengi Malzeme özelliğiyle daha uyumlu hale getirir. (I1de96)
  • android:enableOnBackInvokedCallback="true" durumunda Android T/13 ve sonraki sürümlerde ModalBottomSheet uygulamasının geri işlenmesi 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ı. 1.2.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • TabIndicatorScope sınıfını deneysel olarak işaretleyin. (I45c88)
  • İpucu için desteği sonlandırılmış deneysel API'leri kaldırma. (I438cb)
  • Yeni TabRow aşırı yüklemelerini alt bileşimleri kullanmayacak şekilde değiştirin. Bu, sağlanan özel değiştiricilerle TabRow göstergelerini oluşturmanın farklı bir yolunu sunar. (Ife741)
  • DismissDirection ve DismissValue API'lerini kullanımdan kaldırın. Bunlar, değerleri SwipeToDismissBox konumunu ve yönünü belirten SwipeToDismissValue ile birleştirildi. DismissState.progress artık 0.0 ile 1.0 arasında FloatRange olarak işaretli. Kullanımdan kaldırılan DismissState Tasarrufu ve Oluşturucu artık kaldırıldı. SwipeToDismiss bileşeni, durum ve varsayılanlar nesnesi deneysel olarak işaretlendi. (Ib54f2)

Hata Düzeltmeleri

  • PullToRefresh için varsayılan gösterge artık düz bir üçgen yerine açık ok ucudur. (I67be3)

Sürüm 1.2.0-alfa12

29 Kasım 2023

androidx.compose.material3:material3-*:1.2.0-alpha12 yayınlandı. Sürüm 1.2.0-alpha12 bu kayıtları içerir.

API Değişiklikleri

  • RangeSlider artık bir Kotlin aralığı (ör. 0f..1f) kullanabilirsiniz.FloatRange SnapFlingBehavior.kt artık bir Kotlin aralığı da kullanıyor. (I025cb)
  • Değiştirici'nin fabrika işlevlerini @Stable olarak işaretle. (Ib109f)

Sürüm 1.2.0-alfa11

15 Kasım 2023

androidx.compose.material3:material3-*:1.2.0-alpha11 yayınlandı. Sürüm 1.2.0-alpha11 bu kayıtları içerir.

Yeni Özellikler

  • Birlikte Material3'te yenileme uygulaması için bir çekme olanağı sağlayan PullToRefreshContainer ve PullToRefreshState uygular. (I16456, b/261760718)

API Değişiklikleri

  • SwipeToDismissBox DismissDirection ve DismissValue öğelerini deneysel olarak işaretleyin. (I517b0)
  • SwipeToDismiss alanının adını SwipeToDismissBox olarak değiştirin. background öğesini backgroundContent, dismissContent adını ise sondaki content lambda olarak değiştirin. (I7f4d3)
  • ChipElevation ve SelectableChipElevation için oluşturucuyu herkese açık hale getirin. (Ie0c48, b/308432421)
  • ModalBottomSheetProperties ekleniyor. securePolicy, ModalBottomSheetProperties hedefine taşınıyor. isFocusable ve shouldDismissOnBackPress, ModalBottomSheetProperties koleksiyonuna ekleniyor. Bu yeni boole değerleri, kalıcı alt sayfanın IME etkinliklerini nasıl işleyeceğini belirlemeye yardımcı olur. (Iea56f, b/278216859)
  • initialOnValueChange, başlangıç önekleri ve uygun kdocs'ları kaldırmak için RangeSlider ve Slider 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ğrudan BorderStroke kullanmanızı öneririz. (I89cc2)
  • Foundation Tooltip API'leri artık @ExperimentalFoundationApi oldu. (I30b0b)
  • TabRow ve ScrollableTabRow 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 kullanıyor. (I07a8d)
  • SegmentedButton artık doğrudan BorderStroke kullanıyor. (I89b9b)
  • Genel AlertDialog işlevi BasicAlertDialog olarak yeniden adlandırıldı ve önceki işlev kullanımdan kaldırıldı. (Idbe52)
  • SwipeToDismiss API'lerinin adını SwipeDismiss olarak değiştirin ve yeni SwipeDismiss API'lerini kararlı sürüme yükseltin. (I14cbe)
  • İpucu API'lerine tonalElevation ve shadowElevation ekleniyor. Ayrıca, yanlışlıkla kararlı olarak kullanıma sunuldukları için TooltipBox, PlainTooltip ve RichTooltip API'leri tekrar deneme sürümüne taşındı. (If0f66, b/293939035)
  • Deneysel çip API'lerini kararlı sürüme yükseltin. (Iea2c3)
  • @ExperimentalMaterial3Api ek açıklaması, Material3 tıklanabilir Kartlarından kaldırıldı. (I88dbf)

Hata Düzeltmeleri

  • SwipeToDismiss öğesinin, iç içe yerleştirilmiş Lookahead ve Lazy düzenlerin kullanıldığı belirli senaryolarda kilitlenmesine neden olan sorun düzeltildi. (Ica8d1, b/297226562)

Sürüm 1.2.0-alfa10

18 Ekim 2023

androidx.compose.material3:material3-*:1.2.0-alpha10 yayınlandı. Sürüm 1.2.0-alpha10 bu kayıtları içerir.

API Değişiklikleri

  • Badge ve BadgedBox, kararlı sürüme yükseltiliyor. (I67f16, b/261565132)
  • Kullanıcıların WindowManager.LayoutParams.FLAG_SECURE davranışını tanımlayabilmesi için securePolicy, ModalBottomSheet öğesine parametre olarak ekleniyor. (Icdac8, b/296250262)
  • progress öğesini lambda olarak alan yeni LinearProgressIndicator ve CircularProgressIndicator aşırı yüklemeleri eklendi. Bu uygulamaların önceki sürümlerden daha iyi performans göstermesi beklenir. (I824e6, b/295616656)
  • StandardSizeClasses öğesinin adını AllSizeClasses olarak değiştirir. (I8cb07)
  • Pencere boyutu sınıflarının hesaplama işlevlerini birleştirme. (Iad935)

Hata Düzeltmeleri

  • Görüntülenen ay, izin verilen yıl aralığının sınırına ulaştığında gezinme oku düğmeleri hızlı bir şekilde tıklandığında DatePicker kilitlenmesi düzeltildi. (I46f36, b/290954897, b/297002119)
  • [Gezinme çubuğu/ç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 kayıtları içerir.

API Değişiklikleri

  • Yeni AnchoredDraggable API'lerini kullanmak için ModalNavigationDrawer ve DismissibleNavigationDrawer taşındı. DrawerState'in animateTo özelliği, açma ve kapatma yöntemleriyle değiştirildi ve göreli konum artık durum nesnesi yerine kayan nokta olarak gösteriliyor. Zaman farkına doğrudan currentOffset üzerinden erişebilirsiniz. (I0a72c)
  • Doğrudan DatePickerState ve DateRangePickerState oluşturmak için birleştirilemez işlevler eklendi. Bu işlevler, gerektiğinde Composable rememberDatePickerState ve rememberDateRangePickerState 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ımlandığı gibi renk ve gösterge davranışıyla doğru bir şekilde eşleşir.
  • PrimaryScrollableTabRow ve SecondaryScrollableTabRow artık kaydırma durumunu gösteriyor. (Iec8f5, b/260572337)
  • Geliştiricilerin, sayfanın kapsayacağı maksimum genişliği belirtmek üzere ayarlayabileceği yeni bir sheetMaxWidth parametresi ekleme. Tüm ekran genişliğini kaplayan bir sayfa istenirse parametre için Dp.Belirtilmemiş değeri geçirilebilir. (Ifb7c9, b/266697696)
  • PlainTooltipBox ve RichTooltipBox API'lerini kullanımdan kaldırılan yöntemler olarak geri ekleme. (I246fa)

Hata Düzeltmeleri

  • DatePicker, tarih kalıplarına dönüştürüldüğünde (ör. YY) aynı kalan belirli tarih iskeletlerine sahip bir DatePickerFormatter ile başlatıldığında ortaya çıkan kilitlenme düzeltildi. (I01f29)

Sürüm 1.2.0-alpha08

20 Eylül 2023

androidx.compose.material3:material3-*:1.2.0-alpha08 yayınlandı. Sürüm 1.2.0-alpha08 bu kayıtları içerir.

Davranış Kırıcı Değişikliği

  • ColorScheme artık Sabit olduğundan tek tek renk güncellemelerini daha az verimli hale getirirken renklerin daha yaygın kullanımını daha verimli hale getiriyor. Bu değişikliğin nedeni, uygulamaların çoğunun ana kullanım alanı olarak bağımsız renkleri güncellemeyecek olmasıdır. Bu mümkündür, ancak eskisinden daha fazla yeniden oluşturma yapılacak. Bunun sonucunda, tüm Materyal kodları üzerinden durum aboneliği sayısı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 spesifikasyonla eşleşecek şekilde farklı etkileşim durumlarında animasyon oluşturmamaktadır. (Icdd12)

API Değişiklikleri

  • İçerik kaydırıldığında otomatik olarak gizlenmek için BottomAppBarScrollBehavior parametresi olarak alan yeni bir BottomAppBar eklendi. Ayrıca, FAB'ın uygulama çubuğunu, üzerine sabitlenmek yerine yapıdaki alt uygulama çubuğunu kaplamasına olanak tanıyan FabPosition.EndOverlay özelliği eklendi. (Iecb47)
  • BasicTooltipBox üzerinde oluşturulan 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)
  • Scaffold'un ölçüm sırasında veya yerleştirme sırasında alt öğelerini ölçüp ölçmeyeceğini kontrol eden geçici bir işaret kullanıma sunuldu. Bu metrik varsayılan olarak ölçümde ölçülür. Yeni davranışla ilgili sorunlar yaşıyorsanız lütfen bir sorun bildiriminde bulunun. (I0b354)
  • BottomSheet sürümünde, cihaz ekran genişliği için doğru ölçüm uygulanarak yatay Kenardan Kene doğru düzeltildi. (I1df0c, b/299058752)
  • Sayfada aşağı doğru kaydırarak kapatırken ModalBottomSheet ürününün onDismissedRequest öğ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ı. Sürüm 1.2.0-alpha07 bu kayıtları içerir.

Yeni Özellikler

  • compose material 1.6.0-alpha05 ürününe otomatik yansıtma simgeleri desteği eklendi. Otomatik yansıtma simgeleriyle ilgili ayrıntılar için lütfen sürüm notlarına bakın.

API Değişiklikleri

  • SliderState, DraggableState (I9b116) özelliğini uygular
  • Şekli gerekli bir parametre olacak şekilde değiştirin. position öğesini, şekil yardımcı işlevinde index olarak yeniden adlandırın. (I34941)
  • DatePicker formatWithSkeleton öğelerini, performans iyileştirmeleri için önbellek olarak kullanılan bir harita içerecek şekilde günceller. (I3195f)
  • BasicTooltipBox öğesi compose.foundation koleksiyonuna eklendi ve PlainTooltipBox ile RichTooltipBox, TooltipBox öğesini yeni PlainTooltip ve RichTooltip composable'larla kullanacak şekilde güncellendi. (I79e1d)

Hata Düzeltmeleri

  • dynamicLightColorScheme ve dynamicDarkColorScheme artık yüzey ve surfaceContainer rolleri için daha yüksek renk renkleri döndürüyor. (I5e901)
  • LookaheadScope içinde bir Yapı İskelesi içinde Alt Bileşim (ö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 yayınlandı. Sürüm 1.2.0-alpha06 bu kayıtları içerir.

Hata Düzeltmeleri

  • DropdownMenu ürününün offset hesaplaması, x ofseti yalnızca yerel düzen yönüne bağlı olacak şekilde düzeltildi ve artık menü ekranın alt kısmına yakın olduğunda y ofseti tersine çevrilmeyecek. (Iccc74, b/294103942)
  • DropdownMenu ürününün offset hesaplaması, x ofseti yalnızca yerel düzen yönüne bağlı olacak şekilde düzeltildi ve artık menü ekranın alt kısmına yakın olduğunda y ofseti tersine çevrilmeyecek. (Ib87a2, b/294103942)

Sürüm 1.2.0-alpha05

9 Ağustos 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 yayınlandı. Sürüm 1.2.0-alpha05 bu kayıtları içerir.

API Değişiklikleri

  • Onay kutusu ve TriStateCheckbox renkle ilgili güncellemeler. CheckboxDefaults.colors() disabledUncheckedColor artık yalnızca onay kutusunun kenarlığını etkiler. Devre dışı bırakıldığında ve işareti kaldırıldığında dahili kutu rengini ayarlamanızı gerektiren özel durumlar için istenen renk değerlerine sahip özel oluşturulmuş bir CheckboxColors ö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ı. Sürüm 1.2.0-alpha04 bu kayıtları içerir.

Yeni Özellikler

  • Deneysel Bölümlü Düğme API'sı (Ifc8fb)
  • Ayırıcılar, artık dikey ayırıcıları desteklemek için yönü kontrol edecek bir parametreye sahiptir. (I4c899, b/288438593)

API Değişiklikleri

  • Yoğunluk bağımlılığını bileşen seviyesine taşıyoruz. Bu, şu bileşenler için geçerlidir: SwipeToDismiss ve E-tablo tabanlı bileşenler. Lütfen yoğunluğun bir parametre olduğu yeni aşırı yükü kullanın. (I1846e)
  • composable'lara izin verilen girişleri belirten ek ek açıklamalar (Ief234)
  • Segmentlere ayrılmış düğmelere bir simge parametresi ekleyin. Anlamları bölmek, bölümlendirilmiş düğmelerin tekli seçim yapmak üzere seçilebilmesini sağlar. Sırasıyla SelectableSegmentedButtonRow ve ToggelableSegmentedButtonRow ile çoklu seçim uygulamak için açılıp kapatılabilir. (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çin ClosedFloatingPointRange kullanımını değiştirin. (I4aab5)
  • FabPosition için yeni Başlangıç hizalaması eklendi (Ib7aea, b/170592777)

Hata Düzeltmeleri

Sürüm 1.2.0-alpha03

21 Haziran 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 yayınlandı. Sürüm 1.2.0-alpha03 bu kayıtları içerir.

Davranış Değişiklikleri

  • Malzeme 3 tipografisinde includeFontPadding artık varsayılan olarak false. Varsayılan satır yüksekliği stili de Trim.None ve Alignment.Center olarak değiştirildi ve Typography adlı öğenin TextStyle öğelerine açıkça lineHeight (sp cinsinden) eklendi. Bu değerleri özelleştirmek istiyorsanız API dokümanlarına göz atın. Bu değişikliklerin ayrıntılı bir açıklaması için blog yayınına göz atın. (I6266f, Icabc3)

Yeni Özellikler

  • Bileşenin durum bilgili sürümü olan RangeSlider için aşırı yükleme eklendi. Geçerli etkin kanal için tüm bilgileri, RangeSlider bileşenlerinin ölçümlerini ve sürükleme ve hareket mantığını içeren RangeSliderState oluşturuldu. (I8c270)
  • Yeni eklenen shadowElevation parametresiyle artık arama çubuğu gölgeleri destekliyor. (Ia5369, b/271040353)
  • ColorScheme artık yeni SurfaceContainer rollerini destekliyor.
  • Yüzey ton yüksekliği yer paylaşımı artık yerel LocalTonalElevationEnabled bileşimi ile devre dışı bırakılabilir. (Ic203c, b/277774590)

API Değişiklikleri

  • Bileşen renkleri kurucularını açın. (I8c4a6)
  • Geliştiricilerin, ipucunun dokunma etkinliklerini tüketip kullanmamalarını sağlayabilecekleri şekilde her iki araç ipucu API'sine de odaklanılabilir parametre ekleme. Bunun erişilebilirlik odağı otomatik geçişini bozabileceğine dikkat edin. (Ie32d8)
  • Performans ve bellek ayırmaları için optimize edilmiş erişilebilirlik. (Iede48)
  • WindowSizeClasses için DefaultSizeClasses hizmetini kullanıma sunun ve StandardSizeClasses oluşturun (I91838)
  • WindowWidth/HeightSizeClass değerini, kayan değer sınıflarıyla değiştirin (Ie686e)

Hata Düzeltmeleri

  • Scaffold'un contentWindowInsets parametresi artık tüketilen pencere eklerine uyar. Bu parametreler sağlandığında topBar ve bottomBar değerlerine dayalı 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 oluşturulmaması için orta üst uygulama çubuğunun hizalamasını düzeltin. (I4369f, b/236994621)
  • Sekme konumları artık minimum 24.dp içerik genişliğini zorunlu tutuyor. Bu, sekme göstergeleri için erişilebilir bir dokunma hedefi sağlar. (Id8861)
  • dynamicLightColorScheme ve dynamicDarkColorScheme kaynaklı dinamik renk paletleri artık yeni yüzey rollerini destekliyor. (I1252e)
  • Rozet bildirimi hizalaması, büyük büyükanne ve büyükbaba ile çarpılırken klip oluşturulmayacak ş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ı. Sürüm 1.2.0-alpha02 bu kayıtları içerir.

API Değişiklikleri

  • ModalBottomSheet öğesine window insets parametresi ekleyin.
    • ModalBottomSheet görünümü artık windowInsets değeri sıfıra ayarlanmış şekilde durum çubuğunun arkasına çizilebilir
    • Varsayılan ModalBottomSheet işlevi, gezinme dahil olmak üzere sistem çubuklarının dışında kalacak şekilde güncellendi
    • Durum çubuğu iç içe işleme işlemi, uçtan uca modda sürükleme tutamacı tarafından sağlanır.
    • BottomSheetDefaults, BottomSheetWindow için pencere eklerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/272973615, b/2064}
  • Indicator öğesini kullanımdan kaldırın ve M3 spesifikasyonlarıyla eşleşmesi için Primary/SecondaryIndicator ekleyin. PrimaryIndicator, sekme içeriğinin genişliğiyle eşleşirken, SecondaryIndicator mevcut genişliğin tamamını kapsar. SecondaryIndicator, desteği sonlandırılmış Indicator ile eşdeğerdir ve doğrudan kullanılabilir. (I27604)
  • Görüntülenen menü öğelerinin dikey kaydırma durumunu kontrol etmek için DropdownMenu veya ExposedDropdownMenu oluştururken ScrollState geçirme seçeneği eklendi. (Ia0734, b/185304441)
  • Bileşenin durum bilgili sürümü olan Slider için aşırı yükleme eklendi. Geçerli etkin kanal için tüm bilgileri, Slider bileşenlerinin ölçümlerini ve sürükleme ve hareket mantığını içeren SliderState oluşturuldu. (I124a5)
  • isContainer semantik mülkünü isTraversalGroup olarak yeniden adlandırma (I121f6)
  • Tam parametre listesine sahip, optimize edilmiş TextStyle.merge(...) eklendi. (Iad234, b/246961787)
  • TooltipState, RichTooltipState ve PlainTooltipState arayüzleri herkese açık hale getirildi. Varsayılan durumlar için RichTooltipStateImpl ve PlainTooltipStateImpl eklendi. Uygulanan bu durumları elde etmek için remember*State işlevleri eklendi. Bir TooltipDefault.GlobalMutatorMutex için TooltipSync kaldırıldı. (I7813d)
  • DatePickerColors öğesi; 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 ve DateRangePickerState, artık rememberDatePickerState ve rememberDateRangePickerState tarafından alınabilen, varsayılan uygulamalara sahip herkese açık arayüzlerdir. (I71c52)
  • dateValidator öğesi DatePicker ve DateRangePicker işlevlerinden kaldırıldı ve kullanıcı arayüzünde hangi tarihlerin veya yılların seçilebileceğini kontrol etmek için durumda ayarlanabilen bir SelectableDates 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ı için önerilmez ve işlevsellik etkin bir şekilde korunmaz. (Ib3778)

Hata Düzeltmeleri

  • AlertDialog kapatma işlemi, iletişim kutusunun genişliğine sığacak şekilde birbirinin üzerine yığıldığında onay işleminin altında görünecek şekilde düzeltildi. Bu düzeltme, uygulamayı Materyal Tasarım spesifikasyonuyla uyumlu hale getirir. (I029de, b/235454277)
  • Üç satırlı öğeler için yanlış dolgunun kullanılmasıyla ilgili ListItem hatası 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ı. Sürüm 1.2.0-alpha01 bu kayıtları içerir.

Sürüm 1.1

Sürüm 1.1.2

20 Eylül 2023

androidx.compose.material3:material3:1.1.2 ve androidx.compose.material3:material3-window-size-class:1.1.2 yayınlandı. 1.1.2 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Değiştiricinin iki composable'a yanlış şekilde aktarılması düzeltildi. (b/282761472)
  • Düzeltilen TimePickerState, 23 saatle ilk kullanıma hazırlandığında yanlış saatler döndürüyor. (b/278242122)
  • Öğle ve dakika doğrulaması için başlangıçtaki açma/kapatma durumu düzeltildi. (b/269768197, b/282790635)
  • state.hour işlevinin 23:00 için yanlış değer döndürmesi 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ü bu kayıtları içerir.

Hata Düzeltmeleri

  • İkili program uyumluluğu için windowInset parametresi olmadan ModalBottomSheet çağrısı ekler. (Ib7959)
  • ModalBottomSheet öğesine window insets parametresi ekleyin.
    • ModalBottomSheet görünümü artık windowInsets değeri sıfıra ayarlanmış şekilde durum çubuğunun arkasına çizilebilir
    • Varsayılan ModalBottomSheet işlevi, gezinme dahil olmak üzere sistem çubuklarının dışında kalacak şekilde güncellendi
    • Durum çubuğu iç içe işleme işlemi, uçtan uca modda sürükleme tutamacı tarafından sağlanır.
    • BottomSheetDefaults, BottomSheetWindow için pencere eklerini içerir. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/272973615, b/2064}

Sürüm 1.1.0

10 Mayıs 2023

androidx.compose.material3:material3:1.1.0 ve androidx.compose.material3:material3-window-size-class:1.1.0 yayınlandı. 1.1.0 sürümü bu kayıtları içerir.

1.1.0'ın temel özellikleri

Yeni Materyal Tasarım 3 bileşenleri

Mevcut Materyal Tasarım 3 bileşenlerinde geliştirmeler.

Deneysel API'leri kararlı sürüme yükseltti.

Ayrıntılı bilgi için lütfen bu blog yayınını inceleyin.

Sürüm 1.1.0-rc01

19 Nisan 2023

androidx.compose.material3:material3:1.1.0-rc01 ve androidx.compose.material3:material3-window-size-class:1.1.0-rc01 yayınlandı. 1.1.0-rc01 sürümü bu kayıtları 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ı için önerilmez ve işlevsellik 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 yayınlandı. 1.1.0-beta02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • SheetState artık isteğe bağlı skipHiddenState parametresine sahip
  • rememberStandardBottomSheetState artık isteğe bağlı skipHiddenState parametresine sahip
  • Varsayılan olarak devre dışı olsa da BottomSheetScaffold artık tanımlanmış bir Gizli bağlayıcıya sahip
  • SheetState.requireOffset doküman güncellendi
  • BottomSheetDefaults.MinimizedShape, BottomSheetDefaults.HiddenShape (I839f4, b/273870234) olarak yeniden adlandırıldı

Hata Düzeltmeleri

  • Dokunarak keşfetme etkinken kadranı saatten dakikaya değiştirmeyin. (I717d0)
  • ModalBottomSheet ve BottomSheetScaffold sürükleme tutamacı semantiği artık birleştirilmiş. (I05afb)
  • BottomSheetScaffold değiştirici, containerColor ve contentColor parametreleri artık yalnızca içeriği etkiliyor. (I992cb)
  • Sayfa içeriği için BottomSheetScaffold nestedScroll artık fling'leri 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 yayınlandı. 1.1.0-beta01 sürümü bu kayıtları 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, deneme olarak işaretlendi. (I65561)
  • BottomSheetScaffold öğesine gölge yüksekliği eklendi (I94e0f)
  • Tarih seçicilerin başlık bölümü olmadan görüntülenmesi için destek eklendi. Tarih seçici oluşturulurken boş başlık geçirilmesine olanak tanıyan API değişiklikleri. Gözetimsiz seçici göstermek 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 odak otomatik olarak temizleniyor. (I22a7c, b/261444487)
  • DateRangePicker, başlangıç ve bitiş tarihlerinin aynısına sahip bir aralığın seçilmesine olanak tanıyacak şekilde güncellendi. (I16529, b/272882497)
  • Yazı tipi boyutu beklenenden küçük olduğunda metin alanları artık metin öğelerini doğru şekilde 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 sayfadaki 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 yayınlandı. Sürüm 1.1.0-alpha08 bu kayıtları içerir.

Yeni Özellikler

  • BottomSheetScaffold ve BottomSheetScaffoldState için destek eklendi. (I063d4)

API Değişiklikleri

  • DatePickerState ve DateRangePickerState öğelerine, eyaletin ilk oluşturulmasından sonra tarihleri ayarlamaya olanak tanıma ve boş zaman damgaları ayarlayarak seçimleri sıfırlama işlevi eklendi. Tarihleri manuel olarak ayarlarken dikkatli olun. Yeni setSelection işlevi, sağlanan bir tarihin bir ön koşulda başarısız olması durumunda istisna oluşturur (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 sütununu PartiallyExpanded olarak yeniden adlandırın. (Ia1491)
  • ListItem parametre adları _text yerine _content olarak güncellendi. Varsayılan alıcılar, uygun durumlarda artık ReadOnlyComposables olarak ayarlanmıştır. (I69a25)
  • Deneysel çalışmaların etkileşimli Surface API'lerini mezun edin. (I90d59, b/261561812)

Hata Düzeltmeleri

  • ModalBottomSheet sayfasının HalfExpanded durumunun yanlış hesaplanması ve sayfanın kayan görünmesi sorunu düzeltildi. (I45e84, b/268411386)
  • ModalBottomSheet için kaydırma hareketi yapmak üzere confirmValueChange kontrolünü ekleyin. (I2311a, b/270425759)
  • Tutma yerini sürüklemek için anlamsal BottomSheet işlemlerini taşıyın. (I158ba)
  • ModalBottomSheet artık komutları başlatmaya odaklanıyor, geri düğmesini kolluyor. (I4d2ab)
  • ModalBottomSheet onDismissRequest artık iç içe yerleştirilmiş kaydırma kaydırmaları 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ı. Sürüm 1.1.0-alpha07 bu kayıtları içerir.

Yeni Özellikler

  • Zaman girişi için M3 spesifikasyonuna (Ia4fab) uyan ve rememberTimePickerState() ile çalışan bir Zaman Girişi composable'ı ekleyin
  • Tarih aralığı seçmek için Material 3 DateRangePicker API'si eklendi. (I7a6c3, b/267194809)
  • DateRangePicker API'si aracılığıyla tarih aralığı seçmek için Material 3 giriş modu desteği eklendi. (Ifdbc4)
  • Metin alanı renkleri artık aşağıdaki özelleştirmelere olanak tanır:
    • Odak ve hata durumuna göre giriş alanı ve yer tutucu metin renkleri. textColor parametresi unfocusedTextColor, placeholderColor parametresi ise unfocusedPlaceholderColor olarak yeniden adlandırıldı.
    • Yeni errorContainerColor parametresiyle hata durumuna dayalı olarak doldurulmuş metin alanları için kapsayıcı rengi.
  • Gösterilen açılır menü 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üp özel küçük parmak ve izleme bulunan yeni deneysel Kaydırma Çubuğu'nun kapsadığı gereksiz Kaydırma Çubuğu aşırı yüklemeleri kaldırılır. İstikrarlı olması için RangeSlider yükseltiliyor. (Ie8fbd)
  • defaultElevation, çipin yükseltme işlevlerinde 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ı (I18856) kullanır
  • 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 zaman SheetDefaults.ExpandedShape olur. (I0dfca)
  • Materyal 3 DatePicker ve DateRangePicker için erişilebilirlik iyileştirmeleri. (I5087e)
  • Maksimum yükseklik kısıtlamasının yayıldığı ve kilitlenebileceği hatayı düzeltin. (I30d8c)
  • Tıklanabilir ve seçilebilir yüzeylerden anlamsal roller kaldırıldı, değiştirici.semantics'i kullanarak rol 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 yayınlandı. 1.1.0-alpha06 sürümü bu kayıtları içerir.

Yeni Özellikler

  • Metin alanları artık ön ek ve son ek metinlerini destekliyor (Ia8578, b/179884561)
  • Malzeme 3 spesifikasyonuna uyan bir zaman seçici göstermek için TimePickerState ve kolaylık yöntemi rememberTimePickerState (I71910) ile birlikte kullanılan bir TimePicker işlevi eklendi
  • Tarih girişi artık DatePicker öğesinde 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)
  • Materyal 3 için kalıcı alt sayfa uygulaması (ModalBottomSheet ve ModalBottomSheetDefaults dahil). Ayrıca, gelecekteki sayfa bileşenleri için kullanılabilecek SheetState ve rememberSheetState özelliklerini de sunar. (I0853a, b/244189383)

API Değişiklikleri

  • showSnackbar API'sini (I195c2, b/261424370) Stablize et
  • Yardım çipi ve öneri çipi için API'leri statik hale getirin (Ibb67b, b/261424370)
  • ListItem, ListItemDefaults ve ListItemColors API'lerini deneysel olmayan bir sürüme yükseltir (I7e7fa, b/261438882)
  • SliderPositions, SliderDefaults.Thumb ve SliderDefaults.Track sürümlerini kararlı sürüme yükseltme ve özel küçük resimler ile izleme içeren deneysel olmayan Slider ve RangeSlider API'leri ekleme. Önceki Slider ve RangeSlider 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 ipucu görüntülenmesi gerektiğini belirtmek için bunu bağlantıya iletebilir. PlainTooltipBox API, TooltipState öğesini artık null kullanılamaz hale getirecek şekilde güncellendi ve artık varsayılan değere sahip. (Ie2fb7)
  • ProgressIndicatorDefaults.circularTrackColor, tutarlılık amacıyla @Composable olarak işaretlendi. (Id29cc)
  • LocalMinimuTouchTargetEnforcement mülk alıcısı geri yüklendi ve kullanımdan kaldırıldı olarak işaretlenip LocalMinimumInteractiveComponentEnforcement hedefine 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 yayınlandı. Sürüm 1.1.0-alpha05 bu kayıtları içerir.

Yeni Özellikler

  • DatePickerDialog ve erişilebilirlik desteği
  • Özel küçük resim ve parça RangeSlider koleksiyonuna eklendi.

Bağımlılık Güncellemeleri

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ı. Sürüm 1.1.0-alpha04 bu kayıtları içerir.

Yeni Özellikler

  • Takvim kullanıcı arayüzü üzerinden tek bir tarih seçmek için başlangıç DatePicker API'si. Bu API'de hâlâ değişiklikler yapılıyor. (I722b9)
  • PlainTooltipBox aracılığıyla düz ipucu desteği eklendi. (I0cdfb)
  • Arama çubuğu (Iad128)
  • SwipeToDismiss (I458a8, b/242889540)

API Değişiklikleri

  • Yüzeylere IsContainer semantik özelliğine eklendi. Bu özellik, geçiş sırasının yüzeyler gibi öğelerin anlamsal anlamına göre belirlendiği daha sonra yapılacak 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 renk parametresi ve hem dairesel hem de doğrusal ilerleme göstergeleri için bir çizgi sınırı parametresi eklendi. (Ie668c, b/216325962, b/222964817)
  • Kullanımdan kaldırılan gizli işlevlerin daha fazla döndürme türü boş değer atanabilirliği (Ibf7b0)
  • Modifier.minimumInteractiveComponentSize ekleyin. Öğenin daha küçük ölçülmesi durumunda, dokunma etkileşimlerini belirginleştirmek amacıyla en az 48.dp boyut ayırmak için kullanılabilir. (I33f58, b/258495559)
  • İçerik alanı olan AlertDialog composable için deneysel API eklendi. (Iec4a2)

Hata Düzeltmeleri

  • İlerleme göstergelerinin ilerleme durumu, artık beklenen aralığa düzgün bir şekilde sınırlanmıştır. (I8a7eb, b/262262727)

Bilinen Sorun

  • androidx.compose.foundation:1.4.0-alpha03 sürümünden androidx.compose.foundation:1.4.0-alpha04 sürümüne güncelleme yaparken java.lang.NoSuchFieldError hatasıyla karşılaşabilirsiniz. Sorunun ilk olarak bildirildiği yer burada. Bir düzeltme gönderildi. Bu düzeltme bir sonraki Compose güncellemesinde hazır olacaktır. Geçici bir çözüm olarak androidx.compose.material ve androidx.compose.material3 kitaplıklarınızı en son sürüme(1.1.0-alpha04) güncelleyin veya androidx.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ı. Sürüm 1.1.0-alpha03 bu kayıtları içerir.

API Değişiklikleri

  • consumedWindowInsets() adı consumeWindowInsets(), withConsumedWindowInsets() adı ise onConsumedWindowInsetsChanged() olarak değiştirildi ve Değiştiriciler herkese açık hale getirildi. (Ie44e1)
  • Kullanılacak simge içeren metin düğmesi için yeni varsayılan içerik dolgusu eklendi. (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'si eklendi. (I2ba9d, b/203141462)
  • Hareketler kaydırma etkinliğine dönüşebilirken basma etkileşimlerini doğru bir şekilde ertelemek için Clickable içinde kullanılır.
  • Clickables işlevinin, Scrollable ViewGroup içinde kullanıldığında dalgaları doğru şekilde geciktirmemesi düzeltildi.
  • Hareketlerin kaydırma etkinliklerine dönüşmesi ihtimaline karşı bastırmaları doğru bir şekilde geciktirecek Çekmeceler ve E-Tablolar güncellendi.

Bağımlılık Güncellemeleri

  • Compose UI ve Compose Material artık Yaşam Döngüsü 2.5.1'e bağlıdır. (I05ab0, b/258038814)

Sürüm 1.1.0-alpha02

9 Kasım 2022

androidx.compose.material3:material3:1.1.0-alpha02 ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 yayınlandı. Sürüm 1.1.0-alpha02 bu kayıtları içerir.

API Değişiklikleri

  • awaitFirstDown ve waitForUpOrCancellation artık daha fazla esneklik için PointerEventPass kabul ediyor (ayrıca kaydırma sırasında menü gösteren ExposedDropdownMenuBox düzeltmeleri).(I7579a, b/212091796)
  • Malzeme ve malzeme3 Metin, TextField ve OutlinedTextField öğelerine minLines parametresi eklendi. Bu parametre, satır sayısı (I4af1d) açısından bileşenin minimum yüksekliğinin ayarlanmasını sağlar.
  • TopAppBar oluştururken kullanılması gereken yeni bir topAppBarColors işlevi için TopAppBarDefaults smallTopAppBarColors işlevini kullanımdan kaldırın. (Ie6cb9)
  • BasicText ve BasicTextField öğelerine minLines parametresi eklendi. Bu composable'ların satır sayısına göre minimum yüksekliğinin ayarlanmasını sağlar (I24294, b/122476634).

Hata Düzeltmeleri

  • Material3 IconButton ve IconToggleBotton içeriğini, bileşenin durum katmanı şekline (ör. dairesel şekil) kırpın. (I9da8f)
  • Material3 Medium ve Large üst uygulama çubukları, tüm yüzeye aynı arka plan rengini uygulayacak ve şeffaf renk değerleriyle varsayılan renklerin geçersiz kılınmasına olanak tanıyacak şekilde güncellendi. (I67659, b/249688556, b/250838918)

Sürüm 1.1.0-alpha01

24 Ekim 2022

androidx.compose.material3:material3:1.1.0-alpha01 ve androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.

Hata Düzeltmeleri

  • Başlık, TextStyle ve Brush ile uygulandığında üst uygulama çubuğuna yönelik düzeltmeler yapıldı. (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ü bu kayıtları içerir.

Hata Düzeltmeleri

  • Material3 Medium ve Large üst uygulama çubukları, tüm yüzeye aynı arka plan rengini uygulayacak ve şeffaf renk değerleriyle varsayılan renklerin geçersiz kılınmasına olanak tanıyacak şekilde güncellendi. (I67659, b/249688556, b/250838918)

Sürüm 1.0.0

24 Ekim 2022

androidx.compose.material3:material3:1.0.0 ve androidx.compose.material3:material3-window-size-class:1.0.0 yayınlandı. 1.0.0 sürümü bu kayıtları 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

Pencere Boyutu Sınıfı

  • material3-window-size-class, pencere boyutu sınıflarını destekleyen yeni bir kitaplıktır. Bu, yeniden boyutlandırılabilir uygulama düzenlerini tasarlayıp geliştirebileceğiniz ve test edebileceğiniz, dikkatli görüntü alanı ayrılma noktalarından oluşur. calculateWindowSizeClass kullanarak bir pencere boyutu sınıfı örneği alabilirsiniz. Bu örneği kullanarak kullanıcı arayüzünüzün nasıl görüneceğini belirleyebilirsiniz (örneğin, daha büyük pencere boyutları için alt gezinme bölümü yerine gezinme çubuğu gösterme). Daha fazla bilgi ve örnek kullanım için WindowSizeClass API referansı belgelerine bakın.

  • Ayrıntılı bilgi için lütfen bu blog yayınını inceleyin.

Sürüm 1.0.0-rc01

5 Ekim 2022

androidx.compose.material3:material3:1.0.0-rc01 ve androidx.compose.material3:material3-window-size-class:1.0.0-rc01 yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Metin alanı API'sına metin desteklemek için slot parametresi eklendi (Iaac0d, b/227146125)

Sürüm 1.0.0-beta03

21 Eylül 2022

androidx.compose.material3:material3:1.0.0-beta03 ve androidx.compose.material3:material3-window-size-class:1.0.0-beta03 yayınlandı. 1.0.0-beta03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • ExposedDropdownMenuDefaults artık menü öğeleri için bir dolgu değeri gösteriyor. (I34ee1)
  • ExposedDropdownMenuBoxScope, artık doğru a11y davranışı için metin alanına iletilmesi gereken bir Modifier.menuAnchor() değiştiricisine sahip. (I27fa3)
  • Kullanıcıların kaydırma çubuğunu doldurmak için bir başparmak veya kanalla iletişim kurmalarını sağlamak amacıyla geçerli Slider API'ye iki aşırı yüklenmiş yöntem ekleme. (I21c00)

Hata Düzeltmeleri

  • Hata Kapsayıcısı için koyu tema rengi eşlemesi, ton 90 (Ic5612) ile güncellendi
  • Küçük Material 3 üst uygulama çubuklarında şeffaf bir arka plan ayarlamak için sorunları düzeltin. (I645e2, b/245575782)

Sürüm 1.0.0-beta02

7 Eylül 2022

androidx.compose.material3:material3:1.0.0-beta02 ve androidx.compose.material3:material3-window-size-class:1.0.0-beta02 yayınlandı. 1.0.0-beta02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Beta01 sürümünde m3 bileşenlerinde sunulan varsayılan bileşen ekleri artık IME eklerini dikkate almamaktadır.
  • Material3 Scaffold bileşeninde artık içerik alanı için işlenecek ek öğe miktarının belirtilmesine olanak tanıyan bir contentWindowInsets parametresi bulunuyor. (Icf11a, b/243713323)
  • Deneysel Materyal 3 SmallTopAppBar işlevini kullanımdan kaldırır ve eşdeğer bir TopAppBar işlevi sunar. Lütfen kullanımınızı yeni sürüme taşıyın. (I74404, b/226918634)
  • Üst uygulama çubuğundaki kaydırma ve yapıştırma davranışları üzerinde kontrol sağlar. (I15c81)
  • Bölücü'deki startIndent'i kaldırır, rengi son parametreye taşır. (If7be2)

Hata Düzeltmeleri

  • İletişim Kutuları, görüntülendiklerinde İletişim Kutusu kelimesini söyleyerek talkback kullanıcıları için kendilerini tanıtmaları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ü bu kayıtları içerir.

API Referansı

Mevcut 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 genişletilmiş bir duruma tamamen daraltılarak tutturulacak şekilde güncellendi. Ayrıca, TopAppBarDefaults davranış işlevi Composables olacak şekilde güncellendi ve üst uygulama çubuğu durumu ve animasyon özellikleri için varsayılan değerler sağlandı. (I642b3)
  • FAB bileşen imzaları, yüzey API'siyle (I3afaa) eşleşecek şekilde güncellendi
  • Üst uygulama çubukları, çekmeceler, gezinme çubuğu ve çubuklar için yerleşik destek eklendi. Bu bileşenler, ayrı olarak veya Scaffold ile birlikte kullanıldığında geliştiriciler için insetleri 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ı içermemektedir. Uçtan uca en iyi deneyimi sunabilmek için lütfen bu işlemleri manuel olarak yapmaya devam edin. (I7e4e6, b/183161866)
  • Gelecekteki esneklik ve performans iyileştirmeleri için API yüzeyini küçültmek amacıyla 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, Ayırıcı'dan kaldırıldı ve renk son parametre olarak taşındı.(If7be2)

Sürüm 1.0.0-alfa16

10 Ağustos 2022

androidx.compose.material3:material3:1.0.0-alpha16 ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 yayınlandı. 1.0.0-alpha16 sürümü bu kayıtları 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 simgesi sekmesi parametrelerini yeniden sıralayın (Ie2637)
  • BadgeDefaults deneme olarak işaretlendi. (I98ef3)
  • Kullanımdan kaldırılan gezinme çekmecesi işlevi kaldırıldı. (I4f2db)
  • API ile tutarlılığı korumak için Materyal 3'teki Kaydırma Çubuğu parametrelerini yeniden sıralayın (I0aee7)
  • API içinde tutarlılığı korumak için NavigationBar ve NavigationRail parametrelerini yeniden sıralayın (I51cda)
  • 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)
  • Simge parametresi, üst uygulama çubuğuyla tutarlı olacak şekilde işlemler olarak yeniden adlandırıldı (Id75be)
  • Bağlayıcı hizalaması hâlâ değişimli olduğundan Badge ve BadgedBox uygulamalarını deneysel olarak işaretleyin. (I1712e, b/236524516)
  • Simge düğmesi varyantlarındaki @ExperimentalMaterial3Api ek açıklamalarını @OptIn olarak değiştirin (I070b5)
  • Gezinme çekmecesinin içeriği, özel genişlik belirtilebilmesi için kendi composable'ına ayrıldı. (Ia7f10)
  • Divider, MenuDefaults ve TabDefaults içinden kaldırılır (I4e33c)

Sürüm 1.0.0-alfa15

27 Temmuz 2022

androidx.compose.material3:material3:1.0.0-alpha15 ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 yayınlandı. 1.0.0-alpha15 sürümü bu kayıtları içerir.

Yeni Özellikler

  • Üst uygulama çubuğunun çubuğun kendisinden sürüklenmesine izin ver. (I65c00, b/205873416)

API Değişiklikleri

  • FilterChip ve ElevatedFilterChip API'lerinde yapılan güncellemelerle selectedIcon yuvası kaldırılır ve leadingIcon, seçilen durumu görüntülemek için yeniden kullanılır. (Ie5dc2)
  • Ekose ve dış çizgi varyantı renk rolleri ekleyin. (Id6d54)
  • Varsayılan composable varsayılan adlandırma kurallarını düzeltin. (I62b27)
  • ListItemDefaults ve ListItemColors uygulamalarını 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 TextFieldColors ürününe eklendi. (Iba1b8)
  • Simge içeren düğmelerle kullanılmak üzere ButtonDefault.ButtonWithIconContentPadding ekleniyor. (I2bf9c)
  • Metin alanları, gelecekteki API değişikliklerinde daha fazla esneklik sağlamak için deneysel olarak işaretlenmiştir. (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, renkleri, şekilleri 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 örneklerinden ç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 yayınlandı. Sürüm 1.0.0-alpha14 bu kayıtları içerir.

Yeni Özellikler

  • M3 listesi uygulaması eklendi. Örnek kullanım için dokümanlara bakın (Id7a20)

API Değişiklikleri

  • RangeSlider öğesinde değerler olan parametre adını değere değiştirin (I3b79a)
  • Materyal Tasarım spesifikasyonuna göre seçilebilir bir durumu desteklemek için InputChip uygulamasında API değişiklikleri yapıldı. Seçilen devre dışı durum için FilterChip renklerde ek destek. (I55244, b/235792432)
  • BottomAppBar varsayılan FAB'sini (Ida4c8) ekle
  • ColorScheme.surfaceColorAtElevation eklendi (Id41af)
  • Oluşturma kitaplıklarındaki arayüzler artık jdk8 varsayılan arayüz yöntemleri (I5bcf1) kullanılarak oluşturuluyor
  • WindowWidthSizeClass ve WindowHeightSizeClass artık Karşılaştırılabilir'i uyguluyor. Böylece operatörler (<, <=, >=, >) ve diğer API'ler kullanılarak karşılaştırılabiliyor. (I747d0)

Hata Düzeltmeleri

  • Daha anlamlı içerik açıklaması 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-alfa13

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ı. Sürüm 1.0.0-alpha13 bu kayıtları içerir.

API Değişiklikleri

  • Yapılandırma değişiminde en üstteki uygulama çubuğu konumunu korumayı destekler. (I10459, b/216160958)

Sürüm 1.0.0-alpha12

18 Mayıs 2022

androidx.compose.material3:material3:1.0.0-alpha12 ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 yayınlandı. 1.0.0-alpha12 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Kaydırma çubuğunun üst öğesi artık 0 genişliğe sahip olabilir. (b/231707291)

Sürüm 1.0.0-alpha11

11 Mayıs 2022

androidx.compose.material3:material3:1.0.0-alpha11 ve androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 yayınlandı. Sürüm 1.0.0-alpha11 bu kayıtları içerir.

Yeni Özellikler

  • RangeSlider, Malzeme 3'e eklendi (I18e38)
  • Material3 AssistChip ve InputChip desteği ekler (I0d25a)
  • Material3 FilterChip ve SuggestionChip desteği ekler (I9fdf3)

API Değişiklikleri

  • OutlinedTextField içinde kenarlık çizgisi çizen TextFieldDefaults.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 ver. (Ia2445)

Hata Düzeltmeleri

  • İç dolgunun kullanıldığından emin olmak için malzeme3/Yönlendiriciye lint kontrolü ekleyin (I72293, b/226951418)

Sürüm 1.0.0-alfa10

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ı. Sürüm 1.0.0-alpha10 bu kayıtları içerir.

Yeni Özellikler

  • material3-window-size-class, pencere boyutu sınıflarını destekleyen yeni bir kitaplıktır. Bu, yeniden boyutlandırılabilir uygulama düzenlerini tasarlayıp geliştirebileceğiniz ve test edebileceğiniz, dikkatli görüntü alanı ayrılma noktalarından oluşur. calculateWindowSizeClass kullanarak bir pencere boyutu sınıfı örneği alabilirsiniz. Bu örneği kullanarak kullanıcı arayüzünüzün nasıl görüneceğini belirleyebilirsiniz (örneğin, daha büyük pencere boyutları için alt gezinme bölümü yerine gezinme çubuğu gösterme). Daha fazla bilgi ve örnek kullanım için WindowSizeClass 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 ile BottomAppBar öğesinden sonraki lambdayı kaldırır. (I92c47)
  • Malzeme3 FilledIconButton, FilledTonalIconButton ve OutlinedIconButton ekler. (İb2bda)
  • Material 3 Snackbar API, isteğe bağlı işlem ve kapatma işlemi için renk değerlerini kabul edecek şekilde güncellendi. (Ibe4b4)
  • Kısmi tüketim (düşüş VEYA konum) PointerInputChange içinde kullanımdan kaldırıldı. Değişiklikten tamamen yararlanmak için consume() öğesini kullanabilirsiniz. Başka birinin değişikliği daha önce kullanıp kullanmadığını belirlemek için isConsumed kullanabilirsiniz.
  • PointerInputChange::copy() artık her zaman yüzeysel bir kopya oluşturuyor. Bu, kopyalardan biri tüketildiğinde PointerInputChange kopyalarının kullanılacağı anlamına gelir. Bağlantısız bir PointerInputChange oluşturmak istiyorsanız bunun yerine kurucuyu kullanın. (Ie6be4, b/225669674)
  • Kapsayıcıyı ve içerik renklerini bir CardColors arayüzü aracılığıyla almak ve tıklanabilir kartlar için devre dışı bırakılmasını desteklemek için Cards API'de yapılan değişiklikler. (I927df)
  • backgroundColor parametresi, diğer bileşenlerle daha iyi tutarlılık sağlamak için Materyal 3 metin alanlarında containerColor olarak yeniden adlandırıldı. (I6fbd9)

Hata Düzeltmeleri

  • Material3 spesifikasyonuyla uyumlu olması için standart IconButton üzerinde yapılan güncellemeler (I09eab)
  • Malzeme3'ün üst çubuk yüksekliğini, içeriğe geçirilen dolguya taşıyın ve içeriğin üst uygulama çubuğunun altında oluşturulmasına olanak sağlayın. PaddingValues yoksayılırsa içerik, üst çubuk tarafından gizlenebilir. (I83cbc, b/217776202)

Sürüm 1.0.0-alpha09

6 Nisan 2022

androidx.compose.material3:material3:1.0.0-alpha09 yayınlandı. Sürüm 1.0.0-alpha09 bu kayıtları içerir.

Yeni Özellikler

  • Material 3 Anahtar API'sı eklendi (I2c3ad)

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 "kombo kutular") için destek eklendi. (I1b832)
  • MaterialTheme ve Şekil alt sistemine şekil parametresi eklendi. (I37426)
  • FAB'ın genişletilip daraltılmayacağını kontrol etmek için ExtendedFloatingActionButton öğesine genişletilmiş bir parametre eklendi. Bu parametre, her bir durumun arasında animasyonlarla yer almaktadır. Simgesiz Genişletilmiş FAB'ler için sonda metin olan genişletilmiş FAB'lar için genişletilmiş FAB aşırı yüklemesi eklendi. (Iba7f1)

Sürüm 1.0.0-alpha08

23 Mart 2022

androidx.compose.material3:material3:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü bu kayıtları içerir.

Yeni Özellikler

API Değişiklikleri

  • Menü için varsayılan ayırıcı ekle (I01374)
  • ColorScheme sınıfına surfaceTint renk parametresi eklendi. (I2f558)

Hata Düzeltmeleri

  • Varsayılan metin stili değerini MaterialTheme'den okumak için Material3 Düğmesi'nde düzeltme yapın. (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 kayıtları içerir.

API Değişiklikleri

  • Seçilebilir ve değiştirilebilen Yüzeyleri destekleyen bir işlev eklemenin yanı sıra, tıklanabilir Yüzeyler için aşırı yüklenen işlevleri geri getiren Material 3 Surface API güncellemeleri. (I4bf18)
  • LazyVerticalGrid ve LazyHorizontalGrid kararlı durumda. (I307c0)
  • LazyVerticalGrid/LazyHorizontalGrid ve ilgili tüm API'ler .grid alt paketine taşındı. Lütfen androidx.compose.foundation.lazy'deki içe aktarma işlemlerinizi androidx.compose.foundation.lazy.grid olarak güncelleyin. (I2d446)
  • WindowInsetsControllerCompat için yalnızca bir Görünüme dayalı önceki değişiklik geri alındı ve yine bazı pencere işaretlerini yönetmek için gereken bir Pencere gerekiyor. Doğru pencerenin kullanıldığından emin olmak için (örneğin, iletişim kutusunun olması durumunda) WindowCompat.getInsetsController yerine ViewCompat.getWindowInsetsController desteği sonlandırıldı. (I660ae, b/219572936)
  • Çapraz eksen boyutlarını tanımlamak için yeni bir LazyVerticalGrid API'si eklendi (I17723)

Hata Düzeltmeleri

  • Surface API'deki (I3c8b9) değişiklikleri uygulamak için Card API'deki güncellemeler

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 kayıtları içerir.

API Değişiklikleri

  • Çekmeceler içindeki tek bir hedefi temsil eden NavigationDrawerItem eklendi (Ic396f, b/218286829)
  • PermanentNavigationDrawer ve DismissibleNavigationDrawer deneysel API olarak eklendi. Büyük ekranlı cihazlar için uygun çekmeceler bunlardır. (I5f8ab, b/218286829)
  • Material 3 alt uygulama çubuğu desteğini ekler (Ic432a)
  • NavigationDrawer, ModalNavigationDrawer (I1807d, b/218286829) olarak yeniden adlandırıldı
  • Materyal 3 Kaydırma Çubuğu sınıfı ve jetonlar eklendi (I1ccee)
  • Sekme uygulaması eklendi. Örnek kullanım dokümanlarına bakın (Ie0146)

Hata Düzeltmeleri

  • TalkBack ekran okuyucu doğrusal gezinmesinin 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 gizli AlertDialog düğmeleriyle ilgili 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 kayıtları içerir.

Yeni Özellikler

Materyal Tasarım 3 bileşenleri eklendi

API Değişiklikleri

  • onClick geri çağırması alan Surface işlevi kullanımdan kaldırıldı. Tıklanabilir yüzeyler InteractionSource ve Modifier.clickable() ile oluşturulmalıdır. (I211c6)
  • FAB için basılı ve odaklanmış yükseklik desteği eklendi. (Ibb584)
  • Surface API, farklı durumlardaki görünümünü kontrol etmeye olanak tanıyan bir EngagementSource'u alacak şekilde değiştirildi. (Iafbc8)

Hata Düzeltmeleri

  • Dinamik renk şemalarındaki 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ı. Sürüm 1.0.0-alpha04 bu kayıtları içerir.

API Değişiklikleri

  • Karmaşık bir mantığa sahip olmayan mevcut yöntemlerin aşırı yüklendiği yöntemlere NonRestartableComposable eklendi. Bu, çağrılan iç fonksiyonda tekrarlanan tüm parametreler için derleyici tarafından oluşturulan not alma kontrollerini azaltır (eşittir). (I90490)
  • Malzeme 3 ayırıcı eklendi. (Ica5fc)
  • Onay Kutusu ve RadioButton öğelerini deneysel bir API ek açıklamasıyla işaretleyin. (Ie44bb)
  • Materyal 3 ilerleme göstergeleri için destek eklendi. (Iff232, b/205023841)

Hata Düzeltmeleri

  • Devre dışı bırakılan TextButton's kapsayıcı rengini şeffaf olacak şekilde güncelleyin (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 kayıtları içerir.

Hata Düzeltmeleri

  • Materyal 3'ün MaterialTheme özelliğine LocalIndication 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 hizmetini kullanabilirsiniz.

Sürüm 1.0.0-alpha02

1 Aralık 2021

androidx.compose.material3:material3:1.0.0-alpha02 yayınlandı. Sürüm 1.0.0-alpha02 bu kayıtları içerir.

Yeni Özellikler

  • Onay kutusu ve radyo düğmesi için destek eklendi.
  • Kotlin 1.6.0 ile uyumlu olacak şekilde güncellendi

API Değişiklikleri

  • Malzeme 3'ün iskelesinden çekmeceyi çıkarın. (I04f51)
  • Materyal 3 Checkbox desteği ekler. (Id5542)
  • Materyal 3 RadioButton desteği ekler. (I20334)

Hata Düzeltmeleri

  • IconButton dalga yarıçapını 40 dp'den 20 dp'ye düşürün. (I68bbe, b/206674345)
  • Text için bağlantı noktası dizesinin compose.material tarihinden itibaren hızlı yolu (I30b03)
  • Düzeltildi ancak bu sabit kodlu düğme her zaman etkin olacak. (Iea832, b/205335456)

Sürüm 1.0.0-alpha01

27 Ekim 2021

androidx.compose.material3:material3:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.

Yeni Özellikler

Materyal Tasarım 3 teması ve Material You dinamik rengi

Materyal Tasarım 3 bileşenleri

Daha fazla bilgi için Compose'da Materyal Tema Oluşturma kılavuzundaki Material Design 3 ve Material You bölümüne göz atın.