حاشیه نویسی
این جدول تمام مصنوعات موجود در گروه androidx.annotation
را فهرست می کند.
مصنوع | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
---|---|---|---|---|
حاشیه نویسی | 1.8.2 | - | - | 1.9.0-alpha03 |
حاشیه نویسی-تجربی | 1.4.1 | - | - | 1.5.0-alpha01 |
اعلام وابستگی ها
برای افزودن وابستگی به Annotation، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر ، مخزن Maven Google را بخوانید.
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle
برای برنامه یا ماژول خود اضافه کنید:
شیار
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" }
کاتلین
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 حاوی این commit ها است.
مشارکت خارجی
- پشتیبانی از هدف چند پلتفرمی
linuxArm64
را اضافه می کند (به لطف جیک وارتون!)
نسخه 1.8
نسخه 1.8.2
7 آگوست 2024
androidx.annotation:annotation-*:1.8.2
منتشر شد. نسخه 1.8.2 حاوی این commit ها است.
رفع اشکال
- افزودن پشتیبانی از پلتفرم
mingwX64
( I461ca , b/349894318 )
نسخه 1.8.1
24 جولای 2024
androidx.annotation:annotation-*:1.8.1
منتشر شد. نسخه 1.8.1 شامل این commit ها است.
رفع اشکال
- شامل اهداف مولتی پلتفرم اضافی Kotlin:
watchos
،tvos
.
نسخه 1.8.0
14 مه 2024
androidx.annotation:annotation-*:1.8.0
منتشر شد. نسخه 1.8.0 شامل این commit ها است.
تغییرات مهم از 1.7.0
- حاشیه نویسی
@ReplaceWith
برای بیان جایگزینی برای APIهای منسوخ شده اضافه شد - حاشیه نویسی
@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
اکنون در API پایدار است، اما بررسی پرز مرتبط با رفع خودکار هنوز ارسال نشده است
نسخه 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 حاوی این commit ها است.
تغییرات API
- حاشیه نویسی
@ReplaceWith
برای بیان جایگزینی برای APIهای منسوخ شده اضافه شد. ( I38db3 , b/322373864 )
مشارکت های خارجی
- از ایوان ماتکوف برای انتقال حاشیه نویسی
@MainThread
به مجموعه منبع مشترک سپاسگزاریم. ( 6f228c )
نسخه 1.7
نسخه 1.7.1
13 دسامبر 2023
androidx.annotation:annotation-*:1.7.1
منتشر شد. نسخه 1.7.1 حاوی این commit ها است.
رفع اشکال
- هنگام درج وابستگی پلت فرم پیش فرض، از دامنه
compile
استفاده کنید. ( I4958f )
نسخه 1.7.0
6 سپتامبر 2023
androidx.annotation:annotation-*:1.7.0
منتشر شد. نسخه 1.7.0 حاوی این commit ها است.
تغییرات مهم از 1.6.0
- شامل مصنوعات چند پلتفرمی Kotlin که پلتفرمهای iOS، Linux و MacOS را هدف قرار میدهند.
- اکنون می توانید از Annotations در پروژه های KMM استفاده کنید. توجه داشته باشید که اهداف غیر اندرویدی Annotations هنوز آزمایشی هستند، اما ما تصمیم گرفتیم نسخهها را ادغام کنیم تا توسعهدهندگان بتوانند آنها را راحتتر امتحان کنند. به طور خاص، برخی از حاشیه نویسی ها ممکن است در طول توسعه آلفا بین کد رایج و پلت فرم خاص حرکت کنند، زیرا مرزها را نهایی می کنیم.
نسخه 1.7.0-rc01
23 آگوست 2023
androidx.annotation:annotation-*:1.7.0-rc01
منتشر شد. نسخه 1.7.0-rc01 حاوی این commit ها است.
این نسخه هیچ تغییری نسبت به نسخه بتای قبلی ندارد.
نسخه 1.7.0-beta01
9 آگوست 2023
androidx.annotation:annotation-*:1.7.0-beta01
منتشر شد. نسخه 1.7.0-beta01 حاوی این تعهدات است.
ویژگی های جدید
- API های تثبیت شده برای انتشار
نسخه 1.7.0-alpha03
26 جولای 2023
androidx.annotation:annotation-*:1.7.0-alpha03
منتشر شد. نسخه 1.7.0-alpha03 حاوی این commit ها است.
رفع اشکال
- انتشارات 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 حاوی این commit ها است.
ویژگی های جدید
- شامل مصنوعات چند پلتفرمی Kotlin که پلتفرمهای iOS، Linux و MacOS را هدف قرار میدهند.
- اکنون می توانید از Annotations در پروژه های KMM استفاده کنید. توجه داشته باشید که اهداف غیر اندرویدی Annotations هنوز آزمایشی هستند، اما ما تصمیم گرفتیم نسخهها را ادغام کنیم تا توسعهدهندگان بتوانند آنها را راحتتر امتحان کنند. به طور خاص، برخی از حاشیه نویسی ها ممکن است در طول توسعه آلفا بین کد رایج و پلت فرم خاص حرکت کنند، زیرا مرزها را نهایی می کنیم.
نسخه 1.6
نسخه 1.6.0
22 فوریه 2023
androidx.annotation:annotation:1.6.0
و androidx.annotation:annotation-jvm:1.6.0
منتشر شدند. نسخه 1.6.0 حاوی این commit ها است.
تغییرات مهم از 1.5.0
- یک حاشیه نویسی
@RequiresExtension
اضافه می کند تا بیان کند که یک API به نسخه خاصی از یک SDK برنامه افزودنی خاص نیاز دارد ( I5e4fe ) - کتابخانه حاشیه نویسی تبدیل به ساخت با استفاده از زنجیره ابزار چند پلت فرم Kotlin ( 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 حاوی این commit ها است.
- حاشیه نویسی برای نامزد انتشار 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 حاوی این commit ها است.
نسخه 1.6.0-dev01
8 فوریه 2023
androidx.annotation:annotation-*:1.6.0-dev01
منتشر شد. نسخه 1.6.0-dev01 حاوی این commit ها است.
- Annotation چند پلتفرم Kotlin را برای پیش نمایش توسعه دهندگان 1.6.0-dev01 فعال کرده است.
ویژگی های جدید
- یک حاشیه نویسی
@RequiresExtension
اضافه می کند تا بیان کند که یک API به نسخه خاصی از یک SDK برنامه افزودنی خاص نیاز دارد. ( I5e4fe ) - کتابخانه حاشیه نویسی تبدیل به ساخت با استفاده از زنجیره ابزار چند پلت فرم Kotlin ( I3be8d )
نسخه 1.5.0
نسخه 1.5.0
21 سپتامبر 2022
androidx.annotation:annotation:1.5.0
منتشر شد. نسخه 1.5.0 حاوی این commit ها است.
تغییرات مهم از 1.4.0
- کتابخانه حاشیه نویسی به طور کامل به منابع Kotlin منتقل شده است، و در نتیجه از سایت های استفاده از هدف خاص Kotlin و سایر ویژگی های حاشیه نویسی سازگار با Kotlin پشتیبانی می شود.
نسخه 1.5.0-rc01
7 سپتامبر 2022
androidx.annotation:annotation:1.5.0-rc01
منتشر شد. نسخه 1.5.0-rc01 حاوی این commit ها است.
- هیچ تغییری نسبت به نسخه بتای قبلی 1.5.0 وجود ندارد.
نسخه 1.5.0-beta01
24 آگوست 2022
androidx.annotation:annotation:1.5.0-beta01
منتشر شد. نسخه 1.5.0-beta01 حاوی این تعهدات است.
- بدون تغییر نسبت به نسخه قبلی سطح API برای بتا ثابت شده است.
نسخه 1.5.0-alpha02
10 آگوست 2022
androidx.annotation:annotation:1.5.0-alpha02
منتشر شد. نسخه 1.5.0-alpha02 حاوی این commit ها است.
- هیچ تغییری نسبت به نسخه آلفا قبلی وجود ندارد.
نسخه 1.5.0-alpha01
27 جولای 2022
androidx.annotation:annotation:1.5.0-alpha01
منتشر شد. نسخه 1.5.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- کتابخانه حاشیه نویسی به طور کامل به منابع Kotlin منتقل شده است، و در نتیجه از سایت های استفاده از هدف خاص Kotlin و سایر ویژگی های حاشیه نویسی سازگار با Kotlin پشتیبانی می شود.
نسخه 1.4.0
نسخه 1.4.0
15 ژوئن 2022
androidx.annotation:annotation:1.4.0
منتشر شد. نسخه 1.4.0 حاوی این commit ها است.
تغییرات مهم از 1.3.0
-
@RestrictTo
به منابع Kotlin منتقل شده است و اکنون از سایت استفاده از@file
پشتیبانی می کند. در نتیجه، کتابخانه Annotation اکنون به کتابخانه استاندارد Kotlin وابسته است. -
@ReturnThis
(b/140249763): تضمین میکند که روشهای نادیده گرفته شده این روش باید همان نمونه را برگردانند (برای سازندگان و غیره) -
@OpenForTesting
(b/141539024): کلاسها و روشهای Kotlin با علامت «open» را میتوان با این حاشیهنویسی حاشیهنویسی کرد، و lint مطمئن میشود که این کلاس فقط زیر کلاس (و روشها فقط لغو) از تستهای واحد است. -
@DeprecatedSinceApi
(b/37116481): نشان میدهد که روش مشروح (یا کلاس یا فیلد) بخشی از یک کتابخانه پشتیبان برای یک API پلتفرم است که در سطح API داده شده دیگر به آن نیازی نیست. -
@EmptySuper
: نشان می دهد که این روش خالی تعریف شده است، بنابراین در هنگام بازخوانی نیازی به فراخوانی آن نیست (و در واقع نباید این کار را انجام دهید؛ به عنوان مثال، می تواند شامل بررسی سازگاری به عقب باشد.)
نسخه 1.4.0-rc01
1 ژوئن 2022
androidx.annotation:annotation:1.4.0-rc01
منتشر شد. نسخه 1.4.0-rc01 حاوی این commit ها است.
- سطح و عملکرد API برای انتشار نهایی شده است.
نسخه 1.4.0-beta01
18 مه 2022
androidx.annotation:annotation:1.4.0-beta01
منتشر شد. نسخه 1.4.0-beta01 حاوی این تعهدات است.
- از آخرین آلفا تغییری ایجاد نشده است. سطح API برای انتشار بتا قفل شده است.
نسخه 1.4.0-alpha02
9 فوریه 2022
androidx.annotation:annotation:1.4.0-alpha02
منتشر شد. نسخه 1.4.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
حاشیه نویسی
@ReturnThis
،@OpenForTesting
،@EmptySuper
و@DeprecatedSinceApi
اضافه شد. ( 21946a2 )@ReturnThis
( b/140249763 ): تضمین میکند که روشهای نادیده گرفته شده این روش باید همان نمونه را برگردانند (برای سازندگان و غیره)@OpenForTesting
( b/141539024 ): کلاسها و روشهای Kotlin با علامت «open» را میتوان با این حاشیهنویسی حاشیهنویسی کرد، و lint مطمئن میشود که این کلاس فقط زیر کلاس (و روشها فقط لغو) از آزمونهای واحد است.@DeprecatedSinceApi
( b/37116481 ): نشان میدهد که روش مشروح (یا کلاس یا فیلد) بخشی از یک کتابخانه پشتیبان برای یک API پلتفرم است که در سطح API دادهشده دیگر به آن نیازی نیست.@EmptySuper
: نشان می دهد که این روش خالی تعریف شده است، بنابراین در هنگام بازخوانی نیازی به فراخوانی آن نیست (و در واقع نباید این کار را انجام دهید؛ به عنوان مثال، می تواند شامل بررسی سازگاری به عقب باشد.)
نسخه 1.4.0-alpha01
15 دسامبر 2021
androidx.annotation:annotation:1.4.0-alpha01
منتشر شد. نسخه 1.4.0-alpha01 حاوی این commit ها است.
تغییرات API
- حاشیه نویسی
RestrictTo
به منابع Kotlin منتقل شد ( Ia6336 )
نسخه 1.3.0
نسخه 1.3.0
3 نوامبر 2021
androidx.annotation:annotation:1.3.0
منتشر شد. نسخه 1.3.0 حاوی این commit ها است.
تغییرات مهم از 1.2.0
- حاشیهنویسی
@Discouraged
برای علامتگذاری APIهایی که نمیتوان آنها را بهطور منطقی منسوخ کرد، اما تأثیر منفی قابلتوجهی بر عملکرد دارند و نباید در کد تولید عادی فراخوانی شوند. - حاشیه نویسی
@Context
برای علامت گذاری زمینه های عمومی به طوری که توسعه دهندگان بتوانند راحت تر به API های جدید مهاجرت کنند. - حاشیه نویسی
@GravityInt
برای علامت گذاری عناصر حاوی مقادیر گرانش به صورت اعداد صحیح - منسوخ شده
@InspectableProperty
به نفع@Attribute
برایandroidx.resourceinspection
نسخه 1.3.0-rc01
27 اکتبر 2021
androidx.annotation:annotation:1.3.0-rc01
منتشر شد. نسخه 1.3.0-rc01 حاوی این commit ها است.
نسخه 1.3.0-beta01
29 سپتامبر 2021
androidx.annotation:annotation:1.3.0-beta01
منتشر شد. نسخه 1.3.0-beta01 حاوی این تعهدات است.
تغییرات API
- نیاز به توضیح در "پیام" برای @Descouraged. ( I3390f )
- اضافه کردن حاشیهنویسی @Descouraged برای علامتگذاری عناصری که دلسرد شدهاند. ( Ib2549 )
- حاشیه نویسی RestrictTo را از پنجره بازشو اسناد استودیو قابل مشاهده کنید ( Ie8e1a , b/183134648 )
رفع اشکال
- حاشیهنویسی متن را برای علامتگذاری زمینههای عمومی اضافه کنید، تا توسعهدهندگان بتوانند راحتتر به APIهای جدید مهاجرت کنند. ( Ie581a )
نسخه 1.3.0-alpha01
24 مارس 2021
androidx.annotation:annotation:1.3.0-alpha01
منتشر شد. نسخه 1.3.0-alpha01 حاوی این commit ها است.
تغییرات API
-
@InspectableProperty
به نفع@Attribute
درandroidx.resourceinspection
منسوخ شد. ( IC0eff ) - حاشیه نویسی
@GravityInt
برای علامت گذاری عناصر حاوی مقادیر گرانش به صورت اعداد صحیح اضافه شده است. ( Ifcaa4 , b/180620048 )
Annotation-Experimental نسخه 1.5
نسخه 1.5.0-alpha01
21 آگوست 2024
androidx.annotation:annotation-experimental:1.5.0-alpha01
منتشر شد. نسخه 1.5.0-alpha01 حاوی این تعهدات است.
تغییرات API
- برای تطبیق حاشیه نویسی Kotlin stdlib با مقدار رشته خالی پیش فرض،
message
را بهRequiresOptIn
اضافه کنید. ( I1f50e )
Annotation-Experimental نسخه 1.4
نسخه 1.4.1
3 آوریل 2024
androidx.annotation:annotation-experimental:1.4.1
منتشر شد. نسخه 1.4.1 شامل این commit ها است.
رفع اشکال
- استفاده از
isKotlin
را اصلاح کنید تا از راهاندازی تصادفی بررسیRequiresOptIn
در فایلهای Kotlin جلوگیری کنید. ( I2d8c1f )
نسخه 1.4.0
24 ژانویه 2024
androidx.annotation:annotation-experimental:1.4.0
منتشر شد. نسخه 1.4.0 حاوی این commit ها است.
تغییرات مهم از 1.3.0
- پشتیبانی از چند پلتفرم Kotlin را اضافه کنید
- رفع سازگاری با Kotlin 2.0
- نمایش هشدارها برای استفاده جاوا از ویژگی های 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 حاوی این commit ها است.
رفع اشکال
- پیشنهادات رفع خودکار در سطح کلاس را موقتاً حذف کنید تا در اطراف b/301598518 کار کنید. ( ID98b2 )
- نمایش هشدارها برای استفاده جاوا از ویژگی های Kotlin مشروح تجربی ( I8bd43 )
- رفع قرار دادن حاشیه نویسی اصلاح خودکار در روش های Kotlin ( Id7a41 )
نسخه 1.4.0-dev01
8 فوریه 2023
androidx.annotation:annotation-experimental:1.4.0-dev01
منتشر شد. نسخه 1.4.0-dev01 حاوی این commit ها است.
- Annotation-experimental چند پلتفرم 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 حاوی این commit ها است.
رفع اشکال
- هنگام اعمال اصلاح خودکار پرز، حاشیه نویسی را در ابتدای لیست اصلاح کننده ها قرار دهید. ( b/251172715 )
- برای جلوگیری از استفاده از
androidx.annotation.RequiresOptIn
در منابع Kotlin از بررسی لینت استفاده کنید ( b/241097743 )
Annotation-Experimental نسخه 1.3.0
نسخه 1.3.0
7 سپتامبر 2022
androidx.annotation:annotation-experimental:1.3.0
منتشر شد. نسخه 1.3.0 حاوی این commit ها است.
تغییرات مهم از 1.2.0
- اضافه کردن پشتیبانی برای استفاده در سطح بسته از
@androidx.annotation.OptIn
( I24d58 ) - وابستگی Kotlin stdlib را به جای کامپایل به نوع API منتقل کرد. این بدان معنی است که همه مشتریان کتابخانه Annotation-Experimental کتابخانه استاندارد Kotlin را در وابستگی های انتقالی خود قرار می دهند.
نسخه 1.3.0-rc01
24 آگوست 2022
androidx.annotation:annotation-experimental:1.3.0-rc01
منتشر شد. نسخه 1.3.0-rc01 حاوی این commit ها است.
- بدون تغییر نسبت به نسخه قبلی اجرا برای 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 حاوی این commit ها است.
تغییرات API
- اضافه کردن پشتیبانی برای استفاده در سطح بسته از
@androidx.annotation.OptIn
( I24d58 )
Annotation-Experimental نسخه 1.2.0
نسخه 1.2.0
15 دسامبر 2021
androidx.annotation:annotation-experimental:1.2.0
منتشر شد. نسخه 1.2.0 حاوی این commit ها است.
تغییرات مهم از 1.1.0
این کتابخانه اکنون سطح زبان جاوا 8 را هدف قرار داده است.
نسخه 1.2.0-rc01
1 دسامبر 2021
androidx.annotation:annotation-experimental:1.2.0-rc01
منتشر شد. نسخه 1.2.0-rc01 حاوی این commit ها است.
هیچ تغییری نسبت به بتا وجود ندارد.
نسخه 1.2.0-beta01
17 نوامبر 2021
androidx.annotation:annotation-experimental:1.2.0-beta01
منتشر شد. نسخه 1.2.0-beta01 حاوی این تعهدات است.
تغییرات API
API ها برای نسخه بتا نهایی شده اند.
Annotation-Experimental version 1.2.0-alpha01
30 ژوئن 2021
androidx.annotation:annotation-experimental:1.2.0-alpha01
منتشر شد. نسخه 1.2.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- کتابخانه اکنون سطح زبان جاوا 8 را هدف قرار داده است
نسخه 1.2.0
نسخه 1.2.0
24 مارس 2021
androidx.annotation:annotation:1.2.0
منتشر شد. نسخه 1.2.0 حاوی این commit ها است.
تغییرات عمده از 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 حاوی این commit ها است.
نسخه 1.2.0-beta01
13 ژانویه 2021
androidx.annotation:annotation:1.2.0-beta01
منتشر شد. نسخه 1.2.0-beta01 حاوی این تعهدات است.
تغییرات API
- حاشیه نویسی جدید
@DoNotInline
که به بهینه سازهای کد (مثلاً Proguard، R8) دستور می دهد تا روش مشروح شده را درون خطی نکنند. ( I3dfe8 , b/141326133 )
نسخه 1.2.0-alpha01
14 مه 2020
androidx.annotation:annotation:1.2.0-alpha01
منتشر شد. نسخه 1.2.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- حاشیه نویسی
@ChecksSdkIntAtLeast
اضافه شد. این اجازه می دهد تا androidx و کاربران روش ها و فیلدهایی را که نشان دهنده یک بررسیSDK_INT
هستند، حاشیه نویسی کنند. ( I89a54 , b/120255046 )
Annotation-Experimental نسخه 1.1.0
نسخه 1.1.0
7 آوریل 2021
androidx.annotation:annotation-experimental:1.1.0
منتشر شد. نسخه 1.1.0 حاوی این commit ها است.
تغییرات عمده از 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 حاوی این commit ها است.
رفع اشکال
- قوانین Proguard اضافه شد تا اطمینان حاصل شود که بهینه سازی کد در مورد گم شدن متا حاشیه نویسی Kotlin هشدار نمی دهد.
نسخه 1.1.0-rc01
10 مارس 2021
androidx.annotation:annotation-experimental:1.1.0-rc01
منتشر شد. نسخه 1.1.0-rc01 حاوی این commit ها است.
هیچ تغییری نسبت به نسخه بتا قبلی وجود ندارد.
نسخه 1.1.0-beta01
27 ژانویه 2021
androidx.annotation:annotation-experimental:1.1.0-beta01
منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است.
تغییرات API
- نوع androidx حاشیه نویسی تجربی برای ارائه برابری با Kotlin منسوخ شده است. جایگزین آن با یک نوع آندرویکس از حاشیه نویسی RequiresOptIn شده است، و لاینر رو به جاوا برای پشتیبانی از حاشیه نویسی جدید Kotlin و نوع جدید اندرویدکس به روز شده است. ( I52495 , b/151331381 )
نسخه 1.1.0-alpha01
22 جولای 2020
androidx.annotation:annotation-experimental:1.1.0-alpha01
منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- کتابخانه حاشیه نویسی تجربی اکنون در کاتلین نوشته شده است، اما نیازی به گنجاندن کتابخانه استاندارد کاتلین به عنوان یک وابستگی ندارد. این شامل یک فایل Proguard است که اجازه می دهد ابرداده های غیر ضروری Kotlin از پروژه هایی که فقط از زبان برنامه نویسی جاوا استفاده می کنند حذف شوند.
-
@UseExperimental
اکنون از چندین کلاس نشانگر پشتیبانی می کند ( aosp/1185577 ، b/145137892 )
Annotation-Experimental نسخه 1.0.0
Annotation-Experimental نسخه 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
مبتنی بر لینت در کد منبع جاوا - حاشیه نویسی جاوا که رفتاری معادل با حاشیه نویسی
@Experimental
و@UseExperimental
Kotlin را بدون نیاز به وابستگی به Kotlin ارائه می کند.
Annotation-Experimental نسخه 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 حاوی این commit ها است .
مسائل شناخته شده
هنگام استفاده از Studio 3.5 stable، اخطارهای ردیاب استفاده از @Experimental
برای استفاده های نامعتبر جاوا از Kotlin @Experimental
در IDE نمایش داده نمی شود. به b/140640322 مراجعه کنید.
Annotation-Experimental نسخه 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 یک پیاده سازی سازگار با جاوا از نشانگرهای API آزمایشی Kotlin را ارائه می دهد. مصنوع
-lint
یک پیادهسازی مبتنی بر لینت از محدودیتهای استفاده آزمایشی را ارائه میکند و محدودیتهایی را در استفاده از جاوا از نشانگرهای API تجربی بومی Kotlin اعمال میکند.هنگام استفاده از مصنوع
annotation-experimental
به عنوان یک وابستگی، قوانین Lint ارائه شده توسط artifactannotation-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
منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.
نسخه 1.1.0-beta01
3 آوریل 2019
androidx.annotation:annotation:1.1.0-beta01
منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.
ویژگی های جدید
- حاشیه نویسی
@InspectableProperty
جدید برای پشتیبانی از API های بازرسی نمای جدید اضافه شده در Android 10. این حاشیه نویسی را می توان برای دریافت کنندگان نماها یا سایر عناصر رابط کاربری اعمال کرد. ابزارهای تولید کد ممکن است از آن برای ایجاد اشیاء همراهی استفاده کنند که نام ویژگیها را ترسیم میکنند و شناسهها را به مقادیر ویژگیها بدون سربار بازتاب نسبت میدهند.
API تغییر می کند
- تغییر شکست:
@ContentView
به یک حاشیه نویسی سازنده تغییر یافته و مقدار@LayoutRes
حذف شده است. کلاس هایی که مایل به پشتیبانی از حاشیه نویسی@ContentView
هستند باید این حاشیه نویسی را به سازنده ای اضافه کنند که پارامتر@LayoutRes int
می گیرد. این یک مشکل را هنگام استفاده از این حاشیه نویسی در ماژول های کتابخانه برطرف می کند. ( b/128352521 )
نسخه 1.1.0-alpha02
13 مارس 2019
androidx.annotation:annotation:1.1.0-alpha02
منتشر شد. لیست کامل commit های موجود در این نسخه را می توانید در اینجا بیابید.
ویژگی های جدید
- محدوده محدودیت API جدید:
RestrictTo.Scope.LIBRARY_GROUP_PREFIX
. این استفاده را به کد در بستههایی که گروههای آنها پیشوند گروه کتابخانه یکسانی دارند محدود میکند.
(دوره). به عنوان مثال، چون کتابخانههایfoo.bar:lib1
وfoo.baz:lib2
پیشوندfoo
به اشتراک میگذارند، میتوانند از APIهای یکدیگر استفاده کنند که به این محدوده محدود شدهاند. به طور مشابه، برایcom.foo.bar:lib1
وcom.foo.baz:lib2
com.foo.
پیشوند و می تواند API های محدود به آن محدوده را به اشتراک بگذارد. Librarycom.bar.qux:lib3
نمی تواند از API محدود شده استفاده کند زیرا فقط پیشوند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 )