टिप्पणी
इस टेबल में, androidx.annotation
ग्रुप के सभी आर्टफ़ैक्ट शामिल हैं.
सह-प्रॉडक्ट | स्टेबल रिलीज़ | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
---|---|---|---|---|
टिप्पणी | 1.8.2 | - | - | 1.9.0-ऐल्फ़ा01 |
एनोटेशन-एक्सपेरिमेंट | 1.4.1 | - | - | - |
डिपेंडेंसी तय करना
एनोटेशन पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट. Google की Maven रिपॉज़िटरी पढ़ें हमारा वीडियो देखें.
उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको build.gradle
फ़ाइल में ज़रूरत है
आपका ऐप्लिकेशन या मॉड्यूल:
ग्रूवी
dependencies { implementation "androidx.annotation:annotation:1.8.2" // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation "androidx.annotation:annotation-experimental:1.4.1" }
Kotlin
dependencies { implementation("androidx.annotation:annotation:1.8.2") // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation("androidx.annotation:annotation-experimental:1.4.1") }
डिपेंडेंसी के बारे में ज़्यादा जानकारी के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.
सुझाव
आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको नई समस्याओं का पता चलता है या आपको इस लाइब्रेरी को बेहतर बनाने के लिए आइडिया मिल सकते हैं. कृपया, इस मौजूदा समस्याएं इस लाइब्रेरी में जोड़ें. किसी मौजूदा समस्या के लिए अपना वोट दें. इसके लिए ये तरीके अपनाएं: स्टार बटन पर क्लिक करके ऐसा किया जा सकता है.
समस्या को ट्रैक करने वाले टूल से जुड़ा दस्तावेज़ देखें हमारा वीडियो देखें.
वर्शन 1.9
वर्शन 1.9.0-alpha01
26 जून, 2024
androidx.annotation:annotation-*:1.9.0-alpha01
रिलीज़ हो गया है. वर्शन 1.9.0-alpha01 में ये कमिट मौजूद हैं.
बाहरी योगदान
linuxArm64
मल्टीप्लैटफ़ॉर्म टारगेट के लिए सहायता जोड़ी गई (जेक व्हार्टन का धन्यवाद!)
वर्शन 1.8
वर्शन 1.8.2
7 अगस्त, 2024
androidx.annotation:annotation-*:1.8.2
रिलीज़ हो गया है. वर्शन 1.8.2 में ये शर्तें शामिल हैं.
गड़बड़ियां ठीक की गईं
mingwX64
प्लैटफ़ॉर्म (I461ca, b/349894318) के लिए, सहायता जोड़ी जा रही है
वर्शन 1.8.1
24 जुलाई, 2024
androidx.annotation:annotation-*:1.8.1
रिलीज़ हो गया है. वर्शन 1.8.1 में ये शर्तें शामिल हैं.
गड़बड़ियां ठीक की गईं
- इसमें अन्य Kotlin मल्टीप्लैटफ़ॉर्म टारगेट शामिल हैं:
watchos
,tvos
.
वर्शन 1.8.0
14 मई, 2024
androidx.annotation:annotation-*:1.8.0
रिलीज़ हो गया है. वर्शन 1.8.0 में ये बातें शामिल हैं.
1.7.0 के बाद से हुए अहम बदलाव
- काम नहीं करने वाले एपीआई को बदलने के लिए,
@ReplaceWith
एनोटेशन जोड़ा गया @MainThread
एनोटेशन को सामान्य सोर्स सेट में ले जाया गया.
वर्शन 1.8.0-rc01
1 मई, 2024
androidx.annotation:annotation-*:1.8.0-rc01
रिलीज़ हो गया है. वर्शन 1.8.0-rc01 में, पिछली बीटा रिलीज़ के बाद से कोई बदलाव नहीं किया गया है.
वर्शन 1.8.0-beta02
17 अप्रैल, 2024
androidx.annotation:annotation-*:1.8.0-beta02
रिलीज़ हो गया है. पिछली रिलीज़ के बाद से, वर्शन 1.8.0-beta02 में कोई बदलाव नहीं हुआ है.
वर्शन 1.8.0-beta01
3 अप्रैल, 2024
androidx.annotation:annotation-*:1.8.0-beta01
रिलीज़ हो गया है. वर्शन 1.8.0-beta01 में ये प्रतिबद्धताएं शामिल हैं.
नई सुविधाएं
ReplaceWith
एनोटेशन अब एपीआई-स्टेबल है. हालांकि, अपने-आप ठीक होने की सुविधा के साथ इससे जुड़ी लिंट जांच अब तक शिप नहीं की गई है
वर्शन 1.8.0-alpha02
20 मार्च, 2024
androidx.annotation:annotation-*:1.8.0-alpha02
रिलीज़ हो गया है. इसमें कोई खास बदलाव नहीं हुआ है. वर्शन 1.8.0-alpha02 में ये कमिट मौजूद हैं.
वर्शन 1.8.0-alpha01
21 फ़रवरी, 2024
androidx.annotation:annotation-*:1.8.0-alpha01
रिलीज़ हो गया है. वर्शन 1.8.0-alpha01 में ये कमियां हैं.
एपीआई में बदलाव
- काम न करने वाले एपीआई की जगह कोई दूसरी जानकारी देने के लिए,
@ReplaceWith
एनोटेशन जोड़ा गया. (I38db3, b/322373864)
बाहरी योगदान
@MainThread
एनोटेशन को सामान्य सोर्स सेट में ले जाने के लिए, इवान मटकोव का धन्यवाद. (6f228c)
वर्शन 1.7
वर्शन 1.7.1
13 दिसंबर, 2023
androidx.annotation:annotation-*:1.7.1
रिलीज़ हो गया है. वर्शन 1.7.1 में ये कमियां शामिल हैं.
गड़बड़ियां ठीक की गईं
- डिफ़ॉल्ट प्लैटफ़ॉर्म डिपेंडेंसी शामिल करते समय,
compile
स्कोप का इस्तेमाल करें. (I4958f)
वर्शन 1.7.0
6 सितंबर, 2023
androidx.annotation:annotation-*:1.7.0
रिलीज़ हो गया है. वर्शन 1.7.0 में ये कमियां शामिल हैं.
1.6.0 के बाद के अहम बदलाव
- इसमें iOS, Linux, और MacOS प्लैटफ़ॉर्म को टारगेट करने वाले Kotlin मल्टीप्लैटफ़ॉर्म आर्टफ़ैक्ट शामिल हैं.
- अब KMM प्रोजेक्ट में एनोटेशन का इस्तेमाल किया जा सकता है. ध्यान दें कि Android के अलावा, एनोटेशन के टारगेट अब भी एक्सपेरिमेंट के तौर पर हैं. हालांकि, हमने वर्शन मर्ज करने का फ़ैसला लिया है, ताकि डेवलपर उन्हें आसानी से आज़मा सकें. खास तौर पर, जब हम सीमाएं तय कर लेते हैं, तो ऐल्फ़ा डेवलपमेंट के दौरान कुछ एनोटेशन सामान्य और प्लैटफ़ॉर्म के खास कोड के बीच स्विच हो सकते हैं.
वर्शन 1.7.0-rc01
23 अगस्त, 2023
androidx.annotation:annotation-*:1.7.0-rc01
रिलीज़ हो गया है. वर्शन 1.7.0-rc01 में ये कमिट हैं.
इस रिलीज़ में पिछले बीटा वर्शन का कोई बदलाव नहीं है.
वर्शन 1.7.0-beta01
9 अगस्त, 2023
androidx.annotation:annotation-*:1.7.0-beta01
रिलीज़ हो गया है. वर्शन 1.7.0-beta01 में ये कमिट हैं.
नई सुविधाएं
- रिलीज़ के लिए स्टेबलाइज़ किए गए एपीआई
वर्शन 1.7.0-alpha03
26 जुलाई, 2023
androidx.annotation:annotation-*:1.7.0-alpha03
रिलीज़ हो गया है. वर्शन 1.7.0-alpha03 में ये कमिट हैं.
गड़बड़ियां ठीक की गईं
- Maven पीओएम पब्लिकेशन में अब डिपेंडेंसी के तौर पर डिफ़ॉल्ट जेवीएम-टारगेट मल्टीप्लैटफ़ॉर्म आर्टफ़ैक्ट शामिल है
वर्शन 1.7.0-alpha02
24 मार्च, 2023
androidx.annotation:annotation-*:1.7.0-alpha02
रिलीज़ हो गया है.
गड़बड़ियां ठीक की गईं
- Kotlin नेटिव टारगेट (b/274786186, KT-57531) में बिल्ड की समस्या को हल करने के लिए, Maven आर्टफ़ैक्ट से डिपेंडेंसी से जुड़ी पाबंदियों को हटाया गया.
वर्शन 1.7.0-alpha01
22 मार्च, 2023
androidx.annotation:annotation-*:1.7.0-alpha01
रिलीज़ हो गया है. वर्शन 1.7.0-alpha01 में ये कमियां हैं.
नई सुविधाएं
- इसमें iOS, Linux, और MacOS प्लैटफ़ॉर्म को टारगेट करने वाले Kotlin मल्टीप्लैटफ़ॉर्म आर्टफ़ैक्ट शामिल हैं.
- अब KMM प्रोजेक्ट में एनोटेशन का इस्तेमाल किया जा सकता है. ध्यान दें कि Android के अलावा, एनोटेशन के टारगेट अब भी एक्सपेरिमेंट के तौर पर हैं. हालांकि, हमने वर्शन मर्ज करने का फ़ैसला लिया है, ताकि डेवलपर उन्हें आसानी से आज़मा सकें. खास तौर पर, जब हम सीमाएं तय कर लेते हैं, तो ऐल्फ़ा डेवलपमेंट के दौरान कुछ एनोटेशन सामान्य और प्लैटफ़ॉर्म के खास कोड के बीच स्विच हो सकते हैं.
वर्शन 1.6
वर्शन 1.6.0
22 फ़रवरी, 2023
androidx.annotation:annotation:1.6.0
और androidx.annotation:annotation-jvm:1.6.0
रिलीज़ हुई हैं. वर्शन 1.6.0 में ये कमियां शामिल हैं.
1.5.0 के बाद के अहम बदलाव
- यह बताने के लिए कि एपीआई को किसी खास एक्सटेंशन SDK टूल (I5e4fe) के किसी खास वर्शन की ज़रूरत है,
@RequiresExtension
एनोटेशन जोड़ता है - Kotlin मल्टीप्लैटफ़ॉर्म टूलचेन (I3be8d) का इस्तेमाल करके बनाने के लिए, एनोटेशन लाइब्रेरी में बदलाव किया गया
वर्शन 1.6.0-rc01
8 फ़रवरी, 2023
androidx.annotation:annotation:1.6.0-rc01
और androidx.annotation:annotation-jvm:1.6.0-rc01
रिलीज़ हुई हैं. वर्शन 1.6.0-rc01 में ये कमिट हैं.
- रिलीज़ कैंडिडेट 1.6.0-rc01 के लिए, एनोटेशन को स्टेबलाइज़ किया गया है.
वर्शन 1.6.0-beta01
25 जनवरी, 2023
androidx.annotation:annotation:1.6.0-beta01
और androidx.annotation:annotation-jvm:1.6.0-beta01
रिलीज़ हुई हैं. 1.6.0-alpha01
में कोई बदलाव नहीं किया गया है.
वर्शन 1.6.0-alpha01
11 जनवरी, 2023
androidx.annotation:annotation-*:1.6.0-alpha01
रिलीज़ हो गया है. वर्शन 1.6.0-alpha01 में ये कमियां हैं.
वर्शन 1.6.0-dev01
8 फ़रवरी, 2023
androidx.annotation:annotation-*:1.6.0-dev01
रिलीज़ हो गया है. वर्शन 1.6.0-dev01 में ये कमियां शामिल हैं.
- एनोटेशन ने डेवलपर प्रीव्यू 1.6.0-dev01 के लिए, Kotlin मल्टी-प्लैटफ़ॉर्म चालू किया है.
नई सुविधाएं
- यह बताने के लिए कि एपीआई को किसी खास एक्सटेंशन SDK टूल के खास वर्शन की ज़रूरत होती है,
@RequiresExtension
एनोटेशन जोड़ता है. (I5e4fe) - Kotlin मल्टीप्लैटफ़ॉर्म टूलचेन (I3be8d) का इस्तेमाल करके बनाने के लिए, एनोटेशन लाइब्रेरी में बदलाव किया गया
वर्शन 1.5.0
वर्शन 1.5.0
21 सितंबर, 2022
androidx.annotation:annotation:1.5.0
रिलीज़ हो गया है. वर्शन 1.5.0 में ये कमियां शामिल हैं.
1.4.0 के बाद के अहम बदलाव
- एनोटेशन लाइब्रेरी को पूरी तरह से Kotlin सोर्स पर माइग्रेट कर दिया गया है. इससे, खास तौर पर Kotlin के टारगेट इस्तेमाल की साइटों और Kotlin के साथ काम करने वाली एनोटेशन की सुविधाओं के लिए काम किया जा सकता है.
वर्शन 1.5.0-rc01
7 सितंबर, 2022
androidx.annotation:annotation:1.5.0-rc01
रिलीज़ हो गया है. वर्शन 1.5.0-rc01 में ये कमिट शामिल हैं.
- पिछले 1.5.0 बीटा रिलीज़ से कोई बदलाव नहीं.
वर्शन 1.5.0-beta01
24 अगस्त, 2022
androidx.annotation:annotation:1.5.0-beta01
रिलीज़ हो गया है. वर्शन 1.5.0-beta01 में ये कमिट हैं.
- पिछली रिलीज़ की तुलना में कोई बदलाव नहीं. बीटा वर्शन के लिए, एपीआई प्लैटफ़ॉर्म को फ़्रीज़ कर दिया गया है.
वर्शन 1.5.0-alpha02
10 अगस्त, 2022
androidx.annotation:annotation:1.5.0-alpha02
रिलीज़ हो गया है. वर्शन 1.5.0-alpha02 में ये कमियां हैं.
- पिछली ऐल्फ़ा रिलीज़ के बाद से कोई बदलाव नहीं किया गया है.
वर्शन 1.5.0-alpha01
27 जुलाई, 2022
androidx.annotation:annotation:1.5.0-alpha01
रिलीज़ हो गया है. वर्शन 1.5.0-alpha01 में ये कमियां हैं.
नई सुविधाएं
- एनोटेशन लाइब्रेरी को पूरी तरह से Kotlin सोर्स पर माइग्रेट कर दिया गया है. इससे, खास तौर पर Kotlin के टारगेट इस्तेमाल की साइटों और Kotlin के साथ काम करने वाली अन्य एनोटेशन की सुविधाओं का इस्तेमाल किया जा सकता है.
वर्शन 1.4.0
वर्शन 1.4.0
15 जून, 2022
androidx.annotation:annotation:1.4.0
रिलीज़ हो गया है. वर्शन 1.4.0 में ये कमियां शामिल हैं.
1.3.0 के बाद से हुए अहम बदलाव
@RestrictTo
को Kotlin सोर्स पर माइग्रेट कर दिया गया है. अब यह@file
के इस्तेमाल के लिए बनी साइट के साथ काम करता है. इस वजह से, एनोटेशन लाइब्रेरी अब Kotlin स्टैंडर्ड लाइब्रेरी पर निर्भर करती है.@ReturnThis
(b/140249763): यह पक्का करता है कि इस तरीके को बदलने के मेथड से एक ही इंस्टेंस दिखे (बिल्डर वगैरह के लिए)@OpenForTesting
(b/141539024): Kotlin क्लास और मेथड को "ओपन" के तौर पर मार्क किया गया है को इस एनोटेशन के साथ एनोटेट किया जा सकता है और लिंट से यह पक्का होगा कि इस क्लास को सिर्फ़ यूनिट टेस्ट से सब-क्लास (और सिर्फ़ मेथड को ओवरराइड) किया जाए@DeprecatedSinceApi
(b/37116481): इससे पता चलता है कि जानकारी देने वाला तरीका (या क्लास या फ़ील्ड), प्लैटफ़ॉर्म एपीआई के लिए बैकपोर्ट लाइब्रेरी का हिस्सा है. मौजूदा एपीआई लेवल के लिए, अब इसकी ज़रूरत नहीं है.@EmptySuper
: इससे पता चलता है कि यह तरीका खाली है. इसलिए, ओवरराइड करते समय आपको इसे कॉल करने की ज़रूरत नहीं है (और असल में आपको ऐसा नहीं करना चाहिए. उदाहरण के लिए, इसमें पुराने सिस्टम के साथ काम करने की सुविधा की जांच की जा सकती है.)
वर्शन 1.4.0-rc01
1 जून, 2022
androidx.annotation:annotation:1.4.0-rc01
रिलीज़ हो गया है. वर्शन 1.4.0-rc01 में ये कमिट शामिल हैं.
- एपीआई प्लैटफ़ॉर्म और उसके फ़ंक्शन को रिलीज़ करने के लिए तय कर लिया गया है.
वर्शन 1.4.0-beta01
18 मई, 2022
androidx.annotation:annotation:1.4.0-beta01
रिलीज़ हो गया है. वर्शन 1.4.0-beta01 में ये कमिट मौजूद हैं.
- पिछले ऐल्फ़ा वर्शन के बाद से कोई बदलाव नहीं हुआ है. बीटा रिलीज़ के लिए, एपीआई प्लैटफ़ॉर्म को लॉक कर दिया गया है.
वर्शन 1.4.0-alpha02
9 फ़रवरी, 2022
androidx.annotation:annotation:1.4.0-alpha02
रिलीज़ हो गया है. वर्शन 1.4.0-alpha02 में ये कमियां हैं.
नई सुविधाएं
@ReturnThis
,@OpenForTesting
,@EmptySuper
, और@DeprecatedSinceApi
एनोटेशन जोड़े गए. (21946a2)@ReturnThis
(b/140249763): यह पक्का करता है कि इस तरीके को बदलने के तरीके से, एक जैसा इंस्टेंस दिखे (बिल्डर वगैरह के लिए)@OpenForTesting
(b/141539024): Kotlin क्लास और मेथड को "ओपन" के तौर पर मार्क किया गया है को इस एनोटेशन के साथ एनोटेट किया जा सकता है और लिंट से यह पक्का होगा कि इस क्लास को सिर्फ़ यूनिट टेस्ट से सब-क्लास (और सिर्फ़ मेथड को ओवरराइड) किया जाए@DeprecatedSinceApi
(b/37116481): इससे यह पता चलता है कि जानकारी देने वाला तरीका (या क्लास या फ़ील्ड), प्लैटफ़ॉर्म एपीआई के लिए बैकपोर्ट लाइब्रेरी का हिस्सा है. मौजूदा एपीआई लेवल के लिए, इसकी ज़रूरत नहीं है.@EmptySuper
: इससे पता चलता है कि यह तरीका खाली है. इसलिए, ओवरराइड करते समय आपको इसे कॉल करने की ज़रूरत नहीं है (और असल में आपको ऐसा नहीं करना चाहिए. उदाहरण के लिए, इसमें पुराने सिस्टम के साथ काम करने की सुविधा की जांच की जा सकती है.)
वर्शन 1.4.0-alpha01
15 दिसंबर, 2021
androidx.annotation:annotation:1.4.0-alpha01
रिलीज़ हो गया है. वर्शन 1.4.0-alpha01 में ये कमियां हैं.
एपीआई में बदलाव
RestrictTo
एनोटेशन को Kotlin सोर्स में माइग्रेट किया गया (Ia6336)
वर्शन 1.3.0
वर्शन 1.3.0
3 नवंबर, 2021
androidx.annotation:annotation:1.3.0
रिलीज़ हो गया है. वर्शन 1.3.0 में ये कमियां शामिल हैं.
01.2.0 के बाद से हुए अहम बदलाव
- उन एपीआई को मार्क करने के लिए
@Discouraged
एनोटेशन जिन्हें किसी वजह से रोका नहीं जा सकता. हालांकि, जिनकी परफ़ॉर्मेंस पर खराब असर पड़ता हो और जिन्हें सामान्य प्रोडक्शन कोड में कॉल नहीं किया जाना चाहिए - सामान्य कॉन्टेक्स्ट मार्क करने के लिए
@Context
एनोटेशन, ताकि डेवलपर नए एपीआई पर ज़्यादा आसानी से माइग्रेट कर सकें - उन एलिमेंट को मार्क करने के लिए
@GravityInt
एनोटेशन जिनमें गुरुत्वाकर्षण वैल्यू वाले पूर्णांक में पैक किए गए हों androidx.resourceinspection
के लिए@InspectableProperty
का समर्थन@Attribute
के पक्ष में किया गया
वर्शन 1.3.0-rc01
27 अक्टूबर, 2021
androidx.annotation:annotation:1.3.0-rc01
रिलीज़ हो गया है. वर्शन 1.3.0-rc01 में ये कमिट हैं.
वर्शन 1.3.0-beta01
29 सितंबर, 2021
androidx.annotation:annotation:1.3.0-beta01
रिलीज़ हो गया है. वर्शन 1.3.0-beta01 में ये कमिट हैं.
एपीआई में बदलाव
- 'मैसेज' में पूरी जानकारी देना ज़रूरी है @Discouraged के लिए धन्यवाद. (I3390f)
- जिन एलिमेंट का इस्तेमाल करने से मना किया गया है उन्हें मार्क करने के लिए, @Discouraged एनोटेशन जोड़ना. (Ib2549)
- Studio Docs के पॉप-अप (Ie8e1a, b/183134648) से, LimitTo व्याख्या दिखाएं
गड़बड़ियां ठीक की गईं
- जेनरिक कॉन्टेक्स्ट को मार्क करने के लिए, कॉन्टेक्स्ट के बारे में व्याख्या जोड़ें. इससे डेवलपर को यह मदद मिलेगी नए एपीआई पर ज़्यादा आसानी से माइग्रेट कर सकते हैं. (Ie581a)
वर्शन 1.3.0-alpha01
24 मार्च, 2021
androidx.annotation:annotation:1.3.0-alpha01
रिलीज़ हो गया है. वर्शन 1.3.0-alpha01 में ये कमियां हैं.
एपीआई में बदलाव
@InspectableProperty
का समर्थन@Attribute
के पक्ष में किया गयाandroidx.resourceinspection
में. (Ic0eff)- इसमें शामिल एलिमेंट को मार्क करने के लिए,
@GravityInt
एनोटेशन जोड़ा गया गुरुत्वाकर्षण मान पूर्णांकों में पैक किए गए. (Ifcaa4, b/180620048)
एनोटेशन-प्रयोग का वर्शन 1.4
वर्शन 1.4.1
3 अप्रैल, 2024
androidx.annotation:annotation-experimental:1.4.1
रिलीज़ हो गया है. वर्शन 1.4.1 में ये शर्तें शामिल हैं.
गड़बड़ियां ठीक की गईं
- Kotlin फ़ाइलों में गलती से
RequiresOptIn
चेक को ट्रिगर होने से बचाने के लिए,isKotlin
के इस्तेमाल को ठीक करें. (I2d8c1f)
वर्शन 1.4.0
24 जनवरी, 2024
androidx.annotation:annotation-experimental:1.4.0
रिलीज़ हो गया है. वर्शन 1.4.0 में ये कमियां शामिल हैं.
1.3.0 के बाद से हुए अहम बदलाव
- Kotlin मल्टी-प्लैटफ़ॉर्म के लिए सहायता जोड़ना
- Kotlin 2.0 के साथ काम करने की समस्या ठीक करना
- एक्सपेरिमेंट के तौर पर बताई गई Kotlin प्रॉपर्टी (I8bd43) के Java इस्तेमाल के लिए चेतावनियां दिखाएं
- Kotlin के तरीकों (Id7a41) पर, अपने-आप ठीक होने की सुविधा की प्लेसमेंट से जुड़ी गड़बड़ी को ठीक करें
वर्शन 1.4.0-rc01
10 जनवरी, 2024
androidx.annotation:annotation-experimental:1.4.0-rc01
रिलीज़ हो गया है. पिछली रिलीज़ के बाद से, वर्शन 1.4.0-rc01 में कोई बदलाव नहीं किया गया है.
वर्शन 1.4.0-beta01
13 दिसंबर, 2023
androidx.annotation:annotation-experimental:1.4.0-beta01
रिलीज़ हो गया है. पिछली रिलीज़ के बाद से कोई बदलाव नहीं हुआ है.
वर्शन 1.4.0-alpha01
29 नवंबर, 2023
androidx.annotation:annotation-experimental:1.4.0-alpha01
रिलीज़ हो गया है. वर्शन 1.4.0-alpha01 में ये कमियां हैं.
गड़बड़ियां ठीक की गईं
- b/301598518 पर काम करने के लिए, क्लास-लेवल पर अपने-आप सुधार होने की सुविधा के सुझावों को कुछ समय के लिए हटाएं. (आईडी98b2)
- एक्सपेरिमेंट के तौर पर बताई गई Kotlin प्रॉपर्टी (I8bd43) के Java इस्तेमाल के लिए चेतावनियां दिखाएं
- Kotlin के तरीकों (Id7a41) पर, अपने-आप ठीक होने की सुविधा की प्लेसमेंट से जुड़ी गड़बड़ी को ठीक करें
वर्शन 1.4.0-dev01
8 फ़रवरी, 2023
androidx.annotation:annotation-experimental:1.4.0-dev01
रिलीज़ हो गया है. वर्शन 1.4.0-dev01 में ये कमियां शामिल हैं.
- एनोटेशन-एक्सपेरिमेंट के तहत, डेवलपर झलक 1.4.0-dev01 के लिए Kotlin मल्टी-प्लैटफ़ॉर्म चालू किया गया है.
एनोटेशन-प्रयोग का वर्शन 1.3.1
वर्शन 1.3.1
21 जून, 2023
androidx.annotation:annotation-experimental:1.3.1
रिलीज़ हो गया है. वर्शन 1.3.1 में ये कमियां शामिल हैं.
गड़बड़ियां ठीक की गईं
- लिंट ऑटो-फ़िक्स लागू करते समय, व्याख्या को कार्रवाई बदलने वाली सूची की शुरुआत में रखें. (b/251172715)
- Kotlin सोर्स में
androidx.annotation.RequiresOptIn
के इस्तेमाल को रोकने के लिए, लिंट चेक का इस्तेमाल करें (b/241097743)
एनोटेशन-प्रयोग का वर्शन 1.3.0
वर्शन 1.3.0
7 सितंबर, 2022
androidx.annotation:annotation-experimental:1.3.0
रिलीज़ हो गया है. वर्शन 1.3.0 में ये कमियां शामिल हैं.
01.2.0 के बाद से हुए अहम बदलाव
@androidx.annotation.OptIn
(I24d58) के पैकेज-लेवल पर इस्तेमाल करने के लिए सहायता जोड़ें- Kotlin stdlib डिपेंडेंसी को सिर्फ़ कंपाइल करने के बजाय एपीआई टाइप पर ले जाया गया. इसका मतलब है कि एनोटेशन-एक्सपेरिमेंट वाली लाइब्रेरी के सभी क्लाइंट, अपनी ट्रांज़िटिव डिपेंडेंसी में Kotlin स्टैंडर्ड लाइब्रेरी को शामिल करेंगे.
वर्शन 1.3.0-rc01
24 अगस्त, 2022
androidx.annotation:annotation-experimental:1.3.0-rc01
रिलीज़ हो गया है. वर्शन 1.3.0-rc01 में ये कमिट हैं.
- पिछली रिलीज़ की तुलना में कोई बदलाव नहीं. आरसी के लिए लागू करने के तरीके को रोक दिया गया है.
वर्शन 1.3.0-beta01
10 अगस्त, 2022
androidx.annotation:annotation-experimental:1.3.0-beta01
रिलीज़ हो गया है. वर्शन 1.3.0-beta01 में ये कमिट हैं.
- ऐल्फ़ा वर्शन में कोई बदलाव नहीं किया गया. इस लाइब्रेरी को बीटा रिलीज़ के लिए स्थिर कर दिया गया है.
वर्शन 1.3.0-alpha01
27 जुलाई, 2022
androidx.annotation:annotation-experimental:1.3.0-alpha01
रिलीज़ हो गया है. वर्शन 1.3.0-alpha01 में ये कमियां हैं.
एपीआई में बदलाव
@androidx.annotation.OptIn
(I24d58) के पैकेज-लेवल पर इस्तेमाल करने के लिए सहायता जोड़ें
एनोटेशन-प्रयोग का वर्शन 1.2.0
वर्शन 1.2.0
15 दिसंबर, 2021
androidx.annotation:annotation-experimental:1.2.0
रिलीज़ हो गया है. वर्शन 1.2.0 में ये कमियां शामिल हैं.
1.1.0 के बाद के अहम बदलाव
यह लाइब्रेरी अब Java 8 भाषा स्तर को लक्षित कर रही है.
वर्शन 1.2.0-rc01
1 दिसंबर, 2021
androidx.annotation:annotation-experimental:1.2.0-rc01
रिलीज़ हो गया है. वर्शन 1.2.0-rc01 में ये कमिट शामिल हैं.
बीटा वर्शन से कोई बदलाव नहीं हुआ.
वर्शन 1.2.0-beta01
17 नवंबर, 2021
androidx.annotation:annotation-experimental:1.2.0-beta01
रिलीज़ हो गया है. वर्शन 1.2.0-beta01 में ये कमिट मौजूद हैं.
एपीआई में बदलाव
एपीआई के बीटा वर्शन को प्रोसेस कर दिया गया है.
एनोटेशन-प्रयोग वर्शन 1.2.0-alpha01
30 जून, 2021
androidx.annotation:annotation-experimental:1.2.0-alpha01
रिलीज़ हो गया है. वर्शन 1.2.0-alpha01 में ये कमियां हैं.
नई सुविधाएं
- लाइब्रेरी अब Java 8 भाषा स्तर को लक्षित कर रही है
वर्शन 1.2.0
वर्शन 1.2.0
24 मार्च, 2021
androidx.annotation:annotation:1.2.0
रिलीज़ हो गया है. वर्शन 1.2.0 में ये कमियां शामिल हैं.
1.1.0 से अब तक के बड़े बदलाव
@ChecksSdkIntAtLeast
एनोटेशन जोड़ा गया. इसकी मदद से, उन तरीकों या फ़ील्ड की पहचान की जा सकती है जिनका इस्तेमाल करके, SDK टूल के लेवल पर ऐक्सेस को रोका जा सकता है. साथ ही,NewApi
लिंट की जांच पूरी की जा सकती है.@DoNotInline
एनोटेशन जोड़ा गया, जिसे ProGuard नियम के साथ जोड़ा गया, ताकि ऑप्टिमाइज़ेशन के दौरान सदस्यों को इनलाइन न दिखाया जा सके.- अब
@Documented
के साथ कई तरह की जानकारी के बारे में जानकारी जोड़ी गई है, ताकि यह पक्का किया जा सके कि वे जानकारी उन सदस्यों के दस्तावेज़ों में दिखें जिनके बारे में जानकारी दी गई है.
वर्शन 1.2.0-rc01
24 फ़रवरी, 2021
androidx.annotation:annotation:1.2.0-rc01
रिलीज़ हो गया है. वर्शन 1.2.0-rc01 में ये कमिट शामिल हैं.
वर्शन 1.2.0-beta01
13 जनवरी, 2021
androidx.annotation:annotation:1.2.0-beta01
रिलीज़ हो गया है. वर्शन 1.2.0-beta01 में ये कमिट मौजूद हैं.
एपीआई में बदलाव
@DoNotInline
की नई जानकारी, जो कोड ऑप्टिमाइज़र (जैसे, ProGuard, R8) को यह निर्देश देती है कि वह जानकारी देने वाले तरीके को इनलाइन न करे. (I3dfe8, b/141326133)
वर्शन 1.2.0-alpha01
14 मई, 2020
androidx.annotation:annotation:1.2.0-alpha01
रिलीज़ हो गया है. वर्शन 1.2.0-alpha01 में ये कमियां हैं.
नई सुविधाएं
@ChecksSdkIntAtLeast
एनोटेशन जोड़ा गया. इस उदाहरण में, androidx और उपयोगकर्ता को ऐसे तरीकों और फ़ील्ड के बारे में बताया गया है जोSDK_INT
चेक दिखाते हैं. (I89a54, b/120255046)
एनोटेशन-प्रयोग का वर्शन 1.1.0
वर्शन 1.1.0
7 अप्रैल, 2021
androidx.annotation:annotation-experimental:1.1.0
रिलीज़ हो गया है. वर्शन 1.1.0 में ये कमियां शामिल हैं.
1.0.0 के बाद से हुए बड़े बदलाव
- Jetpack के एक्सपेरिमेंटल एनोटेशन को Kotlin में फिर से लिखा गया है, ताकि कई मार्कर क्लास के लिए सहायता मिल सके और बंद करने की प्रक्रिया को बेहतर किया जा सके.
- Kotlin के जैसा बनाने के लिए,
RequiresOptIn
औरOptIn
एनोटेशन जोड़ दिए गए हैं. साथ ही,Experimental
औरUsesExperimental
एनोटेशन को हटा दिया गया है.
वर्शन 1.1.0-rc02
24 मार्च, 2021
androidx.annotation:annotation-experimental:1.1.0-rc02
रिलीज़ हो गया है. वर्शन 1.1.0-rc02 में ये कमिट हैं.
गड़बड़ियां ठीक की गईं
- ProGuard नियम जोड़े गए, ताकि यह पक्का किया जा सके कि कोड ऑप्टिमाइज़ेशन, Kotlin मेटा-एनोटेशन के न होने के बारे में चेतावनी न दे.
वर्शन 1.1.0-rc01
10 मार्च, 2021
androidx.annotation:annotation-experimental:1.1.0-rc01
रिलीज़ हो गया है. वर्शन 1.1.0-rc01 में ये कमिट शामिल हैं.
पिछली बीटा रिलीज़ के बाद से कोई बदलाव नहीं हुआ है.
वर्शन 1.1.0-beta01
27 जनवरी, 2021
androidx.annotation:annotation-experimental:1.1.0-beta01
रिलीज़ हो गया है. वर्शन 1.1.0-beta01 में ये कमिट हैं.
एपीआई में बदलाव
- प्रयोग के तौर पर दी गई जानकारी का androidx वैरिएंट Kotlin के साथ समानता देने के लिए बंद किया गया है. इसे requiredOptIn एनोटेशन को अपडेट किया गया है और Java-फ़ेसिंग लिंटर को इस तरह अपडेट किया गया है नए Kotlin एनोटेशन और नए androidx वैरिएंट, दोनों के साथ काम करते हैं. (I52495, b/151331381)
वर्शन 1.1.0-alpha01
22 जुलाई, 2020
androidx.annotation:annotation-experimental:1.1.0-alpha01
रिलीज़ हो गया है. वर्शन 1.1.0-alpha01 में ये कमियां हैं.
नई सुविधाएं
- एक्सपेरिमेंटल एनोटेशन लाइब्रेरी अब Kotlin में लिखी गई है, लेकिन इसे डिपेंडेंसी के तौर पर Kotlin स्टैंडर्ड लाइब्रेरी को शामिल करने की ज़रूरत नहीं है. इसमें एक ProGuard फ़ाइल होती है, जो सिर्फ़ Java प्रोग्रामिंग भाषा का इस्तेमाल करने वाले प्रोजेक्ट से Kotlin मेटाडेटा को हटाने की अनुमति देती है.
@UseExperimental
अब एक से ज़्यादा मार्कर क्लास (aosp/1185577, b/145137892) के साथ काम करता है
एनोटेशन-प्रयोग वर्शन 1.0.0
एनोटेशन-प्रयोग वर्शन 1.0.0
7 नवंबर, 2019
androidx.annotation:annotation-experimental:1.0.0
और androidx.annotation:annotation-experimental-lint:1.0.0
को 1.0.0-rc01
से रिलीज़ किया गया है. इसमें कोई बदलाव नहीं किया गया है. वर्शन 1.0.0 में ये कमियां शामिल हैं.
1.0.0 की मुख्य सुविधाएं
- Java सोर्स कोड में, Kotlin
@Experimental
सिमेंटिक्स को लिंट पर आधारित लागू करना - ऐसे Java एनोटेशन जो Kotlin के
@Experimental
और@UseExperimental
एनोटेशन की तरह ही काम करते हैं, वह भी Kotlin पर निर्भरता की ज़रूरत के बिना
एनोटेशन-प्रयोग वाला वर्शन 1.0.0-rc01
23 अक्टूबर, 2019
androidx.annotation:annotation-experimental:1.0.0-rc01
और androidx.annotation:annotation-experimental-lint:1.0.0-rc01
रिलीज़ हुई हैं. वर्शन 1.0.0-rc01 में ये कमियां शामिल हैं.
आम समस्याएं
Studio 3.5 स्टेबल का इस्तेमाल करते समय, @Experimental
के इस्तेमाल के लिंट डिटेक्टर से मिली चेतावनियां, Kotlin @Experimental
एनोटेशन के अमान्य Java इस्तेमाल के लिए IDE में नहीं दिखती हैं. b/140640322 देखें.
एनोटेशन-प्रयोग वर्शन 1.0.0-beta01
9 अक्टूबर, 2019
androidx.annotation:annotation-experimental:1.0.0-beta01
और androidx.annotation:annotation-experimental-lint:1.0.0-beta01
रिलीज़ किए गए हैं. इनमें 1.0.0-alpha01
के बाद से कोई बदलाव नहीं किया गया है. वर्शन 1.0.0-beta01 में ये कमियां शामिल हैं.
एनोटेशन-प्रयोग वर्शन 1.0.0-alpha01
18 सितंबर, 2019
androidx.annotation:annotation-experimental:1.0.0-alpha01
और androidx.annotation:annotation-experimental-lint:1.0.0-alpha01
रिलीज़ हुई हैं. एक्सपेरिमेंट के तौर पर शुरू किए गए 1.0.0-alpha01
में शामिल किए गए वचन और ये एक्सपेरिमेंट-एक्सपेरिमेंट-लिंट में शामिल किए गए टिप 1.0.0-alpha01
हैं
नई सुविधाएं
Jetpack एक्सपेरिमेंटल एनोटेशन लाइब्रेरी में, Kotlin के एक्सपेरिमेंट वाले एपीआई मार्कर को Java के साथ काम करने लायक लागू किया जाता है.
-lint
आर्टफ़ैक्ट, प्रयोग के तौर पर इस्तेमाल से जुड़ी पाबंदियों के लिए, लिंट पर आधारित लागू करता है. साथ ही, Kotlin के नेटिव एक्सपेरिमेंटल एपीआई मार्कर के Java के इस्तेमाल पर पाबंदियां लागू करता है.annotation-experimental
आर्टफ़ैक्ट को डिपेंडेंसी के तौर पर इस्तेमाल करने पर,annotation-experimental-lint
आर्टफ़ैक्ट से मिले Lit के नियम अपने-आप लागू हो जाएंगे.
वर्शन 1.1.0
वर्शन 1.1.0
5 जून, 2019
androidx.annotation:annotation:1.1.0
को 1.1.0-rc01 में किसी बदलाव के बिना रिलीज़ किया गया है.
वर्शन 1.1.0-rc01
7 मई, 2019
androidx.annotation:annotation:1.1.0-rc01
को 1.1.0-beta01
के बिना किसी बदलाव के रिलीज़ किया गया. इस वर्शन में शामिल कमिट को यहां देखा जा सकता है.
वर्शन 1.1.0-beta01
3 अप्रैल, 2019
androidx.annotation:annotation:1.1.0-beta01
रिलीज़ हो गया है. इस वर्शन में शामिल कमिट को यहां देखा जा सकता है.
नई सुविधाएं
- Android 10 में जोड़े गए, व्यू की जांच करने वाले नए एपीआई के लिए नई
@InspectableProperty
एनोटेशन. यह जानकारी, व्यू या दूसरे यूज़र इंटरफ़ेस (यूआई) एलिमेंट पर गैटर पर लागू की जा सकती है. कोड जनरेट करने वाले टूल, इसका इस्तेमाल कंपैनियन ऑब्जेक्ट बनाने के लिए कर सकते हैं. ये ऐसे कंपैनियन ऑब्जेक्ट होते हैं जो प्रॉपर्टी के नाम और आईडी को, प्रॉपर्टी की वैल्यू पर एट्रिब्यूट करते हैं. ऐसा, रिफ़्लेक्शन के ओवरहेड के बिना किया जाता है.
एपीआई में किए गए बदलाव
- शुरुआती बदलाव:
@ContentView
को कंस्ट्रक्टर की जानकारी में बदल दिया गया है और@LayoutRes
वैल्यू को हटा दिया गया है. जिन क्लास को@ContentView
एनोटेशन के साथ काम करना है उन्हें यह एनोटेशन ऐसे कंस्ट्रक्टर से जोड़ना चाहिए जो@LayoutRes int
पैरामीटर लेता है. इससे, लाइब्रेरी मॉड्यूल में इस एनोटेशन का इस्तेमाल करने पर आने वाली समस्या ठीक हो जाती है. (b/128352521)
वर्शन 1.1.0-alpha02
13 मार्च, 2019
androidx.annotation:annotation:1.1.0-alpha02
रिलीज़ हो गया है. किराये की पूरी सूची
इस वर्शन में यहां बताया गया है.
नई सुविधाएं
- एपीआई पर लगाई गई नई पाबंदी का दायरा:
RestrictTo.Scope.LIBRARY_GROUP_PREFIX
. यह जिन पैकेज के ग्रुप एक ही लाइब्रेरी शेयर करते हैं उनमें कोड के इस्तेमाल पर पाबंदी लगाता है पिछली.
(पीरियड) तक समूह उपसर्ग. उदाहरण के लिए, क्योंकि लाइब्रेरीfoo.bar:lib1
औरfoo.baz:lib2
प्रीफ़िक्सfoo
शेयर करते हैं, वे एक-दूसरे के एपीआई इस्तेमाल कर सकते हैं जो इस दायरे तक सीमित हैं. इसी तरह,com.foo.bar:lib1
औरcom.foo.baz:lib2
,com.foo.
प्रीफ़िक्स शेयर करता है. साथ ही, वह सिर्फ़ इन एपीआई को शेयर कर सकता है उस दायरे में नहीं आते. हालांकि लाइब्रेरीcom.bar.qux:lib3
का उपयोग नहीं कर पाएगा प्रतिबंधित एपीआई, क्योंकि यह सिर्फ़com.
प्रीफ़िक्स शेयर करता है, बिलकुल नहीं आखिरी.
(पीरियड) तक.
वर्शन 1.1.0-alpha01
30 जनवरी, 2019
androidx.annotation:annotation 1.1.0-alpha01
रिलीज़ हो गया है.
नई सुविधाएं
- एक
@ContentView
एनोटेशन जोड़ा गया है. इससे यह बताया जा सकता है कि कौनसी लेआउट एक्सएमएल फ़ाइल को इनफ़्लेट किया जाना चाहिए. इसका इस्तेमालComponentActivity
में,1.0.0-alpha04
औरFragment
की1.1.0-alpha04
रिलीज़ में किया जा सकता है. ऐसाsetContentView()
या मौजूदाonCreateView()
का इस्तेमाल करने के विकल्प के तौर पर किया जा सकता है. (aosp/837619)
वर्शन 1.0.2
वर्शन 1.0.2
25 फ़रवरी, 2019
androidx.annotation:annotation 1.0.2
रिलीज़ हो गया है.
गड़बड़ियां ठीक की गईं
- जार में एम्बेड किए गए R8/ProGuard नियमों को ठीक करें. ये
androidx.annotation
के बजाय, गलत तरीके से पुरानेandroid.support.annotation
टाइप का रेफ़रंस दे रहे थे. ध्यान दें: इससे आपके बिल्ड पर सिर्फ़ तब असर पड़ेगा, जब आपgetDefaultProguardFile
का इस्तेमाल नहीं कर रहे होंगे, क्योंकि उन डिफ़ॉल्ट नियमों में दोनों पैकेज के लिए सही नियम भी शामिल थे. (aosp/891685) - ऐसा R8/ProGuard नियम जोड़ें, जो साफ़ तौर पर @Keep एनोटेशन को बनाए रखता है. इससे यह पक्का होता है कि ProGuard किसी एनोटेशन को उसके सिमेंटिक्स का पालन करने से पहले टाइप से नहीं हटाता है. ध्यान दें: इससे आपके बिल्ड पर सिर्फ़ तब असर पड़ेगा, जब आप
getDefaultProguardFile
का इस्तेमाल नहीं कर रहे होंगे, क्योंकि उन डिफ़ॉल्ट नियमों में दोनों पैकेज के लिए सही नियम भी शामिल थे. (aosp/903818)