تعليق توضيحي

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

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

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

أضِف الملحقات التابعة للعناصر التي تحتاجها في ملف 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.0-alpha03

4 سبتمبر 2024

تم طرح androidx.annotation:annotation-*:1.9.0-alpha03. لا يحتوي الإصدار 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 متعدد الأنظمة الأساسية (بفضل Jake Wharton!)

الإصدار 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 مستقرًا الآن مع واجهة برمجة التطبيقات، ولكن لم يتم بعد شحن أداة فحص Lint المرتبط بالإصلاح التلقائي.

الإصدار 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 المتعددة المنصات التي تستهدف أنظمة التشغيل 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 المتعددة المنصات التي تستهدف أنظمة التشغيل 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 والطرق التي تم وضع علامة "مفتوحة" عليها وإضافة تعليقات توضيحية إليه، وستتأكد أداة 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): فئات 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.5

الإصدار 1.5.0-alpha01

21 آب (أغسطس) 2024

تم طرح androidx.annotation:annotation-experimental:1.5.0-alpha01. يحتوي الإصدار 1.5.0-alpha01 على عمليات التنفيذ هذه.

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

• أضِف message إلى RequiresOptIn لمطابقة التعليق التوضيحي Kotlin stdlib مع القيمة التلقائية لسلسلة فارغة. (I1f50e)

التعليق التوضيحي - الإصدار التجريبي 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
• إصلاح التوافق مع الإصدار 2.0 من Kotlin
• عرض تحذيرات بشأن استخدامات 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)
• استخدام أداة "التحقّق من أداة Lint" لمنع استخدام 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)
• تم نقل تبعية 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) وإكمال فحص أداة Lint 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 من التعليق التوضيحي يتطلب OptIn، وتم تحديث 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

• التنفيذ المستند إلى أداة Lint لدلالات @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 من Studio 3.5، لا يتم عرض التحذيرات من أداة رصد أداة Lint الاستخدام في @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-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 تنفيذًا متوافقًا مع 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)