حاشیه نویسی

ابرداده‌هایی را که به ابزارها و سایر توسعه‌دهندگان کمک می‌کند کد برنامه شما را درک کنند، در معرض نمایش قرار دهید.

این جدول تمام مصنوعات موجود در گروه androidx.annotation را فهرست می کند.

مصنوع انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
حاشیه نویسی 1.9.1 - - -
حاشیه نویسی-تجربی 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"
}

کاتلین 

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 کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.9

نسخه 1.9.1

30 اکتبر 2024

androidx.annotation:annotation-*:1.9.1 منتشر شد. نسخه 1.9.1 شامل این commit ها است.

رفع اشکال

  • پلتفرم هدف JS اضافه شد. ( I2310b )
  • به روز رسانی نسخه کاتلین به 1.9 ( I1a14c )

نسخه 1.9.0

16 اکتبر 2024

androidx.annotation:annotation-*:1.9.0 منتشر شد. نسخه 1.9.0 شامل این commit ها است.

تغییرات مهم از 1.8.0

  • پشتیبانی از اهداف چند پلتفرمی Kotlin زیر اضافه شده است: 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 حاوی این تعهدات است.

تغییرات API

  • پشتیبانی از هدف پلتفرم 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 حاوی این commit ها است.

مشارکت خارجی

  • پشتیبانی از هدف چند پلتفرمی linuxArm64 اضافه می کند (به لطف جیک وارتون!)

نسخه 1.8

نسخه 1.8.2

7 آگوست 2024

androidx.annotation:annotation-*:1.8.2 منتشر شد. نسخه 1.8.2 حاوی این commit ها است.

رفع اشکال

نسخه 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.1

16 جولای 2025

androidx.annotation:annotation-experimental:1.5.1 منتشر شد. نسخه 1.5.1 شامل این commit ها است.

نسخه 1.5.0

7 مه 2025

androidx.annotation:annotation-experimental:1.5.0 منتشر شد. نسخه 1.5.0 شامل این commit ها است.

تغییرات مهم از 1.4.0

  • برای تطبیق حاشیه نویسی Kotlin stdlib با مقدار رشته خالی پیش فرض، message به RequiresOptIn اضافه شد. ( I1f50e )
  • این کتابخانه اکنون سطح زبان Kotlin 2.0 را هدف قرار می دهد و به KGP 2.0.0 یا جدیدتر نیاز دارد. ( Idb6b5 )

نسخه 1.5.0-rc01

23 آوریل 2025

androidx.annotation:annotation-experimental:1.5.0-rc01 منتشر شد. نسخه 1.5.0-rc01 هیچ تغییری نسبت به نسخه بتا قبلی ندارد، به commits مراجعه کنید.

نسخه 1.5.0-beta01

9 آوریل 2025

androidx.annotation:annotation-experimental:1.5.0-beta01 منتشر شد. نسخه 1.5.0-beta01 حاوی این تعهدات است.

تغییرات مهم

  • این کتابخانه اکنون سطح زبان Kotlin 2.0 را هدف قرار می دهد و به KGP 2.0.0 یا جدیدتر نیاز دارد ( Idb6b5 )

نسخه 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 ارائه شده توسط artifact 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 منتشر شد. 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 های محدود به آن محدوده را به اشتراک بگذارد. Library com.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 )