تعليق توضيحي
يعرض هذا الجدول كل العناصر في مجموعة androidx.annotation
.
العناصر | الإصدار المستقر | سحب المرشح | الإصدار التجريبي | إصدار أولي |
---|---|---|---|---|
تعليق توضيحي | 1.8.2 | - | - | 1.9.0-alpha03 |
تعليق توضيحي تجريبي | 1.4.1 | - | - | 1.5.0-alpha01 |
إعلان التبعيات
لإضافة تبعية إلى التعليقات التوضيحية، يجب إضافة مستودع Google Maven إلى مشروعك. الاطّلاع على مستودع Maven من Google لمزيد من المعلومات.
أضِف الملحقات التابعة للعناصر التي تحتاجها في ملف build.gradle
لـ
لتطبيقك أو الوحدة التي تستخدمها:
Groovy
dependencies { implementation "androidx.annotation:annotation:1.8.2" // 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.8.2") // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation("androidx.annotation:annotation-experimental:1.4.1") }
لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية عن طريق بالنقر فوق زر النجمة.
يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل. لمزيد من المعلومات.
الإصدار 1.9
الإصدار 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 على عمليات الالتزام هذه.
إصلاح الأخطاء
- إتاحة استخدام نظام
mingwX64
الأساسي (I461ca، b/349894318)
الإصدار 1.8.1
24 يوليو 2024
تم طرح androidx.annotation:annotation-*:1.8.1
. يحتوي الإصدار 1.8.1 على عمليات الالتزام هذه.
إصلاح الأخطاء
- تتضمّن أهدافًا إضافية للأنظمة الأساسية المتعدّدة بلغة Kotlin:
watchos
وtvos
.
الإصدار 1.8.0
14 مايو 2024
تم طرح androidx.annotation:annotation-*:1.8.0
. يحتوي الإصدار 1.8.0 على عمليات التنفيذ هذه.
تغييرات مهمة منذ الإصدار 1.7.0
- تمت إضافة التعليق التوضيحي
@ReplaceWith
للتعبير عن بدائل واجهات برمجة التطبيقات المتوقّفة. - تم نقل التعليق التوضيحي
@MainThread
إلى مجموعة المصادر الشائعة.
الإصدار 1.8.0-rc01
1 مايو 2024
تم طرح androidx.annotation:annotation-*:1.8.0-rc01
. لا يحتوي الإصدار 1.8.0-rc01 على أي تغييرات منذ الإصدار التجريبي السابق.
الإصدار 1.8.0-beta02
17 أبريل 2024
تم طرح androidx.annotation:annotation-*:1.8.0-beta02
. لا يحتوي الإصدار 1.8.0-beta02 على أي تغييرات منذ الإصدار السابق.
الإصدار 1.8.0-beta01
3 أبريل 2024
تم طرح androidx.annotation:annotation-*:1.8.0-beta01
. يحتوي الإصدار 1.8.0-beta01 على عمليات التنفيذ هذه.
الميزات الجديدة
- أصبح التعليق التوضيحي
ReplaceWith
مستقرًا الآن مع واجهة برمجة التطبيقات، ولكن لم يتم بعد شحن أداة فحص Lint المرتبط بالإصلاح التلقائي.
الإصدار 1.8.0-alpha02
20 مارس 2024
تم طرح androidx.annotation:annotation-*:1.8.0-alpha02
بدون أي تغييرات ملحوظة. يحتوي الإصدار 1.8.0-alpha02 على عمليات التنفيذ هذه.
الإصدار 1.8.0-alpha01
21 فبراير 2024
تم طرح androidx.annotation:annotation-*:1.8.0-alpha01
. يحتوي الإصدار 1.8.0-alpha01 على هذه عمليات التنفيذ.
التغييرات في واجهة برمجة التطبيقات
- تمت إضافة تعليق
@ReplaceWith
التوضيحي للتعبير عن بدائل واجهات برمجة التطبيقات المتوقّفة. (I38db3، b/322373864)
المساهمات الخارجية
- شكرا "إيفان ماتكوف" على نقل التعليق التوضيحي
@MainThread
إلى مجموعة المصادر الشائعة. (6f228c)
الإصدار 1.7
الإصدار 1.7.1
13 كانون الأول (ديسمبر) 2023
تم طرح androidx.annotation:annotation-*:1.7.1
. يحتوي الإصدار 1.7.1 على عمليات الالتزام هذه.
إصلاح الأخطاء
- استخدام نطاق
compile
عند إدراج التبعية التلقائية للنظام الأساسي (I4958f)
الإصدار 1.7.0
6 أيلول (سبتمبر) 2023
تم طرح androidx.annotation:annotation-*:1.7.0
. يحتوي الإصدار 1.7.0 على عمليات الالتزام هذه.
تغييرات مهمة منذ الإصدار 1.6.0
- يتضمن عناصر Kotlin المتعددة المنصات التي تستهدف أنظمة التشغيل 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 (b/274786186 وKT-57531).
الإصدار 1.7.0-alpha01
22 آذار (مارس) 2023
تم طرح androidx.annotation:annotation-*:1.7.0-alpha01
. يحتوي الإصدار 1.7.0-alpha01 على هذه عمليات التنفيذ.
الميزات الجديدة
- يتضمن عناصر Kotlin المتعددة المنصات التي تستهدف أنظمة التشغيل 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-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
- إصلاح التوافق مع الإصدار 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 في معاينة مطوري البرامج للإصدار 1.4.0-dev01.
التعليقات التوضيحية - الإصدار التجريبي 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) - تم نقل تبعية stdlib 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) وإكمال فحص أداة LintNewApi
. - تمت إضافة تعليق
@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 للتعليق التوضيحي التجريبي نهائيًا لتوفير التكافؤ مع Kotlin. تم استبداله بإصدار androidx من التعليق التوضيحي يتطلب OptIn، وتم تحديث linter المواجه لـ 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
- التنفيذ المستند إلى أداة Lint لدلالات
@Experimental
بلغة Kotlin في رمز المصدر في 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 من Studio 3.5، لا يتم عرض التحذيرات من أداة رصد أداة Lint الاستخدام في @Experimental
في بيئة التطوير المتكاملة (IDE) بشأن استخدامات Java غير الصالحة للتعليق التوضيحي @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
. هذه هي الالتزامات المضمَّنة في التعليقات التوضيحية التجريبية 1.0.0-alpha01
، وهذه هي الالتزامات المضمّنة في أداة "التعليق التوضيحي التجريبي" 1.0.0-alpha01
الميزات الجديدة
توفّر مكتبة التعليقات التوضيحية التجريبية Jetpack تنفيذًا متوافقًا مع Java لعلامات واجهة برمجة التطبيقات التجريبية في لغة Kotlin. يوفّر عنصر
-lint
تنفيذًا مستندًا إلى أداة Lint لقيود الاستخدام التجريبي، كما يفرض قيودًا على استخدامات Java لعلامات واجهة برمجة التطبيقات التجريبية الأصلية في Kotlin.عند استخدام عنصر
annotation-experimental
كملحق، سيتم تلقائيًا فرض قواعد Lint التي يوفّرها عنصرannotation-experimental-lint
.
الإصدار 1.1.0
الإصدار 1.1.0
5 حزيران (يونيو) 2019
تم طرح androidx.annotation:annotation:1.1.0
بدون أي تغييرات من 1.1.0-rc01.
الإصدار 1.1.0-rc01
7 أيار (مايو) 2019
تم طرح androidx.annotation:annotation:1.1.0-rc01
بدون أي تغييرات من 1.1.0-beta01
. يمكن الاطّلاع على صفقات الاشتراك المضمَّنة في هذا الإصدار هنا.
الإصدار 1.1.0-beta01
3 نيسان (أبريل) 2019
تم طرح androidx.annotation:annotation:1.1.0-beta01
. يمكن الاطّلاع على صفقات الاشتراك المضمَّنة في هذا الإصدار هنا.
الميزات الجديدة
- إضافة
@InspectableProperty
تعليق توضيحي جديد لدعم واجهات برمجة التطبيقات الجديدة لفحص طريقة العرض التي تمت إضافتها في Android 10 يمكن تطبيق هذا التعليق التوضيحي على التنبيهات في طرق العرض أو عناصر واجهة المستخدم الأخرى. ويمكن أن تستخدمها أدوات إنشاء الرموز لإنشاء عناصر مصاحبة تربط أسماء السمات ومعرّفات السمات بقيم المواقع بدون عبء الانعكاس.
التغييرات في واجهة برمجة التطبيقات
- تغيير قد يؤدي إلى عطل: تم تغيير
@ContentView
إلى تعليق توضيحي للدالة الإنشائية وتمت إزالة قيمة@LayoutRes
. أما الفئات التي تريد إتاحة تعليقات@ContentView
التوضيحية، فيجب أن تضيف هذا التعليق التوضيحي إلى دالة إنشاء تأخذ مَعلمة@LayoutRes int
. يساهم ذلك في حلّ المشكلة عند استخدام هذا التعليق التوضيحي في وحدات المكتبة. (b/128352521)
الإصدار 1.1.0-alpha02
13 آذار (مارس) 2019
تم طرح androidx.annotation:annotation:1.1.0-alpha02
. تشمل القائمة الكاملة لخطط الاشتراك
في هذا الإصدار يمكن العثور عليها هنا.
الميزات الجديدة
- نطاق التقييد الجديد لواجهة برمجة التطبيقات:
RestrictTo.Scope.LIBRARY_GROUP_PREFIX
. أُنشأها جون هنتر، الذي كان متخصصًا استخدام هذا الرمز البرمجي ضمن الحزم التي تشترك مجموعاتها في المكتبة نفسها بادئة المجموعة حتى آخر.
(نقطة). على سبيل المثال، نظرًا لأن المكتباتfoo.bar:lib1
يستخدمfoo.baz:lib2
البادئةfoo
، ويمكنهما استخدام واجهات برمجة التطبيقات لبعضهما البعض. التي تقتصر على هذا النطاق. وبالمثل، بالنسبة إلىcom.foo.bar:lib1
و يستخدمcom.foo.baz:lib2
البادئةcom.foo.
ويمكن مشاركة واجهات برمجة التطبيقات المحصورة بـ هذا النطاق. ولكن لن يكون بإمكان المكتبةcom.bar.qux:lib3
استخدام واجهة برمجة تطبيقات محدودة نظرًا لأنها تشارك البادئةcom.
فقط وليس حتى آخر.
(نقطة).
الإصدار 1.1.0-alpha01
30 كانون الثاني (يناير) 2019
تم طرح androidx.annotation:annotation 1.1.0-alpha01
.
الميزات الجديدة
- تمت إضافة تعليق توضيحي
@ContentView
يتيح لك تحديد ملف XML للتنسيق الذي يجب تضخيمه. يتوفّر هذا الخيار فيComponentActivity
في1.0.0-alpha04
وFragment
في إصدار1.1.0-alpha04
بدلاً من استخدامsetContentView()
أو إلغاءonCreateView()
على التوالي. (aosp/837619)
الإصدار 1.0.2
الإصدار 1.0.2
25 شباط (فبراير) 2019
تم طرح androidx.annotation:annotation 1.0.2
.
إصلاح الأخطاء
- صحِّح قواعد R8/ProGuard المضمَّنة في البرطمان. كانت هذه الأخطاء تشير بشكل غير صحيح إلى أنواع
android.support.annotation
القديمة بدلاً منandroidx.annotation
. ملاحظة: كان من كان لذلك تأثير في إصداراتك فقط في حال عدم استخدامgetDefaultProguardFile
لأنّ هذه القواعد التلقائية تتضمّن أيضًا قواعد صحيحة لكلتا الحِزمتَين. (aosp/891685) - أضف قاعدة R8/ProGuard التي تحتفظ صراحةً بالتعليق التوضيحي @Keep نفسه. ويضمن ذلك أنّ ProGuard لا يزيل التعليق التوضيحي من الأنواع قبل الالتزام بدلالاته فعليًا. ملاحظة: كان لذلك تأثير في إصداراتك فقط في حال عدم استخدام
getDefaultProguardFile
لأنّ هذه القواعد التلقائية تتضمّن أيضًا قواعد صحيحة لكلتا الحِزمتَين. (aosp/903818)