تعليق

يعرض هذا الجدول جميع العناصر في مجموعة androidx.annotation.

إعلان التبعيات

لإضافة تبعية إلى Annotation، يجب إضافة مستودع Google Maven إلى مشروعك. لمزيد من المعلومات، يمكنك الاطّلاع على مستودع Maven من Google.

أضف التبعيات للعناصر التي تحتاجها في ملف build.gradle لتطبيقك أو الوحدة الخاصة بك:

dependencies {
    implementation "androidx.annotation:annotation:1.7.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.7.1")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

لمزيد من المعلومات حول التبعيات، انظر إضافة تبعيات الإصدار.

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إخبارنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء عدد جديد

راجِع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

الإصدار 1.8

الإصدار 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-الإصدار التجريبي 01 على هذه الالتزامات.

الميزات الجديدة

• أصبح التعليق التوضيحي 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

• وتشمل عناصر Kotlin Multiplatform التي تستهدف أنظمة iOS وLinux وMacOS.
• يمكنك الآن استخدام التعليقات التوضيحية في مشاريع 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".

إصلاح الأخطاء

• تمت إزالة قيود التبعية من عناصر Maven لحل مشكلة إنشاء في أهداف Kotlin الأصلية (b/274786186، KT-57531).

الإصدار 1.7.0-alpha01

22 آذار (مارس) 2023

تم طرح "androidx.annotation:annotation-*:1.7.0-alpha01". يتضمّن الإصدار 1.7.0-alpha01 هذه الالتزامات.

الميزات الجديدة

• وتشمل عناصر Kotlin Multiplatform التي تستهدف أنظمة iOS وLinux وMacOS.
• يمكنك الآن استخدام التعليقات التوضيحية في مشاريع 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 هذه الالتزامات.

• وقد فعّلت ميزة "التعليقات التوضيحية" الأنظمة الأساسية المتعددة في Kotlin لمعاينة الإصدار 1.6.0-dev01 من المطوّرين.

الميزات الجديدة

• تضيف هذه السياسة تعليق @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): يمكن إضافة تعليقات توضيحية إلى فئات Kotlin والطرق التي تم وضع علامة "مفتوحة" عليها باستخدام هذا التعليق التوضيحي، وسيتأكد Linux من أنّ هذه الفئة يتم تصنيفها كفئة فرعية فقط (ويتم إلغاء الطُرق فقط) من اختبارات الوحدات.
• @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 والطرق التي تم وضع علامة "مفتوح" عليها باستخدام هذا التعليق التوضيحي، وسيتأكد برنامج 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 لوضع علامات على العناصر التي تتضمن قيم الجاذبية مع تجميعها في أعداد صحيحة
• تم إيقاف "@InspectableProperty" لصالح "@Attribute" للحساب androidx.resourceinspection.

الإصدار 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)
• جعل التعليق التوضيحي RestrictTo مرئيًا من النافذة المنبثقة في "مستندات استوديو YouTube" (Ie8e1a، b/183134648)

إصلاح الأخطاء

