एनोटेशन

इस टेबल में, androidx.annotation ग्रुप के सभी आर्टफ़ैक्ट की सूची होती है.

डिपेंडेंसी का एलान करना

एनोटेशन पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.

अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:

dependencies {
    implementation "androidx.annotation:annotation:1.9.1"
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation "androidx.annotation:annotation-experimental:1.4.1"
}

dependencies {
    implementation("androidx.annotation:annotation:1.9.1")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.

सुझाव/राय दें या शिकायत करें

आपके सुझाव, शिकायत या राय से हमें Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या इस लाइब्रेरी को बेहतर बनाने के लिए आपके पास कोई सुझाव है, तो हमें बताएं. नई लाइब्रेरी बनाने से पहले, कृपया इस लाइब्रेरी में मौजूद मौजूदा समस्याओं पर एक नज़र डालें. किसी मौजूदा समस्या पर अपना वोट जोड़ने के लिए, स्टार बटन पर क्लिक करें.

नई समस्या बनाना

ज़्यादा जानकारी के लिए, समस्या ट्रैकर का दस्तावेज़ देखें.

वर्शन 1.9

वर्शन 1.9.1

30 अक्टूबर, 2024

androidx.annotation:annotation-*:1.9.1 रिलीज़ हो गया है. वर्शन 1.9.1 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

• JS टारगेट प्लैटफ़ॉर्म जोड़ा गया. (I2310b)
• Kotlin वर्शन को 1.9 (I1a14c) पर अपडेट किया गया

वर्शन 1.9.0

16 अक्टूबर, 2024

androidx.annotation:annotation-*:1.9.0 रिलीज़ हो गया है. वर्शन 1.9.0 में ये कमिट शामिल हैं.

1.8.0 के बाद किए गए ज़रूरी बदलाव

• Kotlin के इन मल्टीप्लैटफ़ॉर्म टारगेट के लिए सहायता जोड़ी गई है: watchosDeviceArm64, mingwX64, linuxArm64.

वर्शन 1.9.0-rc01

2 अक्टूबर, 2024

androidx.annotation:annotation-*:1.9.0-rc01 रिलीज़ हो गया है. पिछले बीटा वर्शन के बाद, 1.9.0-rc01 वर्शन में कोई बदलाव नहीं हुआ है.

वर्शन 1.9.0-beta01

18 सितंबर, 2024

androidx.annotation:annotation-*:1.9.0-beta01 रिलीज़ हो गया है. वर्शन 1.9.0-beta01 में ये कमिट शामिल हैं.

एपीआई में हुए बदलाव

• watchosDeviceArm64 प्लैटफ़ॉर्म टारगेट (I1cc04, b/364652024) के लिए सहायता जोड़ता है

वर्शन 1.9.0-alpha03

4 सितंबर, 2024

androidx.annotation:annotation-*:1.9.0-alpha03 रिलीज़ हो गया है. पिछले alpha वर्शन के बाद, 1.9.0-alpha03 वर्शन में कोई बदलाव नहीं हुआ है.

वर्शन 1.9.0-alpha02

21 अगस्त, 2024

androidx.annotation:annotation-*:1.9.0-alpha02 रिलीज़ हो गया है. वर्शन 1.9.0-alpha02 में ये कमिट शामिल हैं.

नई सुविधाएं

• mingwX64 प्लैटफ़ॉर्म (I461ca, b/349894318) के लिए सहायता जोड़ना
• linuxArm64 Kotlin के मल्टी-प्लैटफ़ॉर्म टारगेट के लिए सहायता जोड़ें. (I139d3, b/338268719)

वर्शन 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 Multiplatform आर्टफ़ैक्ट शामिल हैं.
• अब 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 POM पब्लिकेशन में अब डिफ़ॉल्ट JVM-टारगेट किए गए मल्टीप्लैटफ़ॉर्म आर्टफ़ैक्ट को डिपेंडेंसी के तौर पर शामिल किया गया है

वर्शन 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 Multiplatform आर्टफ़ैक्ट शामिल हैं.
• अब 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 के बाद किए गए अहम बदलाव

• @RequiresExtension एनोटेशन जोड़ता है, ताकि यह बताया जा सके कि किसी एपीआई को किसी खास एक्सटेंशन SDK टूल (I5e4fe) के किसी खास वर्शन की ज़रूरत है
• Kotlin Multiplatform टूलचेन (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 के मल्टी-प्लैटफ़ॉर्म वर्शन को चालू किया गया है.

नई सुविधाएं

• @RequiresExtension एनोटेशन जोड़ता है, ताकि यह बताया जा सके कि किसी एपीआई को किसी खास एक्सटेंशन SDK टूल के किसी खास वर्शन की ज़रूरत है. (I5e4fe)
• Kotlin Multiplatform टूलचेन (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): "open" के तौर पर मार्क की गई Kotlin क्लास और तरीकों को इस एनोटेशन से एनोटेट किया जा सकता है. साथ ही, lint यह पक्का करेगा कि यूनिट टेस्ट से इस क्लास को सिर्फ़ सब-क्लास किया गया हो और तरीकों को सिर्फ़ बदला गया हो
• @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): "open" के तौर पर मार्क की गई Kotlin क्लास और तरीकों को इस एनोटेशन से एनोटेट किया जा सकता है. साथ ही, lint यह पक्का करेगा कि यूनिट टेस्ट से इस क्लास को सिर्फ़ सब-क्लास किया गया हो (और तरीकों को सिर्फ़ बदला गया हो)

• @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 वर्शन में ये बदलाव शामिल हैं.

1.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 के दस्तावेज़ों के पॉप-अप से RestrictTo एनोटेशन को दिखाना (Ie8e1a, b/183134648)

गड़बड़ियां ठीक की गईं

• सामान्य कॉन्टेक्स्ट को मार्क करने के लिए, कॉन्टेक्स्ट एनोटेशन जोड़ें, ताकि डेवलपर नए एपीआई पर आसानी से माइग्रेट कर सकें. (Ie581a)

वर्शन 1.3.0-alpha01

24 मार्च, 2021

androidx.annotation:annotation:1.3.0-alpha01 रिलीज़ हो गया है. 1.3.0-alpha01 वर्शन में ये बदलाव शामिल हैं.

एपीआई में हुए बदलाव

• androidx.resourceinspection में @InspectableProperty के बजाय @Attribute का इस्तेमाल किया गया. (Ic0eff)
• पूर्णांक में पैक की गई गुरुत्वाकर्षण वैल्यू वाले एलिमेंट को मार्क करने के लिए, @GravityInt एनोटेशन जोड़ा गया. (Ifcaa4, b/180620048)

एनोटेशन-प्रयोग के तौर पर उपलब्ध वर्शन 1.5

वर्शन 1.5.0-beta01

9 अप्रैल, 2025

androidx.annotation:annotation-experimental:1.5.0-beta01 रिलीज़ हो गया है. वर्शन 1.5.0-beta01 में ये कमिट शामिल हैं.

ज़रूरी बदलाव

• यह लाइब्रेरी अब Kotlin 2.0 लैंग्वेज लेवल को टारगेट करती है. इसके लिए, KGP 2.0.0 या इसके बाद के वर्शन (Idb6b5) की ज़रूरत होती है

वर्शन 1.5.0-alpha01

21 अगस्त, 2024

androidx.annotation:annotation-experimental:1.5.0-alpha01 रिलीज़ हो गया है. वर्शन 1.5.0-alpha01 में ये कमिट शामिल हैं.

एपीआई में हुए बदलाव

• Kotlin स्टैंडर्ड लाइब्रेरी के एनोटेशन को डिफ़ॉल्ट खाली स्ट्रिंग वैल्यू से मैच करने के लिए, RequiresOptIn में message जोड़ें. (I1f50e)

एनोटेशन-एक्सपेरिमेंटल वर्शन 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 प्रॉपर्टी के Java इस्तेमाल के लिए चेतावनियां दिखाना (I8bd43)
• 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 से जुड़ी समस्या को हल करने के लिए, क्लास-लेवल पर गड़बड़ी को अपने-आप ठीक करने के सुझावों को कुछ समय के लिए हटा दिया गया है. (Id98b2)
• एक्सपेरिमेंट के तौर पर एनोटेट की गई Kotlin प्रॉपर्टी के Java इस्तेमाल के लिए चेतावनियां दिखाना (I8bd43)
• 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 वर्शन में ये बदलाव शामिल हैं.

1.2.0 के बाद किए गए अहम बदलाव

• @androidx.annotation.OptIn के पैकेज-लेवल के इस्तेमाल के लिए सहायता जोड़ना (I24d58)
• Kotlin stdlib की डिपेंडेंसी को, सिर्फ़ कंपाइल करने के बजाय एपीआई-टाइप पर ले जाया गया. इसका मतलब है कि Annotation-Experimental लाइब्रेरी के सभी क्लाइंट, अपनी ट्रांज़िशन डिपेंडेंसी में 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 वर्शन में ये बदलाव शामिल हैं.

एपीआई में हुए बदलाव

• Kotlin के साथ समानता देने के लिए, एक्सपेरिमेंटल एनोटेशन के androidx वैरिएंट का इस्तेमाल बंद कर दिया गया है. इसे RequiresOptIn एनोटेशन के androidx वैरिएंट से बदल दिया गया है. साथ ही, 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 के सेमेंटेक्स को लागू करने के लिए, Lint का इस्तेमाल करना
• 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 के स्टेबल वर्शन का इस्तेमाल करने पर, Kotlin @Experimental एनोटेशन के गलत Java इस्तेमाल के लिए, @Experimental के इस्तेमाल से जुड़े लिंट डिटेक्टर की चेतावनियां IDE में नहीं दिखती हैं. b/140640322 देखें.

एनोटेशन-एक्सपेरिमेंटल वर्शन 1.0.0-beta01

9 अक्टूबर, 2019

1.0.0-alpha01 वर्शन के बाद, androidx.annotation:annotation-experimental:1.0.0-beta01 और androidx.annotation:annotation-experimental-lint:1.0.0-beta01 वर्शन में कोई बदलाव नहीं किया गया है. 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 रिलीज़ हो गए हैं. ये annotation-experimental 1.0.0-alpha01 में शामिल कमिट हैं और ये annotation-experimental-lint 1.0.0-alpha01 में शामिल कमिट हैं

नई सुविधाएं

• Jetpack की एक्सपेरिमेंटल एनोटेशन लाइब्रेरी, Kotlin के एक्सपेरिमेंटल एपीआई मार्कर को Java के साथ काम करने वाला बनाती है. -lint आर्टफ़ैक्ट, एक्सपेरिमेंट के तौर पर इस्तेमाल की जा रही सुविधाओं के इस्तेमाल पर पाबंदियों को लागू करने के लिए, Lint का इस्तेमाल करता है. साथ ही, Kotlin के नेटिव एक्सपेरिमेंटल एपीआई मार्कर के Java इस्तेमाल पर पाबंदियां लगाता है.

• annotation-experimental आर्टफ़ैक्ट को डिपेंडेंसी के तौर पर इस्तेमाल करने पर, annotation-experimental-lint आर्टफ़ैक्ट से मिले Lint नियम अपने-आप लागू हो जाएंगे.

वर्शन 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 रिलीज़ हो गया है.

गड़बड़ियां ठीक की गईं

• jar में एम्बेड किए गए R8/ProGuard नियमों को ठीक करें. ये androidx.annotation के बजाय, पुराने android.support.annotation टाइप का गलत तरीके से रेफ़रंस दे रहे थे. ध्यान दें: अगर getDefaultProguardFile का इस्तेमाल नहीं किया जा रहा था, तो इसका असर सिर्फ़ आपके बिल्ड पर पड़ता. इसकी वजह यह है कि उन डिफ़ॉल्ट नियमों में, दोनों पैकेज के लिए सही नियम भी शामिल थे. (aosp/891685)
• R8/ProGuard का ऐसा नियम जोड़ें जो @Keep एनोटेशन को साफ़ तौर पर बनाए रखता हो. इससे यह पक्का होता है कि ProGuard, अपने सेमेटिक्स को लागू करने से पहले, टाइप से एनोटेशन को न हटाए. ध्यान दें: अगर getDefaultProguardFile का इस्तेमाल नहीं किया जा रहा था, तो इसका असर सिर्फ़ आपके बिल्ड पर पड़ता. इसकी वजह यह है कि उन डिफ़ॉल्ट नियमों में, दोनों पैकेज के लिए सही नियम भी शामिल थे. (aosp/903818)