تعليق توضيحي

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

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

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

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

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

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

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

الملاحظات

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

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

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

تعليق توضيحي

الإصدار 1.11

الإصدار 1.11.0

‫23 سبتمبر 2026

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

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

• السماح باستخدام التعليق التوضيحي @WorkerThread من مجموعات المصادر المشترَكة في Kotlin Multiplatform
• السماح بتطبيق التعليق التوضيحي @DoNotInline على الحقول
• تعديل قواعد الاحتفاظ بالسلسلة للسماح بتقليص العناصر التي تمّت إضافة تعليقات توضيحية إليها باستخدام @DoNotInline

الإصدار ‎1.11.0-rc01

‫9 سبتمبر 2026

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

الإصدار ‎1.11.0-alpha02

‫26 أغسطس 2026

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

الإصدار ‎1.11.0-alpha01

‫15 يوليو 2026

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

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

• السماح بتطبيق @DoNotInline على الحقول (I99120، b/521434897)

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

• أضِف allowshrinking إلى @DoNotInline حتى يمكن إزالة الطرق المشروحة إذا لم يكن من الممكن الوصول إلى الدالة. (Id2c8c)

الإصدار 1.10

الإصدار 1.10.0

‫8 أبريل 2026

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

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

• تمت إضافة علامة توضيح @RequiresFlag للإشارة إلى استخدامات واجهات برمجة التطبيقات غير الثابتة بعد لنظام Android الأساسي
• إزالة إمكانية استخدام استهدافات KMP x86 على أجهزة Apple

الإصدار ‎1.10.0-rc01

‫25 مارس 2026

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

الإصدار ‎1.10.0-alpha01

‫11 مارس 2026

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

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

• إيقاف إتاحة استهداف أجهزة Mac وiOS المستندة إلى x86 في KMP

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

• تمت إضافة التعليق التوضيحي RequiresFlag إلى الرمز الذي يجب أن يكون محميًا من خلال عمليات التحقّق من علامات الإصدار المسبق (I77bba، b/479114442)
• إضافة استهداف ANNOTATION_TYPE إلى RequiresApi وRequiresExtension (I0cb0d)
• تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5، b/344563182)
• تم تعديل سياسة الاحتفاظ بالبيانات في @Discouraged. (Id2f85، b/375937557)

الإصدار 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 multiplatform (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 الآن متوافقة مع واجهة برمجة التطبيقات، ولكن لم يتم طرح عملية التحقّق من الأخطاء المرتبطة بها باستخدام ميزة الإصلاح التلقائي بعد.

الإصدار ‎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 هذه التعديلات.

• تم تفعيل المنصّة المتعددة في 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. نتيجةً لذلك، تعتمد مكتبة Annotation الآن على مكتبة 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 من النافذة المنبثقة لمستندات Studio (Ie8e1a، b/183134648)

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

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

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

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

Annotation-Experimental

الإصدار 1.6

الإصدار 1.6.0

‫8 أبريل 2026

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

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

• إصلاحات لتوفير التوافق مع أحدث إصدار من أداة Android Lint في عمليات التحقّق المجمّعة من Lint

الإصدار 1.6.0-rc01

‫11 فبراير 2026

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

الإصدار ‎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 Multiplatform
• حلّ مشاكل التوافق مع الإصدار 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 Multiplatform في الإصدار 1.4.0-dev01 من معاينة المطوّرين.

الإصدار 1.3

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

‫7 أيلول (سبتمبر) 2022

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

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

• إتاحة استخدام @androidx.annotation.OptIn على مستوى الحزمة (I24d58)
• تم نقل اعتمادية مكتبة Kotlin العادية إلى النوع 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)

الإصدار 1.2

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

‫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

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

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

• فرض دلالات Kotlin @Experimental المستندة إلى Lint في رمز مصدر 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 من "استوديو Android"، لا يتم عرض التحذيرات من أداة فحص @Experimental في بيئة التطوير المتكاملة (IDE) لحالات الاستخدام غير الصالحة للتعليق التوضيحي @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. هذه هي عمليات الدمج المُضمَّنة في 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.