تعليق توضيحي

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

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
تعليق توضيحي 1.9.1 - - -
annotation-experimental 1.5.1 - - -
تم إجراء آخر تعديل على هذه المكتبة في: 16 يوليو 2025

تعريف التبعيات

لإضافة تبعية على 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"
}

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.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 على عمليات الدمج هذه.

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

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

  • تم تفعيل ميزة "التعليقات التوضيحية" في الإصدار التجريبي 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 من النافذة المنبثقة لمستندات "استوديو YouTube" (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.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)

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

  • لم يتم إجراء أي تغييرات مقارنةً بالإصدار السابق. تم تجميد عملية التنفيذ لـ 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 للتصميم الذي يجب تضخيمه. تتوفّر هذه الميزة في الإصدار 1.0.0-alpha04 من ComponentActivity والإصدار 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)