تعليق توضيحي

  
أظهِر البيانات الوصفية التي تساعد الأدوات والمطوّرين الآخرين في فهم رمز تطبيقك البرمجي.

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
تعليق توضيحي 1.9.1 - - -
annotation-experimental 1.4.1 - 1.5.0-beta01 -
تاريخ آخر تعديل على هذه المكتبة: 9 نيسان (أبريل) 2025

تحديد التبعيات

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

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

Groovy

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"
}

Kotlin

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.1

30 تشرين الأول (أكتوبر) 2024

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

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

  • تمت إضافة منصّة استهداف JavaScript. (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 هذه المراجعات.

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

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

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

الإصدار 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 الآن عنصرًا افتراضيًا مخصّصًا لنظام التشغيل Java Virtual Machine (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 وطُرقها التي تم وضع علامة "مفتوحة" عليها، وسيتأكّد 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-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 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 على أنظمة تشغيل متعددة
  • إصلاح مشكلة التوافق مع 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 على هذه المراجعات.

  • تم تفعيل لغة Kotlin المتوافقة مع أنظمة التشغيل المتعددة في الإصدار التجريبي 1.4.0-dev01 من أداة Annotation-experimental.

التعليق التوضيحي: الإصدار التجريبي 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 إلى نوع واجهة برمجة التطبيقات بدلاً من الاعتماد على عملية الترجمة فقط. وهذا يعني أنّ جميع عملاء مكتبة Annotation-Experimental سيضمّنون المكتبة العادية 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 من التعليق التوضيحي 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

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

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

عند استخدام الإصدار الثابت من Studio 3.5، لا يتم عرض التحذيرات الواردة من أداة فحص الأخطاء في استخدام @Experimental في IDE لحالات استخدام Java غير الصالحة لتعليق Kotlin التوضيحي @Experimental. يُرجى الاطّلاع على 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 تلقائيًا.

الإصدار 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 للتنسيق الذي يجب توسيعه. تتوفّر هذه الميزة في الإصدار 1.0.0-alpha04 من نظام التشغيل ComponentActivity والإصدار 1.1.0-alpha04 من نظام التشغيل Fragment كبديل لاستخدام 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)