• يمكنك إضافة التعليق التوضيحي للسياق لوضع علامة على السياقات العامة، ليتمكّن المطوّرون من الانتقال إلى واجهات برمجة تطبيقات جديدة بسهولة أكبر. (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 هذه الالتزامات.

إصلاح الأخطاء

• يجب إصلاح استخدام isKotlin لتجنُّب إجراء عملية تحقّق RequiresOptIn عن طريق الخطأ في ملفات Kotlin. (I2d8c1f)

الإصدار 1.4.0

24 كانون الثاني (يناير) 2024

تم طرح "androidx.annotation:annotation-experimental:1.4.0". يتضمّن الإصدار 1.4.0 هذه الالتزامات.

التغييرات المهمة منذ الإصدار 1.3.0

• إضافة دعم إلى منصات Kotlin المتعددة
• إصلاح التوافق مع Kotlin 2.0
• عرض تحذيرات لاستخدامات Java لخصائص Kotlin ذات التعليقات التوضيحية التجريبية (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)
• عرض تحذيرات لاستخدامات Java لخصائص Kotlin ذات التعليقات التوضيحية التجريبية (I8bd43)
• إصلاح موضع التعليق التوضيحي للإصلاح التلقائي في طرق Kotlin (Id7a41)

الإصدار 1.4.0-dev01

8 شباط (فبراير) 2023

تم طرح "androidx.annotation:annotation-experimental:1.4.0-dev01". يحتوي الإصدار 1.4.0-dev01 على هذه الالتزامات.

• فعّلت ميزة "Annotation-experimental" النظام الأساسي المتعدد لمنصات Kotlin لمعاينة الإصدار 1.4.0-dev01 من المطوّر.

الإصدار التجريبي 1.3.1

الإصدار 1.3.1

‫21 حزيران (يونيو) 2023

تم طرح "androidx.annotation:annotation-experimental:1.3.1". يتضمّن الإصدار 1.3.1 هذه الالتزامات.

إصلاح الأخطاء

• يمكنك وضع التعليق التوضيحي في بداية قائمة التعديل عند تطبيق الإصلاح التلقائي لأداة Lint. (b/251172715)
• استخدام فحص الوبر للثني عن استخدام androidx.annotation.RequiresOptIn في مصادر Kotlin (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-تجريبية سيدرجون مكتبة 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 لإتاحة فئات متعددة من العلامات ومعالجة محسّنة لعملية الإيقاف النهائي.
• تمت إضافة التعليقات التوضيحية RequiresOptIn وOptIn لتحقيق التكافؤ مع Kotlin، وتم إيقاف التعليقات التوضيحية 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. وقد تم استبداله بصيغة androidx للتعليق التوضيحي RequiresOptIn، وتم تحديث linter المواجه لـ 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 يسمح بإزالة بيانات Kotlin الوصفية غير الضرورية من المشروعات التي تستخدم لغة برمجة Java فقط.
• يتوافق @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

• فرض دلالات @Experimental بلغة Kotlin في رمز المصدر بلغة Java استنادًا إلى الوبر
• تعليقات Java التوضيحية التي توفر سلوكًا مماثلاً لتعليقات @Experimental و@UseExperimental التوضيحية في Kotlin بدون الحاجة إلى الاعتماد على 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 على هذه الالتزامات.

المشاكل المعروفة

عند استخدام الإصدار الثابت من استوديو 3.5، لا يتم عرض التحذيرات من أداة رصد الوبر في الاستخدام @Experimental في بيئة التطوير المتكاملة (IDE) لاستخدام Java غير صالح للتعليق التوضيحي @Experimental بلغة Kotlin. راجِع 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-الإصدار التجريبي 01 على هذه الالتزامات.

الإصدار التجريبي 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 عملية تنفيذ متوافقة مع Java لعلامات واجهة برمجة التطبيقات التجريبية في Kotlin. توفِّر أداة -lint عملية تنفيذ مستندة إلى Lint لقيود الاستخدام التجريبي وتفرض قيودًا على استخدامات Java لعلامات واجهة برمجة التطبيقات التجريبية الأصلية في Kotlin.

• عند استخدام عنصر annotation-experimental كتبعية، سيتم تلقائيًا فرض قواعد Lint التي يوفّرها العنصر annotation-experimental-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". يمكنك الاطّلاع هنا على العمولات التي تم تضمينها في هذا الإصدار.

الميزات الجديدة

• تعليق توضيحي @InspectablePropertyجديد لإتاحة واجهات برمجة التطبيقات الجديدة لفحص طرق العرض والتي تمت إضافتها في Android 10 يمكن تطبيق هذا التعليق التوضيحي على الأحرف في طرق العرض أو عناصر واجهة المستخدم الأخرى. يمكن أن تستخدِمه أدوات إنشاء الرموز لإنشاء عناصر مصاحبة تربط أسماء الخصائص ومعرِّفات السمات بقيم الخصائص بدون عبء الانعكاس.

التغييرات في واجهة برمجة التطبيقات

• تغيير قد يؤدي إلى عطل: تم تغيير @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 التوضيحي يسمح لك بالإشارة إلى تنسيق ملف XML الذي يجب تضخيمه. يتوفّر ذلك في 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 المضمنة في الوعاء. وكانت هذه الأخطاء تشير إلى أنواع android.support.annotation القديمة بدلاً من androidx.annotation. ملاحظة: في حال عدم استخدام getDefaultProguardFile، لن تؤثر هذه القواعد في إصدارَيك إلا إذا تضمّنت هذه القواعد التلقائية القواعد الصحيحة لكلتا الحِزمتَين. (aosp/891685)
• أضِف قاعدة R8/ProGuard التي تحتفظ بشكلٍ صريح بالتعليق التوضيحي @Keep نفسه. ويضمن ذلك ألّا يزيل ProGuard التعليق التوضيحي من الأنواع قبل استخدام دلالاته. ملاحظة: في حال عدم استخدام getDefaultProguardFile، لن تؤثر هذه القواعد في إصدارَيك إلا إذا تضمّنت هذه القواعد التلقائية القواعد الصحيحة لكلتا الحِزمتَين. (aosp/903818)