تعليق توضيحي

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

تحديد الاعتماديات

لإضافة اعتمادية على 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.5.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.5.1")
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 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 Multiplatform التالية: 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. لا يتضمّن الإصدار 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 Multiplatform: 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 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 Native Targets (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 هذه التعديلات.

• تم تفعيل ميزة "التعليقات التوضيحية" في الإصدار التجريبي 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 في الموقع الإلكتروني. نتيجةً لذلك، أصبحت مكتبة Annotation تعتمد الآن على مكتبة Kotlin العادية.
• @ReturnThis (b/140249763): يضمن هذا الرمز أنّه يجب أن تعرض طرق تجاوز هذه الطريقة المثيل نفسه (مخصّصًا لأدوات الإنشاء وما إلى ذلك)
• ‫@OpenForTesting (b/141539024): يمكن إضافة هذه التعليقات التوضيحية إلى فئات Kotlin وطُرقها التي تم وضع علامة "open" عليها، وسيتأكّد 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 وطُرقها التي تم وضع علامة "open" عليها، وسيتأكّد 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 من النافذة المنبثقة لمستندات "استوديو Android" (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)

Annotation-Experimental Version 1.6

الإصدار 1.6.0-alpha01

‫22 أكتوبر 2025

تم طرح androidx.annotation:annotation-experimental:1.6.0-alpha01. يتضمّن الإصدار 1.6.0-alpha01 هذه التعديلات.

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

• تتيح التعليق التوضيحي OptIn الآن استخدام الهدف ElementType.PARAMETER.

التعليقات التوضيحية - الإصدار التجريبي 1.5

الإصدار 1.5.1

‫16 يوليو 2025

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

الإصدار 1.5.0

‫7 مايو 2025

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

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

• تمت إضافة message إلى RequiresOptIn لتتطابق مع تعليق توضيحي في مكتبة Kotlin العادية يتضمّن قيمة سلسلة فارغة تلقائية. (I1f50e)
• تستهدف هذه المكتبة الآن مستوى لغة Kotlin 2.0 وتتطلّب الإصدار 2.0.0 أو إصدارًا أحدث من KGP. (Idb6b5)

الإصدار 1.5.0-rc01

‫23 أبريل 2025

تم طرح androidx.annotation:annotation-experimental:1.5.0-rc01. لا يتضمّن الإصدار 1.5.0-rc01 أي تغييرات منذ إصدار الإصدار التجريبي السابق، يمكنك الاطّلاع على التعديلات.

الإصدار 1.5.0-beta01

‫9 أبريل 2025

تم طرح androidx.annotation:annotation-experimental:1.5.0-beta01. يتضمّن الإصدار 1.5.0-beta01 هذه التعديلات.

التغييرات المهمة

• تستهدف هذه المكتبة الآن مستوى لغة Kotlin 2.0 وتتطلّب الإصدار 2.0.0 من KGP أو إصدارًا أحدث (Idb6b5).

الإصدار 1.5.0-alpha01

‫21 أغسطس 2024

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

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

• أضِف message إلى RequiresOptIn لمطابقة تعليق توضيحي في مكتبة Kotlin العادية مع قيمة السلسلة الفارغة التلقائية. (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 في الإصدار 1.4.0-dev01 من الإصدار التجريبي للمطوّرين من Kotlin متعدد المنصات.

Annotation-Experimental Version 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)
• تم نقل تبعية مكتبة Kotlin stdlib إلى النوع API بدلاً من النوع compile-only. وهذا يعني أنّ جميع برامج Annotation-Experimental ستتضمّن مكتبة Kotlin العادية في التبعيات المتعدّية.

الإصدار 1.3.0-rc01

‫24 أغسطس 2022

تم طرح androidx.annotation:annotation-experimental:1.3.0-rc01. يتضمّن الإصدار 1.3.0-rc01 هذه التعديلات.

• لم يتم إجراء أي تغييرات مقارنةً بالإصدار السابق. تم تجميد عملية التنفيذ لـ RC.

الإصدار 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)

Annotation-Experimental Version 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 هذه التعديلات.

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

تم الانتهاء من واجهات برمجة التطبيقات للإصدار التجريبي.

Annotation-Experimental Version 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)

Annotation-Experimental Version 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 من التعليق التوضيحي Experimental نهائيًا ليتوافق مع لغة Kotlin. تم استبدالها بمتغير androidx من التعليق التوضيحي RequiresOptIn، وتم تعديل أداة التدقيق اللغوي المتوافقة مع 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)

Annotation-Experimental Version 1.0.0

Annotation-Experimental Version 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

• فرض دلالات Kotlin @Experimental المستندة إلى Lint في رمز المصدر Java
• تعليقات Java التوضيحية التي توفّر سلوكًا مكافئًا للتعليقات التوضيحية @Experimental و@UseExperimental في Kotlin بدون الحاجة إلى الاعتماد على Kotlin

Annotation-Experimental Version 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 من "استوديو Android"، لا يتم عرض التحذيرات من أداة فحص @Experimental في بيئة التطوير المتكاملة (IDE) لحالات استخدام Java غير الصالحة لتعليق توضيحي @Experimental في Kotlin. يُرجى الاطّلاع على b/140640322.

Annotation-Experimental Version 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 هذه التعديلات.

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