تعليق توضيحي
يسرد هذا الجدول جميع العناصر في المجموعة androidx.annotation
.
العناصر | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار الأوّلي |
---|---|---|---|---|
تعليق توضيحي | 1.9.1 | - | - | - |
annotation-experimental | 1.5.1 | - | - | - |
تعريف التبعيات
لإضافة تبعية على 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 على عمليات الدمج هذه.
إصلاح الأخطاء
الإصدار 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
متوافقة الآن مع واجهة برمجة التطبيقات، ولكن لم يتم بعد طرح عملية التحقّق من الأخطاء المرتبطة بها مع الإصلاح التلقائي.
الإصدار 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)