टिप्पणी

इस टेबल में, androidx.annotation ग्रुप के सभी आर्टफ़ैक्ट शामिल हैं.

डिपेंडेंसी तय करना

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

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

dependencies {
    implementation "androidx.annotation:annotation:1.8.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.8.1")
    // 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.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 के साथ समानता देने के लिए बंद किया गया है. इसे REQUIREOptIn एनोटेशन डालें. साथ ही, 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)