Compose Material 3
androidx.compose.material3
(सभी कंपोज़ पैकेज के लिए, एपीआई के बारे में जानकारी देने वाले दस्तावेज़ देखें)
| नया अपडेट | स्टेबल रिलीज़ | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
|---|---|---|---|---|
| 22 अक्टूबर, 2025 | 1.4.0 | - | - | 1.5.0-alpha07 |
संरचना
Compose, androidx में मौजूद सात Maven ग्रुप आईडी का कॉम्बिनेशन है. हर ग्रुप में, फ़ंक्शन का एक टारगेट किया गया सबसेट होता है. हर ग्रुप के रिलीज़ नोट का अपना सेट होता है.
इस टेबल में, ग्रुप और रिलीज़ नोट के हर सेट के लिंक के बारे में बताया गया है.
| ग्रुप | ब्यौरा |
|---|---|
| compose.animation | उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, Jetpack Compose ऐप्लिकेशन में ऐनिमेशन बनाएं. |
| compose.compiler | @Composable फ़ंक्शन को बदलें और Kotlin कंपाइलर प्लगिन की मदद से ऑप्टिमाइज़ेशन चालू करें. |
| compose.foundation | इस्तेमाल के लिए तैयार बिल्डिंग ब्लॉक की मदद से, Jetpack Compose ऐप्लिकेशन लिखें. साथ ही, अपने डिज़ाइन सिस्टम के कॉम्पोनेंट बनाने के लिए, फ़ाउंडेशन को बढ़ाएं. |
| compose.material | इस्तेमाल के लिए तैयार मटीरियल डिज़ाइन कॉम्पोनेंट की मदद से, Jetpack Compose यूज़र इंटरफ़ेस (यूआई) बनाएं. यह Compose का टॉप लेवल एंट्री पॉइंट है. इसे ऐसे कॉम्पोनेंट उपलब्ध कराने के लिए डिज़ाइन किया गया है जो www.material.io पर बताए गए कॉम्पोनेंट से मेल खाते हों. |
| compose.material3 | मटीरियल डिज़ाइन 3 कॉम्पोनेंट की मदद से, Jetpack Compose यूज़र इंटरफ़ेस (यूआई) बनाएं. ये कॉम्पोनेंट, मटीरियल डिज़ाइन का अगला वर्शन हैं. Material 3 में, थीमिंग और कॉम्पोनेंट को अपडेट किया गया है. साथ ही, इसमें Material You की मनमुताबिक बनाने की सुविधाएं भी शामिल हैं. जैसे, डाइनैमिक कलर. इसे Android 12 की नई विज़ुअल स्टाइल और सिस्टम यूज़र इंटरफ़ेस (यूआई) के साथ काम करने के लिए डिज़ाइन किया गया है. |
| compose.runtime | Compose के प्रोग्रामिंग मॉडल और स्टेट मैनेजमेंट के बुनियादी बिल्डिंग ब्लॉक. साथ ही, Compose कंपाइलर प्लगिन के लिए कोर रनटाइम, ताकि उसे टारगेट किया जा सके. |
| compose.ui | डिवाइस के साथ इंटरैक्ट करने के लिए, Compose यूज़र इंटरफ़ेस (यूआई) के बुनियादी कॉम्पोनेंट. इनमें लेआउट, ड्रॉइंग, और इनपुट शामिल हैं. |
डिपेंडेंसी का एलान करना
Compose पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.
अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.4.0" implementation "androidx.compose.material3:material3-window-size-class:1.4.0" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha07" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.4.0") implementation("androidx.compose.material3:material3-window-size-class:1.4.0") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha07") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.
सुझाव/राय दें या शिकायत करें
आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या आपके पास इस लाइब्रेरी को बेहतर बनाने के लिए सुझाव हैं, तो हमें बताएं. कृपया नई समस्या सबमिट करने से पहले, इस लाइब्रेरी में शामिल मौजूदा समस्याओं को देखें. स्टार बटन पर क्लिक करके, किसी मौजूदा समस्या के लिए वोट किया जा सकता है.
ज़्यादा जानकारी के लिए, Issue Tracker का दस्तावेज़ देखें.
Compose Material3 का सामान्य वर्शन 1.0
वर्शन 1.0.0-alpha01
17 अप्रैल, 2024
androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01, और androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
थीम के बिना कॉम्पोनेंट, जिनका इस्तेमाल करके मटीरियल डिज़ाइन कॉम्पोनेंट बनाए जा सकते हैं:
- टोनल पैलेट
- आइकॉन
- टच टारगेट का साइज़
Compose Material3 Adaptive Navigation Suite का वर्शन 1.0
वर्शन 1.0.0-alpha07
1 मई, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha07 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- नेविगेशन सुइट एपीआई को एक्सपेरिमेंटल से हटाना (If62af)
गड़बड़ियां ठीक की गईं
- कॉन्टेंट के लिए डिफ़ॉल्ट रूप से इनसेट का इस्तेमाल करना (50266df)
वर्शन 1.0.0-alpha06
17 अप्रैल, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha06 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
NavigationSuiteScaffoldDefaultsमेंcontainerColorऔरcontentColorजोड़ें. (I64e3a, b/331993720)NavigationSuiteDefaultsमेंitemColorsफ़ंक्शन जोड़ा गया. (Idf719, b/328480012)NavigationSuiteScopeको सील करें. (Iefa57)
वर्शन 1.0.0-alpha05
6 मार्च, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha05 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
NavigationSuiteItemColorsकंस्ट्रक्टर को सार्वजनिक करें. (Ica83a, b/324886877)
वर्शन 1.0.0-alpha04
21 फ़रवरी, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha04 में ये बदलाव शामिल हैं.
डिपेंडेंसी से जुड़े अपडेट
- Material3 अडैप्टिव डिपेंडेंसी को नए मॉड्यूल पाथ पर अपडेट करें. (Ibc421)
- विंडो साइज़ क्लास के विंडो मैनेजर वर्शन का इस्तेमाल करने के लिए माइग्रेट करें. (I3794d)
वर्शन 1.0.0-alpha03
7 फ़रवरी, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha03 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- पैकेज का नाम navigation-suite से बदलकर navigationsuite करें (I7eff7)
- Material3 कॉम्पोनेंट, अपने एपीआई में
MutableInteractionSourceको दिखाते हैं. इन्हें अब अपडेट कर दिया गया है. अब ये ऐसेMutableInteractionSourceको दिखाते हैं जो नल हो सकता है और डिफ़ॉल्ट रूप से नल पर सेट होता है. यहां कोई सिमैंटिक बदलाव नहीं किया गया है: null पास करने का मतलब है कि आपकोMutableInteractionSourceको ऊपर नहीं ले जाना है. अगर ज़रूरत होगी, तो इसे कॉम्पोनेंट के अंदर बनाया जाएगा. इसे null पर सेट करने से, कुछ कॉम्पोनेंट कभी भीMutableInteractionSourceको असाइन नहीं करते हैं. साथ ही, अन्य कॉम्पोनेंट सिर्फ़ तब इंस्टेंस बनाते हैं, जब उन्हें इसकी ज़रूरत होती है. इससे इन कॉम्पोनेंट की परफ़ॉर्मेंस बेहतर होती है. अगर इन कॉम्पोनेंट को पास किए गएMutableInteractionSourceका इस्तेमाल नहीं किया जा रहा है, तो हमारा सुझाव है कि आप इसके बजाय null पास करें. हमारा यह भी सुझाव है कि आप अपने कॉम्पोनेंट में भी इसी तरह के बदलाव करें. (I41abb, b/298048146)
वर्शन 1.0.0-alpha02
13 दिसंबर, 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha02 में ये बदलाव शामिल हैं.
नई सुविधाएं
- 'कोई नहीं'
NavigationSuiteTypeजोड़ें (If8cb1, b/313688598)
गड़बड़ियां ठीक की गईं
- जब रूट सर्फ़ेस में
modifier.fillMaxSizeहोता है, तो नेविगेशन कॉम्पोनेंट पूरी स्क्रीन पर दिखने की समस्या ठीक की गई. (c9cf250, b/312664933)
वर्शन 1.0.0-alpha01
15 नवंबर, 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
Compose Material3 का अडैप्टिव वर्शन 1.0
वर्शन 1.0.0-alpha06
7 फ़रवरी, 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha06 में ये बदलाव शामिल हैं.
नई सुविधाएं
ThreePaneScaffoldNavigatorबैक नेविगेशन के लिए, व्यवहार के अतिरिक्त विकल्प जोड़े गए. (I858aa)- नेविगेशन इतिहास में, डेस्टिनेशन का वैकल्पिक कॉन्टेंट जोड़ा गया. (Ibd7e6)
वर्शन 1.0.0-alpha05
24 जनवरी, 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha05 में ये बदलाव शामिल हैं.
नई सुविधाएं
- स्काफ़ोल्ड नेविगेशन और वैल्यू कैलकुलेशन में, इतिहास की जानकारी देने की सुविधा जोड़ी गई (I71d46)
वर्शन 1.0.0-alpha04
10 जनवरी, 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha04 में ये बदलाव शामिल हैं.
नई सुविधाएं
- पेन के स्केफ़ोल्ड में, एज-टू-एज सपोर्ट जोड़ा गया (I1b462)
एपीआई में हुए बदलाव
- पोस्चर में, हिंज बाउंड्री की प्रॉपर्टी को हिंज की जानकारी (I24f90) की सूची में ले जाया गया
गड़बड़ियां ठीक की गईं
AnimatedPaneको फिर से कंपोज़ नहीं किया गया है (c3f573d)
वर्शन 1.0.0-alpha03
13 दिसंबर, 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha03 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- स्काफ़ोल्ड की भूमिकाओं को
ThreePaneScaffoldRoleके उपनामों में बदलें. (I65bd1) - स्काफ़ोल्ड की भूमिकाओं के लिए बेस क्लास बनाएं (I4784d)
AnimatedPaneके कॉन्टेंट (Ibc73b) से ग़ैर-ज़रूरी पैरामीटर हटाएंcollectWindowSizeAsStateका नाम बदलता है और इसके बजाय रॉ वैल्यू दिखाता है (I480f4)
वर्शन 1.0.0-alpha02
29 नवंबर, 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 रिलीज़ किए जाते हैं. वर्शन 1.0.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- नेविगेशन एपीआई को अडैप्टिव स्कैफ़ोल्ड एपीआई से अलग किया गया. (Ic4045)
GutterSizeक्लास हटाएं. (I785b3)
गड़बड़ियां ठीक की गईं
AnimatedPaneका इस्तेमाल न करने पर, फ़िक्स किए गए पैन स्विच नहीं होते हैं (d88f181)
वर्शन 1.0.0-alpha01
15 नवंबर, 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01 रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
Material3 के अडैप्टिव कंडिशन वाले एपीआई:
Material3 के अडैप्टिव पैन के लिए, स्कैफ़ोल्ड डायरेक्टिव एपीआई:
Material3 के अडैप्टिव पैन के लिए, स्कैफ़ोल्ड एपीआई:
- Pane scaffold basic APIs
Compose Material3 वर्शन 1.5
वर्शन 1.5.0-alpha07
22 अक्टूबर, 2025
androidx.compose.material3:material3-*:1.5.0-alpha07 रिलीज़ हो गया है. वर्शन 1.5.0-alpha07 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
keyboardOptionsपैरामीटर के साथ बेहतरSearchBar.InputFieldजोड़ा गया. इससे कीबोर्ड के विकल्प तय करके, टेक्स्ट को ऑप्टिमाइज़ किया जा सकता है. साथ ही,lineLimitsपैरामीटर की मदद से, टेक्स्ट रैपिंग स्क्रोलिंग तय की जा सकती है (Id08a4, b/416991049)
गड़बड़ियां ठीक की गईं
- स्लाइडर में मौजूद एक गड़बड़ी को ठीक किया गया है. इस गड़बड़ी की वजह से, टच डाउन पर प्रेस इंटरैक्शन नहीं हो रहे थे. इस बदलाव से यह पक्का होता है कि
awaitFirstDownपर तुरंतPressInteraction.Pressदिखे, ताकि उपयोगकर्ता को तुरंत विज़ुअल फ़ीडबैक मिल सके. (If9e25, b/308501482) - स्क्रोल करते समय,
Tooltipकैरेट के दिशा न बदलने की समस्या को ठीक किया गया है. अब टूलटिप पॉप-अप के साइड बदलने पर,TooltipBoxफिर से कंपोज़ होता है. इससे यह पक्का होता है कि कैरट की दिशा सही तरीके से अपडेट हो. (I5ad1e, b/438875827)
वर्शन 1.5.0-alpha06
08 अक्टूबर, 2025
androidx.compose.material3:material3-*:1.5.0-alpha06 रिलीज़ हो गया है. वर्शन 1.5.0-alpha06 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
AppBarWithSearchके लिए स्क्रोल किए गए रंग जोड़े गए. इसके अलावा, सर्च बार के इनपुट फ़ील्ड के कंटेनर का रंग अब डिफ़ॉल्ट रूप से पारदर्शी होता है. खोज बार के डिफ़ॉल्ट कंटेनर कलर में कोई बदलाव नहीं किया गया है. (I4fe32)FloatingToolbarमें डिफ़ॉल्ट ओवरफ़्लो इंडिकेटर कंपोज़ेबल जोड़ा गया. (I6a6f8, b/415833723)- बटन ग्रुप में मेन्यू एपीआई के लिए,
isExpandedकोisShowingपर अपडेट करें. (I86309, b/412419514) initialIsExpandedकोinitialIsShowingमें अपडेट किया गया है. साथ ही,ButtonGroupDefaultsमें डिफ़ॉल्ट ओवरफ़्लो इंडिकेटर कंपोज़ेबल जोड़ा गया है. (I6e67c, b/412419514)- सार्वजनिक एपीआई सरफेस (Ic85ba, b/437953743, b/442636084) से, खींचकर साइज़ बदलने की सुविधा हटा दी गई है
गड़बड़ियां ठीक की गईं
- कीबोर्ड नेविगेशन के लिए, कुंजियों के फ़ोकस ऑर्डर को ठीक किया गया है. साथ ही, इसे आरटीएल के लिए भी ठीक किया गया है. (Ibba27, b/422220597)
- डेट पिकर में साल चुनने की ग्रिड में, कीबोर्ड से नेविगेट करने की सुविधा से जुड़ी समस्या ठीक की गई. (I02363, b/422425720, b/446814683)
- तारीख चुनने वाले टूल में, तारीख चुनने की ग्रिड के लिए कीबोर्ड नेविगेशन की समस्या ठीक की गई. (I594ef, b/422220597, b/422223115)
- स्क्रीन से बाहर मौजूद टूलबार पर कीबोर्ड फ़ोकस होने की समस्या ठीक की गई. (I01a73, b/422786812)
RangeSliderऔर स्लाइडर के लिए कीबोर्ड नेविगेशन की सुविधा ठीक की गई. (Ib6bcf, b/424845268, b/422942624)
वर्शन 1.5.0-alpha04
10 सितंबर, 2025
androidx.compose.material3:material3-*:1.5.0-alpha04 रिलीज़ हो गया है. वर्शन 1.5.0-alpha04 में ये बदलाव शामिल हैं.
नई सुविधाएं
Textकंपोज़ेबल ओवरलोड जोड़े गए हैं. येColorProducerलैम्डा को स्वीकार करते हैं. इससे पूरी तरह से फिर से कंपोज़ किए बिना, रंगों में आसानी से बदलाव किया जा सकता है. (I9ff25, b/407055128)
एपीआई में हुए बदलाव
Scrim()का नाम बदलकरLevitatedPaneScrim()करें. साथ ही, Levitated और Reflowed क्लास की प्रॉपर्टी छिपाएं. (I090e1, b/427953101)calculatePosture()एपीआई को इंटरनल के तौर पर छिपाएं (Ie7227, b/424442112)PaneScaffoldHorizontalOrderको सील किए गए सार्वजनिक एपीआई (Ia4ebe) के तौर पर उपलब्ध कराएं- विंडो के साइज़ और पोस्चर से जुड़े एपीआई को एक्सपेरिमेंटल के तौर पर मार्क करें. (I4ee96)
गड़बड़ियां ठीक की गईं
- कीबोर्ड नेविगेशन के क्रम को ठीक किया गया है, ताकि फ़ोकस फ़्लोटिंग ऐक्शन बटन से बदलकर सबसे ऊपर मौजूद पहले आइटम पर चला जाए. (Icaaa1, b/422762939)
- नेविगेशन ड्रॉअर के कीबोर्ड ऐक्सेसिबिलिटी को बेहतर बनाया गया है: खारिज किए जाने पर ड्रॉअर पर अब फ़ोकस नहीं किया जा सकता. इसे Esc कुंजी से बंद किया जा सकता है. साथ ही, खोले जाने पर इसके कॉन्टेंट पर फ़ोकस किया जाता है. (Idb995, b/422793544, b/422793651, b/422797424)
- टाइम पिकर की होम स्क्रीन अब कीबोर्ड नेविगेशन/इनपुट के हिसाब से काम करती है. (I9d5d9, b/425710631)
- पेन को बड़ा करने वाले एंकर की सूची में बदलाव होने पर, नए शुरुआती एंकर का इस्तेमाल करें (I91cd1, b/438829477)
वर्शन 1.5.0-alpha03
27 अगस्त, 2025
androidx.compose.material3:material3-*:1.5.0-alpha03 रिलीज़ हो गया है. वर्शन 1.5.0-alpha03 में ये बदलाव शामिल हैं.
व्यवहार में बदलाव
- चेकबॉक्स के साइज़ और इंडिकेटर के रंगों में बदलाव किया गया है, ताकि वे स्पेसिफ़िकेशन के मुताबिक हों. यूज़र इंटरफ़ेस (यूआई) में रुकावट को कम करने के लिए, माइग्रेशन में मदद करने वाला फ़्लैग
isCheckboxStylingFixEnabledजोड़ा गया है. कृपया इसे अपने ऐप्लिकेशन में मैन्युअल तरीके से चालू करें. आने वाले समय में, इस फ़्लैग को हटा दिया जाएगा. (I5bcd3, b/304300693)
एपीआई में हुए बदलाव
TopAppBar(Ia5fea) के लिएcontentPaddingपैरामीटर जोड़ा गया- नेविगेशन सुइट के लिए कॉम्पोनेंट ओवरराइड जोड़ें (I85312)
गड़बड़ियां ठीक की गईं
TimePickerDialogमेंcontainerColorपैरामीटर अब सही तरीके से लागू हो गया है. इससे डायलॉग बॉक्स के बैकग्राउंड के रंग को पसंद के मुताबिक सेट किया जा सकता है. (I47f89, b/403183883)- मोडल नेविगेशन रेल को छोटा करने पर, अब फ़ोकस नहीं हटता. साथ ही, अब यह ESC बटन दबाने पर बंद हो जाता है. (4255257)
Snackbarमें अब कार्रवाई और खारिज करने वाले बटन के लिए, कीबोर्ड फ़ोकस का सही क्रम है. खारिज करने वाले बटन पर टूलटिप भी दिखाई जा सकती है. (11fa13d)
वर्शन 1.5.0-alpha02
13 अगस्त, 2025
androidx.compose.material3:material3-*:1.5.0-alpha02 रिलीज़ हो गया है. वर्शन 1.5.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
PullToRefreshDefaultsमें,shapeका नाम बदलकरindicatorShapeऔरcontainerColorका नाम बदलकरindicatorContainerColorकर दिया गया है. साथ ही, इंडिकेटर के इस्तेमाल के लिएindicatorMaxDistanceजोड़ा गया है. (Ib6cbe)PullToRefreshDefaults.indicatorColor(Iaaee2) से बंद होने वाला टैग हटाया गयाAppBarWithSearchजोड़ा गया है. यहTopSearchBarकी जगह लेगा और नेविगेशन/ऐक्शन आइकॉन के साथ काम करेगा. (I213a5)
गड़बड़ियां ठीक की गईं
- उस गड़बड़ी को ठीक किया गया है जिसमें बैकप्रेस, ड्रॉअर ऑफ़सेट को गलत तरीके से अपडेट करता है. (I85624, b/427778135)
- अगर कोई अन्य ऐंकर मौजूद नहीं है, तो
SwipeToDismissBoxअब सेटल किए गएtargetValueपर वापस आ जाता है. अगर कोई अन्य ऐंकर मौजूद नहीं है, तोBottomSheetScaffoldअब बड़े किए गएtargetValueपर वापस आ जाता है. (I73d5e, b/428856426) AlertDialogमें बटन की पैडिंग की समस्या ठीक की गई है, जब उन्हें वर्टिकल तरीके से स्टैक किया जाता है. (Ia2118)- [एफ़एबी] उस बग को ठीक किया गया है जिसमें एफ़एबी को
Modifier.animateFloatingActionButtonसे छिपाने के बाद भी उस पर क्लिक किया जा सकता था (I8ea6c, b/430336834) - [स्लाइडर] स्लाइडर के लिए कीबोर्ड नेविगेशन की समस्या ठीक की गई (I3a405)
वर्शन 1.5.0-alpha01
30 जुलाई, 2025
androidx.compose.material3:material3-*:1.5.0-alpha01 रिलीज़ हो गया है. वर्शन 1.5.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
- टूलटिप के लिए, पोज़िशन की जानकारी देने वाले और विकल्प जोड़े गए हैं. इससे डेवलपर यह कंट्रोल कर सकते हैं कि टूलटिप को ऐंकर के ऊपर, नीचे, बाईं ओर या दाईं ओर रखा जाए. केरेट के लिए एक ऐसा एपीआई जोड़ें जो शेप लेता हो, ताकि ज़्यादा कस्टम शेप दिए जा सकें. (Ie513c)
एपीआई में हुए बदलाव
TextFieldColorsअब कॉम्पोनेंट के रंगों का हिसाब लगाने के तरीके सार्वजनिक तौर पर उपलब्ध हैं. (I03165)onDismissकॉलबैक से, निलंबित करने का एनोटेशन हटा दिया गया है. (Ie3166)DatePickerState.getDisplayedMonth(): YearMonth?औरDateRangePickerState.getDisplayedMonth(): YearMonth?को अपडेट किया गया है, ताकि वे ऐसी वैल्यू दिखा सकें जिन्हें शून्य पर सेट नहीं किया जा सकता. (Ice09c, b/427952972)ModalWideNavigationRailDefaultsको हटाएं, इसके कॉन्टेंट कोWideNavigationRailDefaultsमें ले जाएं, और इसके शेप से जुड़े नामों का नाम बदलें. (Ic5e61)WideNavigationRailItem’s colors and copy deprecated functions should be level Hidden. (Id7e82)WideNavigationRailएपीआई के इस्तेमाल बंद होने के लेवल को बदलकर चेतावनी पर सेट किया गया है. साथ ही, इन्हें एक्सपेरिमेंटल बना दिया गया है. (I89085)
गड़बड़ियां ठीक की गईं
- यह कुकी यह पक्का करती है कि
DatePicker, संख्या को फ़ॉर्मैट करने के लिए अपनी स्थानीय भाषा का इस्तेमाल करे. पहले, अगर अरबी भाषा के लिएDatePickerको कॉन्फ़िगर किया गया था, तो डिवाइस के सिस्टम के लिए इस्तेमाल की जाने वाली भाषा में अलग नंबरिंग सिस्टम का इस्तेमाल होने पर, लैटिन अंकों को गलत तरीके से रेंडर किया जा सकता था. (Iccf76, b/432616196) LinearProgressIndicatorसमस्या को ठीक किया गया है. इस समस्या की वजह से, आरटीएल लेआउट में स्टॉप इंडिकेटर सही तरीके से रेंडर नहीं हो रहा था. (I0734c)PrimaryScrollableTabRowऔरSecondaryScrollableTabRowडिवाइडर अब पूरी स्क्रीन पर दिखता है. भले ही, टैब का कॉन्टेंट स्क्रीन के आखिर तक न दिखता हो. (Ic1e9c, b/261741384)
Compose Material3 वर्शन 1.4
वर्शन 1.4.0
24 सितंबर, 2025
androidx.compose.material3:material3-*:1.4.0 रिलीज़ हो गया है. वर्शन 1.4.0 में ये बदलाव शामिल हैं.
1.3.0 के बाद हुए अहम बदलाव:
लाइब्रेरी में किए गए बदलावों के बारे में सूचनाएं
Compose में Material Icons दिखाने के लिए, androidx.compose.material.icons लाइब्रेरी का इस्तेमाल करने का सुझाव अब नहीं दिया जाता. इसकी वजह यह है कि Material Symbols, अब इस्तेमाल करने का नया तरीका है. हमने इस लाइब्रेरी के अपडेट पब्लिश करना बंद कर दिया है. साथ ही, इसे Material 3 लाइब्रेरी की नई रिलीज़ से हटा दिया गया है. अगर आपको अभी माइग्रेट नहीं करना है, तो इसे मैन्युअल तरीके से रेफ़रंस किया जा सकता है.
इसके बजाय, हमारा सुझाव है कि आप https://fonts.google.com/icons के Android टैब से, वेक्टर ड्रॉएबल एक्सएमएल फ़ाइल डाउनलोड करें. इससे आपको स्टाइल वाले नए आइकॉन: Material Symbols का ऐक्सेस मिलेगा.
हम अब लाइब्रेरी का सुझाव क्यों नहीं दे रहे हैं? आइकॉन लाइब्रेरी ("Material Icons") को Material Symbols के नए लुक से बदल दिया गया है. हमने देखा है कि इस लाइब्रेरी की वजह से, आपके ऐप्लिकेशन को बनाने में लगने वाला समय काफ़ी बढ़ सकता है. ऐसा इसलिए, क्योंकि इसमें कई ऐसे आइकॉन शामिल होते हैं जिनकी शायद ज़रूरत न हो.
ज़्यादा जानकारी के लिए: https://developer.android.com/develop/ui/compose/graphics/images/material
व्यवहार में बदलाव
यह लाइब्रेरी अब
material-icons-coreपर डिपेंडेंसी नहीं जोड़ती है. इसलिए, अगर आपका प्रोजेक्ट इस पर निर्भर था, तो आपको अपनी build.gradle[.kts] फ़ाइलों में उस डिपेंडेंसी को साफ़ तौर पर जोड़ना होगा. (I735ff, b/349894318)NavigationBarItemऔरNavigationRailItemके ऐक्टिव लेबल का रंग, इस्तेमाल करने में आसानी, कलर कंट्रास्ट, और सिस्टम में एकरूपता (Ibc297) को बेहतर बनाने के लिए,onSurfaceसे बदलकर सेकंडरी कर दिया गया है. पहले जैसा करने के लिए, डिफ़ॉल्ट रंगों को कॉपी करें औरselectedTextColorकोMaterialTheme.colorScheme.onSurfaceमें बदलें.Material 3 कॉम्पोनेंट अब मोशन तय करने के लिए, नए
MotionSchemeका इस्तेमाल कर रहे हैं. (Ie0f93)सर्कुलर प्रोग्रेस इंडिकेटर की मोशन में बदलाव (I3c07e)
Material Design 3 के नए कॉम्पोनेंट
HorizontalCenteredHeroCarouselVerticalDragHandle- पासवर्ड डालने के फ़ील्ड के लिए सुरक्षित टेक्स्ट फ़ील्ड
मौजूदा Material Design 3 कॉम्पोनेंट में किए गए सुधार
- टेक्स्ट अब
autoSizeके साथ काम करता है- string के साथ टेक्स्ट
- annotatedString के साथ टेक्स्ट
BasicTextField2के लिए, Material 3 डेकोरेटर जोड़े गएTimePickerDialogएपीआई जोड़ा गया है. इसका इस्तेमालTimePicker,TimeInputया स्विच किए जा सकने वाले वर्शन के लिए किया जा सकता है.- खोज बार के नए एपीआई:
- खोज बार को छोटा करने और खोज के "व्यू" को बड़ा करने की सुविधा अब अलग-अलग कंपोज़ेबल हैं:
SearchBarसे, छोटा किया गया खोज बार दिखता है.ExpandedFullScreenSearchBarऔरExpandedDockedSearchBar, खोज बार के बड़े किए गए वर्शन को दिखाते हैं. ये नई विंडो में खुलते हैं.SearchBarStateका इस्तेमाल करके, खोज बार की स्थिति को कंट्रोल करें
- एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई को स्टेबल वर्शन में प्रमोट किया गया!
- परफ़ॉर्मेंस में सुधार किए गए
वर्शन 1.4.0-rc01
10 सितंबर, 2025
androidx.compose.material3:material3-*:1.4.0-rc01 रिलीज़ हो गया है. वर्शन 1.4.0-rc01 में ये बदलाव शामिल हैं.
वर्शन 1.4.0-beta03
27 अगस्त, 2025
androidx.compose.material3:material3-*:1.4.0-beta03 रिलीज़ हो गया है. वर्शन 1.4.0-beta03 में ये बदलाव शामिल हैं.
वर्शन 1.4.0-beta02
13 अगस्त, 2025
androidx.compose.material3:material3-*:1.4.0-beta02 रिलीज़ हो गया है. वर्शन 1.4.0-beta02 में ये बदलाव शामिल हैं.
डिपेंडेंसी में बदलाव
graphics-shapesडिपेंडेंसी हटाएं (I219e0, b/436230765)
एपीआई में हुए बदलाव
PullToRefreshDefaultsमें,shapeका नाम बदलकरindicatorShapeऔरcontainerColorका नाम बदलकरindicatorContainerColorकर दिया गया है. साथ ही, इंडिकेटर के इस्तेमाल के लिएindicatorMaxDistanceजोड़ा गया है. (Ib6cbe)PullToRefreshDefaults.indicatorColor(Iaaee2) से बंद होने वाला टैग हटाया गयाBasicAlertDialogOverrideScopeको गलती से स्टेबल वर्शन में प्रमोट कर दिया गया था. साथ ही, aosp/3701846 में इसके एक्सपेरिमेंटल एनोटेशन को हटा दिया गया था. इसे इंटरनल के तौर पर मार्क किया जा रहा है. यह 1.5.0-ऐल्फ़ा (I9182a) में, एक्सपेरिमेंट के तौर पर सार्वजनिक तौर पर उपलब्ध रहेगी
गड़बड़ियां ठीक की गईं
- उस गड़बड़ी को ठीक किया गया है जिसमें बैकप्रेस, ड्रॉअर ऑफ़सेट को गलत तरीके से अपडेट करता है. (I85624, b/427778135)
वर्शन 1.4.0-beta01
30 जुलाई, 2025
androidx.compose.material3:material3-*:1.4.0-beta01 रिलीज़ हो गया है. वर्शन 1.4.0-beta01 में ये बदलाव शामिल हैं.
नुकसान पहुंचा सकने वाले बदलाव
ExperimentalMaterial3ExpressiveApiयाExperimentalMaterial3ComponentOverrideApiके तौर पर टैग किए गए सभी सार्वजनिक एपीआई हटा दिए गए हैं. इन सुविधाओं का इस्तेमाल जारी रखने के लिए, कृपया1.5.0-alphaपर स्विच करें. (Ie4ae0)- कृपया ध्यान दें कि अगली रिलीज़ में, इन स्टेबल
pullToRefreshएपीआई के नाम बदल दिए जाएंगे. (Ib6cbe)
नई सुविधाएं
Tooltipमें अब कैरेट के आकार और कैरेट की पोज़िशन (ऐंकर के ऊपर, नीचे, बाएं या दाएं) को पसंद के मुताबिक सेट करने की सुविधा उपलब्ध है. (Ie513c)
एपीआई में हुए बदलाव
onDismissकॉलबैक से, निलंबित करने का एनोटेशन हटा दिया गया है. (Ie3166)DatePickerState.getDisplayedMonth(): YearMonth?औरDateRangePickerState.getDisplayedMonth(): YearMonth?को अपडेट किया गया है, ताकि वे ऐसी वैल्यू दिखा सकें जिन्हें शून्य पर सेट नहीं किया जा सकता. (Ice09c, b/427952972)ModalWideNavigationRailDefaultsको हटाएं, इसके कॉन्टेंट कोWideNavigationRailDefaultsमें ले जाएं, और इसके शेप से जुड़े नामों का नाम बदलें. (Ic5e61)
गड़बड़ियां ठीक की गईं
- यह कुकी यह पक्का करती है कि
DatePicker, संख्या को फ़ॉर्मैट करने के लिए अपनी स्थानीय भाषा का इस्तेमाल करे. पहले, अगर अरबी भाषा के लिएDatePickerको कॉन्फ़िगर किया गया था, तो डिवाइस के सिस्टम के लिए इस्तेमाल की जाने वाली भाषा में अलग नंबरिंग सिस्टम का इस्तेमाल होने पर, लैटिन अंकों को गलत तरीके से रेंडर किया जा सकता था. (Iccf76, b/432616196) LinearProgressIndicatorसमस्या को ठीक किया गया है. इस समस्या की वजह से, आरटीएल लेआउट में स्टॉप इंडिकेटर सही तरीके से रेंडर नहीं हो रहा था. (I0734c)PrimaryScrollableTabRowऔरSecondaryScrollableTabRowडिवाइडर अब पूरी स्क्रीन पर दिखता है. भले ही, टैब का कॉन्टेंट स्क्रीन के आखिर तक न दिखता हो. (Ic1e9c, b/261741384)
वर्शन 1.4.0-alpha18
16 जुलाई, 2025
androidx.compose.material3:material3-*:1.4.0-alpha18 रिलीज़ हो गया है. वर्शन 1.4.0-alpha18 में ये बदलाव शामिल हैं.
नई सुविधाएं
ModalBottomSheetPropertiesअब स्क्रिम पर क्लिक करके dismissRequest को बंद करने का विकल्प देता है. (I8e715)RangeSliderके ट्रैक में,trackCornerSizeके साथ काम करने की सुविधा जोड़ी गई. (Iec529)
एपीआई में हुए बदलाव
WideNavigationRailItemके लिएrailExpandedको ज़रूरी पैरामीटर बनाया गया,WideNavigationRailColorsके लिएmodalContentColorजोड़ा गया, औरWideNavigationRailDefaults.modalContainerShapeकोModalWideNavigationRailDefaults.containerShapeपर ले जाया गया. (Id60c5)WideNavigationRailके नए कलर फ़ंक्शन पैरामीटर को आखिरी पैरामीटर के तौर पर सेट करें और पुराने फ़ंक्शन को बंद करें. (Iac7f7)PullToRefreshअब एक स्टेबल एपीआई (I18537) हैDatePickersAPI से जुड़े अपडेट. हमनेDateRangePickerके लिए, खत्म होने की तारीख को डिफ़ॉल्ट रूप से शून्य पर सेट करने की सुविधा हटा दी है. साथ ही, इसे पास करना ज़रूरी बना दिया है. हमने एपीआई के दस्तावेज़ में, तारीख को दिखाने के लिए यूटीसी के हिसाब से आधी रात के इस्तेमाल के बारे में भी बताया है. साथ ही, java.time API का इस्तेमाल करने वाले नए गेटर और सेटर को फ़िलहाल एक्सपेरिमेंटल के तौर पर मार्क किया है. (I121b3, b/427952972)tint: ColorProducerपैरामीटर वाले आइकॉन एपीआई को एक्सपेरिमेंट के तौर पर उपलब्ध सुविधा से हटाना. (Ia0133)DatePicker,DateRangePicker, और उनसे जुड़ी स्थितियों, क्लास, और टाइप से एक्सपेरिमेंट के तौर पर उपलब्ध एनोटेशन हटा दिए गए हैं. (I0e4e0, b/391848485)- a11y फ़ोकस की समस्या को ठीक करने के लिए, फ़ोकस किए जा सकने वाले डिफ़ॉल्ट वैल्यू को बदलकर false कर दिया गया है. साथ ही,
TooltipBoxमेंhasActionपैरामीटर जोड़ा गया है. (I62998) WideNavigationRail,ShortNavigationBar, औरNavigationItemएपीआई के एक्सपेरिमेंटल वर्शन को स्टेबल वर्शन में अपग्रेड किया गया. (I3ca3c)- ऐप्लिकेशन बार के कुछ फ़ंक्शन, सपोर्ट करने वाली क्लास, और ऑब्जेक्ट से
@ExperimentalMaterial3Apiएनोटेशन हटा दिए गए हैं. (I0a9b7)
वर्शन 1.4.0-alpha17
2 जुलाई, 2025
androidx.compose.material3:material3-*:1.4.0-alpha17 रिलीज़ हो गया है. वर्शन 1.4.0-alpha17 में ये बदलाव शामिल हैं.
नई सुविधाएं
- बटन ग्रुप के ऐनिमेशन को अपडेट किया गया है. अब बटन को दबाने के बजाय क्लिक करने पर, ऐनिमेशन 75% तक ऐनिमेट होगा. (593942a, b/423596967)
गड़बड़ियां ठीक की गईं
- हमने उस समस्या को ठीक कर दिया है जिसमें लेआउट कैलकुलेशन के दौरान, कुछ मामलों में कैरसेल आइटम का साइज़ बड़े एलिमेंट के साइज़ से ज़्यादा हो जाता था. इससे पूरा विजेट कट जाता था. (I1c3d7, b/397489534)
- शुरू और खत्म होने की शिफ्ट के ऐसे ऑफ़सेट को स्क्रोल करते समय
beforeContentPaddingके आगे बढ़ने की समस्या ठीक की गई है जो एक-दूसरे से ओवरलैप होते थे. (c3d5f3a, b/420618979) SwipeToDismissके चालू होने की स्थिति को अपडेट करें, ताकि मौजूदा स्थिति के बजाय सेटल की गई स्थिति को देखा जा सके. यह कुकी, पहले जैसी सेटिंग को वापस लाती है. इसमें ऐंकर के व्यवहार को सिर्फ़ तब बंद किया जाता है, जब कॉम्पोनेंट को खारिज कर दिया जाता है. (3844e07, b/425006844)- अब कीबोर्ड की मदद से,
ExposedDropdownMenuका पॉप-अप मेन्यू खोला जा सकता है. इसके अलावा, बदलाव किए जा सकने वाले वर्शन के लिए, मेन्यू को कीबोर्ड से ऐक्सेस करने की समस्या को भी ठीक किया गया है. (46ead03)
वर्शन 1.4.0-alpha16
18 जून, 2025
androidx.compose.material3:material3-*:1.4.0-alpha16 रिलीज़ हो गया है. वर्शन 1.4.0-alpha16 में ये बदलाव शामिल हैं.
नई सुविधाएं
- सेंटर में अलाइन किया गया हीरो कैरसेल कॉम्पोनेंट (I6f6d3) जोड़ा गया
एपीआई में हुए बदलाव
- वर्टिकल टूलबार को बदलने की सुविधा लागू करें (Ia1604)
CarouselStateमें प्रोग्राम के हिसाब से स्क्रोल करने के फ़ंक्शन जोड़े गए (I12f8e)ModalWideNavigationRailके लिएComponentOverrideजोड़ा गया (I4f440)WideNavigationRailके लिएComponentOverrideजोड़ा गया (I6354f)HorizontalFloatingToolbar(I51116) के लिएComponentOverrideबनाएंShortNavigationBarके लिएComponentOverrideबनाएं (I30e24)SwipeToDismissBoxStateमेंconfirmValueChangeके रेफ़रंस को 'इस्तेमाल नहीं किया जा सकता' के तौर पर मार्क किया गया है. इसके बजाय, उपयोगकर्ताओं कोSwipeToDismissBoxएपीआईonDismissedकॉलबैक का इस्तेमाल करना चाहिए. (Iee780)- कैरसेल कंपोज़ेबल में userScrollEnabled पैरामीटर जोड़ा गया. (I1d4d2)
- अब
CarouselStateसे कैरसेल केcurrentItemको देखा जा सकता है. (Ie87e9)
गड़बड़ियां ठीक की गईं
- ऐसी समस्या को ठीक किया गया है जिसमें
FloatingToolbarको पास किए गए FAB पर मौजूद किसी भी आकार पर, शैडो सही तरीके से लागू नहीं हो रही थी. (Icdcc9, b/423336922) - अब सभी कैरसेल, डिफ़ॉल्ट रूप से कैरसेल की सिमैंटिक भूमिका का इस्तेमाल करते हैं. (I7af12)
LaunchedEffectके ज़रिए स्लाइडर की स्थिति अपडेट होने पर, थंब के गलत तरीके से हिलने की समस्या ठीक की गई (Id9f31, b/302774166)
वर्शन 1.4.0-alpha15
20 मई, 2025
androidx.compose.material3:material3-*:1.4.0-alpha15 रिलीज़ हो गया है. वर्शन 1.4.0-alpha15 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
MotionTheme.LocalMotionScheme, कंपोज़िशन लोकल को जोड़ा गया. इससेCompositionLocalConsumerModifierNodesसे थीम मोशन स्कीम को ऐक्सेस किया जा सकता है. इसके लिए,currentValueOf(MotionTheme.LocalMotionScheme)का इस्तेमाल किया जाता है. (I014b1)- फ़िक्स्ड कलर रोल के बिना
ColorSchemeकंस्ट्रक्टर का इस्तेमाल अब नहीं किया जा सकता. कृपया उस कंस्ट्रक्टर पर माइग्रेट करें जिसमें तय की गई भूमिकाएं शामिल हों. (Iad0ee) - M3 टेक्स्ट कॉम्पोनेंट अब
TextAutoSizeके साथ काम करता है. (I7f524) - स्प्लिट बटन के साइज़ के वैरिएंट बनाने के लिए एपीआई जोड़ें और सैंपल जोड़ें. (Ice30b)
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसकी वजह से, एज-टू-एज सुविधा चालू होने पर
SnackbarऔरFloatingActionButtonगलत जगह पर दिख रहे थे. Scaffold अब इन कॉम्पोनेंट में हॉरिज़ॉन्टल इंसर्ट को सही तरीके से लागू करता है. (Ib7c30, b/244400727) BottomSheetमोशन को पूरी तरह से बड़ा किए गए से बदलकर, कुछ हद तक बड़ा किया गया करें.BottomSheetअब छिपाने या छोटा करने के लिए,MotionSchemeके फ़ास्ट-इफ़ेक्ट का इस्तेमाल करता है. साथ ही, बड़ा करने के लिए डिफ़ॉल्ट-स्पेशल का इस्तेमाल करता है. (Ifa46f, b/416063171)- सरफ़ेस कंटेनर की भूमिकाओं के बिना
ColorSchemeकंस्ट्रक्टर को छिपा हुआ के तौर पर मार्क कर दिया गया है. अब इसका इस्तेमाल करने का सुझाव नहीं दिया जाता. (Ia7237) - ज़्यादा विकल्प देने के लिए,
CircularWavyProgressIndicatorSize.minDimension > 0की ज़रूरी शर्त हटा दी गई है. पहले, इस शर्त के पूरा न होने पर अपवाद दिखता था. (Ic9418, b/377531195) Text(AnnotatedString)में हाइपरलिंक के लिए, अब डिफ़ॉल्ट रूप से मटीरियल स्टाइलिंग उपलब्ध है. (I78288, b/339843816)- उस समस्या को ठीक किया गया है जिसमें
RoundedPolygonमें मौजूदtoShape()फ़ंक्शन, पाथ को कैश मेमोरी में सेव कर रहा था. इसकी वजह से, अलग-अलग साइज़ के साथ कईcreateOutlineकॉल किए जाने पर समस्या आ रही थी. (I4026d)
वर्शन 1.4.0-alpha14
7 मई, 2025
androidx.compose.material3:material3-*:1.4.0-alpha14 रिलीज़ हो गया है. वर्शन 1.4.0-alpha14 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- एक नया
AppBarColumnकंपोज़ेबल जोड़ा गया है. यहAppBarRowकी तरह ही काम करता है, लेकिन इसका इस्तेमाल कॉलम में मौजूद कॉन्टेंट के लिए किया जाता है. (Iaf6bd) AppBarRowमें ज़्यादा से ज़्यादा आइटम जोड़े गए. टॉप ऐप्लिकेशन बार के लिए, मटीरियल स्पेसिफ़िकेशन को सही तरीके से लागू करने के लिए यह ज़रूरी है. (I92ce4)- ऐंकर के
layoutCoordinatesको पाने के लिए,TooltipScopeमें एक तरीका जोड़ा गया.drawCaretतरीके को बंद किया जा रहा है, क्योंकि डेवलपर इस नए तरीके का इस्तेमाल करके ऐंकर बाउंडlayoutCoordinatesहासिल कर सकते हैं. साथ ही, ऐसा सही शेप बना सकते हैं जिसमें कैरट शामिल हो. (Ia2e12, b/329470609) java.timeमें तारीख चुनने की सुविधा जोड़ी गई:rememberDatePickerState/rememberDateRangePickerStateओवरलोड पेश किए गए हैं.ये java.time ऑब्जेक्ट स्वीकार करते हैं. जैसे, शुरुआतीLocalDate,YearMonth. साथ ही,LocalDateऔरYearMonthजैसे टाइप का इस्तेमाल करके वैल्यू पाने/सेट करने के लिए, स्टेट ऑब्जेक्ट पर एक्सटेंशन फ़ंक्शन जोड़े गए हैं. इसके लिए, एपीआई 26 या इसके बाद का वर्शन या डिसुगरिंग ज़रूरी है. (I70f29, b/266202516, b/281859606)CenteredTrackकंपोज़ेबल जोड़ा गया है. इससे, बीच से शुरू होने वाले ट्रैक के साथ स्लाइडर का इस्तेमाल किया जा सकेगा. (I5b1d6)
गड़बड़ियां ठीक की गईं
- वेवी प्रोग्रेस इंडिकेटर की परफ़ॉर्मेंस को बेहतर बनाया गया है: लीनियर टाइप अब ~8.5% तेज़ी से लोड होते हैं और इनमें ~11% कम जगह लगती है. वहीं, सर्कुलर टाइप की स्पीड में ~47% की बढ़ोतरी हुई है और इनमें ~39% कम जगह लगती है. (I595d8)
वर्शन 1.4.0-alpha13
23 अप्रैल, 2025
androidx.compose.material3:material3-*:1.4.0-alpha13 रिलीज़ हो गया है. वर्शन 1.4.0-alpha13 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
isAppearanceLightStatusBarsऔरisAppearanceLightNavigationBarsकोModalBottomSheetPropertiesमें फिर से शामिल किया गया है. ये सिर्फ़ Android के पैरामीटर के तौर पर उपलब्ध हैं. (Id4bc0)- एक
AppBarRowकंपोज़ेबल जोड़ें, जो अपनी सीमाओं से बाहर फ़िट होने वाले आइटम के ओवरफ़्लो को मैनेज करता है. (I742bd) - तारीख डालने के मोड पर स्विच करते समय फ़ोकस का अनुरोध करने के लिए,
DatePickerऔरDateRangePickerएपीआई को अपडेट करें. हमनेrequestFocusबूलियन पैरामीटर को एक वैकल्पिकfocusRequesterपैरामीटर से बदल दिया है. यहFocusRequesterलेता है. (I14b69) - डिफ़ॉल्ट रूप से क्लिक किए जा सकने वाले और टॉगल किए जा सकने वाले आइटम से, मॉडिफ़ायर और इंटरैक्शन सोर्स हटाएं. इसके बजाय, इसे लागू करने से जुड़ी जानकारी के तौर पर इस्तेमाल करें. (I95ed6)
- स्क्रीन पर बहुत ज़्यादा बटन होने पर,
ButtonGroupको ड्रॉपडाउन मेन्यू में बदल दिया गया है. (I7b88b)
गड़बड़ियां ठीक की गईं
- Bottomsheet अब टॉप इनसेट का इस्तेमाल करता है, जब वह मौजूदा ऑफ़सेट से छोटा होता है. इससे उपयोगकर्ताओं को, बड़े किए गए व्यवहार के लिए टॉप इनसेट उपलब्ध कराने की अनुमति मिलती है.
BottomSheetDefaults.windowInsetsमें अबWindowInsets.safeDrawing.Topशामिल है. (I0ab67, b/321877275, b/336962418, b/342093067) - चिप में मौजूद लीडिंग आइकॉन/अवतार और ट्रेलिंग आइकॉन के लिए, जोड़ने या हटाने पर फ़ेड/स्लाइड वाले ऐनिमेशन चालू किए गए. इससे मुख्य रूप से, चुने जा सकने वाले चिप (फ़िल्टर, इनपुट) को फ़ायदा मिलता है. हालांकि, यह सुविधा आम तौर पर लागू होती है. (I9af21)
LookaheadScopeकी वजह से, आरटीएल स्लाइडर के काम न करने की समस्या को ठीक किया गया. (Ieb152, b/408118041)- सिस्टम यूज़र इंटरफ़ेस (यूआई) को छिपाकर स्क्रोल करने पर, बॉटम
AppBarके क्रैश होने की समस्या ठीक की गई. (Ic6140, b/405996228)
वर्शन 1.4.0-alpha12
9 अप्रैल, 2025
androidx.compose.material3:material3-*:1.4.0-alpha12 रिलीज़ हो गया है. वर्शन 1.4.0-alpha12 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
ModalBottomSheetProperties(Iab97f, b/362539765) से Android के लिए खास तौर पर बनाए गए पैरामीटर हटाए गए- ड्रैग हैंडल के साइज़ के डिफ़ॉल्ट फ़ंक्शन के लिए ओवरलोडिंग फ़ंक्शन जोड़े गए (I0ed0d)
- नए लेआउट टाइप के लिए, नए
NavigationSuiteScaffoldऔरNavigationSuiteScaffoldLayoutफ़ंक्शन जोड़े गए हैं. साथ ही, वैकल्पिक प्राइमरी ऐक्शन कॉन्टेंट के लिए सहायता जोड़ी गई है. (Ib262a, b/353144478) ButtonGroupमें फ़िल पैरामीटर के साथModifier.weightको बंद कर दिया गया है. बिना फ़िल किए गए वर्शन को जोड़ना. (Id32bb)xSmall-औरxLarge-IconButton कॉम्पोनेंट के डिफ़ॉल्ट नाम बदलकरextraकर दिए गए हैं. (Ib6e0f)- नए लेआउट टाइप के साथ काम करने के लिए, नए
NavigationSuite,NavigationSuiteItem, औरNavigationSuiteColorsफ़ंक्शन जोड़े गए हैं. (I203d6) - नए
NavigationSuiteTypesऔरnavigationSuiteTypeफ़ंक्शन जोड़ें, जिनमें लेआउट के वे विकल्प शामिल हों (If68f9)
गड़बड़ियां ठीक की गईं
ColorScheme.contentColorForअबsurfaceDimकोonSurfaceपर मैप करता है. (I8891a)DateInputTextFieldको अपडेट किया गया है. इससे उस समस्या को ठीक किया जा सकेगा जिसमें इनपुट फ़ील्ड में, प्रोग्राम के हिसाब से सेट की गई तारीख नहीं दिखती थी. (I6c8d1, b/401143451)- नेविगेशन रेल और वाइड नेविगेशन रेल के लिए, TalkBack के फ़ोकस का क्रम ठीक किया गया (I6cf6f, b/407048224)
वर्शन 1.4.0-alpha11
26 मार्च, 2025
androidx.compose.material3:material3-*:1.4.0-alpha11 रिलीज़ हो गया है. वर्शन 1.4.0-alpha11 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- बटन और टॉगल बटन के लिए, डिफ़ॉल्ट ऑब्जेक्ट में कंपोज़ेबल प्रॉपर्टी के लिए कैपिटल लेटर अपडेट किए गए. कंटेनर की ऊंचाई के हिसाब से, सुझाए गए कॉन्टेंट पैडिंग, शेप, आइकॉन के साइज़, आइकॉन के बीच की दूरी, और टेक्स्ट स्टाइल के लिए,
ToggleButtonDefaultsऔरButtonDefaultsमें तरीके जोड़ें. (Iea69e) FloatingToolbarसे, एक्सपेरिमेंट के तौर पर उपलब्ध ऐसे फ़ंक्शन और कॉन्स्टेंट हटा दिए गए हैं जिनका इस्तेमाल अब नहीं किया जा सकता. (I8f339)- एलिवेशन कॉम्पोनेंट अब एक सामान्य इंटरफ़ेस शेयर करते हैं. साथ ही, इनमें सार्वजनिक कंस्ट्रक्टर और प्रॉपर्टी होती हैं. (Ibb172)
ButtonGroupScopeमेंanimateWidthमॉडिफ़ायर जोड़ा गया है. इसका इस्तेमाल बटन ग्रुप के बच्चों के साथ करना होगा, ताकि बच्चों को सही तरीके से ऐनिमेट किया जा सके. (Ia3bb6)
गड़बड़ियां ठीक की गईं
- फ़्लोटिंग टूलबार की पैडिंग को ठीक किया गया है, ताकि छोटा होने पर भी विज़ुअल बैलेंस बना रहे. साथ ही, बड़े कॉन्टेंट के लिए बेहतर फ़्लेक्सिबिलिटी दी गई है. (I06c00)
वर्शन 1.4.0-alpha10
12 मार्च, 2025
androidx.compose.material3:material3-*:1.4.0-alpha10 रिलीज़ हो गया है. वर्शन 1.4.0-alpha10 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
TabRowDefaults.tabIndicatorOffsetकी जगह अबTabIndicatorScope.tabIndicatorOffsetका इस्तेमाल किया जाता है. (Ib36b3)- बटन के डिफ़ॉल्ट में, कॉन्टेंट के लिए कम पैडिंग की वजह से हुई टाइपिंग की गड़बड़ी को ठीक किया गया. (I19bfe)
TabRowऔरScrollableTabRowअब काम नहीं करते. इनकी जगह, हर एक के प्राइमरी और सेकंडरी वैरिएंट का इस्तेमाल किया जाता है. प्राइमरी और सेकंडरी टैब की लाइनें, स्पेसिफ़िकेशन के मुताबिक ज़्यादा सटीक और बेहतर तरीके से काम करती हैं. (I918e2)rememberSliderStateऔरrememberRangeSliderStateको जोड़ा गया. (I8e384)- ऑटो-स्नैपिंग मैकेनिज़्म को कंट्रोल करने के लिए,
SliderStateमेंshouldAutoSnapजोड़ा गया. इसे बंद करने से, कस्टम ऐनिमेशन के लिए फ़ायदा मिल सकता है. (I07745) - स्क्रोल की जा सकने वाली टैब लाइन में टैब की कम से कम चौड़ाई अब एक पैरामीटर है. प्राइमरी और सेकंडरी टैब की लाइन के वैरिएंट अब एक्सपेरिमेंट के तौर पर उपलब्ध नहीं हैं. (If6f15, b/226665301)
- क्लास
ExitAlwaysFloatingToolbarScrollBehaviorको सार्वजनिक कर दिया गया है, ताकि कंपोज़िशन के बिना क्लास बनाई जा सके. (Ibf31c)
वर्शन 1.4.0-alpha09
26 फ़रवरी, 2025
androidx.compose.material3:material3-*:1.4.0-alpha09 रिलीज़ हो गया है. वर्शन 1.4.0-alpha09 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- डिफ़ॉल्ट स्थिति में
DragHandleके सेटिंग फ़ील्ड का नाम बदलें; दबाए गए और खींचे गए स्टेटस को अलग-अलग करें; डिफ़ॉल्ट साइज़ को सार्वजनिक करें. (I787b9) TowRowsTopAppBarAPI से जुड़े अपडेट.expandedलैंबडा पैरामीटर को हटा दिया गया है. साथ ही, एक्सपैंड और कोलैप्स की गई ऊंचाई के लिए अलग-अलग पैरामीटर जोड़े गए हैं. (Idd677, b/306697446, b/229134133, b/268068946)
गड़बड़ियां ठीक की गईं
- सबसे नीचे मौजूद ऐप्लिकेशन बार अब टच एक्सप्लोरेशन सेवा का इस्तेमाल करते हैं. जैसे,
TalkBack) और सेवा चालू होने पर उन्हें हमेशा दिखने दें. (I4b34d)
वर्शन 1.4.0-alpha08
12 फ़रवरी, 2025
androidx.compose.material3:material3-*:1.4.0-alpha08 रिलीज़ हो गया है. वर्शन 1.4.0-alpha08 में ये बदलाव शामिल हैं.
नई सुविधाएं
TimePickerDialogएपीआई जोड़ा गया है. इसका इस्तेमालTimePicker,TimeInputया स्विच किए जा सकने वाले वर्शन के लिए किया जा सकता है. (Id2d83)खोज बार के लिए नए एपीआई:
- खोज बार को छोटा करने और खोज के "व्यू" को बड़ा करने की सुविधा, अब अलग-अलग कंपोज़ेबल हैं.
SearchBarसे, छोटा किया गया खोज बार दिखता है.ExpandedFullScreenSearchBarऔरExpandedDockedSearchBar, खोज बार के बड़े किए गए वर्शन को दिखाते हैं. ये नई विंडो में खुलते हैं.SearchBarStateका इस्तेमाल करके, खोज बार की स्थिति को कंट्रोल करनाTopSearchBarको जोड़कर, इनसेट हैंडलिंग और स्क्रोल करने के तरीके को बेहतर बनाया जा सकता हैInputFieldका नया ओवरलोड, जोSearchBarStateका इस्तेमाल करता है (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)
एपीआई में हुए बदलाव
- बटन दबाने पर, आइकॉन बटन के कॉर्नर के आकार में बदलाव करने की सुविधा. (I21843)
- टेक्स्ट फ़ील्ड डेकोरेटर/डेकोरेशन बॉक्स एपीआई अब एक्सपेरिमेंटल नहीं हैं. (I31d95)
ButtonGroupके लिए, कनेक्ट किए गए वैरिएंट के सैंपल और डिफ़ॉल्ट वैल्यू जोड़ी गई हैं. (I5c8ce)NavigationSuiteScaffoldऔरNavigationSuiteScaffoldLayoutमें, state पैरामीटर को आखिरी पैरामीटर बनाएं. (I9cc7b)
गड़बड़ियां ठीक की गईं
FloatingToolbarsमें सुलभता से जुड़ी कस्टम कार्रवाइयां जोड़ी गईं, ताकि सुलभता सेवाएं अबFloatingToolbarके सभी वर्शन को बड़ा या छोटा कर सकें. एफ़एबी वाले वर्शन में, इसे एफ़एबी पर लागू किया जाता है. वहीं, एफ़एबी के बिना वाले वर्शन में, इसे मुख्य कॉन्टेंट पर लागू किया जाता है. (I26420)FloatingToolbarsअब टच एक्सप्लोरेशन सेवा का इस्तेमाल करते हैं. जैसे, TalkBack) की सुविधा चालू होने पर, टूलबार को बड़ा करके रखें, ताकि वह हमेशा दिखता रहे. (I02172)- अगर प्रोग्रेस के तौर पर
Float.NaNपास किया जाता है, तो प्रोग्रेस और लोडिंग इंडिकेटर में क्रैश होने की समस्या ठीक की गई है. (I4fa96, b/352364576)
वर्शन 1.4.0-alpha07
29 जनवरी, 2025
androidx.compose.material3:material3-*:1.4.0-alpha07 रिलीज़ हो गया है. वर्शन 1.4.0-alpha07 में ये बदलाव शामिल हैं.
नई सुविधाएं
- नए एपीआई की मदद से, चेकबॉक्स के दिखने के तरीके को अपनी पसंद के मुताबिक बनाने की सुविधा जोड़ी गई है. यह एपीआई, स्ट्रोक पैरामीटर उपलब्ध कराता है. इनकी मदद से, चेक मार्क और चेकबॉक्स-आउटलाइन को रेंडर करने के तरीके पर ज़्यादा कंट्रोल पाया जा सकता है. (I65a88)
- दो लाइनों वाले टॉप ऐप्लिकेशन बार बनाने के लिए,
TwoRowsTopAppBarएपीआई जोड़ा गया है. यह मीडियम और लार्ज ऐप्लिकेशन बार का ज़्यादा पसंद के मुताबिक बनाया जा सकने वाला विकल्प है. डेवलपर के पास अब टाइटल और सबटाइटल के कॉन्टेंट को कंट्रोल करने का विकल्प है. वे यह तय कर सकते हैं कि टाइटल और सबटाइटल, छोटे किए गए वर्शन में कैसे दिखेंगे और बड़े किए गए वर्शन में कैसे दिखेंगे. साथ ही, वे हर वर्शन के लिए टाइटल और सबटाइटल की ऊंचाई को अपनी पसंद के मुताबिक सेट कर सकते हैं. (I0be3c, b/306697446, b/229134133, b/268068946)
एपीआई में हुए बदलाव
- एक्सपेरिमेंट के तौर पर उपलब्ध
BottomAppBarवर्शन का नाम बदलकरFlexibleBottomAppBarकर दिया गया है. इससे कॉन्टेंट को व्यवस्थित करने और उसकी ऊंचाई को कंट्रोल करने के ज़्यादा विकल्प मिलते हैं. (Iaa448) - बटन ग्रुप के डिफ़ॉल्ट ऑब्जेक्ट में मौजूद प्रॉपर्टी के नाम को
CapitalCaseके तौर पर अपडेट करें.animateFractionका नाम अपडेट करें, ताकि यह उस व्यवहार को ज़्यादा सटीक तरीके से दिखा सके जिसके लिए इसे बनाया गया है. (I545cd) - सामान्य बटन के लिए ओवरलोड जोड़े गए हैं. इससे बटन दबाने पर ऐनिमेटेड शेप इस्तेमाल किए जा सकते हैं. बटन के कैश मेमोरी में सेव किए गए आकार जोड़े गए. (I5ec20)
- अब
FloatingToolbarScrollBehaviorउपलब्ध कराकर, यह कंट्रोल किया जा सकता है कि स्क्रोल करने पर, FAB के साथFloatingToolbarकैसा व्यवहार करे. अगर टूलबार को बीच के किनारे (जैसे, ऊपर या नीचे के बीच में) पर रखा गया है, तो हमारा सुझाव है कि स्क्रोल करने के दौरान पूरे कॉम्पोनेंट को छिपाने के लिए, स्क्रोल करने की सुविधा का इस्तेमाल करें. इससे टूलबार ज़्यादा साफ़ दिखेगा. इससे FAB को बीच में आने से भी रोका जा सकता है. ऐसा तब हो सकता है, जब कोलैप्स करने के लिएexpandedफ़्लैग का इस्तेमाल किया जा रहा हो. (I33f67) - टाइटल और सबटाइटल का अलाइनमेंट सेट करते समय, कस्टम
TopAppBarTitleAlignmentके बजायAlignment.Horizontalका इस्तेमाल करने के लिए, एक्सपेरिमेंटलTopAppBarएपीआई अपडेट करता है. (I70ca2) SliderState#onValueChangeअब सार्वजनिक तौर पर उपलब्ध है, ताकि उपयोगकर्ता को ज़्यादा कंट्रोल मिल सके (I104eb)- नेविगेशन कॉम्पोनेंट को ऐनिमेट करने के लिए,
NavigationSuiteScaffoldStateको शामिल करें. साथ ही,NavigationSuiteScaffoldऔरNavigationSuiteScaffoldLayoutके ऐसे ओवरलोड भी शामिल करें जिनमें स्टेट पैरामीटर होता है. (I6a8c9, b/328674235)
गड़बड़ियां ठीक की गईं
IconButtonColorsऔरIconToggleButtonColorsक्लास कोIconButtonDefaults.ktसे वापसIconButton.ktमें ले जाएं. (I3c233)
बाहरी योगदान
SliderState#isDraggingअब सभी के लिए उपलब्ध है. (I8458a)
वर्शन 1.4.0-alpha06
15 जनवरी, 2025
androidx.compose.material3:material3-*:1.4.0-alpha06 रिलीज़ हो गया है. वर्शन 1.4.0-alpha06 में ये बदलाव शामिल हैं.
व्यवहार में बदलाव
- हमने इनसेट के उस ग्रुप में
displayCutoutजोड़ा है जिसे Material कॉम्पोनेंट डिफ़ॉल्ट रूप से ध्यान में रखते हैं. इससे, कॉन्टेंट को डिसप्ले कटआउट के साथ ओवरलैप होने से रोका जा सकेगा. यह व्यवहार में होने वाला बदलाव है. इससे, डिसप्ले कटआउट के आस-पास मौजूद इंसर्ट-अवेयर कॉम्पोनेंट के व्यवहार पर असर पड़ेगा. इसमें, Material 3 कॉम्पोनेंट के लिएWindowInsetsपैरामीटर की डिफ़ॉल्ट वैल्यू शामिल होती है. साथ ही, Material 2 और Material 3, दोनों के लिए कॉम्पोनेंट के डिफ़ॉल्ट ऑब्जेक्ट में दी गईWindowInsetsवैल्यू भी शामिल होती हैं. अगर इस बदलाव की वजह से कोई समस्या होती है, तो हर कॉम्पोनेंट के लिएWindowInsetsपैरामीटर को मैन्युअल तरीके से सेट करें. (I43ee9, b/362508045)
एपीआई में हुए बदलाव
TopAppBarAPI से जुड़े अपडेट. मीडियम और बड़े टॉप ऐप्लिकेशन बार का नाम बदलकर*FlexibleTopAppBarकर दिया गया है. रंग के अलग-अलग वैरिएंट को एक हीTopAppBarDefault.topAppBarColors()फ़ंक्शन में शामिल किया गया है. साथ ही, दिए गए सबटाइटल कंपोज़ेबल (I41b65) के लिए,subtitleकलर पैरामीटर जोड़ा गया हैWideNavigationRailArrangementAPI को हटाकरArrangement.Vertical(Id0341) का इस्तेमाल किया गया- कोई नया
VerticalSlider @Composableजोड़ें. (I2bfba) - एक नया ट्रैक
@Composableजोड़ा गया है. इससे कस्टम बाहरी ट्रैक कॉर्नर और ट्रैक आइकॉन तय किए जा सकते हैं. (I436a4) - फ़्लोटिंग टूलबार एपीआई को अपडेट करें, ताकि वे कंटेनर के एक रंग के बजाय
FloatingToolbarColorsऑब्जेक्ट का इस्तेमाल कर सकें. (I9a054) - एक्सपेरिमेंट के तौर पर उपलब्ध नई एनोटेशन सुविधा
ExperimentalMaterial3ComponentOverrideApi(Ia1eaf) को जोड़ना और उसका इस्तेमाल करना Modifier.indicatorLineअब टेक्स्ट फ़ील्ड के लिए एक शेप लेता है, ताकि क्लिपिंग को मैनेज किया जा सके. (I8c5f3, b/380704151)- एक्सपेरिमेंट के तौर पर उपलब्ध
FloatingAppBarफ़ंक्शन के नाम बदलकरFloatingToolbarकर दिए गए हैं (I1dbf8) - एक नया
floatingToolbarVerticalNestedScrollजोड़ा गया है. इसे स्क्रोल किए जा सकने वाले कंटेनर से अटैच किया जा सकता है. इससे, थ्रेशोल्ड पार करने वाले स्क्रोल मोशन के आधार पर, फ़्लोटिंग टूलबार के एक्सपैंशन की स्थिति को अपडेट किया जा सकता है. (I6d65f) - पेश है फ़्लोटिंग टूलबार बनाने के लिए नया एपीआई. इसमें फ़्लोटिंग ऐक्शन बटन (एफ़एबी) अटैच किया गया है. इस एपीआई में, ज़रूरत के हिसाब से बदलाव करने के कई विकल्प मिलते हैं. इनकी मदद से, टूलबार को हॉरिज़ॉन्टल या वर्टिकल तौर पर व्यवस्थित किया जा सकता है. साथ ही, FAB को टूलबार की शुरुआत या आखिर में रखा जा सकता है. (I9e350)
गड़बड़ियां ठीक की गईं
- Snackbar की सुलभता से जुड़ी समस्या को ठीक किया गया है. इस समस्या की वजह से,
TalkBackचालू होने पर Snackbar खारिज होने पर खुद ही सूचना देता था. (/I9db53)
बाहरी योगदान
- इसे फ़ाउंडेशन में
BasicTooltipऔर Material3 मेंBasicTooltip/Tooltipके तौर पर इस्तेमाल किया जाता है. (Ifc2e6)
वर्शन 1.4.0-alpha05
12 दिसंबर, 2024
androidx.compose.material3:material3-*:1.4.0-alpha05 रिलीज़ हो गया है. वर्शन 1.4.0-alpha05 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- बेहतर तरीके से पढ़ने के लिए, किसी सूची के लिए
WideNavigationRailState.current/targetवैल्यू में टाइप बदलें (I2d6ab) SplitButtonबाइनरी कंपैटबिलिटी के लिए, Shape API को डेटा क्लास से क्लास में बदलें. (I53812)- टूलटिप एपीआई जोड़ा गया है. इसमें
onDismissRequestपैरामीटर होता है, ताकि मेकर यह तय कर सकें कि जब कोई उपयोगकर्ता टूलटिप के बाहर क्लिक करता है, तो क्या होता है. पुराने एपीआई को बंद कर दिया गया है, जिसमें यह नया पैरामीटर शामिल नहीं है. (I99aef) opticalCenteringका नाम बदलकरhorizontalCenterOpticallyकर दिया गया है. मॉडिफ़ायर को इंटरनल बनाना. पैडिंग पैरामीटर को ज़्यादा से ज़्यादा स्टार्ट और एंड ऑफ़सेट से बदलें. (I0b904)WideNavigationRailStateको बदलकर मौजूदा/टारगेट वैल्यू करें. साथ ही, बूलियन के पक्ष में एनम हटाएं. (Idfa29, b/356039090)NavigationBarItemComponentOverrideजोड़ें. (I3a06a)
गड़बड़ियां ठीक की गईं
- ऊपर और नीचे मौजूद ऐप्लिकेशन बार के व्यवहार को ठीक किया गया है, ताकि कॉन्टेंट को पूरी तरह से स्क्रोल करने पर, रंग में बदलाव हो सके. (Idc4e8, b/293665988)
- ऊपर और नीचे मौजूद ऐप्लिकेशन बार के लिए स्क्रोल करने के तरीके से जुड़े फ़ंक्शन, अब याद किए गए तरीके को दिखाते हैं. इससे, रीकंपोज़िशन के दौरान बेहतर परफ़ॉर्म किया जा सकता है. (I0fdbe, b/207957336)
- अब मॉडिफ़ायर पैरामीटर को, इंटरनल मॉडिफ़ायर के बाद लागू किया जाता है. जैसे, खींचने का तरीका और सिमैंटिक्स. पहले इसे इंटरनल मॉडिफ़ायर से पहले लागू किया जाता था. इससे, मॉडिफ़ायर लागू करने के क्रम पर असर पड़ता है. (I8d83f)
- बॉटम शीट का साइज़ बदलने पर भी, वह बड़ी ही रहती है. (I2870b, b/324934884)
- विंडोज़ प्रॉपर्टी के लिए, स्टेटस और नेविगेशन बार के फ़्लैग को सही तरीके से रूट करना. (Ie674d, b/362539765)
- मॉडिफ़ायर पैरामीटर को, दस्तावेज़ में बताए गए तरीके के मुताबिक, स्कैफ़ोल्ड के रूट पर ले जाएं. इससे M2 के साथ इंटिग्रेशन किया जा सकेगा. (I0235e, b/372311595)
बाहरी योगदान
DatePickerDialogफ़ंक्शन को सामान्य बनाया गया. (I7dced)
वर्शन 1.4.0-alpha04
13 नवंबर, 2024
androidx.compose.material3:material3-*:1.4.0-alpha04 रिलीज़ हो गया है. वर्शन 1.4.0-alpha04 में ये बदलाव शामिल हैं.
व्यवहार में बदलाव
- aosp/3212478 में किए गए रंग के बदलावों को
iconButtonColors,iconToggleButtonColors,outlinedIconButtonColors,outlinedIconToggleButtonColors, औरoutlinedIconToggleButtonBorderपर वापस लाएं. अब वापस लाए गए व्यवहार कोiconButtonVibrantColorsजैसे फ़ंक्शन के नए सेट में ले जाया गया है, ताकि ज़्यादा कंट्रास्ट वाले रंगों को हाइलाइट किया जा सके. (Iffd8d)
नई सुविधाएं
VerticalDragHandleकॉम्पोनेंट (I6c770) पेश किया गया
एपीआई में हुए बदलाव
DismissibleModalWideNavigationRailDefaultsका नाम बदलकरModalWideNavigationRailDefaultsकरें. (I8e877)NavigationBarComponentOverridesजोड़ें. (I8a3f3)NavigationRailComponentOverrideजोड़ें. (I83e13)- रेल को छोटा/बड़ा करने के लिए
WideNavigationRailStateको शामिल किया गया है. साथ ही,ModalWideNavigationRailको खारिज करने की अनुमति दी गई है औरDismissibleModalWideNavigationRailको मिटा दिया गया है. (I88568) - टॉगल बटन के डिफ़ॉल्ट साइज़ में, xSmall, medium, large, और xLarge साइज़ के डिफ़ॉल्ट साइज़ जोड़ें. (Ie95d1)
- बटन के डिफ़ॉल्ट साइज़ में, xSmall, medium, large, और xLarge साइज़ के डिफ़ॉल्ट जोड़ें. (If8b6d)
गड़बड़ियां ठीक की गईं
- फ़िल्टर चिप के ट्रेलिंग आइकॉन का रंग, स्पेसिफ़िकेशन के मुताबिक प्राइमरी से बदलकर
OnSurfaceContainerकर दिया गया है. सभी चिप की आउटलाइन के रंग, स्पेसिफ़िकेशन के मुताबिक आउटलाइन से बदलकर आउटलाइन वैरिएंट कर दिए गए हैं. (I68bd4)
वर्शन 1.4.0-alpha03
30 अक्टूबर, 2024
androidx.compose.material3:material3-*:1.4.0-alpha03 रिलीज़ हो गया है. वर्शन 1.4.0-alpha03 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- डेंसिटी वाले
SheetStateकंस्ट्रक्टर को अब इस्तेमाल नहीं किया जा सकता. इसके बजाय, पोज़िशनल और वेलोसिटी थ्रेशोल्ड का इस्तेमाल किया जा सकता है. (Ifd16e) - अपडेट किए गए पोज़िशनिंग लॉजिक वाला
rememberTooltipPositionProviderजोड़ा गया.rememberPlainTooltipPositionProviderऔरrememberRichTooltipPositionProviderअब सेवा में नहीं हैं. (Ie66e2) - अतिरिक्त
ModalBottomSheetPropertiesकी मदद से, स्टेटस और नेविगेशन बार के रंगों को पसंद के मुताबिक बनाया जा सकता है. डिफ़ॉल्ट रूप से, ये सिस्टम की डार्क थीम की स्थिति के बजाय, कॉन्टेंट के रंग के हिसाब से अपडेट होते हैं. (Ib874e, b/362539765) - तारीख चुनने वालों के लिए इनपुट अनुभव को बेहतर बनाया गया है: इनपुट मोड में होने पर, तारीख के टेक्स्ट फ़ील्ड पर फ़ोकस किया जाएगा, ताकि तुरंत टेक्स्ट डाला जा सके. इस बदलाव से,
DatePickerऔरDateRangePickerमेंrequestFocusपैरामीटर जुड़ जाता है.falseपास करके, फ़ोकस को रोका जा सकता है. (I12d09, b/286399710, b/340102743) - शेप ऑब्जेक्ट में, शेप की डिफ़ॉल्ट सेटिंग को कैश मेमोरी में सेव किया जाता है. टॉगल बटन के लिए, शेप को डिफ़ॉल्ट
@Composableके तौर पर सेट करना. वैरिएंट एक ही टोकन फ़ाइल की ओर इशारा करते हैं. इसलिए, सभी शेप को डिफ़ॉल्ट रूप से एक शेप में छोटा कर दिया जाता है. (Iaa014)
गड़बड़ियां ठीक की गईं
- Optimize Scaffold
contentPaddingके व्यवहार को ऑप्टिमाइज़ करें, ताकिcontentPaddingमें बदलाव होने पर, बॉडी कॉन्टेंट को हमेशा फिर से कंपोज़ न करना पड़े. (I8c8e2, b/373904168) TextFieldLabelScopeprogressका नाम बदलकरlabelMinimizedProgressकर दिया गया हैTextFieldLabelPositionDefaultका नाम बदलकरAttachedकर दिया गया है. इंटरफ़ेस के सदस्यों को हटा दिया गया है. (If75c6)- इनपुट मोड में
DatePickerसे जुड़ी समस्या को ठीक किया गया है. इसमें पुष्टि करने से जुड़ी गड़बड़ियों की वजह से, कॉम्पोनेंट की ऊंचाई बदल सकती थी. (I2e229, b/280462363) - कंट्रोल बटन दबाने पर, स्लाइडर की वैल्यू में बदलाव करें. (I1c442)
वर्शन 1.4.0-alpha02
16 अक्टूबर, 2024
androidx.compose.material3:material3-*:1.4.0-alpha02 रिलीज़ हो गया है. वर्शन 1.4.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- तारीख चुनने वाले टूल को अपडेट किया गया है. इससे यह पक्का किया जा सकेगा कि
DatePickerStateयाDateRangePickerStateके ज़रिए सीधे तौर पर कोई स्थान-भाषा सेट करते समय,DatePickerऔरDateRangePickerमें एक ही स्थान-भाषा का इस्तेमाल किया जाए. ध्यान दें कि जब सीधे तौर पर राज्य के हिसाब से स्थानीय भाषाएं सेट की जाती हैं, तो यह आपकी ज़िम्मेदारी होती है कि टाइटल और हेडलाइन के टेक्स्ट को उसी के हिसाब से स्थानीय भाषा में बदला जाए. ऐसा इसलिए, क्योंकि डिफ़ॉल्ट प्लैटफ़ॉर्म की स्थानीय भाषा के हिसाब से ही डिफ़ॉल्ट टेक्स्ट लागू होगा. (I37073, b/326490763, b/321657276) SheetState.isAnimationRunningअब दिखने लगा है. (I9a3d7)DatePickerColorsअब थीम की टाइपोग्राफ़ी टेक्स्ट स्टाइल में तय किए गए किसी भी मिलते-जुलते रंग के मुकाबले, ज़्यादा प्राथमिकता दी जाती है. यह भी ध्यान दें कि इस अपडेट में, तारीख चुनने वाले फ़ंक्शन मेंcolorपैरामीटर की पोज़िशन में बदलाव किया गया है. साथ ही, हेडर और टाइटल के टेक्स्ट के रंगों को पसंद के मुताबिक बनाने के लिए,contentColorपैरामीटर जोड़ा गया है. (I30d03, b/347031394)SplitButtonका नाम बदलकरSplitButtonLayoutकर दिया जाएगा. साथ ही,SplitButtonकलर वैरिएंट एपीआई हटा दिए जाएंगे. वैरिएंट,SplitButtonDefaultsकी ओर से उपलब्ध कराए गए बटन वैरिएंट का फिर से इस्तेमाल करके हासिल किए जाएंगे. (I44c36)ModalBottomSheetमें अबsheetGestureEnabledपैरामीटर है (I856cb, b/288211587)standardMotionSchemeऔरexpressiveMotionSchemeका नाम बदलकर स्टैंडर्ड और एक्सप्रेसिव कर दिया गया है. अब दोनों फ़ंक्शन कोMotionSchemeकंपैनियन ऑब्जेक्ट के ज़रिए ऐक्सेस किया जा सकता है. इसके लिए,MotionScheme.standard()औरMotionScheme.expressive()को कॉल करें. (Iceccf)- सामान्य और रिच टूलटिप में
maxWidthपैरामीटर जोड़ा गया है. सामान्य टूलटिप के लिए, यह डिफ़ॉल्ट रूप से 200 dp और रिच टूलटिप के लिए 320 dp के डिज़ाइन स्पेसिफ़िकेशन पर सेट होता है. (I30ce9)
गड़बड़ियां ठीक की गईं
DatePickerऔरDateRangePickerअब अपनी स्थिति केdisplayedMonthMillisके ज़रिए सेट किए जाने पर, दिखाए गए महीने को सही तरीके से अपडेट करते हैं. (If9e47, b/333414302)ModalBottomSheetकॉन्टेंट अब स्टेटस बार से कॉन्टेंट को दूर ले जाता है. (I5114c, b/321877275, b/336962418, b/342093067)- [बॉटम शीट] IME कीबोर्ड को पहले बंद करने की अनुमति देने के लिए, वापस कॉल करने की प्राथमिकता को
PRIORITY_DEFAULTपर वापस सेट करें. (I447fb) - जब कम से कम चुने जा सकने वाले साल को आने वाले साल के लिए सेट किया जाता है, तब
DatePickerऔरDateRangePickerमें क्रैश होने की समस्या ठीक की गई. (I78656, b/319395747) - तारीख चुनने वाले कंट्रोल से जुड़ी समस्या को ठीक किया गया है, ताकि अपडेट किए गए
SelectableDatesइंस्टेंस को लागू करने पर यूज़र इंटरफ़ेस (यूआई) अपडेट हो जाए. (Iad59a, b/290135807, b/339898760)
वर्शन 1.4.0-alpha01
2 अक्टूबर, 2024
androidx.compose.material3:material3-*:1.4.0-alpha01 रिलीज़ हो गया है. वर्शन 1.4.0-alpha01 में ये बदलाव शामिल हैं.
व्यवहार में बदलाव
- लाइब्रेरी अब
material-icons-coreपर डिपेंडेंसी नहीं जोड़ती है. इसलिए, अगर आपका प्रोजेक्ट उस पर निर्भर करता है, तो आपको अपनीbuild.gradle[.kts]फ़ाइलों में उस डिपेंडेंसी को साफ़ तौर पर जोड़ना होगा. (I735ff, b/349894318) NavigationBarItemऔरNavigationRailItemके ऐक्टिव लेबल का रंग, इस्तेमाल करने में आसानी, कलर कंट्रास्ट, और सिस्टम में एकरूपता (Ibc297) को बेहतर बनाने के लिए,onSurfaceसेsecondaryमें बदल गया है. पहले जैसा करने के लिए, डिफ़ॉल्ट रंगों को कॉपी करें औरselectedTextColorकोMaterialTheme.colorScheme.onSurfaceमें बदलें.- Material 3 कॉम्पोनेंट अब मोशन तय करने के लिए, नए
MotionSchemeका इस्तेमाल कर रहे हैं. (Ie0f93) - सर्कुलर प्रोग्रेस इंडिकेटर की मोशन में बदलाव (I3c07e)
- कलर कंट्रास्ट को बेहतर बनाने के लिए,
OutlinedIconButtonColorsऔरOutlinedIconToggleButtonColorsको अपडेट करें. (I2743d) FilledIconToggleButtonColorsऔरFilledTonalIconToggleButtonColorsके लिए, कंटेनर और कॉन्टेंट का रंग अपडेट किया गया. (Ic5d0f)OutlinedButtonके बॉर्डर का रंग,outlineसे बदलकरoutlineVariantकर दिया गया है. (057f00)
एपीआई में हुए बदलाव
TopAppBarकेenterAlwaysScrollBehaviorफ़ंक्शन में एक वैकल्पिकreverseLayoutपैरामीटर जोड़ा गया है, ताकिreverseLayoutके साथ सेट किए गए कॉन्टेंट को बेहतर तरीके से सपोर्ट किया जा सके. (I4e0e5)SegmentedButtonअबcontentPaddingआर्ग्युमेंट के साथ काम करता है. (I5ad91, b/358414376)PullToRefreshStateमें अबisAnimating(I6a593) के लिए डिफ़ॉल्ट सेटिंग लागू नहीं होती- Material
TextFieldऔरOutlinedTextFieldके नए ओवरलोड जोड़े गए हैं. येTextFieldStateका इस्तेमाल करते हैं. डेकोरेशन बॉक्स वाले ऐसे एपीआई जोड़े गए हैं जोTextFieldDecoratorके साथ काम करते हैं. (If13a1) - कंट्रोल टेक्स्ट फ़ील्ड के
labelPositionमें पैरामीटर जोड़ा गया.alwaysMinimizeका इस्तेमाल करने पर, टेक्स्ट फ़ील्ड में लेबल और प्लेसहोल्डर को एक साथ दिखाया जा सकता है. ऐसा तब भी किया जा सकता है, जब फ़ील्ड पर फ़ोकस न किया गया हो. (I1ef2c) - पासवर्ड डालने के फ़ील्ड के लिए, Material
SecureTextFieldऔरOutlinedSecureTextFieldजोड़े गए. (I7e22d) - ऐनिमेशन की प्रोग्रेस के बारे में क्वेरी करने के लिए, टेक्स्ट फ़ील्ड के लेबल में स्कोप जोड़ा गया. (If5ec8)
- टूलटिप में
MotionEvent.CLASSIFICATION_DEEP_PRESSके काम करने की सुविधा जोड़ी गई है. (I62e6a) TimePickerStateकाisAfternoonअब इंटरफ़ेस में var के बजाय एक्सटेंशन वैल्यू है. इसका नाम बदलकरisPm(I89a97) कर दिया गया है- टाइपोग्राफ़ी क्लास को अपडेट किया गया है, ताकि फ़ोकस किए गए टाइप स्केल का इस्तेमाल किया जा सके. (Ifa13c)
ModalWideNavigationRailएपीआई जोड़ा गया. साथ ही,ModalExpandedNavigationRailएपीआई का नाम बदलकरDismissibleModalWideNavigationRailकर दिया गया. (Ic9118)FloatingAppBarScrollBehaviorको अपडेट किया गया है, ताकि वहscreenOffsetकी अपने-आप गणना कर सके और इसके लिए@Composableकी ज़रूरत न पड़े. (Idf349)LoadingIndicatorएपीआई में अपडेट किए गए हैं, ताकि डिफ़ॉल्ट ऑब्जेक्ट में नामकरण की समस्या को ठीक किया जा सके.LoadingIndicatorElevationपरPullToRefreshकॉन्सटेंट जोड़ा गया. (I1d72b)LoadingIndicatorएपीआई में अपडेट किए गए हैं, ताकि डिफ़ॉल्ट ऑब्जेक्ट में नामकरण की समस्या को ठीक किया जा सके.LoadingIndicatorElevationपरPullToRefreshकॉन्सटेंट जोड़ा गया. (I1d72b)LinearWavyProgressIndicatorऔरCircularWavyProgressIndicatorके अनिश्चित वैरिएंट के लिए,amplitudeऔरwaveSpeedपैरामीटर जोड़े गए. (I2a0c5)- दबाए जाने या चुने जाने की स्थिति के आधार पर, आइकॉन टॉगल बटन के आकार को बदलने की सुविधा. (Ibc781)
- टाइपोग्राफ़ी क्लास को अपडेट किया गया है, ताकि फ़ोकस किए गए टाइप स्केल को सपोर्ट किया जा सके. (Ifa13c)
SplitButtonडिफ़ॉल्ट / दबाई गई स्थिति के आधार पर आकार बदलता है.AnimatedTrailingButtonएपीआई हटाया गया, क्योंकिTrailingButtonएपीआई एक जैसी सुविधाएं (I95066) दे सकता है- एफ़एबी को दिखाने और छिपाने को ऐनिमेट करने के लिए, मॉडिफ़ायर जोड़ें. उदाहरण के लिए, जब कॉन्टेंट स्क्रोल होता है. (I8338d)
ButtonGroupDefaultsमें कनेक्ट किए गए बटन ग्रुप के आकार और स्पेसिंग को जोड़ना, ताकि इसे सैंपल में इस्तेमाल किया जा सके. (I68e30)- स्प्लिट बटन, ट्रेलिंग बटन के लिए हॉरिज़ॉन्टल पैडिंग जोड़ता है. साथ ही, यह ऑप्टिकल सेंटरिंग को चालू करता है. इसकी गणना, शुरुआती और आखिरी कोने के अंतर (I122e2) से की जाती है
- पेश है नया Material
MotionScheme, ताकि कॉम्पोनेंट के मोशन के लिए स्कीम सेट की जा सके. इस स्कीम कोMaterialThemeके ज़रिए सेट किया जाता है. (Id50c2)
गड़बड़ियां ठीक की गईं
Scaffoldचाइल्ड कंपोज़ेबल के लिए, सही फ़ोकस ट्रैवर्सल इंडेक्स लागू करें. ऑर्डरtopBar,bottomBar, fab, content, snackbar है. (I5936b)DatePickerऔरDateRangePickerमें मौजूद उस समस्या को ठीक किया गया है जिसमें कुछ भाषाओं और फ़ॉर्मैट-स्केलेटन में, तारीख के कुछ एलिमेंट (जैसे, महीने के नाम) कैपिटल लेटर से शुरू नहीं होते थे. (I1430f)- एफ़एबी और एफ़एबी मेन्यू कॉम्पोनेंट टोकन इंटिग्रेट किए गए हैं. साथ ही, पैडिंग और टेक्स्ट में छोटे-मोटे विज़ुअल अपडेट किए गए हैं (Ib57f3)
ModalBottomSheetअब सिमैंटिक ट्रैवर्सल के क्रम में सबसे पहले है. इसके बाद, स्क्रिम है. (I436f9, b/358594665)- एज-टू-एज मोड में नेविगेशन पिल के नीचे स्क्रोल करने पर, बॉटम ऐप्लिकेशन बार पूरी तरह से नहीं हटता था. इस समस्या को ठीक किया गया है (I3ee21)
Compose Material3 वर्शन 1.3
वर्शन 1.3.2
9 अप्रैल, 2025
androidx.compose.material3:material3-*:1.3.2 रिलीज़ हो गया है. वर्शन 1.3.2 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
ListItemअपनी मूल ऊंचाई के हिसाब से कैलकुलेशन को ठीक करता है. अब लेआउट में सही जगह रिज़र्व की जाती है.NavigationBarItemलेबल की ज़रूरत से ज़्यादा पैडिंग हटाएं और इसे स्पेसिफ़िकेशन के मुताबिक सही तरीके से अलाइन करें.- आरटीएल मोड में
TabRowलेआउट को ठीक करता है.
वर्शन 1.3.1
30 अक्टूबर, 2024
androidx.compose.material3:material3-*:1.3.1 रिलीज़ हो गया है. वर्शन 1.3.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
DatePickerऔरDateRangePickerअब अपनी स्थिति केdisplayedMonthMillisके ज़रिए सेट किए जाने पर, दिखाए गए महीने को सही तरीके से अपडेट करते हैं. (If9e47, b/333414302)- जब कम से कम चुने जा सकने वाले साल को आने वाले साल के लिए सेट किया जाता है, तब
DatePickerऔरDateRangePickerमें क्रैश होने की समस्या ठीक की गई. (I78656, b/319395747) - तारीख चुनने वाले कंट्रोल से जुड़ी समस्या को ठीक किया गया है, ताकि अपडेट किए गए
SelectableDatesइंस्टेंस को लागू करने पर यूज़र इंटरफ़ेस (यूआई) अपडेट हो जाए. (Iad59a, b/290135807, b/339898760) - बॉटम शीट में इस्तेमाल की गई बैक कॉलबैक प्राथमिकता को
PRIORITY_DEFAULTपर वापस सेट करें, ताकि IME कीबोर्ड को पहले बंद किया जा सके. (I447fb)
वर्शन 1.3.0
4 सितंबर, 2024
androidx.compose.material3:material3-*:1.3.0 रिलीज़ हो गया है. वर्शन 1.3.0 में ये बदलाव शामिल हैं.
1.2.0 के बाद हुए ज़रूरी बदलाव
1.3.0 की मुख्य सुविधाएं
Material Design 3 के नए कॉम्पोनेंट
- कैरसेल
HorizontalMultiBrowseCarouselऔरHorizontalUncontainedCarouselमौजूदा Material Design 3 कॉम्पोनेंट को बेहतर बनाया गया है.
- [
ModalBottomSheet] अब U+ पर Predictive Back की सुविधा काम करती है (Iccf32, b/281967264, b/304850357) - [
SearchBar] अब U+ पर पीछे जाने पर झलक दिखाने वाले हाथ के जेस्चर की सुविधा काम करती है (I657f8) - नेविगेशन पैनल (
ModalDrawerSheetऔरDismissibleDrawerSheet) में अब U+ पर ऑप्ट-इन के तौर पर, अनुमानित बैक सुविधा (Ie5b0b) काम करती है DropdownMenuमें अब कस्टम कलर, शेप, एलिवेशन, और बॉर्डर का इस्तेमाल किया जा सकता है. (I8e981,b/289554448, b/301887035, b/283654243)- स्लाइडर को अपडेट किया गया है, ताकि सुलभता को बेहतर बनाया जा सके. इसके लिए, स्लाइडर में गैप और स्टॉप इंडिकेटर जोड़ा गया है. (I3058e)
- गैप और स्टॉप इंडिकेटर जोड़कर,
ProgressIndicatorको अपडेट किया गया है, ताकि इसे आसानी से ऐक्सेस किया जा सके. (I21451) - रिच टूलटिप के लिए डिफ़ॉल्ट कैरट जोड़ा गया. साथ ही, ऐंकर
LayoutCoordinatesके हिसाब से कस्टम कैरट बनाने की सुविधा जोड़ी गई. (Ifd42c) नुकसान पहुंचा सकने वाले बदलाव - पुल-टू-रिफ़्रेश करने की सुविधा वाले नए एपीआई:
- Dp यूनिट के बजाय, फ़्रैक्शनल वैल्यू इस्तेमाल करने के लिए
PullToRefreshStateको आसान बनाया गया है. isRefreshingकी स्थिति कोPullToRefreshStateके बजाय उपयोगकर्ता कंट्रोल करता है.PullToRefreshStateसे नेस्ट किए गए स्क्रोल कनेक्शन को अलग कर दिया गया है. इसे नएPullToRefreshBoxयाModifier.pullToRefreshसे मैनेज किया जाता है.- यह अपडेट, एक्सपेरिमेंट के तौर पर उपलब्ध कराए गए पिछले एपीआई में एक बड़ा बदलाव है. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) विज़ुअल में हुए बड़े बदलाव
- Dp यूनिट के बजाय, फ़्रैक्शनल वैल्यू इस्तेमाल करने के लिए
- फ़ोकस स्टेट ओवरले को 0.1f पर अपडेट करें, ताकि रंगों का सही कंट्रास्ट मिल सके. (I7ea77)
lightColorSchemeऔरdarkColorSchemeमें, डिफ़ॉल्ट रूप से मौजूद बैकग्राउंड और रंग में मामूली बदलाव किए गए हैं. (I9db52)- टेक्स्ट के अलावा अन्य एलिमेंट के कंट्रास्ट के नए स्पेसिफ़िकेशन के मुताबिक, स्लाइडर और
ProgressIndicatorके रंगों को अपडेट किया गया है. (I26807) - अब कॉम्पोनेंट,
SurfaceContainerवैरिएंट का इस्तेमाल करते हैं. जिन कॉम्पोनेंट में पहलेSurfaceऔरTonalElevationकी मदद से कलर का हिसाब लगाया जाता था वे अब डिफ़ॉल्ट रूप सेSurfaceContainerरोल का इस्तेमाल करते हैं. टोनल एलिवेशन का इन पर कोई असर नहीं पड़ता. (b/304584161) - सरफ़ेस और सरफ़ेस कंटेनर की बेसलाइन भूमिकाओं में थोड़ा बदलाव किया गया है. इससे, हल्के और गहरे रंग वाली थीम में ज़्यादा रंगत मिलती है. (I677a5)
- एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई को स्टेबल वर्शन में प्रमोट किया गया!
- परफ़ॉर्मेंस में सुधार किए गए
वर्शन 1.3.0-rc01
21 अगस्त, 2024
androidx.compose.material3:material3-*:1.3.0-rc01 रिलीज़ हो गया है. वर्शन 1.3.0-rc01 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
ModalBottomSheetअब सिमैंटिक ट्रैवर्सल के क्रम में सबसे पहले है. इसके बाद, स्क्रिम है. (I436f9, b/358594665)
वर्शन 1.3.0-beta05
24 जुलाई, 2024
androidx.compose.material3:material3-*:1.3.0-beta05 रिलीज़ हो गया है. वर्शन 1.3.0-beta05 में ये बदलाव शामिल हैं.
- उस समस्या को ठीक कर दिया गया है जिसमें Android N और O पर
BottomSheetकॉन्टेंट मौजूद नहीं था या कट गया था (a10a2d) - स्लाइडर के सिमैंटिक बाउंड्री को बढ़ाया गया है, ताकि
TalkBackथंब के चारों ओर फ़ोकस इंडिकेटर को ठीक से दिखा सके. (0b5a1d)
वर्शन 1.3.0-beta04
26 जून, 2024
androidx.compose.material3:material3-*:1.3.0-beta04 रिलीज़ हो गया है. वर्शन 1.3.0-beta04 में ये बदलाव शामिल हैं.
वर्शन 1.3.0-beta03
12 जून, 2024
androidx.compose.material3:material3-*:1.3.0-beta03 रिलीज़ हो गया है. वर्शन 1.3.0-beta03 में ये बदलाव शामिल हैं.
बाहरी योगदान
- कॉमन सोर्स सेट से
androidx.compose.material3.DropdownMenuउपलब्ध कराएं. (If62c0)
वर्शन 1.3.0-beta02
29 मई, 2024
androidx.compose.material3:material3-*:1.3.0-beta02 रिलीज़ हो गया है. वर्शन 1.3.0-beta02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
Modifier.pullToRefreshIndicatorमें एलिवेशन की सुविधा काम करती है. साथ ही, Pull To Refresh API को अपडेट किया गया है, ताकि लैम्ब्डा के बजाय बूलियन को चालू किया जा सके.PullToRefreshBoxमें कॉन्टेंट अलाइनमेंट की सुविधा उपलब्ध है (I75679)TooltipScopeको सील किया गया इंटरफ़ेस बनाना औरTooltipBoxऔर लेबल में इस्तेमाल करने के लिए इंटरनल इंप्लीमेंटेशन बनाना. (I3833e)CarouselItemScopeमें दो नए मॉडिफ़ायर जोड़े गए हैं -maskClipऔरmaskBorder. इनकी मदद से, किसी भी कैरसेल आइटम में आसानी से शेप और बॉर्डर जोड़ा जा सकता है (Id67a1)TimePickerStateअब एक इंटरफ़ेस है. इससे समय सेट किया जा सकता है (I88546)- लिंक को स्टाइल करने के लिए एपीआई अपडेट किया गया:
TextLinkStylesकोTextStyleमें ले जाया गया औरTextDefaultsको मटीरियल से हटा दिया गया. (I5477b)
गड़बड़ियां ठीक की गईं
ModalBottomSheetके स्टेटस और नेविगेशन बार के आइकॉन अब गहरे रंग वाली थीम की स्थिति के हिसाब से दिखते हैं. (Ie1fe7, b/338342149)ModalBottomSheetस्क्रिम में, शीट बंद करने के सिमैंटिक जोड़े गए. (0e61cb,b/328801864)
बाहरी योगदान
androidx.compose.material3.AlertDialogको सामान्य सोर्स सेट से उपलब्ध कराएं (Ia33f5)ModalBottomSheetको सामान्य सोर्स सेट (Id7cc7) से उपलब्ध कराएं
वर्शन 1.3.0-beta01
14 मई, 2024
androidx.compose.material3:material3-*:1.3.0-beta01 रिलीज़ हो गया है. वर्शन 1.3.0-beta01 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
CaretPropertiesके बजायDpSizeका इस्तेमाल करना.CaretPropertiesको हटाया जा रहा है.CaretScopeका नाम बदलकरTooltipScopeकरें. (Id9a76)- टेक्स्ट में Material थीम वाले लिंक पाने के लिए, एपीआई को अपडेट किया गया है. खास तौर पर, थीम वाले
TextDefaultsबनाने के लिएTextDefaultsसे तरीके हटा दिए गए हैं. साथ ही, थीम वाले लिंक के साथ एचटीएमएल पार्स करने की सुविधा भी हटा दी गई है.LinkAnnotationsइसके बजाय,TextLinkStylesक्लास जोड़ी गई है. इससे Text कंपोज़ेबल के पैरामीटर के तौर पर लिंक को स्टाइल किया जा सकता है. (I31b93)
वर्शन 1.3.0-alpha06
1 मई, 2024
androidx.compose.material3:material3-*:1.3.0-alpha06 रिलीज़ हो गया है. वर्शन 1.3.0-alpha06 में ये बदलाव शामिल हैं.
नुकसान पहुंचा सकने वाले बदलाव
पुल-टू-रिफ़्रेश करने की सुविधा देने वाले नए एपीआई:
- Dp यूनिट के बजाय, फ़्रैक्शनल वैल्यू इस्तेमाल करने के लिए
PullToRefreshStateको आसान बनाया गया है. isRefreshingकी स्थिति कोPullToRefreshStateके बजाय उपयोगकर्ता कंट्रोल करता है.PullToRefreshStateसे नेस्ट किए गए स्क्रोल कनेक्शन को अलग कर दिया गया है. इसे नएPullToRefreshBoxयाModifier.pullToRefreshसे मैनेज किया जाता है.- यह अपडेट, एक्सपेरिमेंट के तौर पर उपलब्ध कराए गए पिछले एपीआई में एक बड़ा बदलाव है. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Dp यूनिट के बजाय, फ़्रैक्शनल वैल्यू इस्तेमाल करने के लिए
एपीआई में हुए बदलाव
RippleConfiguration#isEnabledको हटा दिया गया है औरLocalRippleConfigurationको नल के तौर पर सेट किया गया है. रिपल इफ़ेक्ट को बंद करने के लिए,isEnabled = falseके साथRippleConfigurationदेने के बजाय,LocalRippleConfigurationकोnullदें. (I22725)ModalBottomSheetएज-टू-एज सुविधा चालू होने पर, स्टेटस बार पर ज़्यादा सटीक तरीके से स्क्रिम बनाता है. अब मॉडल बॉटम शीट का कॉन्टेंट, विंडो इंसर्ट का इस्तेमाल कर सकता है. इससे नेविगेशन बार के ऊपर मौजूद कॉन्टेंट दिखता है.ModalBottomSheetपैरामीटरwindowInsetsका नाम बदलकरcontentWindowInsetsकर दिया गया है, ताकि यह तय किया जा सके कि इनसेट कहां लागू किए जाएंगे. अब ये विंडो लॉजिक से नहीं जुड़े हैं.contentWindowInsetsटाइप को ऐसे फ़ंक्शन में बदल दिया गया है जोWindowInsetsदिखाता है, ताकि इसे नई विंडो में हल किया जा सके. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRowऔरSecondaryScrollableTabRowअब सबकंपोज़िशन के बजाय कस्टम लेआउट का इस्तेमाल करते हैं. इससे परफ़ॉर्मेंस बेहतर होनी चाहिए. (I991e0)- टेक्स्ट लिंक में, सामान्य स्टाइलिंग, होवर किए गए, और फ़ोकस किए गए स्टाइलिंग के अलावा, दबाए गए स्टाइलिंग का विकल्प भी जोड़ा गया है.
TextDefaultsतरीकों में से हर एक कोpressedStyleआर्ग्युमेंट मिला, ताकि वह इसका इस्तेमाल कर सके. (Ic473f, b/139312671)
गड़बड़ियां ठीक की गईं
- नेविगेशन ड्रॉअर के ड्रैग ऐंकर की चौड़ाई अब
drawerContentकी चौड़ाई से मेल खाती है. (Ibc72f, b/245355396) - लेबल के लिए
OutlinedTextFieldटॉप पैडिंग अब सिस्टम फ़ॉन्ट के साइज़ के हिसाब से तय होती है. (Idc781) - पैकेज की जगह की जानकारी
CalendarLocaleपर सेट है. (Ifa235) - [प्रिडिक्टिव बैक] प्रिडिक्टिव बैक ऐनिमेशन को अपडेट करके, (0.1, 0.1, 0, 1) का इंटरपोलेशन कर्व इस्तेमाल किया गया (I2591a)
वर्शन 1.3.0-alpha05
17 अप्रैल, 2024
androidx.compose.material3:material3-*:1.3.0-alpha05 रिलीज़ हो गया है. वर्शन 1.3.0-alpha05 में ये बदलाव शामिल हैं.
नई सुविधाएं
SearchBarऔरDockedSearchBarमें नए ओवरलोड हैं, जो टेक्स्ट फ़ील्ड पैरामीटर लेते हैं. इससे टेक्स्ट फ़ील्ड को खोज बार के बाकी हिस्से से अलग स्टाइल किया जा सकता है. साथ ही, कस्टम टेक्स्ट फ़ील्ड में पास किया जा सकता है. मौजूदा लागू करने की प्रोसेस के टेक्स्ट फ़ील्ड कोSearchBarDefaults.InputFieldके तौर पर उपलब्ध कराया गया है. (I50c73, b/275074248, b/278773336, b/326627700)- अगर ज़रूरत हो, तो टिक को पसंद के मुताबिक बनाने के लिए, lambda
drawTickको सार्वजनिक एपीआई में जोड़ा गया है (I0c048)
एपीआई में हुए बदलाव
- टेक्स्ट लिंक में, सामान्य स्टाइलिंग के साथ-साथ दबाए गए बटन की स्टाइलिंग का विकल्प भी जोड़ा गया है. इसके अलावा, बटन पर कर्सर घुमाने और फ़ोकस करने की सुविधा भी जोड़ी गई है (I5f864, b/139312671)
CarouselItemInfoको अपडेट किया गया है, ताकि मास्क रेक्ट का पता चल सके. इससे यह पता चलता है कि आइटम को किस मास्क रेक्ट से काटा जा रहा है (I785d8)BasicTooltipStateको Material 3 के सार्वजनिक एपीआई से हटा दिया गया है. जब तक Foundation काBasicTooltipस्थिर नहीं हो जाता, तब तक इसकी सुविधाओं कोTooltipStateके साथ जोड़ दिया गया है. (Icda29)- एक
TextDefaultsऑब्जेक्ट जोड़ा गया है. इसमेंLinkAnnotationबनाने के तरीके शामिल हैं. साथ ही, इसमें एचटीएमएल टैग वाली स्ट्रिंग को पार्स करने का तरीका भी शामिल है. यह तरीका, लिंक परMaterialThemeलागू करता है (I98532, b/139312671) ExposedDropdownMenuBoxScopeअब सबक्लास की अनुमति नहीं देता. अब एक्सपोज़ किए गए ड्रॉपडाउन मेन्यू मेंMenuAnchorTypeहै. इसेmenuAnchorको पास किया जाना चाहिए, ताकि बेहतर ए11वाई की सुविधा मिल सके. इसका इस्तेमाल, अब बंद हो चुकेExposedDropdownMenuकोfocusableपास करने के बजाय किया जाना चाहिए.menuAnchorमेंenabledकी स्थिति को कंट्रोल करने के लिए एक नया पैरामीटर है. (I55ee6, b/257209915, b/308840226)OutlinedButtonके बंद होने पर, उसके बॉर्डर के रंग की समस्या ठीक की गई. चालू की गई स्थिति को लेने वालेButtonDefaults.outlinedButtonBorder("enabled")ओवरलोड को जोड़ा गया. (Ie650b, b/318461363)- क्लाइंट को आइटम के साइज़ के बारे में जानकारी देने के लिए, नई
CarouselItemInfoक्लास जोड़ी गई. (I9070c) - अब बिना सर्फ़ेस कंटेनर वाले
ColorSchemeकंस्ट्रक्टर का इस्तेमाल नहीं किया जा सकता. कृपया उस कंस्ट्रक्टर पर माइग्रेट करें जिसमें सर्फ़ेस कंटेनर शामिल हैं. (I35c11) - [आउटलाइन किया गया]
TextFieldDefaultsContainerBoxका नाम बदलकरContainerकर दिया गया है. (Ie8d3b)
गड़बड़ियां ठीक की गईं
- अगर
sheetSwipeEnabledकी वैल्यू false पर सेट है, तोBottomSheetScaffoldनेस्ट किए गए स्क्रोल से स्क्रोल नहीं होगा. (I5e1c1, b/306464779) IconButtonSamples.ktमें,ExperimentalMaterial3Apiके कुछ ऑप्ट-इन एनोटेशन हटा दिए गए हैं. (I111d1)
वर्शन 1.3.0-alpha04
3 अप्रैल, 2024
androidx.compose.material3:material3-*:1.3.0-alpha04 रिलीज़ हो गया है. वर्शन 1.3.0-alpha04 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Material3 कैरोसेल के दो एक्सपेरिमेंटल वर्शन जोड़े गए हैं -
HorizontalMultiBrowseCarouselऔरHorizontalUncontainedCarousel(I88d64) - Compose M3 Nav Drawer (
ModalDrawerSheetऔरDismissibleDrawerSheet) को अपडेट किया गया है, ताकि U+ पर ऑप्ट-इन के तौर पर, अनुमानित बैक जेस्चर (Ie5b0b) की सुविधा काम कर सके - आइकॉन में एक नया एपीआई जोड़ा गया है. इससे कलर टिंट को लैंबडा के तौर पर पास किया जा सकेगा, ताकि उसे फिर से कंपोज़ करने से बचा जा सके. (I5b5a2)
- टॉप ऐप्लिकेशन बार एपीआई अब फ़िक्स्ड और कोलैप्स किए जा सकने वाले, दोनों सेक्शन के लिए कस्टम ऊंचाई की सुविधा देते हैं. (Ib8b0c, b/323403446)
एपीआई में हुए बदलाव
- टॉप ऐप्लिकेशन बार एपीआई अब फ़िक्स्ड और कोलैप्स किए जा सकने वाले, दोनों सेक्शन के लिए कस्टम ऊंचाई की सुविधा देते हैं. उस समस्या को ठीक कर दिया गया है जिसकी वजह से कॉन्टेंट को स्क्रोल करते समय, एक लाइन वाले टॉप ऐप्लिकेशन बार कई बार फिर से कंपोज़ हो जाते थे. हमने उस समस्या को ठीक कर दिया है जिसमें बड़े फ़ॉन्ट/डिसप्ले सेटिंग वाले डिवाइसों पर
MediumTopAppBarछोटे किए गए टाइटल दिखते थे. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButtonऔर इससे जुड़े एपीआई अब स्थिर हो गए हैं (I8a158)SwipeToDismissBox,SwipeToDismissBoxDefaults,SwipeToDismissBoxState, औरSwipeToDismissBoxValueको अब स्टेबल के तौर पर मार्क कर दिया गया है. (I5f000)- बहिष्कृत किए गए
DismissDirectionऔरDismissValueएनम और एपीआई हटा दिए गए हैं. (I89ccd) - कैरसेल के
CarouselStateकंपैनियन ऑब्जेक्ट में एक्सपेरिमेंटल टैग जोड़ा गया. (I94154) LocalMinimumInteractiveComponentEnforcementको बंद कर दिया गया है और इसकी जगहLocalMinimumInteractiveComponentSizeको लॉन्च किया गया है. (I7a7ac)SearchBarColorsकंस्ट्रक्टर अब सभी के लिए उपलब्ध है. (I769ca)SwipeToDismissBoxमेंgesturesEnabledपैरामीटर जोड़ा गया. (Idc59f, b/324170119)- उन टेक्स्ट फ़ील्ड एपीआई को हटा दिया गया है जिन्हें 'अब इस्तेमाल में नहीं है' और 'एक्सपेरिमेंट के तौर पर उपलब्ध' के तौर पर मार्क किया गया था. (I1305f)
वर्शन 1.3.0-alpha03
20 मार्च, 2024
androidx.compose.material3:material3-*:1.3.0-alpha03 रिलीज़ हो गया है. वर्शन 1.3.0-alpha03 में ये बदलाव शामिल हैं.
विज़ुअल में नुकसान पहुंचाने वाले बदलाव
- फ़ोकस स्टेट ओवरले को 0.1f पर अपडेट करें, ताकि रंगों का सही कंट्रास्ट मिल सके. (I7ea77)
lightColorSchemeऔरdarkColorSchemeमें, डिफ़ॉल्ट रूप से मौजूद बैकग्राउंड और रंग में मामूली बदलाव किए गए हैं. (I9db52)
नई सुविधाएं
ExposedDropdownMenuको पसंद के मुताबिक बनाने के लिए पैरामीटर जोड़े गए. खास तौर पर, मेन्यू में अबfocusableपैरामीटर (डिफ़ॉल्टtrue) होता है. बदलाव किए जा सकने वाले टेक्स्ट फ़ील्ड के साथ काम करते समय, इसेfalseपर सेट किया जाना चाहिए. (I4184c, b/323694447, b/278609042)
एपीआई में हुए बदलाव
ScaffoldSubcomposeInMeasureFixफ़्लैग को हटा दिया गया है. (Ie2a4b)NavigationRailItemColorsको अब@Immutableके तौर पर मार्क कर दिया गया है. (If6112, b/327660613)NavigationBarItemColorsको अब@Immutableके तौर पर मार्क कर दिया गया है. (I42a30, b/298064514)- Slider Track कंपोज़ेबल में पैरामीटर का क्रम बदला गया. (I9f315)
ExposedDropdownMenuको अबPopupका इस्तेमाल करके लागू किया गया है. व्यवहार एक जैसा होना चाहिए. हालांकि, कीबोर्ड पर टाइप करते समय, फ़ोकस किए जा सकने वाले मेन्यू और बदलाव किए जा सकने वाले टेक्स्ट फ़ील्ड बंद किए जा सकते हैं.
गड़बड़ियां ठीक की गईं
- सरफ़ेस और सरफ़ेस कंटेनर की बेसलाइन भूमिकाओं में थोड़ा बदलाव किया गया है. इससे, हल्के और गहरे रंग वाली थीम में ज़्यादा रंगत मिलती है. (I677a5)
- टेक्स्ट के अलावा अन्य एलिमेंट के कंट्रास्ट के नए स्पेसिफ़िकेशन के मुताबिक, स्लाइडर और
ProgressIndicatorके रंगों को अपडेट किया गया है. (I26807) - फ़ोकस स्टेट ओवरले को 0.1f पर अपडेट करें, ताकि रंगों का सही कंट्रास्ट मिल सके. (I7ea77)
lightColorSchemeऔरdarkColorSchemeमें, डिफ़ॉल्ट रूप से मौजूद बैकग्राउंड और रंग में मामूली बदलाव किए गए हैं. (I9db52)
वर्शन 1.3.0-alpha02
6 मार्च, 2024
androidx.compose.material3:material3-*:1.3.0-alpha02 रिलीज़ हो गया है. वर्शन 1.3.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- स्लाइडर की स्थितियों को फिर से स्थिर किया जा रहा है.
State.onValueChangeFinishedको फिर से मान्य किया जा रहा है.onValueChangeFinishedकोrememberUpdatedStateमें रैप किया जा रहा है. (I82ab2, b/322269951) - नेविगेशन कॉम्पोनेंट अब नई
SurfaceContainerभूमिकाओं का इस्तेमाल करते हैं.DrawerDefaultsएट्रिब्यूट में अबstandardContainerColorऔरmodalContainerColorएट्रिब्यूट शामिल हैं.DrawerDefaults.ModalDrawerElevationअब0.dpहै. (I7fbac) - हम
state.onValueChangeFinishedकोvarमें बदल रहे हैं. इसलिए,Sliderके स्टेटस से@Stableको हटाया जा रहा है. (Ied34a, b/322269951) ModalBottomSheetऔरStandardBottomSheetऐनिमेशन स्पेसिफ़िकेशन अबTweenSpecहै. इसे स्प्रिंग ऐनिमेशन से अपडेट किया गया है. इससे, दिखने वाले ओवरशूट की समस्या ठीक हो जाती है. डेंसिटी के बिना काम न करने वालेSheetStateकंस्ट्रक्टर अब हटा दिए गए हैं. (I7babc, b/285847707)
गड़बड़ियां ठीक की गईं
- अब कॉम्पोनेंट,
SurfaceContainerवैरिएंट का इस्तेमाल करते हैं. जिन कॉम्पोनेंट में Surface औरTonalElevationकी मदद से कलर का हिसाब लगाया जाता था वे अब डिफ़ॉल्ट रूप सेTonalElevationकी भूमिकाओं का इस्तेमाल करते हैं. इन पर टोनल एलिवेशन का कोई असर नहीं पड़ता.SurfaceContainer(b/304584161) - उस गड़बड़ी को ठीक किया गया है जिसकी वजह से,
ElevatedFilterChipके चुने नहीं गए और बंद किए गए कंटेनर का रंग काला हो जाता था. (I400e6, b/322407043) - प्रोग्रेस 0 होने पर, प्रोग्रेस इंडिकेटर में प्रोग्रेस का प्रतिशत न दिखने की समस्या ठीक की गई (Id6582)
- दाएं से बाएं लेआउट (Iab0e1) में
SliderऔरRangeSliderसे जुड़ी समस्या ठीक की गई - स्लाइडर की रेंज का हिसाब लगाने के लिए
SliderRangeToleranceजोड़ा गया है, क्योंकि फ़्लोट राउंडिंग गलत हो सकती है. (Ic918a, b/324934900) - पक्का करें कि
DatePickerDialogमेंDateRangePickerको नेस्ट करते समय या बड़ी स्क्रीन पर बड़े फ़ॉन्ट के साथ किसी भी तरह का तारीख चुनने वाला कंट्रोल दिखाते समय, उसके बटन दिखें. (Ie4758, b/325107799, b/277768544) Menuअब कंटेनर के रंग के लिए,SurfaceContainerकी भूमिका का इस्तेमाल करता है.MenuDefaults.TonalElevationअब0.dpहै. (I135b7)TextFieldअब कंटेनर के रंग के लिए,SurfaceContainerHighestकी भूमिका का इस्तेमाल करता है. (I4dced)- अब एलिवेटेड चिप,
SurfaceContainerLowभूमिका (I7cd2f) का इस्तेमाल करते हैं DatePickerकंटेनर का रंग अबSurfaceContainerHighहै.DatePickerDefaults.TonalElevationअब0.dpहै. (Ida753)- इस कुकी का इस्तेमाल, बॉटम शीट कंटेनर और ड्रैग हैंडल के रंग को अपडेट करने के लिए किया जाता है. (I72a0a)
RichTooltipकंटेनर का रंग अबSurfaceContainerहै. (Ia8b45)SearchBarकंटेनर का रंग अबSurfaceContainerHighestहै.SearchBarDefaults.TonalElevationअब0.dpहै. (I88604)- अपडेट स्विच बंद कर दिया गया है. साथ ही,
SurfaceContainerHighestकलर रोल का इस्तेमाल करने के लिए, चुने नहीं गए ट्रैक/आइकॉन को हटा दिया गया है. (I7687a) AlertDialogकंटेनर का रंग अबSurfaceContainerHighहै. (Ie0433)BottomAppBarकंटेनर का रंग अबSurfaceContainerहै.TopAppBaronScrollका रंग अबSurfaceContainerहै. (I41630)ElevatedCardकंटेनर का रंग अबSurfaceContainerLowहै.FilledCardके कंटेनर का रंगSurfaceContainerHighestहै. (I35141)ElevatedButtonकंटेनर का रंग अबSurfaceContainerLowहै.FilledIconButtonको अबSurfaceContainerHighestरंग में दिखाया जाएगा. (I792c9)TimePickerकंटेनर के रंग और घड़ी के डायल के रंग की भूमिका कोSurfaceContainerHighestमें अपडेट करता है. (I43b93)
वर्शन 1.3.0-alpha01
21 फ़रवरी, 2024
androidx.compose.material3:material3-*:1.3.0-alpha01 रिलीज़ हो गया है. वर्शन 1.3.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Compose M3
ModalBottomSheetको अपडेट करें, ताकि यह U+ पर Predictive Back की सुविधा के साथ काम कर सके (Iccf32, b/281967264, b/304850357) - U+ पर पीछे जाने पर झलक दिखाने वाले हाथ के जेस्चर की सुविधा के लिए, Compose M3
SearchBarको अपडेट किया गया (I657f8) - स्लाइडर को अपडेट किया गया है, ताकि सुलभता को बेहतर बनाया जा सके. इसके लिए, स्लाइडर में गैप और स्टॉप इंडिकेटर जोड़ा गया है. (I3058e)
- गैप और स्टॉप इंडिकेटर जोड़कर,
ProgressIndicatorको अपडेट किया गया है, ताकि इसे आसानी से ऐक्सेस किया जा सके. (I21451) - रिच टूलटिप के लिए डिफ़ॉल्ट कैरट जोड़ा गया. रिच टूलटिप का नया एपीआई, अब ऐंकर
LayoutCoordinatesके हिसाब से कस्टम कैरट बनाने की अनुमति देता है. (Ifd42c)
व्यवहार में बदलाव
- मटीरियल कॉम्पोनेंट को नए रिपल एपीआई का इस्तेमाल करने के लिए माइग्रेट कर दिया गया है. अब वे
RippleThemeसे क्वेरी नहीं करते हैं.
एपीआई में हुए बदलाव
drawStopIndicatorअब सभी के लिए उपलब्ध है. (I3f59f)DatePickerकेformatWithSkeletonफ़ंक्शन को इंटरनल के तौर पर मार्क करें (Ic65dc)DropdownMenuमें अब कस्टम कलर, शेप, एलिवेशन, और बॉर्डर का इस्तेमाल किया जा सकता है. (I8e981, b/289554448, b/301887035, b/283654243)- Material3 कॉम्पोनेंट, अपने एपीआई में
MutableInteractionSourceको दिखाते हैं. इन्हें अब अपडेट कर दिया गया है. अब ये ऐसेMutableInteractionSourceको दिखाते हैं जो नल हो सकता है और डिफ़ॉल्ट रूप सेnullपर सेट होता है. यहां कोई सिमैंटिक बदलाव नहीं किया गया है: null पास करने का मतलब है कि आपकोMutableInteractionSourceको ऊपर नहीं ले जाना है. अगर ज़रूरत होगी, तो इसे कॉम्पोनेंट के अंदर बनाया जाएगा. इसे null पर सेट करने से, कुछ कॉम्पोनेंट कभी भीMutableInteractionSourceको असाइन नहीं करते हैं. साथ ही, अन्य कॉम्पोनेंट सिर्फ़ तब इंस्टेंस बनाते हैं, जब उन्हें इसकी ज़रूरत होती है. इससे इन कॉम्पोनेंट की परफ़ॉर्मेंस बेहतर होती है. अगर इन कॉम्पोनेंट को पास किए गएMutableInteractionSourceका इस्तेमाल नहीं किया जा रहा है, तो हमारा सुझाव है कि आप इसके बजाय null पास करें. हमारा यह भी सुझाव है कि आप अपने कॉम्पोनेंट में भी इसी तरह के बदलाव करें. (I41abb, b/298048146) RippleConfigurationऔरLocalRippleConfigurationजोड़े गए हैं. इससे, तय की गई वैल्यू का इस्तेमाल करके, हर कॉम्पोनेंट / सब-ट्री के लिए रिपल को पसंद के मुताबिक बनाया जा सकेगा. उदाहरण के लिए, किसी ऐसे कॉम्पोनेंट का रंग बदलने के लिए जिसे कंट्रोल नहीं किया जा सकता या किसी कॉम्पोनेंट के लिए रिपल इफ़ेक्ट बंद करने के लिए. ज़्यादातर मामलों में, डिफ़ॉल्ट वैल्यू का इस्तेमाल करना चाहिए: ये एपीआई, अलग-अलग कॉम्पोनेंट / सीमित सब-ट्री को पसंद के मुताबिक बनाने के लिए एक विकल्प हैं. बड़े बदलावों और कस्टम डिज़ाइन सिस्टम के लिए, आपकोcreateRippleModifierNodeका इस्तेमाल करके अपना रिपल बनाना चाहिए. (I7b5d6, b/298048146)- material3 में नया रिपल एपीआई जोड़ा गया है. यह
rememberRippleकी जगह लेगा. यहrememberRipple/RippleThemeएपीआई के इस्तेमाल के लिए, Material3 कॉम्पोनेंट को वापस लाने के लिए, कुछ समय के लिएCompositionLocal,LocalUseFallbackRippleImplementationभी जोड़ता है. इसे अगले स्टेबल वर्शन में हटा दिया जाएगा. साथ ही, इसका इस्तेमाल सिर्फ़ उन मामलों में किया जा सकता है जहां आपको कस्टमRippleThemeदेना है. (I34cbc, b/298048146)
गड़बड़ियां ठीक की गईं
- परफ़ॉर्मेंस को बेहतर बनाने के लिए,
ModalBottomSheetमें मौजूद सबकंपोज़िशन को हटा दिया गया है. उस समस्या को ठीक किया गया है जिसमेंLookaheadScopeके साथ इस्तेमाल करने पर, कुछ खास मामलों मेंModalBottomSheetक्रैश हो सकता था. (I2a198) - परफ़ॉर्मेंस को बेहतर बनाने के लिए,
BottomSheetScaffoldमें मौजूद सबकंपोज़िशन को हटा दिया गया है. उस समस्या को ठीक किया गया है जिसमेंLookaheadScopeके साथ इस्तेमाल करने पर, कुछ खास मामलों मेंBottomSheetScaffoldक्रैश हो जाता था. (Ie6401) - बैज के अलाइनमेंट को इस तरह से अडजस्ट किया जाता है कि वह सबसे ऊपर दाएं कोने के हिसाब से, ऐंकर किए गए कॉन्टेंट के बीच में हो. (I18a28)
DateRangePickerमें सुलभता से जुड़ी समस्या को ठीक किया गया है. इसमें, महीने और साल के टेक्स्ट टाइटल को स्क्रीन रीडर, स्विच ऐक्सेस, और Voice Access का इस्तेमाल करने वाले लोगों के लिए कार्रवाई करने लायक बताया गया था. (I2ac55)mediumTopAppBarColorsपैरामीटर के क्रम से जुड़ी गड़बड़ी ठीक की गई. (Ibe64a)
वर्शन 1.2
वर्शन 1.2.1
6 मार्च, 2024
androidx.compose.material3:material3-*:1.2.1 रिलीज़ हो गया है. वर्शन 1.2.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- स्लाइडर की स्थितियों को फिर से स्थिर करें.
State.onValueChangeFinishedको फिर से मान्य किया जा रहा है.onValueChangeFinishedकोrememberUpdatedStateमें रैप किया जा रहा है. (Ie8fd0, b/322269951) - हम
state.onValueChangeFinishedकोvarमें बदल रहे हैं. इसलिए,Sliderके स्टेटस से@Stableको हटाया जा रहा है. (I82ba1, b/322269951) - डिफ़ॉल्ट रंगों से कॉपी करने के लिए,
NavigationBarकस्टम रंगों को ठीक करें. (80a779, b/326894020) ExposedDropdownMenuमें रिग्रेशन को ठीक किया गया है, ताकि इसे फिर से फ़ोकस किया जा सके (3fcec1, b/323694447)- 'ठीक करें' बटन के रंग को कैश मेमोरी में सेव करने से जुड़ी समस्या ठीक की गई (3e5bbcb/327371655)
वर्शन 1.2.0
7 फ़रवरी, 2024
androidx.compose.material3:material3-*:1.2.0 रिलीज़ हो गया है. वर्शन 1.2.0 में ये बदलाव शामिल हैं.
आम समस्या
- परफ़ॉर्मेंस को बेहतर बनाने के लिए,
PrimaryTabRowमें व्यू-कंपोज़ इंटरऑप रेंडरिंग से जुड़ी गड़बड़ी हुई थी. इस समस्या को हल करने के लिए,TabRowDefaults.PrimaryIndicatorकी मदद सेTabRowका इस्तेमाल करें
1.1.0 के बाद हुए अहम बदलाव
Material Design 3 के नए कॉम्पोनेंट
- नीचे खींचकर रीफ़्रेश करें
- सेगमेंट किया गया बटन
मौजूदा मटीरियल डिज़ाइन 3 कॉम्पोनेंट को बेहतर बनाया गया है.
- बॉटम ऐप्लिकेशन बार (आरटीएल अलाइनमेंट, स्क्रोल करने पर अपने-आप छिप जाता है)
- टैब के विज़ुअल में बदलाव
- बैज (अलाइनमेंट अपडेट)
एक्सपेरिमेंटल एपीआई को स्टेबल वर्शन में प्रमोट किया गया!
परफ़ॉर्मेंस में सुधार
- ज़्यादा जानकारी के लिए, कृपया यह ब्लॉग पोस्ट देखें!
वर्शन 1.2.0-rc01
24 जनवरी, 2024
androidx.compose.material3:material3-*:1.2.0-rc01 रिलीज़ हो गया है. वर्शन 1.2.0-rc01 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
mediumTopAppBarColorsपैरामीटर के क्रम से जुड़ी गड़बड़ी ठीक की गई. (Ibe64a)CardDefaults.cardColorsमें1.2.0-beta02के दौरान हुई गड़बड़ी को ठीक किया गया है. इस गड़बड़ी की वजह से,containerColorपैरामीटर की वैल्यू के आधार परcontentColorअपडेट नहीं हो रहा था. (Iee041, b/319671246)1.2.0-beta02में पेश की गईdisabledContentColorमें मौजूद गड़बड़ी को ठीक किया गया है. साथ ही, इसमें कुछ सुधार किए गए हैं. (I6dda1, b/318428829)
वर्शन 1.2.0-beta02
10 जनवरी, 2024
androidx.compose.material3:material3-*:1.2.0-beta02 रिलीज़ हो गया है. वर्शन 1.2.0-beta02 में ये बदलाव शामिल हैं.
ऐसी गड़बड़ी जिसकी जानकारी पहले से है
IconButtonColorsमें मौजूद एक बग की वजह से, उपयोगकर्ता के तय किए गएcontentColorके बजाय,LocalContentColorके ऐल्फ़ा (0.38f) को डिफ़ॉल्ट रूप सेdisabledContentColorअसाइन कर दिया जाएगा. इस समस्या को हल करने के लिए,disabledContentColorको साफ़ तौर पर सेट करें. इस समस्या को अगले वर्शन में ठीक कर दिया जाएगा.
एपीआई में हुए बदलाव
- Plain
TooltipAPI के लिए, टूलटिप कैरट चालू करने की सुविधा जोड़ी गई है. (Ibf767) SwipeToDismissState,rememberSwipeToDismiss, औरSwipeToDismissValue, सभी का नाम बदलकर_SwipeToDismissBox_कर दिया गया है. (I68d6d)
गड़बड़ियां ठीक की गईं
ListItemके आखिर में पैडिंग की वैल्यू को स्पेसिफ़िकेशन के मुताबिक अलाइन करने से जुड़ी समस्या ठीक की गई. (Ibd68b, b/305342674)- आउटलाइन वाले कार्ड के लिए आउटलाइन का रंग, अब
OutlineVariantपर सही तरीके से मैप किया गया है. (I75480, b/310979715) - डाइनैमिक कलर अब सिस्टम में तय की गई कलर रोल से जानकारी लेता है. इससे, ऐक्सेस किए जा सकने वाले कॉन्टेंट का कंट्रास्ट बेहतर होता है. साथ ही, डाइनैमिक कलर, Material spec के ज़्यादा करीब होता है. (I1de96)
- Android T/13+ पर
android:enableOnBackInvokedCallback="true"होने पर,ModalBottomSheetको वापस लाने की सुविधा से जुड़ी समस्या ठीक की गई. (I728dc, b/306196110)
वर्शन 1.2.0-beta01
13 दिसंबर, 2023
androidx.compose.material3:material3-*:1.2.0-beta01 रिलीज़ हो गया है. वर्शन 1.2.0-beta01 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
TabIndicatorScopeको एक्सपेरिमेंट के तौर पर मार्क करें. (I45c88)- टूलटिप के लिए, बंद किए गए एक्सपेरिमेंटल एपीआई हटाए जा रहे हैं. (I438cb)
- नई
TabRowओवरलोड को इस तरह से बदलें कि वे सबकंपोज़िशन का इस्तेमाल न करें. इससे, कस्टम मॉडिफ़ायर के साथTabRowइंडिकेटर बनाने का एक अलग तरीका मिलता है. (Ife741) DismissDirectionऔरDismissValueएपीआई को बंद कर दिया गया है. इन्हेंSwipeToDismissValueमें मर्ज कर दिया गया है. इनकी वैल्यू से,SwipeToDismissBoxकी पोज़िशन और दिशा, दोनों के बारे में पता चलता है.DismissState.progressको अब0.0और1.0के बीचFloatRangeके तौर पर मार्क किया गया है.DismissStateके बंद किए गए Saver और Constructor को अब हटा दिया गया है.SwipeToDismissकॉम्पोनेंट, स्टेट, और डिफ़ॉल्ट ऑब्जेक्ट को एक्सपेरिमेंटल के तौर पर फिर से मार्क किया गया है. (Ib54f2)
गड़बड़ियां ठीक की गईं
PullToRefreshके लिए डिफ़ॉल्ट इंडिकेटर, अब भरे हुए त्रिकोण के बजाय खुला ऐरोहेड है. (I67be3)
वर्शन 1.2.0-alpha12
29 नवंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha12 रिलीज़ हो गया है. वर्शन 1.2.0-alpha12 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
RangeSliderअब Kotlin रेंज लेता है. जैसे,0f..1f) का इस्तेमाल करें.FloatRangeSnapFlingBehavior.ktमें अब Kotlin रेंज का भी इस्तेमाल किया जाता है. (I025cb)- Mark Modifier फ़ैक्ट्री फ़ंक्शन को
@Stableके तौर पर मार्क करें. (Ib109f)
वर्शन 1.2.0-alpha11
15 नवंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha11 रिलीज़ हो गया है. वर्शन 1.2.0-alpha11 में ये बदलाव शामिल हैं.
नई सुविधाएं
- यह
PullToRefreshContainerऔरPullToRefreshStateको लागू करता है. ये दोनों मिलकर, Material3 में रीफ़्रेश करने के लिए पुल की सुविधा देते हैं. (I16456, b/261760718)
एपीआई में हुए बदलाव
SwipeToDismissBoxDismissDirectionऔरDismissValueको एक्सपेरिमेंट के तौर पर मार्क करें. (I517b0)SwipeToDismissका नाम बदलकरSwipeToDismissBoxकरें.backgroundका नाम बदलकरbackgroundContentऔरdismissContentका नाम बदलकर, आखिर में इस्तेमाल होने वालाcontentlambda करें. (I7f4d3)ChipElevationऔरSelectableChipElevationके कंस्ट्रक्टर को सार्वजनिक करें. (Ie0c48, b/308432421)ModalBottomSheetPropertiesजोड़ा जा रहा है.securePolicyकोModalBottomSheetPropertiesमें ले जाया जा रहा है.isFocusableऔरshouldDismissOnBackPressकोModalBottomSheetPropertiesमें जोड़ा जा रहा है. इन नए बूलियन से यह तय करने में मदद मिलती है कि बॉटम शीट वाला मोडल, IME इवेंट को कैसे हैंडल करे. (Iea56f, b/278216859)RangeSliderऔरSliderकी स्थितियों को अपडेट किया गया है, ताकिinitialOnValueChange, शुरुआती प्रीफ़िक्स, और ज़रूरी केडॉक को हटाया जा सके. (I57d30)ChipBorderक्लास और उससे जुड़े फ़ंक्शन कॉल को बंद कर दिया गया है. हमारा सुझाव है कि इसके बजाय, सीधेBorderStrokeका इस्तेमाल करें. (I89cc2)- Foundation Tooltip API अब
@ExperimentalFoundationApiहैं. (I30b0b) TabRowऔरScrollableTabRowको अब बंद नहीं किया गया है. प्राइमरी और सेकंडरी वैरिएंट के नए वर्शन को एक्सपेरिमेंटल के तौर पर मार्क किया गया है. (I0def6)- फ़िल्टर और इनपुट चिप अब सीधे
BorderStrokeका इस्तेमाल करते हैं. (I07a8d) SegmentedButtonअब सीधे तौर परBorderStrokeका इस्तेमाल करता है. (I89b9b)- सामान्य
AlertDialogफ़ंक्शन का नाम बदलकरBasicAlertDialogकर दिया गया है. साथ ही, पिछले फ़ंक्शन को बंद कर दिया गया है. (Idbe52) SwipeToDismissएपीआई का नाम बदलकरSwipeDismissकर दिया गया है. साथ ही, नएSwipeDismissएपीआई को स्टेबल वर्शन के तौर पर प्रमोट किया गया है. (I14cbe)- टूलटिप एपीआई में
tonalElevationऔरshadowElevationको जोड़ा जा रहा है. इसके अलावा,TooltipBox,PlainTooltip, औरRichTooltipएपीआई को वापस एक्सपेरिमेंटल वर्शन में ले जाया गया है, क्योंकि इन्हें गलती से स्टेबल वर्शन के तौर पर रिलीज़ कर दिया गया था. (If0f66, b/293939035) - एक्सपेरिमेंट के तौर पर उपलब्ध चिप एपीआई को स्टेबल वर्शन में प्रमोट करें. (Iea2c3)
- Material3 के क्लिक किए जा सकने वाले कार्ड से
@ExperimentalMaterial3Apiएनोटेशन हटा दिया गया है. (I88dbf)
गड़बड़ियां ठीक की गईं
- नेस्ट किए गए Lookahead और Lazy लेआउट के साथ कुछ स्थितियों में
SwipeToDismissके क्रैश होने की समस्या को ठीक किया गया है. (Ica8d1, b/297226562)
वर्शन 1.2.0-alpha10
18 अक्टूबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha10 रिलीज़ हो गया है. वर्शन 1.2.0-alpha10 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
BadgeऔरBadgedBoxको स्टेबल वर्शन में प्रमोट किया जा रहा है. (I67f16, b/261565132)ModalBottomSheetमेंsecurePolicyको पैरामीटर के तौर पर जोड़ा गया है, ताकि उपयोगकर्ताWindowManager.LayoutParams.FLAG_SECUREके लिए व्यवहार तय कर सकें. (Icdac8, b/296250262)LinearProgressIndicatorऔरCircularProgressIndicatorके नए ओवरलोड जोड़े गए हैं. येprogressको लैम्ब्डा के तौर पर लेते हैं. ये पिछले वर्शन से बेहतर परफ़ॉर्म करने चाहिए. (I824e6, b/295616656)StandardSizeClassesका नाम बदलकरAllSizeClassesकर देता है. (I8cb07)- विंडो के साइज़ के हिसाब से क्लास तय करने वाले फ़ंक्शन को एक साथ इस्तेमाल करें. (Iad935)
गड़बड़ियां ठीक की गईं
- जब दिखाया गया महीना, सालों की तय सीमा के आखिर में होता है, तब नेविगेशन ऐरो बटन पर तेज़ी से क्लिक करने पर होने वाली
DatePickerक्रैश की समस्या को ठीक किया गया है. (I46f36, b/290954897, b/297002119) - [नेविगेशन रेल/बार] इंडिकेटर के लिए पारदर्शी रंग की सुविधा उपलब्ध है. (Ie0a9b, b/267289987)
वर्शन 1.2.0-alpha09
4 अक्टूबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha09 रिलीज़ हो गया है. वर्शन 1.2.0-alpha09 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
ModalNavigationDrawerऔरDismissibleNavigationDrawerको माइग्रेट किया गया, ताकि नएAnchoredDraggableएपीआई का इस्तेमाल किया जा सके.DrawerStateकेanimateToको अब open और close तरीकों से बदल दिया गया है. साथ ही, ऑफ़सेट को अब स्टेट ऑब्जेक्ट के बजाय फ़्लोट के तौर पर दिखाया जाता है. ऑफ़सेट को सीधेcurrentOffsetके ज़रिए ऐक्सेस किया जा सकता है. (I0a72c)DatePickerStateऔरDateRangePickerStateको सीधे तौर पर बनाने के लिए, नॉन-कंपोज़ेबल फ़ंक्शन जोड़े गए हैं. ज़रूरत पड़ने पर, इन फ़ंक्शन का इस्तेमाल कंपोज़ेबलrememberDatePickerStateऔरrememberDateRangePickerStateफ़ंक्शन के विकल्प के तौर पर किया जा सकता है. (I70326, b/291524052)- फ़िक्स्ड और स्क्रोल किए जा सकने वाले
TabRowsमें अब प्राइमरी और सेकंडरी वैरिएंट उपलब्ध हैं. ये Material3 में तय किए गए रंग और इंडिकेटर के व्यवहार के हिसाब से सही तरीके से मैप किए गए हैं. PrimaryScrollableTabRowऔरSecondaryScrollableTabRowअब स्क्रोल की स्थिति दिखाते हैं. (Iec8f5, b/260572337)- एक नया
sheetMaxWidthपैरामीटर जोड़ा गया है. डेवलपर इसे सेट करके, शीट की ज़्यादा से ज़्यादा चौड़ाई तय कर सकते हैं. अगर आपको पूरी स्क्रीन की चौड़ाई वाली शीट चाहिए, तो पैरामीटर के लिए Dp.Unspecified पास किया जा सकता है. (Ifb7c9, b/266697696) PlainTooltipBoxऔरRichTooltipBoxएपीआई को, बंद किए गए तरीकों के तौर पर फिर से जोड़ा गया. (I246fa)
गड़बड़ियां ठीक की गईं
DatePickerको ऐसेDatePickerFormatterके साथ शुरू करने पर होने वाली क्रैश की समस्या ठीक की गई है जिसमें तारीख के कुछ ऐसे स्केलेटन होते हैं जो तारीख के पैटर्न (जैसे, YY) में बदलने पर भी एक जैसे रहते हैं. (I01f29)
वर्शन 1.2.0-alpha08
20 सितंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha08 रिलीज़ हो गया है. वर्शन 1.2.0-alpha08 में ये बदलाव शामिल हैं.
व्यवहार में नुकसान पहुंचाने वाला बदलाव
ColorSchemeअब बदला नहीं जा सकता. इसलिए, अलग-अलग रंगों को अपडेट करना कम असरदार हो गया है. हालांकि, रंगों का ज़्यादा इस्तेमाल करना ज़्यादा असरदार हो गया है. इस बदलाव की वजह यह है कि ज़्यादातर ऐप्लिकेशन में, अलग-अलग रंगों को अपडेट करने की सुविधा मुख्य तौर पर इस्तेमाल नहीं की जाती. अब भी ऐसा किया जा सकता है, लेकिन इससे पहले की तुलना में ज़्यादा कोड फिर से कंपोज़ होगा. इससे Material कोड के ज़रिए, स्टेट की सदस्यता लेने की संख्या में काफ़ी कमी आएगी. साथ ही, इससे ज़्यादा स्टैंडर्ड इस्तेमाल के उदाहरणों की शुरुआती और रनटाइम लागत पर असर पड़ेगा. (Ic447d, b/297212873)- टोनल एलिवेशन अब अलग-अलग इंटरैक्शन स्टेट में ऐनिमेट नहीं होता है, ताकि स्पेसिफ़िकेशन से मेल खा सके. (Icdd12)
एपीआई में हुए बदलाव
- एक नया
BottomAppBarजोड़ा गया है. यहBottomAppBarScrollBehaviorको पैरामीटर के तौर पर लेता है, ताकि कॉन्टेंट स्क्रोल करने पर यह अपने-आप छिप जाए.FabPosition.EndOverlayको भी जोड़ा गया है. इससे FAB को ऐंकर करने के बजाय, उसे स्कैफ़ोल्ड में सबसे नीचे मौजूद ऐप्लिकेशन बार पर ओवरले किया जा सकता है. (Iecb47) - एक सामान्य लेबल कॉम्पोनेंट जोड़ा गया है, जो
BasicTooltipBoxके ऊपर बनाया गया है. लेबल की सीमाओं के बाहर टैप करने पर यह खारिज नहीं होगा. (I821f9)
गड़बड़ियां ठीक की गईं
- टूलटिप के लिए
rememberSaveableका इस्तेमाल बंद कर दिया गया है. (Icc131, b/299500338) - एक अस्थायी फ़्लैग जोड़ा गया है. इससे यह कंट्रोल किया जा सकेगा कि मेज़रमेंट के दौरान या प्लेसमेंट के दौरान, Scaffold को अपने चाइल्ड विजेट का मेज़रमेंट करना चाहिए या नहीं. डिफ़ॉल्ट रूप से, इसे मेज़रमेंट में मेज़र किया जाएगा. अगर आपको नई सुविधा से जुड़ी कोई समस्या आ रही है, तो कृपया इसकी शिकायत करें. (I0b354)
- डिवाइस की स्क्रीन की चौड़ाई के लिए सही मेज़रमेंट का इस्तेमाल करके,
BottomSheetमें हॉरिज़ॉन्टल तौर पर Edge to Edge फ़िक्स किया गया. (I1df0c, b/299058752) ModalBottomSheetको खारिज करने के लिए शीट पर नीचे की ओर स्वाइप करने पर,ModalBottomSheetकेonDismissedRequestको कॉल न करने की गड़बड़ी को ठीक किया गया है. (Idfdd8)
वर्शन 1.2.0-alpha07
6 सितंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha07 रिलीज़ हो गया है. वर्शन 1.2.0-alpha07 में ये बदलाव शामिल हैं.
नई सुविधाएं
compose material 1.6.0-alpha05में, अपने-आप मिरर होने वाले आइकॉन की सुविधा जोड़ी गई है. अपने-आप मिरर होने वाले आइकॉन के बारे में ज़्यादा जानने के लिए, कृपया रिलीज़ नोट देखें.
एपीआई में हुए बदलाव
SliderState,DraggableState(I9b116) को लागू करता है- आकार को ज़रूरी पैरामीटर के तौर पर बदलें. शेप हेल्पर फ़ंक्शन में,
positionका नाम बदलकरindexकरें. (I34941) - यह कुकी,
DatePickerformatWithSkeletonको अपडेट करती है. इसमें एक ऐसा मैप शामिल होता है जिसका इस्तेमाल परफ़ॉर्मेंस को बेहतर बनाने के लिए कैश मेमोरी के तौर पर किया जाता है. (I3195f) compose.foundationमेंBasicTooltipBoxको जोड़ा गया है. साथ ही,PlainTooltipBoxऔरRichTooltipBoxको अपडेट किया गया है, ताकि नएPlainTooltipऔरRichTooltipकंपोज़ेबल के साथTooltipBoxका इस्तेमाल किया जा सके. (I79e1d)
गड़बड़ियां ठीक की गईं
dynamicLightColorSchemeऔरdynamicDarkColorSchemeअब सर्फ़ेस औरsurfaceContainerभूमिकाओं के लिए, ज़्यादा क्रोमा वाले रंग दिखाते हैं. (I5e901)- हमने उस समस्या को ठीक कर दिया है जिसमें
LookaheadScopeके अंदर मौजूद Scaffold के अंदर Subcomposition (जैसे किBottomSheetScaffold) का इस्तेमाल करने वाले कुछ कॉम्पोनेंट, अपने साइज़ को बहुत पहले ही पढ़ने की कोशिश कर रहे थे. (I297b4, I871f1, b/295536718)
वर्शन 1.2.0-alpha06
23 अगस्त, 2023
androidx.compose.material3:material3-*:1.2.0-alpha06 रिलीज़ हो गया है. वर्शन 1.2.0-alpha06 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
DropdownMenu'soffsetकी कैलकुलेशन में सुधार किया गया है, ताकि x ऑफ़सेट सिर्फ़ स्थानीय लेआउट की दिशा पर निर्भर करें. साथ ही, जब मेन्यू स्क्रीन के सबसे नीचे होगा, तब y ऑफ़सेट अब उलट नहीं जाएंगे. (Iccc74, b/294103942)DropdownMenu'soffsetकी कैलकुलेशन में सुधार किया गया है, ताकि x ऑफ़सेट सिर्फ़ स्थानीय लेआउट की दिशा पर निर्भर करें. साथ ही, जब मेन्यू स्क्रीन के सबसे नीचे होगा, तब y ऑफ़सेट अब उलट नहीं जाएंगे. (Ib87a2, b/294103942)
वर्शन 1.2.0-alpha05
9 अगस्त, 2023
androidx.compose.material3:material3-*:1.2.0-alpha05 रिलीज़ हो गया है. वर्शन 1.2.0-alpha05 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- चेकबॉक्स और
TriStateCheckboxरंगों में किए गए अपडेट.CheckboxDefaults.colors()disabledUncheckedColorअब सिर्फ़ चेकबॉक्स के बॉर्डर पर असर डालता है. कुछ खास मामलों में, जब यह सुविधा बंद हो और चुने न गए बॉक्स के लिए, आपको बॉक्स के अंदर का रंग सेट करना हो, तब आपकोCheckboxColorsका कस्टम इंस्टेंस बनाना होगा. इसमें रंग की वैल्यू आपकी पसंद के मुताबिक होंगी. (I77d17, b/291943198)
वर्शन 1.2.0-alpha04
26 जुलाई, 2023
androidx.compose.material3:material3-*:1.2.0-alpha04 रिलीज़ हो गया है. वर्शन 1.2.0-alpha04 में ये बदलाव शामिल हैं.
नई सुविधाएं
- एक्सपेरिमेंट के तौर पर उपलब्ध Segmented Button API (Ifc8fb)
- अब डिवाइडर में ओरिएंटेशन को कंट्रोल करने के लिए एक पैरामीटर होता है, ताकि वर्टिकल डिवाइडर का इस्तेमाल किया जा सके. (I4c899, b/288438593)
एपीआई में हुए बदलाव
- हम डेंसिटी की निर्भरता को कॉम्पोनेंट लेवल पर ले जा रहे हैं. यह इन कॉम्पोनेंट पर लागू होता है:
SwipeToDismissऔर शीट पर आधारित कॉम्पोनेंट. कृपया उस नए ओवरलोड का इस्तेमाल करें जिसमें डेंसिटी एक पैरामीटर है. (I1846e) - कंपोज़ेबल में इस्तेमाल किए जा सकने वाले इनपुट के बारे में बताने वाले अतिरिक्त एनोटेशन (Ief234)
- सेगमेंट किए गए बटन में आइकॉन पैरामीटर जोड़ें. साथ ही, सिमैंटिक को इस तरह से बांटें कि सेगमेंट किए गए बटन को चुना जा सके. इससे सिंगल-सिलेक्ट को लागू किया जा सकेगा. साथ ही, टॉगल किया जा सकेगा, ताकि मल्टी-सिलेक्ट को लागू किया जा सके. इसके लिए,
SelectableSegmentedButtonRowऔरToggelableSegmentedButtonRowका इस्तेमाल किया जाएगा. (I38740) - डिवाइडर का नाम बदलकर
HorizontalDividerकर दिया गया है.VerticalDividerकी सुविधा जोड़ी गई. (I5975c) - ऑटोबॉक्सिंग को कम करने के लिए, एक्सपेरिमेंटल Material3 एपीआई में हल्के
FloatRangeके लिएClosedFloatingPointRangeका इस्तेमाल बदलें. (I4aab5) FabPositionके लिए नया स्टार्ट अलाइनमेंट जोड़ा गया (Ib7aea, b/170592777)
गड़बड़ियां ठीक की गईं
ModalBottomSheetस्थानीय लेआउट की दिशा का पालन करता है. (Ib4f44, b/285628622)
वर्शन 1.2.0-alpha03
21 जून, 2023
androidx.compose.material3:material3-*:1.2.0-alpha03 रिलीज़ हो गया है. वर्शन 1.2.0-alpha03 में ये बदलाव शामिल हैं.
व्यवहार में बदलाव
- Material 3 टाइपोग्राफ़ी में,
includeFontPaddingअब डिफ़ॉल्ट रूप सेfalseहै. डिफ़ॉल्ट लाइन की ऊंचाई की स्टाइल को भीTrim.NoneऔरAlignment.Centerमें बदल दिया गया है. साथ ही,TypographyकेTextStyleमेंlineHeight(sp में) जोड़ दिया गया है. अगर आपको इन वैल्यू को पसंद के मुताबिक बनाना है, तो एपीआई के दस्तावेज़ पढ़ें. साथ ही, इन बदलावों के बारे में ज़्यादा जानकारी पाने के लिए, ब्लॉग पोस्ट पढ़ें. (I6266f, Icabc3)
नई सुविधाएं
RangeSliderके लिए एक ओवरलोड जोड़ा गया है, जो कॉम्पोनेंट का स्टेटफ़ुल वर्शन है. एकRangeSliderStateबनाया गया है. इसमें मौजूदा ऐक्टिव ट्रैक की पूरी जानकारी,RangeSliderके कॉम्पोनेंट के मेज़रमेंट, और ड्रैग और जेस्चर लॉजिक शामिल है. (I8c270)- सर्च बार में अब नई जोड़ी गई
shadowElevationपैरामीटर की मदद से शैडो का इस्तेमाल किया जा सकता है. (Ia5369, b/271040353) ColorSchemeमें अबSurfaceContainerनई भूमिकाएं उपलब्ध हैं.- अब
LocalTonalElevationEnabledकंपोज़िशन लोकल का इस्तेमाल करके, Surface के टोनल एलिवेशन ओवरले को बंद किया जा सकता है. (Ic203c, b/277774590)
एपीआई में हुए बदलाव
- कॉम्पोनेंट के रंगों के कंस्ट्रक्टर खोलें. (I8c4a6)
- दोनों टूलटिप एपीआई में फ़ोकस किए जा सकने वाले पैरामीटर को जोड़ा गया है, ताकि डेवलपर यह तय कर सकें कि टूलटिप को टच इवेंट इस्तेमाल करने हैं या नहीं. ध्यान रखें कि इससे, सुलभता फ़ोकस के अपने-आप ट्रैवर्स होने की सुविधा काम नहीं करेगी. (Ie32d8)
- परफ़ॉर्मेंस और मेमोरी के लिए, सुलभता को ऑप्टिमाइज़ किया गया है. (Iede48)
WindowSizeClasses(I91838) के लिएDefaultSizeClassesको सार्वजनिक करें औरStandardSizeClassesबनाएंWindowWidth/HeightSizeClassको फ़्लोट वैल्यू क्लास (Ie686e) में बदलें
गड़बड़ियां ठीक की गईं
- Scaffold का
contentWindowInsetsपैरामीटर अब इस्तेमाल किए गए विंडो इंसर्ट का पालन करता है. ध्यान दें कि इन पैरामीटर को उपलब्ध कराने पर,topBarऔरbottomBarके आधार पर कॉन्टेंट पैडिंग के व्यवहार में कोई बदलाव नहीं होता है. (I08b73, b/264601542) - सेंटर टॉप ऐप्लिकेशन बार के अलाइनमेंट को ठीक करें, ताकि लंबा टाइटल ऐक्शन आइकॉन या नेविगेशन आइकॉन पर रेंडर न हो. (I4369f, b/236994621)
- टैब की पोज़िशन के लिए, अब कॉन्टेंट की कम से कम चौड़ाई 24.dp होनी चाहिए. इससे टैब इंडिकेटर के लिए, आसानी से ऐक्सेस किया जा सकने वाला टच टारगेट मिलता है. (Id8861)
dynamicLightColorSchemeऔरdynamicDarkColorSchemeकी डाइनैमिक कलर पैलेट की सुविधा अब नई सर्फ़ेस भूमिकाओं के साथ काम करती है. (I1252e)- बैज की सूचना के अलाइनमेंट को अपडेट किया गया है, ताकि ग्रेट ग्रैंडपैरेंट से टकराने पर वह न कटे. (Idf75a)
वर्शन 1.2.0-alpha02
24 मई, 2023
androidx.compose.material3:material3-*:1.2.0-alpha02 रिलीज़ हो गया है. वर्शन 1.2.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
ModalBottomSheetमें विंडो इंसर्ट पैरामीटर जोड़ें.- अब
ModalBottomSheetके लिए स्क्रिम को स्टेटस बार के पीछे बनाया जा सकता है. इसके लिए,windowInsetsको शून्य पर सेट करना होगा - सिस्टम बार (जैसे, नेविगेशन बार) से बाहर रहने के लिए,
ModalBottomSheetकी डिफ़ॉल्ट सेटिंग को अपडेट किया गया - एज-टू-एज मोड में, स्टेटस बार के इंसर्ट को ड्रैग हैंडल से मैनेज किया जाता है.
BottomSheetDefaultsमेंBottomSheetWindowके लिए विंडो इनसेट शामिल हैं. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- अब
- M3 के स्पेसिफ़िकेशन से मेल खाने के लिए,
Indicatorको बंद करें औरPrimary/SecondaryIndicatorजोड़ें.PrimaryIndicator, टैब के कॉन्टेंट की चौड़ाई से मेल खाता है, जबकिSecondaryIndicator, उपलब्ध पूरी चौड़ाई में फैला होता है.SecondaryIndicator, अब इस्तेमाल नहीं किए जा रहेIndicatorके बराबर है और इसे सीधे तौर पर बदला जा सकता है. (I27604) - दिखाए गए मेन्यू आइटम के वर्टिकल स्क्रोल की स्थिति को कंट्रोल करने के लिए,
DropdownMenuयाExposedDropdownMenuबनाते समयScrollStateको पास करने का विकल्प जोड़ा गया. (Ia0734, b/185304441) Sliderके लिए एक ओवरलोड जोड़ा गया है, जो कॉम्पोनेंट का स्टेटफ़ुल वर्शन है. एकSliderStateबनाया गया है. इसमें मौजूदा ऐक्टिव ट्रैक की पूरी जानकारी,Sliderके कॉम्पोनेंट के मेज़रमेंट, और ड्रैग और जेस्चर लॉजिक शामिल है. (I124a5)- सिमैंटिक्स प्रॉपर्टी
isContainerका नाम बदलकरisTraversalGroupकिया जा रहा है (I121f6) - पूरी पैरामीटर सूची के साथ ऑप्टिमाइज़ किया गया
TextStyle.merge(...)जोड़ा गया. (Iad234, b/246961787) TooltipState,RichTooltipState, औरPlainTooltipStateको सार्वजनिक इंटरफ़ेस बनाया गया. डिफ़ॉल्ट स्टेटस के लिएRichTooltipStateImplऔरPlainTooltipStateImplको जोड़ा गया. इन लागू की गई स्थितियों को पाने के लिए,remember*Stateफ़ंक्शन जोड़े गए.TooltipDefault.GlobalMutatorMutexके पक्ष मेंTooltipSyncको हटाया गया. (I7813d)DatePickerColorsको अपडेट किया गया है, ताकि तारीख चुनने वाले टूल के डिवाइडर, नेविगेशन, और टेक्स्ट इनपुट फ़ील्ड के रंगों को पसंद के मुताबिक बनाने के ज़्यादा विकल्प शामिल किए जा सकें. (I1a685, b/274626815)DatePickerStateऔरDateRangePickerStateअब सार्वजनिक इंटरफ़ेस हैं. इनमें डिफ़ॉल्ट तौर पर लागू होने वाले तरीके शामिल हैं. इन्हेंrememberDatePickerStateऔरrememberDateRangePickerStateसे वापस पाया जा सकता है. (I71c52)dateValidatorकोDatePickerऔरDateRangePickerसे हटा दिया गया है. साथ ही,SelectableDatesइंटरफ़ेस लॉन्च किया गया है. इसे स्टेट पर सेट किया जा सकता है, ताकि यह कंट्रोल किया जा सके कि यूज़र इंटरफ़ेस (यूआई) में कौनसी तारीखें या साल चुने जा सकते हैं. (Ic2fc6)TimePickerको स्टेबल एपीआई से हटा दिया गया है. स्टेट एपीआई (I3f39a) में और बदलाव होने की उम्मीद हैModalBottomSheetको सिर्फ़ Android पर ले जाया गया. डेस्कटॉप परModalBottomSheetका इस्तेमाल करने का सुझाव नहीं दिया जाता. साथ ही, इस सुविधा को सक्रिय रूप से मैनेज नहीं किया जाता. (Ib3778)
गड़बड़ियां ठीक की गईं
- डायलॉग की चौड़ाई में फ़िट होने के लिए, कार्रवाइयों को एक-दूसरे के ऊपर स्टैक करने पर, पुष्टि करने की कार्रवाई के नीचे
AlertDialogखारिज करने की कार्रवाई दिखने की समस्या ठीक की गई. इस फ़िक्स से, मटीरियल डिज़ाइन स्पेसिफ़िकेशन के मुताबिक लागू करने में मदद मिलती है. (I029de, b/235454277) ListItemमें मौजूद उस बग को ठीक किया गया है जिसमें तीन लाइन आइटम के लिए गलत पैडिंग का इस्तेमाल किया गया था. (I6e235)ModalBottomSheetअब IME कीबोर्ड दिखा सकता है (Idc508, b/262140644, b/268380384, b/272483584)
वर्शन 1.2.0-alpha01
10 मई, 2023
androidx.compose.material3:material3:1.2.0-alpha01 और androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 रिलीज़ हो गए हैं. वर्शन 1.2.0-alpha01 में ये बदलाव शामिल हैं.
वर्शन 1.1
वर्शन 1.1.2
20 सितंबर, 2023
androidx.compose.material3:material3:1.1.2 और androidx.compose.material3:material3-window-size-class:1.1.2 रिलीज़ हो गए हैं. वर्शन 1.1.2 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- मॉडिफ़ायर को दो कंपोज़ेबल में गलत तरीके से पास किए जाने की समस्या ठीक की गई. (b/282761472)
- Fixed
TimePickerStateफ़ंक्शन को 23 घंटे के साथ शुरू करने पर, गलत घंटे दिखाता है. (b/278242122) - दोपहर और मिनट की पुष्टि के लिए, टॉगल की शुरुआती स्थिति को ठीक किया गया. (b/269768197, b/282790635)
- रात 11 बजे के लिए,
state.hourकी गलत वैल्यू दिखाने की समस्या ठीक की गई. (b/282761472, b/278242122)
वर्शन 1.1.1
21 जून, 2023
androidx.compose.material3:material3:1.1.1 और androidx.compose.material3:material3-window-size-class:1.1.1 रिलीज़ हो गए हैं. वर्शन 1.1.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- बाइनरी कंपैटिबिलिटी के लिए,
windowInsetपैरामीटर के बिनाModalBottomSheetके लिए कॉल जोड़ता है. (Ib7959) ModalBottomSheetमें विंडो इंसर्ट पैरामीटर जोड़ें.- अब
ModalBottomSheetके लिए स्क्रिम को स्टेटस बार के पीछे बनाया जा सकता है. इसके लिए,windowInsetsको शून्य पर सेट करना होगा - सिस्टम बार (जैसे, नेविगेशन बार) से बाहर रहने के लिए,
ModalBottomSheetकी डिफ़ॉल्ट सेटिंग को अपडेट किया गया - एज-टू-एज मोड में, स्टेटस बार के इंसर्ट को ड्रैग हैंडल से मैनेज किया जाता है.
BottomSheetDefaultsमेंBottomSheetWindowके लिए विंडो इनसेट शामिल हैं. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- अब
वर्शन 1.1.0
10 मई, 2023
androidx.compose.material3:material3:1.1.0 और androidx.compose.material3:material3-window-size-class:1.1.0 रिलीज़ हो गए हैं. वर्शन 1.1.0 में ये बदलाव शामिल हैं.
1.1.0 वर्शन की मुख्य सुविधाएं
Material Design 3 के नए कॉम्पोनेंट
मौजूदा मटीरियल डिज़ाइन 3 कॉम्पोनेंट को बेहतर बनाया गया है.
एक्सपेरिमेंटल एपीआई को स्टेबल वर्शन में प्रमोट किया गया!
ज़्यादा जानकारी के लिए, कृपया यह ब्लॉग पोस्ट देखें!
वर्शन 1.1.0-rc01
19 अप्रैल, 2023
androidx.compose.material3:material3:1.1.0-rc01 और androidx.compose.material3:material3-window-size-class:1.1.0-rc01 रिलीज़ हो गए हैं. वर्शन 1.1.0-rc01 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
TimePickerको स्टेबल एपीआई से हटा दिया गया है. स्टेट एपीआई (I3f39a) में और बदलाव होने की उम्मीद हैModalBottomSheetको सिर्फ़ Android पर ले जाया गया. डेस्कटॉप परModalBottomSheetका इस्तेमाल करने का सुझाव नहीं दिया जाता. साथ ही, इस सुविधा को सक्रिय रूप से मैनेज नहीं किया जाता. (Ib3778)
वर्शन 1.1.0-beta02
5 अप्रैल, 2023
androidx.compose.material3:material3:1.1.0-beta02 और androidx.compose.material3:material3-window-size-class:1.1.0-beta02 रिलीज़ हो गए हैं. वर्शन 1.1.0-beta02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
SheetStateमें अबskipHiddenStateपैरामीटर को वैकल्पिक बना दिया गया हैrememberStandardBottomSheetStateमें अबskipHiddenStateपैरामीटर को वैकल्पिक बना दिया गया हैBottomSheetScaffoldमें अब एक तय किया गया छिपा हुआ ऐंकर है. हालांकि, यह डिफ़ॉल्ट रूप से बंद होता हैSheetState.requireOffsetदस्तावेज़ अपडेट किया गया हैBottomSheetDefaults.MinimizedShapeका नाम बदलकरBottomSheetDefaults.HiddenShapeकर दिया गया है (I839f4, b/273870234)
गड़बड़ियां ठीक की गईं
- छूकर एक्सप्लोर करने की सुविधा चालू होने पर, डायल फ़ेस को घंटे से मिनट पर स्विच न करें. (I717d0)
ModalBottomSheetऔरBottomSheetScaffoldके ड्रैग हैंडल सिमैंटिक अब मर्ज हो गए हैं. (I05afb)BottomSheetScaffoldमॉडिफ़ायर,containerColor, औरcontentColorपैरामीटर अब सिर्फ़ कॉन्टेंट पर असर डालते हैं. (I992cb)BottomSheetScaffold nestedScrollमें अब शीट के कॉन्टेंट के लिए फ़्लिंग की सुविधा लागू की गई है. (I992cb)
वर्शन 1.1.0-beta01
22 मार्च, 2023
androidx.compose.material3:material3:1.1.0-beta01 और androidx.compose.material3:material3-window-size-class:1.1.0-beta01 रिलीज़ हो गए हैं. वर्शन 1.1.0-beta01 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
TimePickerकंपोज़ेबल में लेआउट टाइप पैरामीटर जोड़ें. इससे स्क्रीन कॉन्फ़िगरेशन (Ia0e16) के आधार पर अलग-अलग लेआउट इस्तेमाल किए जा सकते हैंSearchBarDefaultsको एक्सपेरिमेंट के तौर पर मार्क किया गया है. (I65561)BottomSheetScaffold(I94e0f) में शैडो एलिवेशन जोड़ा गया- हेडर वाले हिस्से के बिना तारीख चुनने वाले टूल दिखाने की सुविधा जोड़ी गई. तारीख चुनने वाला टूल बनाते समय, शून्य हेडलाइन पास करने की अनुमति देने के लिए एपीआई में बदलाव किए गए हैं. अब हेडलेस पिकर दिखाने के लिए, हेडलाइन, टाइटल, और
showToggleMode = falseको शून्य के तौर पर पास किया जा सकता है. (Id3f3a, b/266132421, b/267194809)
गड़बड़ियां ठीक की गईं
- अब सर्च बार के इनऐक्टिव होने पर, फ़ोकस अपने-आप हट जाता है. (I22a7c, b/261444487)
DateRangePickerको अपडेट किया गया है, ताकि शुरू और खत्म होने की तारीख के लिए एक ही तारीख की सीमा चुनी जा सके. (I16529, b/272882497)- टेक्स्ट फ़ील्ड अब टेक्स्ट एलिमेंट को सही तरीके से पोज़िशन करते हैं, जब फ़ॉन्ट का साइज़ उम्मीद से कम होता है. फ़ॉन्ट की सेटिंग और स्क्रिप्ट के आधार पर, आपके ऐप्लिकेशन में कुछ पिक्सल का बदलाव हो सकता है. (I8b8d0)
- बॉटम शीट में मौजूद सिमैंटिक कार्रवाइयों में अब लेबल मौजूद हैं. (I277b0)
वर्शन 1.1.0-alpha08
8 मार्च, 2023
androidx.compose.material3:material3:1.1.0-alpha08 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha08 में ये बदलाव शामिल हैं.
नई सुविधाएं
BottomSheetScaffoldऔरBottomSheetScaffoldStateके लिए सहायता जोड़ी गई. (I063d4)
एपीआई में हुए बदलाव
DatePickerStateऔरDateRangePickerStateमें यह सुविधा जोड़ी गई है. इससे, स्थिति बनने के बाद तारीखें सेट की जा सकती हैं. साथ ही, नल टाइमस्टैंप सेट करके चुने गए विकल्पों को रीसेट किया जा सकता है. तारीखें मैन्युअल तरीके से सेट करते समय सावधानी बरतनी चाहिए. साथ ही, अगर दी गई तारीख, पहले से तय की गई शर्त को पूरा नहीं करती है, तो नयाsetSelectionफ़ंक्शन एक अपवाद दिखाएगा. इसके बारे में जानने के लिए, दस्तावेज़ देखें. (Ifa645, b/268609314, b/270427389)- इस स्थिति में व्यवहार को ज़्यादा सटीक और आसानी से दिखाने के लिए, Collapsed
SheetValueका नाम बदलकरPartiallyExpandedकर दिया गया है. (Ia1491) ListItemपैरामीटर के नामों को _text के बजाय _content के तौर पर अपडेट किया गया. डिफ़ॉल्ट गेटर अबReadOnlyComposablesहैं. (I69a25)- इंटरैक्टिव Surface API को एक्सपेरिमेंटल से ग्रेजुएट करें. (I90d59, b/261561812)
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक कर दिया गया है जिसकी वजह से
ModalBottomSheetकेHalfExpandedकी स्थिति का हिसाब गलत तरीके से लगाया जाता था. साथ ही, शीट फ़्लोटिंग के तौर पर दिखती थी. (I45e84, b/268411386) ModalBottomSheetके लिए, स्क्रिम टैप मेंconfirmValueChangeचेक जोड़ा गया. (I2311a, b/270425759)- सिमैंटिक
BottomSheetकार्रवाइयों को ड्रैग हैंडल पर ले जाएं. (I158ba) ModalBottomSheetअब लॉन्च पर फ़ोकस करता है और 'वापस जाएं' बटन को हैंडल करता है. (I4d2ab)ModalBottomSheet onDismissRequestको अब नेस्ट किए गए स्क्रोल फ़्लिंग के दौरान भी हैंडल किया जाता है. (I655c5, b/268433166)
वर्शन 1.1.0-alpha07
22 फ़रवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha07 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha07 में ये बदलाव शामिल हैं.
नई सुविधाएं
rememberTimePickerState()के साथ काम करने वाला टाइम इनपुट कंपोज़ेबल जोड़ें. यह टाइम इनपुट (Ia4fab) के लिए M3 स्पेसिफ़िकेशन का पालन करता है- तारीख की सीमा चुनने के लिए, Material 3
DateRangePickerAPI जोड़ा गया. (I7a6c3, b/267194809) DateRangePickerAPI के ज़रिए तारीख की सीमाएं चुनने के लिए, Material 3 इनपुट मोड की सुविधा जोड़ी गई है. (Ifdbc4)- टेक्स्ट फ़ील्ड के रंगों को अब पसंद के मुताबिक बनाया जा सकता है:
- फ़ोकस और गड़बड़ी की स्थिति के आधार पर, इनपुट फ़ील्ड और प्लेसहोल्डर टेक्स्ट के रंग.
textColorपैरामीटर का नाम बदलकरunfocusedTextColorकर दिया गया है. साथ ही,placeholderColorका नाम बदलकरunfocusedPlaceholderColorकर दिया गया है. errorContainerColorपैरामीटर के साथ, गड़बड़ी की स्थिति के आधार पर भरे गए टेक्स्ट फ़ील्ड के लिए कंटेनर का रंग.
- फ़ोकस और गड़बड़ी की स्थिति के आधार पर, इनपुट फ़ील्ड और प्लेसहोल्डर टेक्स्ट के रंग.
- नए प्रीफ़िक्स और सफ़िक्स एपीआई के साथ काम करने के लिए, दिखाए गए ड्रॉपडाउन मेन्यू के टेक्स्ट फ़ील्ड के रंगों को पैरामीटर के साथ अपडेट किया गया है. (I9c8b4, b/254284181, b/264766350)
एपीआई में हुए बदलाव
- Slider API के कुछ वर्शन को वापस लाया गया है. साथ ही, Slider के ऐसे फ़ंक्शन हटाए गए हैं जो नए एक्सपेरिमेंटल Slider में शामिल हैं. इस नए Slider में कस्टम थंब और ट्रैक की सुविधा है.
RangeSliderको स्टेबल वर्शन के तौर पर प्रमोट किया जा रहा है. (Ie8fbd) - चिप के एलिवेशन फ़ंक्शन में,
defaultElevationका नाम बदलकरelevationकर दिया गया है. (I0f872) - Material 3 के ये टेक्स्ट फ़ील्ड एपीआई अब एक्सपेरिमेंटल नहीं हैं:
TextField,OutlinedTextField,textFieldWithLabelPadding,textFieldWithoutLabelPadding,outlinedTextFieldPadding. (Ieb5c0, b/261561819) TimePickersis24Hourसिस्टम सेटिंग का इस्तेमाल करता है (I18856)- स्काफ़ोल्ड एपीआई से एक्सपेरिमेंटल एनोटेशन हटाया गया. (Ibb51e, b/261565765, b/261436953)
गड़बड़ियां ठीक की गईं
ModalBottomSheetका डिफ़ॉल्ट आकार अब हमेशाSheetDefaults.ExpandedShapeहोता है. (I0dfca)- Material 3
DatePickerऔरDateRangePickerके लिए, सुलभता सुविधाओं में सुधार किए गए हैं. (I5087e) - उस गड़बड़ी को ठीक किया गया है जिसमें ज़्यादा से ज़्यादा ऊंचाई की सीमा लागू की जाती है और इससे ऐप्लिकेशन क्रैश हो सकता है. (I30d8c)
- क्लिक किए जा सकने वाले और चुने जा सकने वाले सर्फ़ेस से सिमैंटिक भूमिकाएं हटा दी गई हैं. साथ ही, उन कॉम्पोनेंट को अपडेट कर दिया गया है जो मॉडिफ़ायर.सिमैंटिक्स (I793d9) का इस्तेमाल करके भूमिकाएं सेट करते थे
वर्शन 1.1.0-alpha06
8 फ़रवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha06 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha06 में ये बदलाव शामिल हैं.
नई सुविधाएं
- टेक्स्ट फ़ील्ड में अब प्रीफ़िक्स और सफ़िक्स टेक्स्ट इस्तेमाल किया जा सकता है (Ia8578, b/179884561)
- Material 3 स्पेसिफ़िकेशन के मुताबिक टाइम पिकर दिखाने के लिए,
TimePickerफ़ंक्शन जोड़ा गया है. इसका इस्तेमालTimePickerStateऔर सुविधा वाले तरीकेrememberTimePickerStateके साथ किया जाता है (I71910) DatePickerपर तारीख डालने की सुविधा, अब डिसप्ले मोड में उपलब्ध है. तारीख चुनने वाले टूल और तारीख डालने के मोड के बीच स्विच करने की सुविधा जोड़ी गई. (Ieeff7)RichTextTooltipsके लिए एपीआई जोड़ा गया. (I58ef3)- Material 3 के लिए मॉडल बॉटम शीट लागू की गई है. इसमें
ModalBottomSheetऔरModalBottomSheetDefaultsशामिल हैं. इसमेंSheetStateऔरrememberSheetStateभी शामिल हैं. इनका इस्तेमाल आने वाले समय में शीट कॉम्पोनेंट के लिए किया जा सकता है. (I0853a, b/244189383)
एपीआई में हुए बदलाव
- एपीआई को स्थिर करें
showSnackbar(I195c2, b/261424370) - सहायता और सुझाव देने वाले चिप के लिए एपीआई को स्थिर करें (Ibb67b, b/261424370)
ListItem,ListItemDefaults, औरListItemColorsएपीआई को एक्सपेरिमेंट के तौर पर उपलब्ध नहीं कराया गया है (I7e7fa, b/261438882)SliderPositions,SliderDefaults.Thumb, औरSliderDefaults.Trackको स्टेबल वर्शन में प्रमोट करना. साथ ही, एक्सपेरिमेंट के तौर पर उपलब्ध नहीं कराए गएSliderऔरRangeSliderएपीआई जोड़ना. इनमें कस्टम थंब और ट्रैक शामिल हैं. साथ ही, हम पिछलेSliderऔरRangeSliderएपीआई को भी बंद कर रहे हैं. (Ie5ea6, b/261566890)Modifier.tooltipAnchor()को सार्वजनिक किया गया है, ताकि डेवलपर इसे ऐंकर को पास कर सकें. इससे यह पता चलता है कि दबाकर रखने पर टूलटिप दिखनी चाहिए.PlainTooltipBoxएपीआई को अपडेट किया गया है, ताकिTooltipStateको अब शून्य नहीं किया जा सके. साथ ही, अब इसमें डिफ़ॉल्ट वैल्यू है. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColorको एक जैसा बनाए रखने के लिए,@Composableके तौर पर मार्क किया गया है. (Id29cc)- वापस लाई गई प्रॉपर्टी गेटर
LocalMinimuTouchTargetEnforcementको काम न करने वाली सुविधा के तौर पर मार्क करें और इसेLocalMinimumInteractiveComponentEnforcementपर रीडायरेक्ट करें. (I60dd5)
वर्शन 1.1.0-alpha05
26 जनवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha05 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha05 में ये बदलाव शामिल हैं.
नई सुविधाएं
DatePickerDialogऔर सुलभता से जुड़ी सहायताRangeSliderमें कस्टम थंबनेल और ट्रैक जोड़ा गया.
डिपेंडेंसी से जुड़े अपडेट
Compose UIऔरCompose Materialअब Lifecycle 2.6.0 पर निर्भर हैं.
वर्शन 1.1.0-alpha04
11 जनवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha04 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha04 में ये बदलाव शामिल हैं.
नई सुविधाएं
- कैलेंडर यूज़र इंटरफ़ेस (यूआई) के ज़रिए कोई तारीख चुनने के लिए, शुरुआती
DatePickerAPI. इस एपीआई में अब भी बदलाव किए जा रहे हैं. (I722b9) PlainTooltipBoxके ज़रिए, सामान्य टूलटिप के लिए सहायता जोड़ी गई. (I0cdfb)- खोज बार (Iad128)
SwipeToDismiss(I458a8, b/242889540)
एपीआई में हुए बदलाव
- इसे Surfaces पर
IsContainerसिमैंटिक्स प्रॉपर्टी में जोड़ा गया है. इस प्रॉपर्टी का इस्तेमाल बाद में किए जाने वाले बदलाव में किया जाएगा. इससे, एलिमेंट के सिमैंटिक मतलब के आधार पर ट्रैवर्सल का क्रम तय किया जा सकेगा. जैसे, सर्फ़ेस. (I63379) - नेविगेशन पैनल से जुड़े एपीआई को स्टेबल के तौर पर मार्क करें. (Iab01e, b/261439597)
- सर्कुलर प्रोग्रेस इंडिकेटर के लिए, ट्रैक कलर पैरामीटर जोड़ा गया. साथ ही, सर्कुलर और लीनियर प्रोग्रेस इंडिकेटर, दोनों के लिए स्ट्रोक कैप पैरामीटर जोड़ा गया. (Ie668c, b/216325962, b/222964817)
- बंद किए गए-छिपाए गए फ़ंक्शन के ज़्यादातर रिटर्न टाइप में null वैल्यू हो सकती है (Ibf7b0)
Modifier.minimumInteractiveComponentSizeजोड़ें. अगर एलिमेंट का साइज़ छोटा है, तो टच इंटरैक्शन को अलग-अलग करने के लिए, कम से कम 48dp का साइज़ रिज़र्व किया जा सकता है. (I33f58, b/258495559)- कॉन्टेंट स्लॉट वाले
AlertDialogकंपोज़ेबल के लिए, एक्सपेरिमेंटल एपीआई जोड़ा गया. (Iec4a2)
गड़बड़ियां ठीक की गईं
- प्रोग्रेस इंडिकेटर की प्रोग्रेस को अब उसकी अनुमानित सीमा के हिसाब से सही तरीके से तय किया जाता है. (I8a7eb, b/262262727)
आम समस्या
androidx.compose.foundation:1.4.0-alpha03सेandroidx.compose.foundation:1.4.0-alpha04पर अपडेट करते समय, आपकोjava.lang.NoSuchFieldErrorगड़बड़ी दिख सकती है. समस्या की शिकायत यहां की गई थी. समस्या को ठीक करने के लिए, एक समाधान सबमिट किया गया है. यह Compose के अगले अपडेट में उपलब्ध होगा. इस समस्या को हल करने के लिए,androidx.compose.materialऔरandroidx.compose.material3लाइब्रेरी को नए वर्शन(1.1.0-alpha04) पर अपडेट करें याandroidx.compose.foundationको 1.4.0-alpha03 पर डाउनग्रेड करें.
वर्शन 1.1.0-alpha03
7 दिसंबर, 2022
androidx.compose.material3:material3:1.1.0-alpha03 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha03 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
consumedWindowInsets()का नाम बदलकरconsumeWindowInsets()औरwithConsumedWindowInsets()का नाम बदलकरonConsumedWindowInsetsChanged()कर दिया गया है. साथ ही, मॉडिफ़ायर को सार्वजनिक कर दिया गया है. (Ie44e1)- आइकॉन के साथ टेक्स्ट बटन के लिए, इस्तेमाल करने के लिए नया डिफ़ॉल्ट कॉन्टेंट पैडिंग जोड़ें. (I8f662)
- नेविगेशन बार और रेल के लिए, बंद किए गए रंगों को जोड़ा गया. (Ia7892, b/258867034)
- स्क्रोल करने की जानकारी के लिए, Modifier API जोड़ा गया. (I2ba9d, b/203141462)
- इस कुकी का इस्तेमाल
Clickableमें किया जाता है. इससे प्रेस इंटरैक्शन को सही तरीके से डिले किया जा सकता है. ऐसा तब किया जाता है, जब जेस्चर स्क्रोल इवेंट बन सकते हैं. Clickablesके अंदर इस्तेमाल किए जाने पर,Clickablesके रिपल इफ़ेक्ट को सही तरीके से डिले न करने की समस्या को ठीक किया गया.Scrollable ViewGroup- ड्रॉअर और शीट को अपडेट किया गया है, ताकि अगर जेस्चर स्क्रोल इवेंट बन सकते हैं, तो प्रेस में सही तरीके से देरी हो.
डिपेंडेंसी से जुड़े अपडेट
Compose UIऔरCompose Materialअब Lifecycle 2.5.1 पर निर्भर हैं. (I05ab0, b/258038814)
वर्शन 1.1.0-alpha02
9 नवंबर, 2022
androidx.compose.material3:material3:1.1.0-alpha02 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
awaitFirstDownऔरwaitForUpOrCancellationअब ज़्यादा फ़्लेक्सिबिलिटी के लिएPointerEventPassस्वीकार करते हैं. इससेExposedDropdownMenuBoxमें स्क्रोल करते समय मेन्यू दिखने की समस्या भी ठीक हो जाती है.(I7579a, b/212091796)- मटीरियल और मटीरियल3 टेक्स्ट,
TextField, औरOutlinedTextFieldमेंminLinesपैरामीटर जोड़ा गया है. इससे लाइनों की संख्या (I4af1d) के हिसाब से कॉम्पोनेंट की कम से कम ऊंचाई सेट की जा सकती है TopAppBarDefaults smallTopAppBarColorsफ़ंक्शन को बंद कर दिया गया है. इसके बजाय, नएtopAppBarColorsफ़ंक्शन का इस्तेमाल करें. इसका इस्तेमालTopAppBarबनाते समय किया जाना चाहिए. (Ie6cb9)BasicTextऔरBasicTextFieldमेंminLinesपैरामीटर जोड़ा गया. इससे, लाइनों की संख्या (I24294, b/122476634) के हिसाब से, इन कंपोज़ेबल की कम से कम ऊंचाई सेट की जा सकती है
गड़बड़ियां ठीक की गईं
- Material3
IconButtonऔरIconToggleBottonके कॉन्टेंट को कॉम्पोनेंट की स्टेट-लेयर के आकार (जैसे, गोलाकार) में काटें. (I9da8f) - यह Material3 के मीडियम और लार्ज टॉप ऐप्लिकेशन बार को अपडेट करता है, ताकि उनके पूरे सर्फ़ेस पर एक ही बैकग्राउंड का रंग लागू किया जा सके. साथ ही, यह डिफ़ॉल्ट रंगों को पारदर्शी रंग की वैल्यू के साथ बदलने की अनुमति देता है. (I67659, b/249688556, b/250838918)
वर्शन 1.1.0-alpha01
24 अक्टूबर, 2022
androidx.compose.material3:material3:1.1.0-alpha01 और androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 रिलीज़ हो गए हैं. वर्शन 1.1.0-alpha01 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- टाइटल पर TextStyle और Brush लागू होने पर, टॉप ऐप्लिकेशन बार से जुड़ी समस्याओं को ठीक किया गया है. (If667e)
वर्शन 1.0
वर्शन 1.0.1
9 नवंबर, 2022
androidx.compose.material3:material3:1.0.1 और androidx.compose.material3:material3-window-size-class:1.0.1 रिलीज़ हो गए हैं. वर्शन 1.0.1 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- यह Material3 के मीडियम और लार्ज टॉप ऐप्लिकेशन बार को अपडेट करता है, ताकि उनके पूरे सर्फ़ेस पर एक ही बैकग्राउंड का रंग लागू किया जा सके. साथ ही, यह डिफ़ॉल्ट रंगों को पारदर्शी रंग की वैल्यू के साथ बदलने की अनुमति देता है. (I67659, b/249688556, b/250838918)
वर्शन 1.0.0
24 अक्टूबर, 2022
androidx.compose.material3:material3:1.0.0 और androidx.compose.material3:material3-window-size-class:1.0.0 रिलीज़ हो गए हैं. वर्शन 1.0.0 में ये बदलाव शामिल हैं.
1.0.0 वर्शन की मुख्य सुविधाएं
यह Compose Material 3 का पहला स्टेबल वर्शन है!
Material Design 3 की थीम और Material You का डाइनैमिक कलर
Material Design 3 कॉम्पोनेंट
- बैज
- बॉटम ऐप्लिकेशन बार
- बटन
- एफ़एबी और एक्सटेंडेड एफ़एबी
- कार्ड
- चेकबॉक्स
- चिप्स
- डायलॉग
- डिवाइडर
- ड्रॉपडाउन मेन्यू
- सूची
- नेविगेशन बार
- नेविगेशन पैनल
- नेविगेशन रेल
- प्रोग्रेस दिखाने वाला इंडिकेटर
- रेडियो बटन
- स्लाइडर
- बदलें
- टैब
- टेक्स्ट फ़ील्ड
- टॉप ऐप्लिकेशन बार
- आइकॉन
- टेक्स्ट
- सरफ़ेस
- लेआउट
- कॉन्टेंट का रंग
विंडो साइज़ क्लास
material3-window-size-classएक नई लाइब्रेरी है. यह विंडो साइज़ क्लास के लिए सहायता उपलब्ध कराती है. यह लाइब्रेरी, व्यूपोर्ट ब्रेकपॉइंट का एक सेट है. इसकी मदद से, ऐप्लिकेशन के लेआउट को डिज़ाइन, डेवलप, और टेस्ट किया जा सकता है.calculateWindowSizeClassका इस्तेमाल करके, विंडो के साइज़ के क्लास इंस्टेंस को वापस पाया जा सकता है. इसका इस्तेमाल करके, यह तय किया जा सकता है कि आपका यूज़र इंटरफ़ेस (यूआई) कैसा दिखना चाहिए. जैसे, बड़ी विंडो के साइज़ के लिए बॉटम नेविगेशन के बजाय नेविगेशन रेल दिखाना. ज़्यादा जानकारी और इस्तेमाल का सैंपल देखने के लिए,WindowSizeClassके लिए एपीआई का रेफ़रंस दस्तावेज़ देखें.ज़्यादा जानकारी के लिए, कृपया यह ब्लॉग पोस्ट देखें!
वर्शन 1.0.0-rc01
5 अक्टूबर, 2022
androidx.compose.material3:material3:1.0.0-rc01 और androidx.compose.material3:material3-window-size-class:1.0.0-rc01 रिलीज़ हो गए हैं. वर्शन 1.0.0-rc01 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- टेक्स्ट फ़ील्ड एपीआई (Iaac0d, b/227146125) में टेक्स्ट जोड़ने के लिए, स्लॉट पैरामीटर जोड़ा गया
वर्शन 1.0.0-beta03
21 सितंबर, 2022
androidx.compose.material3:material3:1.0.0-beta03 और androidx.compose.material3:material3-window-size-class:1.0.0-beta03 रिलीज़ हो गए हैं. वर्शन 1.0.0-beta03 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
ExposedDropdownMenuDefaultsअब मेन्यू आइटम के लिए पैडिंग वैल्यू दिखाता है. (I34ee1)ExposedDropdownMenuBoxScopeमें अबModifier.menuAnchor()मॉडिफ़ायर है. इसे टेक्स्ट फ़ील्ड में पास किया जाना चाहिए, ताकि a11y की सुविधा सही तरीके से काम कर सके. (I27fa3)- मौजूदा Slider API के लिए दो ओवरलोड किए गए तरीके जोड़े गए हैं, ताकि उपयोगकर्ता स्लाइडर को पॉप्युलेट करने के लिए थंब या ट्रैक पास कर सकें. (I21c00)
गड़बड़ियां ठीक की गईं
- गहरे रंग वाली थीम के लिए, 'गड़बड़ी होने पर दिखने वाला कंटेनर' के रंग को टोन 90 (Ic5612) पर मैप किया गया
- इस फ़िक्स की मदद से, छोटे Material 3 टॉप ऐप्लिकेशन बार के लिए पारदर्शी बैकग्राउंड सेट किया जा सकता है. (I645e2, b/245575782)
वर्शन 1.0.0-beta02
7 सितंबर, 2022
androidx.compose.material3:material3:1.0.0-beta02 और androidx.compose.material3:material3-window-size-class:1.0.0-beta02 रिलीज़ हो गए हैं. वर्शन 1.0.0-beta02 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- m3 कॉम्पोनेंट के beta01 वर्शन में, डिफ़ॉल्ट कॉम्पोनेंट इनसेट में IME इनसेट को शामिल नहीं किया गया है.
- Material3 Scaffold कॉम्पोनेंट में अब
contentWindowInsetsपैरामीटर है. इससे, कॉन्टेंट स्लॉट के लिए इनसेट की संख्या तय की जा सकती है. (Icf11a, b/243713323) - यह एक्सपेरिमेंट के तौर पर उपलब्ध Material 3
SmallTopAppBarफ़ंक्शन को बंद कर देता है और इसके बदले में एक जैसाTopAppBarफ़ंक्शन उपलब्ध कराता है. कृपया अपने इस्तेमाल को नए वर्शन पर माइग्रेट करें. (I74404, b/226918634) - इससे टॉप ऐप्लिकेशन बार को फ़्लिंग और स्नैप करने के तरीके को कंट्रोल किया जा सकता है. (I15c81)
- यह फ़ंक्शन, Divider से startIndent को हटाता है और रंग को आखिरी पैरामीटर पर ले जाता है. (If7be2)
गड़बड़ियां ठीक की गईं
- डायलॉग बॉक्स को TalkBack का इस्तेमाल करने वाले लोगों के लिए, अपनी पहचान बतानी चाहिए. इसके लिए, जब डायलॉग बॉक्स दिखे, तब 'डायलॉग' शब्द का एलान करें. (I857ef)
वर्शन 1.0.0-beta01
24 अगस्त, 2022
androidx.compose.material3:material3:1.0.0-beta01 और androidx.compose.material3:material3-window-size-class:1.0.0-beta01 रिलीज़ हो गए हैं. वर्शन 1.0.0-beta01 में ये बदलाव शामिल हैं.
एपीआई का रेफ़रंस
नई थीम, कॉम्पोनेंट, और अन्य कंपोज़ेबल देखने के लिए, Compose Material 3 API के बारे में खास जानकारी देखें.
एपीआई में हुए बदलाव
- Material 3 के टॉप ऐप्लिकेशन बार को अपडेट किया गया है, ताकि वह पूरी तरह से छोटा होने से लेकर पूरी तरह से बड़ा होने की स्थिति में स्नैप हो सके. इसके अलावा,
TopAppBarDefaultsके व्यवहार से जुड़े फ़ंक्शन को कंपोज़ेबल बनाया गया है. साथ ही, उनके टॉप ऐप्लिकेशन बार की स्थिति और ऐनिमेशन स्पेसिफ़िकेशन के लिए डिफ़ॉल्ट वैल्यू दी गई हैं. (I642b3) - FAB कॉम्पोनेंट के सिग्नेचर अपडेट किए गए, ताकि वे Surface API (I3afaa) से मेल खा सकें
- टॉप ऐप्लिकेशन बार, ड्रॉअर, नेविगेशन बार, और रेल के लिए, बिल्ट-इन इनसेट की सुविधा जोड़ी गई है. इन कॉम्पोनेंट का इस्तेमाल अलग-अलग या Scaffold के साथ करने पर, डेवलपर के लिए इनसेट अपने-आप मैनेज हो जाएंगे. ध्यान दें: इस बदलाव से, स्टेटस बार के आइकॉन और स्टेटस और नेविगेशन बार की पारदर्शिता को अपने-आप मैनेज करने की सुविधा नहीं मिलती. कृपया इसे मैन्युअल तरीके से जारी रखें, ताकि आपको एज-टू-एज का बेहतरीन अनुभव मिल सके. (I7e4e6, b/183161866)
- अपडेट किए गए कॉम्पोनेंट में डिफ़ॉल्ट सेटिंग को बदला गया है. इससे आने वाले समय में, एपीआई को ज़्यादा आसानी से इस्तेमाल किया जा सकेगा और इसकी परफ़ॉर्मेंस भी बेहतर होगी. (I31820)
- एपीआई में एक जैसा अनुभव बनाए रखने के लिए, चिप और नेविगेशन ड्रॉअर शीट के पैरामीटर का क्रम बदला गया (I45d0b)
- डिवाइडर से
startIndentको हटा दिया गया है और रंग को आखिरी पैरामीटर के तौर पर जोड़ दिया गया है.(If7be2)
वर्शन 1.0.0-alpha16
10 अगस्त, 2022
androidx.compose.material3:material3:1.0.0-alpha16 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha16 में ये बदलाव शामिल हैं.
नई सुविधाएं
- नेविगेशन पैनल की चौड़ाई को पसंद के मुताबिक सेट करने की सुविधा. (Ia7f10)
एपीआई में हुए बदलाव
- एपीआई (Ie2637) में एक जैसा डेटा बनाए रखने के लिए, टैब और लीडिंग आइकॉन टैब के पैरामीटर का क्रम बदलें
BadgeDefaultsको एक्सपेरिमेंट के तौर पर मार्क किया गया. (I98ef3)- नेविगेशन पैनल के पुराने फ़ंक्शन को हटाया गया. (I4f2db)
- एपीआई में एक जैसा अनुभव बनाए रखने के लिए, Material 3 में स्लाइडर पैरामीटर का क्रम बदलें (I0aee7)
- एपीआई (I51cda) में एक जैसा डेटा बनाए रखने के लिए,
NavigationBarऔरNavigationRailपैरामीटर का क्रम बदलें - एपीआई में एक जैसा अनुभव बनाए रखने के लिए, Material 3 में पैरामीटर का क्रम बदलें. (If4ae1)
- एपीआई में एक जैसा अनुभव बनाए रखने के लिए, Material 3 में स्लाइडर पैरामीटर का क्रम बदलें (I62673)
- टॉप ऐप्लिकेशन बार (Id75be) के साथ एक जैसा रखने के लिए, आइकॉन पैरामीटर का नाम बदलकर कार्रवाइयां कर दिया गया है
BadgeऔरBadgedBoxको एक्सपेरिमेंटल के तौर पर मार्क करें, क्योंकि ऐंकर अलाइनमेंट में अब भी बदलाव हो रहे हैं. (I1712e, b/236524516)- आइकॉन बटन के वैरिएंट पर मौजूद
@ExperimentalMaterial3Apiएनोटेशन को@OptIn(I070b5) में बदलें - नेविगेशन ड्रॉअर के कॉन्टेंट को उसके कंपोज़ेबल से अलग किया गया है, ताकि उस पर कस्टम चौड़ाई तय की जा सके. (Ia7f10)
DividerकोMenuDefaultsऔरTabDefaultsसे हटाता है (I4e33c)
वर्शन 1.0.0-alpha15
27 जुलाई, 2022
androidx.compose.material3:material3:1.0.0-alpha15 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha15 में ये बदलाव शामिल हैं.
नई सुविधाएं
- इस विकल्प को चुनने पर, ऐप्लिकेशन बार को बार से ही खींचकर ले जाया जा सकता है. (I65c00, b/205873416)
एपीआई में हुए बदलाव
FilterChipऔरElevatedFilterChipएपीआई में अपडेट किए गए हैं, ताकिselectedIconस्लॉट को हटाया जा सके. साथ ही, चुने गए राज्य को दिखाने के लिएleadingIconको फिर से इस्तेमाल करने को बढ़ावा दिया जा सके. (Ie5dc2)- स्क्रिम और आउटलाइन वैरिएंट के कलर रोल जोड़ें. (Id6d54)
- कंपोज़ेबल डिफ़ॉल्ट के लिए नाम रखने के नियमों को ठीक करें. (I62b27)
ListItemDefaultsऔरListItemColorsको एक्सपेरिमेंट के तौर पर मार्क करें. (I1f3ec)- टॉप ऐप्लिकेशन बार एपीआई में बदलाव किए गए हैं, ताकि इसकी स्थिति की प्रॉपर्टी का मतलब बेहतर तरीके से पता चल सके. साथ ही, टॉप ऐप्लिकेशन बार एपीआई को एक्सपेरिमेंट के तौर पर मार्क करें. (Ic0ad8)
- टेक्स्ट चुनने के लिए इस्तेमाल किए जाने वाले रंगों को अब
TextFieldColorsमें जोड़ दिया गया है, ताकि लोग इन्हें आसानी से ढूंढ सकें. (Iba1b8) - आइकॉन वाले बटन के साथ इस्तेमाल करने के लिए,
ButtonDefault.ButtonWithIconContentPaddingजोड़ा गया. (I2bf9c) - टेक्स्ट फ़ील्ड को एक्सपेरिमेंटल के तौर पर मार्क किया गया है, ताकि आने वाले समय में एपीआई में होने वाले बदलावों को आसानी से लागू किया जा सके. (I127b5)
Checkboxफ़ंक्शन से@ExperimentalMaterial3Apiएनोटेशन हटा दिया गया है. (I5eefc)RadioButtonफ़ंक्शन से@ExperimentalMaterial3Apiएनोटेशन हटा दिया गया है. (I17e2a)- हमने नॉन-इंटरैक्टिव कार्ड से
@ExperimentalMaterial3Apiएनोटेशन हटा दिया है. (I9bd49) - यह कुकी, अलग-अलग कॉम्पोनेंट के डिफ़ॉल्ट ऑब्जेक्ट को अपडेट करती है, ताकि उनमें रंग, आकार वगैरह शामिल किए जा सकें. (I96e11)
गड़बड़ियां ठीक की गईं
- कैटलॉग ऐप्लिकेशन में लोगों को भ्रम से बचाने के लिए, इनपुट चिप के सैंपल से काम न करने वाले ट्रेलिंग आइकॉन हटा दिए गए हैं. (I9846a)
वर्शन 1.0.0-alpha14
29 जून, 2022
androidx.compose.material3:material3:1.0.0-alpha14 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha14 में ये बदलाव शामिल हैं.
नई सुविधाएं
- M3 सूची लागू करने की सुविधा जोड़ी गई. इसके इस्तेमाल का तरीका जानने के लिए, दस्तावेज़ देखें (Id7a20)
एपीआई में हुए बदलाव
RangeSlider(I3b79a) में पैरामीटर का नाम values से बदलकर value किया गया- मटीरियल डिज़ाइन स्पेसिफ़िकेशन के मुताबिक, हर आइटम के लिए चुनने की सुविधा देने के लिए,
InputChipके एपीआई में बदलाव किए गए हैं. चुने गए डिसैबल किए गए आइटम के लिए,FilterChipके रंगों में अतिरिक्त सहायता. (I55244, b/235792432) BottomAppBarडिफ़ॉल्ट FAB (Ida4c8) जोड़ेंColorScheme.surfaceColorAtElevationको जोड़ा गया (Id41af)- Compose लाइब्रेरी में इंटरफ़ेस अब jdk8 के डिफ़ॉल्ट इंटरफ़ेस के तरीकों (I5bcf1) का इस्तेमाल करके बनाए जाते हैं
WindowWidthSizeClassऔरWindowHeightSizeClassअब Comparable को लागू करते हैं, ताकि इनकी तुलना ऑपरेटर (<, <=, >=, >) और अन्य एपीआई का इस्तेमाल करके की जा सके. (I747d0)
गड़बड़ियां ठीक की गईं
- बैज के सैंपल को अपडेट करें, ताकि कॉन्टेंट के बारे में ज़्यादा जानकारी दी जा सके. (I10b9d)
- इस विकल्प को जोड़ने से, Material 3 कैटलॉग के थीम पिकर में सिस्टम के फ़ॉन्ट साइज़ का इस्तेमाल किया जा सकेगा. (I10605)
- बैज और अनिश्चित प्रोग्रेस इंडिकेटर के लिए सैंपल कोड जोड़ा गया. (I8fbe0)
वर्शन 1.0.0-alpha13
1 जून, 2022
androidx.compose.material3:material3:1.0.0-alpha13 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha13 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- कॉन्फ़िगरेशन में बदलाव होने पर, टॉप ऐप्लिकेशन बार की पोज़िशन को बनाए रखने में मदद करता है. (I10459, b/216160958)
वर्शन 1.0.0-alpha12
18 मई, 2022
androidx.compose.material3:material3:1.0.0-alpha12 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha12 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- स्लाइडर पैरंट की चौड़ाई अब 0 हो सकती है. (b/231707291)
वर्शन 1.0.0-alpha11
11 मई, 2022
androidx.compose.material3:material3:1.0.0-alpha11 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha11 में ये बदलाव शामिल हैं.
नई सुविधाएं
RangeSliderको Material 3 (I18e38) में जोड़ा गया- Material3
AssistChipऔरInputChipके साथ काम करने की सुविधा जोड़ी गई (I0d25a) - Material3
FilterChipऔरSuggestionChipके लिए सहायता जोड़ी गई (I9fdf3)
एपीआई में हुए बदलाव
TextFieldDefaults.BorderStrokeकॉम्पोज़ेबल का नाम बदलकरTextFieldDefaults.BorderBoxकर दिया गया है. यह कॉम्पोज़ेबल,OutlinedTextFieldमें बॉर्डर स्ट्रोक बनाता है. (I5f295)- m3 के विज़ुअल में बदलाव करने की सुविधा चालू/बंद करें (Iab30e)
- स्टैंडर्ड आइकॉन बटन में रंग पास करने की अनुमति दें. (Ia2445)
गड़बड़ियां ठीक की गईं
- यह पक्का करने के लिए कि इनर पैडिंग का इस्तेमाल किया गया है, material3/Scaffold में लिंट चेक जोड़ा गया (I72293, b/226951418)
वर्शन 1.0.0-alpha10
20 अप्रैल, 2022
androidx.compose.material3:material3:1.0.0-alpha10 और androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha10 में ये बदलाव शामिल हैं.
नई सुविधाएं
material3-window-size-classएक नई लाइब्रेरी है. यह विंडो साइज़ क्लास के लिए सहायता उपलब्ध कराती है. यह लाइब्रेरी, व्यूपोर्ट ब्रेकपॉइंट का एक सेट है. इसकी मदद से, ऐप्लिकेशन के लेआउट को डिज़ाइन, डेवलप, और टेस्ट किया जा सकता है.calculateWindowSizeClassका इस्तेमाल करके, विंडो के साइज़ के क्लास इंस्टेंस को वापस पाया जा सकता है. इसका इस्तेमाल करके, यह तय किया जा सकता है कि आपका यूज़र इंटरफ़ेस (यूआई) कैसा दिखना चाहिए. जैसे, बड़ी विंडो के साइज़ के लिए बॉटम नेविगेशन के बजाय नेविगेशन रेल दिखाना. ज़्यादा जानकारी और इस्तेमाल का सैंपल देखने के लिए,WindowSizeClassके लिए एपीआई का रेफ़रंस दस्तावेज़ देखें. विंडो के साइज़ क्लास की परिभाषाओं के बारे में ज़्यादा जानने के लिए, अलग-अलग स्क्रीन साइज़ के लिए सहायता से जुड़े सार्वजनिक दिशा-निर्देश देखें.
एपीआई में हुए बदलाव
- इससे
BottomAppBarके लिए डिफ़ॉल्ट एफ़एबी एलिवेशन जुड़ जाता है. साथ ही, एफ़एबी के साथBottomAppBarसे ट्रेलिंग लैम्ब्डा हट जाता है. (I92c47) - Material3
FilledIconButton,FilledTonalIconButton, औरOutlinedIconButtonजोड़ता है. (Ib2bda) - Material 3 Snackbar API को अपडेट किया गया है, ताकि वह वैकल्पिक कार्रवाई और खारिज करने की कार्रवाई के लिए रंग की वैल्यू स्वीकार कर सके. (Ibe4b4)
PointerInputChangeमें, आंशिक खपत (नीचे या स्थिति) को बंद कर दिया गया है. बदलाव को पूरी तरह से लागू करने के लिए,consume()का इस्तेमाल किया जा सकता है.isConsumedका इस्तेमाल करके यह पता लगाया जा सकता है कि किसी और ने पहले बदलाव का इस्तेमाल किया है या नहीं.PointerInputChange::copy()अब हमेशा शैलो कॉपी बनाता है. इसका मतलब है किPointerInputChangeकी कॉपी का इस्तेमाल एक बार होने के बाद, बाकी कॉपी का इस्तेमाल नहीं किया जा सकेगा. अगर आपको अनबाउंडPointerInputChangeबनाना है, तो कंस्ट्रक्टर का इस्तेमाल करें. (Ie6be4, b/225669674)- Cards API में बदलाव किए गए हैं, ताकि
CardColorsइंटरफ़ेस के ज़रिए कंटेनर और कॉन्टेंट के रंग मिल सकें. साथ ही, क्लिक किए जा सकने वाले कार्ड के लिए, बंद की गई स्थिति को सपोर्ट किया जा सके. (I927df) - अन्य कॉम्पोनेंट के साथ बेहतर तरीके से काम करने के लिए, Material 3 के टेक्स्ट फ़ील्ड में पैरामीटर
backgroundColorका नाम बदलकरcontainerColorकर दिया गया है. (I6fbd9)
गड़बड़ियां ठीक की गईं
- स्टैंडर्ड
IconButtonको Material3 स्पेसिफ़िकेशन के मुताबिक बनाने के लिए अपडेट किया गया है. (I09eab) - material3 Scaffold के टॉप बार की ऊंचाई को कॉन्टेंट में पास की गई पैडिंग में ले जाएं, ताकि कॉन्टेंट को टॉप ऐप्लिकेशन बार के नीचे रेंडर किया जा सके. अगर
PaddingValuesको अनदेखा किया जाता है, तो हो सकता है कि कॉन्टेंट, टॉप बार की वजह से न दिखे. (I83cbc, b/217776202)
वर्शन 1.0.0-alpha09
6 अप्रैल, 2022
androidx.compose.material3:material3:1.0.0-alpha09 रिलीज़ हो गया है. वर्शन 1.0.0-alpha09 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Material 3 Switch API (I2c3ad) जोड़ा गया
एपीआई में हुए बदलाव
- टेक्स्ट फ़ील्ड वाले ड्रॉपडाउन मेन्यू (इन्हें 'एक्सपोज़ किए गए ड्रॉपडाउन मेन्यू' या 'कॉम्बो बॉक्स' भी कहा जाता है) के लिए सहायता जोड़ी गई. (I1b832)
- MaterialTheme और Shape सब सिस्टम में शेप पैरामीटर जोड़ा गया. (I37426)
ExtendedFloatingActionButtonमें एक नया पैरामीटर जोड़ा गया है. इससे यह कंट्रोल किया जा सकेगा कि FAB को बड़ा किया गया है या छोटा. साथ ही, हर स्थिति के बीच ऐनिमेशन भी जोड़े गए हैं. बिना आइकॉन वाले ExtendedFAB के लिए, ट्रेलिंग टेक्स्ट वाले ExtendedFAB के लिए Extended FAB ओवरलोड जोड़ा गया. (Iba7f1)
वर्शन 1.0.0-alpha08
23 मार्च, 2022
androidx.compose.material3:material3:1.0.0-alpha08 रिलीज़ हो गया है. वर्शन 1.0.0-alpha08 में ये बदलाव शामिल हैं.
नई सुविधाएं
- Material 3 टेक्स्ट फ़ील्ड के लिए सपोर्ट जोड़ा गया. (I795cc, b/199377790)
एपीआई में हुए बदलाव
- मेन्यू के लिए डिफ़ॉल्ट डिवाइडर जोड़ा गया (I01374)
ColorSchemeक्लास मेंsurfaceTintरंग पैरामीटर जोड़ा गया. (I2f558)
गड़बड़ियां ठीक की गईं
- Material3 बटन को ठीक करें, ताकि MaterialTheme से इसकी डिफ़ॉल्ट टेक्स्ट स्टाइल वैल्यू पढ़ी जा सके. (Ie62fc)
वर्शन 1.0.0-alpha07
9 मार्च, 2022
androidx.compose.material3:material3:1.0.0-alpha07 रिलीज़ हो गया है. वर्शन 1.0.0-alpha07 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- Material 3 Surface API में अपडेट किए गए हैं. इससे क्लिक किए जा सकने वाले Surface के लिए, ओवरलोड किए गए फ़ंक्शन वापस आ जाते हैं. साथ ही, चुनने और टॉगल करने लायक Surface के लिए, एक फ़ंक्शन जोड़ा गया है. (I4bf18)
LazyVerticalGridऔरLazyHorizontalGridअब स्टेबल हो गए हैं. (I307c0)LazyVerticalGrid/LazyHorizontalGridऔर इससे जुड़ी सभी एपीआई को .grid सबपैकेज में ले जाया गया है. कृपया androidx.compose.foundation.lazy से androidx.compose.foundation.lazy.grid में अपने इंपोर्ट अपडेट करें. (I2d446)WindowInsetsControllerCompatके लिए, सिर्फ़ व्यू पर भरोसा करने वाले पिछले बदलाव को वापस लाया गया है. साथ ही, अब फिर से विंडो की ज़रूरत है. यह कुछ विंडो फ़्लैग मैनेज करने के लिए ज़रूरी है.ViewCompat.getWindowInsetsControllerकोWindowCompat.getInsetsControllerके पक्ष में बंद कर दिया गया है, ताकि यह पक्का किया जा सके कि सही विंडो का इस्तेमाल किया गया हो. जैसे, अगर व्यू किसी डायलॉग में है. (I660ae, b/219572936)- क्रॉस ऐक्सिस के साइज़ तय करने के लिए, नया
LazyVerticalGridएपीआई जोड़ा गया (I17723)
गड़बड़ियां ठीक की गईं
- Surface API (I3c8b9) में हुए बदलावों के मुताबिक, Card API में अपडेट
वर्शन 1.0.0-alpha06
23 फ़रवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha06 रिलीज़ हो गया है. वर्शन 1.0.0-alpha06 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
NavigationDrawerItemजोड़ा गया है, जो ड्रॉअर में मौजूद किसी एक डेस्टिनेशन को दिखाता है (Ic396f, b/218286829)PermanentNavigationDrawerऔरDismissibleNavigationDrawerको एक्सपेरिमेंटल एपीआई के तौर पर जोड़ा गया है. ये ड्रॉअर, बड़ी स्क्रीन वाले डिवाइसों के लिए सही हैं. (I5f8ab, b/218286829)- Material 3 बॉटम ऐप्लिकेशन बार के लिए सहायता जोड़ी गई (Ic432a)
NavigationDrawerका नाम बदलकरModalNavigationDrawerकर दिया गया है (I1807d, b/218286829)- Material 3 के स्लाइडर क्लास और टोकन जोड़े गए (I1ccee)
- टैब लागू करने की सुविधा जोड़ी गई. इस्तेमाल के उदाहरण (Ie0146) के लिए, दस्तावेज़ देखें
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसमें
TalkBackस्क्रीन रीडर के लीनियर नेविगेशन ने, ऐप्लिकेशन के सबसे ऊपर मौजूद बार के खाली टाइटल को चुना था. (Id4690) IconSizeकोFloatingActionButtonDefaultsमें जोड़ा गया. (Ia71cf)AlertDialogके साथ लंबा टेक्स्ट जोड़ने पर,AlertDialogबटन के छिपने की समस्या ठीक की गई है.LazyColumn(Ib2cc9, b/216663029)
वर्शन 1.0.0-alpha05
9 फ़रवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha05 रिलीज़ हो गया है. वर्शन 1.0.0-alpha05 में ये बदलाव शामिल हैं.
नई सुविधाएं
Material Design 3 कॉम्पोनेंट जोड़े गए
- ड्रॉपडाउन मेन्यू
- कार्ड
एपीआई में हुए बदलाव
Surfaceफ़ंक्शन अब काम नहीं करता. यह onClick कॉलबैक लेता है. क्लिक किए जा सकने वाले ऐसेट,InteractionSourceऔरModifier.clickable()की मदद से बनाई जानी चाहिए. (I211c6)- FAB के लिए, दबाए गए और फ़ोकस किए गए एलिवेशन की सुविधा जोड़ी गई. (Ibb584)
SurfaceAPI में बदलाव किया गया है, ताकि InteractionSource मिल सके. इससे अलग-अलग स्थितियों में इसकी उपस्थिति को कंट्रोल किया जा सकता है. (Iafbc8)
गड़बड़ियां ठीक की गईं
- डाइनैमिक कलर स्कीम में, तीसरे रंग के लिए मौजूद नहीं थे. उन्हें जोड़ा गया (I456c4, b/214588434)
वर्शन 1.0.0-alpha04
26 जनवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha04 रिलीज़ हो गया है. वर्शन 1.0.0-alpha04 में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- उन तरीकों में
NonRestartableComposableजोड़ा गया है जो जटिल लॉजिक के बिना, मौजूदा तरीकों के ओवरलोड हैं. इससे, कंपाइलर के जनरेट किए गए मेमोइज़ेशन चेक (equals) कम हो जाते हैं. ये चेक, उन सभी पैरामीटर के लिए होते हैं जो कॉल किए गए इनर फ़ंक्शन में दोहराए जाते हैं. (I90490) - Material 3 का डिवाइडर जोड़ा गया. (Ica5fc)
- एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई एनोटेशन का इस्तेमाल करके, Checkbox और RadioButton को मार्क करें. (Ie44bb)
- Material 3 प्रोग्रेस इंडिकेटर के लिए सपोर्ट जोड़ा गया. (Iff232, b/205023841)
गड़बड़ियां ठीक की गईं
- बंद किए गए
TextButton'sकंटेनर के रंग को पारदर्शी बनाने के लिए अपडेट करें (I6b248, b/213339737)
वर्शन 1.0.0-alpha03
12 जनवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha03 रिलीज़ हो गया है. वर्शन 1.0.0-alpha03 में ये बदलाव शामिल हैं.
गड़बड़ियां ठीक की गईं
- Material 3 के
MaterialThemeमेंLocalIndicationजोड़ें. (I7ce4e) - चेकबॉक्स के लिए लागू किए गए कॉर्नर रेडियस को ठीक किया गया (I38b03, b/175198975, b/202309440)
डिपेंडेंसी से जुड़े अपडेट
- अब Kotlin
1.6.10पर निर्भर करता है.
वर्शन 1.0.0-alpha02
1 दिसंबर, 2021
androidx.compose.material3:material3:1.0.0-alpha02 रिलीज़ हो गया है. वर्शन 1.0.0-alpha02 में ये बदलाव शामिल हैं.
नई सुविधाएं
- चेकबॉक्स और रेडियोबटन के लिए सहायता जोड़ी गई.
- Kotlin
1.6.0के साथ काम करने के लिए अपडेट किया गया
एपीआई में हुए बदलाव
- Material 3 के स्कैफ़ोल्ड से ड्रॉअर हटाएं. (I04f51)
- Material 3
Checkboxके साथ काम करने की सुविधा जोड़ी गई है. (Id5542) - Material 3
RadioButtonके साथ काम करने की सुविधा जोड़ी गई है. (I20334)
गड़बड़ियां ठीक की गईं
IconButtonके रिपल रेडियस को 40dp से घटाकर 20dp करें. (I68bbe, b/206674345)Textके लिए पोर्ट स्ट्रिंग फ़ास्ट पाथ,compose.material(I30b03) से बदल गया है- हमेशा चालू रहने वाले बटन को हार्डकोड करने की समस्या ठीक की गई. (Iea832, b/205335456)
वर्शन 1.0.0-alpha01
27 अक्टूबर, 2021
androidx.compose.material3:material3:1.0.0-alpha01 रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.
नई सुविधाएं
Material Design 3 की थीम और Material You का डाइनैमिक कलर
Material Design 3 कॉम्पोनेंट
- बटन
- एफ़एबी और एक्सटेंडेड एफ़एबी
- डायलॉग
- नेविगेशन बार
- नेविगेशन पैनल
- नेविगेशन रेल
- टॉप ऐप्लिकेशन बार
- बैज
- आइकॉन
- टेक्स्ट
- सरफ़ेस
- लेआउट
- कॉन्टेंट का रंग
ज़्यादा जानकारी के लिए, Compose में Material Theming की गाइड में Material Design 3 और Material You सेक्शन देखें.