حاشیه‌نویسی

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

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

مصنوع انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
حاشیه نویسی ۱.۹.۱ - - -
حاشیه‌نویسی-آزمایشی ۱.۵.۱ - - ۱.۶.۰-آلفا۰۱
این کتابخانه آخرین بار در تاریخ ۲۲ اکتبر ۲۰۲۵ به‌روزرسانی شده است.

اعلام وابستگی‌ها

برای افزودن وابستگی به Annotation، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven گوگل را مطالعه کنید.

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

ایجاد یک مسئله جدید

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

نسخه ۱.۹

نسخه ۱.۹.۱

۳۰ اکتبر ۲۰۲۴

androidx.annotation:annotation-*:1.9.1 منتشر شد. نسخه ۱.۹.۱ شامل این کامیت‌ها است.

رفع اشکالات

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

نسخه ۱.۹.۰

۱۶ اکتبر ۲۰۲۴

androidx.annotation:annotation-*:1.9.0 منتشر شد. نسخه ۱.۹.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۸.۰

  • پشتیبانی از اهداف چند پلتفرمی کاتلین زیر اضافه شد: watchosDeviceArm64 ، mingwX64 ، linuxArm64 .

نسخه ۱.۹.۰-rc01

۲ اکتبر ۲۰۲۴

androidx.annotation:annotation-*:1.9.0-rc01 منتشر شد. نسخه 1.9.0-rc01 از زمان بتای قبلی هیچ تغییری نداشته است.

نسخه ۱.۹.۰-بتا۰۱

۱۸ سپتامبر ۲۰۲۴

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

تغییرات API

  • پشتیبانی از پلتفرم watchosDeviceArm64 ( I1cc04 ، b/364652024 ) را اضافه می‌کند.

نسخه ۱.۹.۰-آلفا۰۳

۴ سپتامبر ۲۰۲۴

androidx.annotation:annotation-*:1.9.0-alpha03 منتشر شد. نسخه 1.9.0-alpha03 هیچ تغییری نسبت به نسخه آلفای قبلی ندارد.

نسخه ۱.۹.۰-آلفا۰۲

۲۱ آگوست ۲۰۲۴

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

ویژگی‌های جدید

  • اضافه شدن پشتیبانی برای پلتفرم mingwX64 ( I461ca ، b/349894318 )
  • پشتیبانی از هدف چند پلتفرمی linuxArm64 kotlin اضافه شد. ( I139d3 ، b/338268719 )

نسخه ۱.۹.۰-آلفا۰۱

۲۶ ژوئن ۲۰۲۴

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

مشارکت خارجی

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

نسخه ۱.۸

نسخه ۱.۸.۲

۷ آگوست ۲۰۲۴

androidx.annotation:annotation-*:1.8.2 منتشر شد. نسخه ۱.۸.۲ شامل این کامیت‌ها است.

رفع اشکالات

  • اضافه شدن پشتیبانی برای پلتفرم mingwX64 ( I461ca ، b/349894318 )

نسخه ۱.۸.۱

۲۴ ژوئیه ۲۰۲۴

androidx.annotation:annotation-*:1.8.1 منتشر شد. نسخه ۱.۸.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • شامل تارگت‌های چندپلتفرمی کاتلین اضافی: watchos ، tvos .

نسخه ۱.۸.۰

۱۴ مه ۲۰۲۴

androidx.annotation:annotation-*:1.8.0 منتشر شد. نسخه ۱.۸.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۷.۰

  • حاشیه‌نویسی @ReplaceWith برای بیان جایگزینی برای APIهای منسوخ‌شده اضافه شد.
  • حاشیه‌نویسی @MainThread به مجموعه منابع مشترک منتقل شده است.

نسخه ۱.۸.۰-rc01

۱ مه ۲۰۲۴

androidx.annotation:annotation-*:1.8.0-rc01 منتشر شد. نسخه 1.8.0-rc01 از زمان انتشار نسخه بتای قبلی هیچ تغییری نداشته است.

نسخه ۱.۸.۰-بتا۰۲

۱۷ آوریل ۲۰۲۴

androidx.annotation:annotation-*:1.8.0-beta02 منتشر شد. نسخه 1.8.0-beta02 هیچ تغییری نسبت به نسخه قبلی نداشته است.

نسخه ۱.۸.۰-بتا۰۱

۳ آوریل ۲۰۲۴

androidx.annotation:annotation-*:1.8.0-beta01 منتشر شد. نسخه 1.8.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • حاشیه‌نویسی ReplaceWith اکنون از نظر API پایدار است، اما بررسی خط کد مرتبط با رفع خودکار هنوز ارائه نشده است.

نسخه ۱.۸.۰-آلفا۰۲

۲۰ مارس ۲۰۲۴

androidx.annotation:annotation-*:1.8.0-alpha02 بدون هیچ تغییر قابل توجهی منتشر شده است. نسخه 1.8.0-alpha02 شامل این کامیت‌ها است.

نسخه ۱.۸.۰-آلفا۰۱

۲۱ فوریه ۲۰۲۴

androidx.annotation:annotation-*:1.8.0-alpha01 منتشر شد. نسخه 1.8.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • حاشیه‌نویسی @ReplaceWith برای بیان جایگزینی برای APIهای منسوخ‌شده اضافه شد. ( I38db3 ، b/322373864 )

مشارکت‌های خارجی

  • از ایوان ماتکوف بابت انتقال حاشیه‌نویسی @MainThread به مجموعه منابع مشترک متشکرم. ( 6f228c )

نسخه ۱.۷

نسخه ۱.۷.۱

۱۳ دسامبر ۲۰۲۳

androidx.annotation:annotation-*:1.7.1 منتشر شد. نسخه ۱.۷.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • هنگام وارد کردن وابستگی پیش‌فرض پلتفرم، از دامنه compile استفاده کنید. ( I4958f )

نسخه ۱.۷.۰

۶ سپتامبر ۲۰۲۳

androidx.annotation:annotation-*:1.7.0 منتشر شد. نسخه ۱.۷.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۶.۰

  • شامل مصنوعات چند پلتفرمی کاتلین است که پلتفرم‌های iOS، لینوکس و MacOS را هدف قرار می‌دهند.
  • اکنون می‌توانید از Annotationها در پروژه‌های KMM استفاده کنید. توجه داشته باشید که Annotationهای غیراندرویدی هنوز در مرحله آزمایشی هستند، اما ما تصمیم گرفتیم نسخه‌ها را ادغام کنیم تا توسعه‌دهندگان بتوانند راحت‌تر آنها را امتحان کنند. به طور خاص، برخی از Annotationها ممکن است در طول توسعه آلفا، همزمان با نهایی شدن مرزها، بین کدهای رایج و کدهای مخصوص پلتفرم جابجا شوند.

نسخه ۱.۷.۰-rc01

۲۳ آگوست ۲۰۲۳

androidx.annotation:annotation-*:1.7.0-rc01 منتشر شد. نسخه 1.7.0-rc01 شامل این کامیت‌ها است.

این نسخه هیچ تغییری نسبت به نسخه بتای قبلی ندارد.

نسخه ۱.۷.۰-بتا۰۱

۹ آگوست ۲۰۲۳

androidx.annotation:annotation-*:1.7.0-beta01 منتشر شد. نسخه 1.7.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • API های پایدار برای انتشار

نسخه ۱.۷.۰-آلفا۰۳

۲۶ ژوئیه ۲۰۲۳

androidx.annotation:annotation-*:1.7.0-alpha03 منتشر شد. نسخه 1.7.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

  • انتشار POM در Maven اکنون شامل مصنوع چند پلتفرمی پیش‌فرضِ هدف قرار گرفته توسط JVM به عنوان وابستگی است.

نسخه ۱.۷.۰-آلفا۰۲

۲۴ مارس ۲۰۲۳

androidx.annotation:annotation-*:1.7.0-alpha02 منتشر شد.

رفع اشکالات

  • محدودیت‌های وابستگی از مصنوعات Maven حذف شد تا یک مشکل ساخت در Kotlin Native Targets ( b/274786186 , KT-57531 ) حل شود.

نسخه ۱.۷.۰-آلفا۰۱

۲۲ مارس ۲۰۲۳

androidx.annotation:annotation-*:1.7.0-alpha01 منتشر شد. نسخه 1.7.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • شامل مصنوعات چند پلتفرمی کاتلین است که پلتفرم‌های iOS، لینوکس و MacOS را هدف قرار می‌دهند.
  • اکنون می‌توانید از Annotationها در پروژه‌های KMM استفاده کنید. توجه داشته باشید که Annotationهای غیراندرویدی هنوز در مرحله آزمایشی هستند، اما ما تصمیم گرفتیم نسخه‌ها را ادغام کنیم تا توسعه‌دهندگان بتوانند راحت‌تر آنها را امتحان کنند. به طور خاص، برخی از Annotationها ممکن است در طول توسعه آلفا، همزمان با نهایی شدن مرزها، بین کدهای رایج و کدهای مخصوص پلتفرم جابجا شوند.

نسخه ۱.۶

نسخه ۱.۶.۰

۲۲ فوریه ۲۰۲۳

androidx.annotation:annotation:1.6.0 و androidx.annotation:annotation-jvm:1.6.0 منتشر شدند. نسخه ۱.۶.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۵.۰

  • یک حاشیه‌نویسی @RequiresExtension اضافه می‌کند تا بیان کند که یک API به نسخه خاصی از SDK یک افزونه خاص ( I5e4fe ) نیاز دارد.
  • کتابخانه حاشیه‌نویسی تبدیل‌شده برای ساخت با استفاده از زنجیره ابزار چندپلتفرمی کاتلین ( I3be8d )

نسخه ۱.۶.۰-rc01

۸ فوریه ۲۰۲۳

androidx.annotation:annotation:1.6.0-rc01 و androidx.annotation:annotation-jvm:1.6.0-rc01 منتشر شدند. نسخه 1.6.0-rc01 شامل این کامیت‌ها است.

  • حاشیه‌نویسی برای نسخه کاندید انتشار ۱.۶.۰-rc۰۱ تثبیت شده است.

نسخه ۱.۶.۰-بتا۰۱

۲۵ ژانویه ۲۰۲۳

androidx.annotation:annotation:1.6.0-beta01 و androidx.annotation:annotation-jvm:1.6.0-beta01 بدون هیچ تغییری نسبت به 1.6.0-alpha01 منتشر شده‌اند.

نسخه ۱.۶.۰-آلفا۰۱

۱۱ ژانویه ۲۰۲۳

androidx.annotation:annotation-*:1.6.0-alpha01 منتشر شد. نسخه 1.6.0-alpha01 شامل این کامیت‌ها است.

نسخه ۱.۶.۰-dev01

۸ فوریه ۲۰۲۳

androidx.annotation:annotation-*:1.6.0-dev01 منتشر شد. نسخه 1.6.0-dev01 شامل این کامیت‌ها است.

  • Annotation قابلیت چند پلتفرمی بودن کاتلین را برای پیش‌نمایش توسعه‌دهندگان ۱.۶.۰-dev۰۱ فعال کرده است.

ویژگی‌های جدید

  • یک حاشیه‌نویسی @RequiresExtension اضافه می‌کند تا بیان کند که یک API به نسخه خاصی از یک SDK افزونه خاص نیاز دارد. ( I5e4fe )
  • کتابخانه حاشیه‌نویسی تبدیل‌شده برای ساخت با استفاده از زنجیره ابزار چندپلتفرمی کاتلین ( I3be8d )

نسخه ۱.۵.۰

نسخه ۱.۵.۰

۲۱ سپتامبر ۲۰۲۲

androidx.annotation:annotation:1.5.0 منتشر شد. نسخه ۱.۵.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۴.۰

  • کتابخانه حاشیه‌نویسی (Annotation library) به طور کامل به منابع کاتلین منتقل شده است که منجر به پشتیبانی از سایت‌های هدف خاص کاتلین و سایر ویژگی‌های حاشیه‌نویسی سازگار با کاتلین می‌شود.

نسخه ۱.۵.۰-rc01

۷ سپتامبر ۲۰۲۲

androidx.annotation:annotation:1.5.0-rc01 منتشر شد. نسخه 1.5.0-rc01 شامل این کامیت‌ها است.

  • هیچ تغییری نسبت به نسخه بتای قبلی ۱.۵.۰ وجود ندارد.

نسخه ۱.۵.۰-بتا۰۱

۲۴ آگوست ۲۰۲۲

androidx.annotation:annotation:1.5.0-beta01 منتشر شد. نسخه 1.5.0-beta01 شامل این کامیت‌ها است.

  • هیچ تغییری نسبت به نسخه قبلی وجود ندارد. سطح API برای بتا مسدود شده است.

نسخه ۱.۵.۰-آلفا۰۲

۱۰ آگوست ۲۰۲۲

androidx.annotation:annotation:1.5.0-alpha02 منتشر شد. نسخه 1.5.0-alpha02 شامل این کامیت‌ها است.

  • از زمان انتشار نسخه آلفای قبلی هیچ تغییری نکرده است.

نسخه ۱.۵.۰-آلفا۰۱

۲۷ ژوئیه ۲۰۲۲

androidx.annotation:annotation:1.5.0-alpha01 منتشر شد. نسخه 1.5.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • کتابخانه حاشیه‌نویسی (Annotation library) به طور کامل به منابع کاتلین منتقل شده است که منجر به پشتیبانی از سایت‌های هدف خاص کاتلین و سایر ویژگی‌های حاشیه‌نویسی سازگار با کاتلین می‌شود.

نسخه ۱.۴.۰

نسخه ۱.۴.۰

۱۵ ژوئن ۲۰۲۲

androidx.annotation:annotation:1.4.0 منتشر شد. نسخه ۱.۴.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۳.۰

  • @RestrictTo به منابع کاتلین منتقل شده و اکنون از @file در سایت پشتیبانی می‌کند. در نتیجه، کتابخانه Annotation اکنون به کتابخانه استاندارد کاتلین وابسته است.
  • @ReturnThis (b/140249763): تضمین می‌کند که متدهای override شده‌ی این متد باید همان نمونه (که برای سازندگان و غیره در نظر گرفته شده است) را برگردانند.
  • @OpenForTesting (b/141539024): کلاس‌ها و متدهای کاتلین که با علامت "open" مشخص شده‌اند، می‌توانند با این حاشیه‌نویسی حاشیه‌نویسی شوند و lint اطمینان حاصل می‌کند که این کلاس فقط از تست‌های واحد، زیرکلاس (و متدها فقط بازنویسی) می‌شود.
  • @DeprecatedSinceApi (b/37116481): نشان می‌دهد که متد (یا کلاس یا فیلد) حاشیه‌نویسی‌شده بخشی از یک کتابخانه پشتیبان برای یک API پلتفرم است که دیگر در سطح API داده‌شده مورد نیاز نیست.
  • @EmptySuper : نشان می‌دهد که این متد به صورت خالی تعریف شده است، بنابراین هنگام override کردن نیازی به فراخوانی آن ندارید (و در واقع نباید هم داشته باشید؛ برای مثال، می‌تواند شامل بررسی سازگاری با نسخه‌های قبلی باشد.)

نسخه ۱.۴.۰-rc01

۱ ژوئن ۲۰۲۲

androidx.annotation:annotation:1.4.0-rc01 منتشر شد. نسخه 1.4.0-rc01 شامل این کامیت‌ها است.

  • سطح و عملکرد API برای انتشار نهایی شده است.

نسخه ۱.۴.۰-بتا۰۱

۱۸ مه ۲۰۲۲

androidx.annotation:annotation:1.4.0-beta01 منتشر شد. نسخه 1.4.0-beta01 شامل این کامیت‌ها است.

  • از آخرین نسخه آلفا هیچ تغییری نکرده است. سطح API برای انتشار بتا قفل شده است.

نسخه ۱.۴.۰-آلفا۰۲

۹ فوریه ۲۰۲۲

androidx.annotation:annotation:1.4.0-alpha02 منتشر شد. نسخه 1.4.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • حاشیه‌نویسی‌های @ReturnThis ، @OpenForTesting ، @EmptySuper و @DeprecatedSinceApi اضافه شد. ( 21946a2 )

  • @ReturnThis ( b/140249763 ): تضمین می‌کند که متدهای override شده‌ی این متد باید همان نمونه (که برای سازندگان و غیره در نظر گرفته شده است) را برگردانند.

  • @OpenForTesting ( b/141539024 ): کلاس‌ها و متدهای کاتلین که با علامت "open" مشخص شده‌اند، می‌توانند با این حاشیه‌نویسی حاشیه‌نویسی شوند و lint اطمینان حاصل می‌کند که این کلاس فقط از تست‌های واحد، زیرکلاس (و متدها فقط بازنویسی) می‌شود.

  • @DeprecatedSinceApi ( b/37116481 ): نشان می‌دهد که متد (یا کلاس یا فیلد) حاشیه‌نویسی‌شده بخشی از یک کتابخانه پشتیبان برای یک API پلتفرم است که دیگر در سطح API داده‌شده مورد نیاز نیست.

  • @EmptySuper : نشان می‌دهد که این متد به صورت خالی تعریف شده است، بنابراین هنگام override کردن نیازی به فراخوانی آن ندارید (و در واقع نباید هم داشته باشید؛ برای مثال، می‌تواند شامل بررسی سازگاری با نسخه‌های قبلی باشد.)

نسخه ۱.۴.۰-آلفا۰۱

۱۵ دسامبر ۲۰۲۱

androidx.annotation:annotation:1.4.0-alpha01 منتشر شد. نسخه 1.4.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • حاشیه‌نویسی RestrictTo به منابع کاتلین منتقل شد ( Ia6336 )

نسخه ۱.۳.۰

نسخه ۱.۳.۰

۳ نوامبر ۲۰۲۱

androidx.annotation:annotation:1.3.0 منتشر شد. نسخه ۱.۳.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۲.۰

  • حاشیه‌نویسی @Discouraged برای علامت‌گذاری APIهایی که نمی‌توان به‌طور منطقی آنها را منسوخ کرد اما تأثیر منفی قابل‌توجهی بر عملکرد دارند و نباید در کد تولید عادی فراخوانی شوند.
  • حاشیه‌نویسی @Context برای علامت‌گذاری Contextهای عمومی تا توسعه‌دهندگان بتوانند راحت‌تر به APIهای جدید مهاجرت کنند.
  • حاشیه‌نویسی @GravityInt برای علامت‌گذاری عناصر حاوی مقادیر گرانشی که در اعداد صحیح فشرده شده‌اند
  • @InspectableProperty به نفع @Attribute برای androidx.resourceinspection منسوخ شد.

نسخه ۱.۳.۰-rc01

۲۷ اکتبر ۲۰۲۱

androidx.annotation:annotation:1.3.0-rc01 منتشر شد. نسخه 1.3.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۳.۰-بتا۰۱

۲۹ سپتامبر ۲۰۲۱

androidx.annotation:annotation:1.3.0-beta01 منتشر شد. نسخه 1.3.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • در قسمت «پیام» برای @Discouraged توضیح لازم است. ( I3390f )
  • اضافه کردن حاشیه‌نویسی @Discouraged برای علامت‌گذاری عناصری که از استفاده از آنها خودداری می‌شود. ( Ib2549 )
  • حاشیه‌نویسی RestrictTo را از پنجره‌ی بازشو اسناد استودیو ( Ie8e1a ، b/183134648 ) قابل مشاهده کنید.

رفع اشکالات

  • حاشیه‌نویسی Context را برای علامت‌گذاری Contextهای عمومی اضافه کنید تا توسعه‌دهندگان بتوانند راحت‌تر به APIهای جدید مهاجرت کنند. ( Ie581a )

نسخه ۱.۳.۰-آلفا۰۱

۲۴ مارس ۲۰۲۱

androidx.annotation:annotation:1.3.0-alpha01 منتشر شد. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • @InspectableProperty در androidx.resourceinspection منسوخ و @Attribute جایگزین آن شد ( Ic0eff )
  • حاشیه‌نویسی @GravityInt برای علامت‌گذاری عناصر حاوی مقادیر گرانشی فشرده‌شده در اعداد صحیح اضافه شد. ( Ifcaa4 ، b/180620048 )

حاشیه‌نویسی-نسخه آزمایشی ۱.۶

نسخه ۱.۶.۰-آلفا۰۱

۲۲ اکتبر ۲۰۲۵

androidx.annotation:annotation-experimental:1.6.0-alpha01 منتشر شد. نسخه 1.6.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • حاشیه‌نویسی OptIn اکنون از هدف ElementType.PARAMETER پشتیبانی می‌کند.

حاشیه‌نویسی-نسخه آزمایشی ۱.۵

نسخه ۱.۵.۱

۱۶ ژوئیه ۲۰۲۵

androidx.annotation:annotation-experimental:1.5.1 منتشر شد. نسخه ۱.۵.۱ شامل این کامیت‌ها است.

نسخه ۱.۵.۰

۷ مه ۲۰۲۵

androidx.annotation:annotation-experimental:1.5.0 منتشر شد. نسخه ۱.۵.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۴.۰

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

نسخه ۱.۵.۰-rc01

۲۳ آوریل ۲۰۲۵

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

نسخه ۱.۵.۰-بتا۰۱

۹ آوریل ۲۰۲۵

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

تغییرات مهم

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

نسخه ۱.۵.۰-آلفا۰۱

۲۱ آگوست ۲۰۲۴

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

تغییرات API

  • message به RequiresOptIn اضافه کنید تا حاشیه‌نویسی Kotlin stdlib با مقدار رشته‌ای خالی پیش‌فرض مطابقت داشته باشد. ( I1f50e )

حاشیه‌نویسی-نسخه آزمایشی ۱.۴

نسخه ۱.۴.۱

۳ آوریل ۲۰۲۴

androidx.annotation:annotation-experimental:1.4.1 منتشر شد. نسخه ۱.۴.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل استفاده از isKotlin برای جلوگیری از فعال شدن تصادفی بررسی RequiresOptIn در فایل‌های Kotlin. ( I2d8c1f )

نسخه ۱.۴.۰

۲۴ ژانویه ۲۰۲۴

androidx.annotation:annotation-experimental:1.4.0 منتشر شد. نسخه ۱.۴.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۳.۰

  • اضافه شدن پشتیبانی از کاتلین چند پلتفرمی
  • رفع مشکل سازگاری با کاتلین ۲.۰
  • نمایش هشدارها برای استفاده‌های جاوا از ویژگی‌های کاتلین که به صورت آزمایشی حاشیه‌نویسی شده‌اند ( I8bd43 )
  • رفع مشکل قرار دادن حاشیه‌نویسی autofix در متدهای کاتلین ( Id7a41 )

نسخه ۱.۴.۰-rc01

۱۰ ژانویه ۲۰۲۴

androidx.annotation:annotation-experimental:1.4.0-rc01 منتشر شد. نسخه 1.4.0-rc01 هیچ تغییری نسبت به نسخه قبلی نداشته است.

نسخه ۱.۴.۰-بتا۰۱

۱۳ دسامبر ۲۰۲۳

androidx.annotation:annotation-experimental:1.4.0-beta01 منتشر شد. هیچ تغییری نسبت به نسخه قبلی ایجاد نشده است.

نسخه ۱.۴.۰-آلفا۰۱

۲۹ نوامبر ۲۰۲۳

androidx.annotation:annotation-experimental:1.4.0-alpha01 منتشر شد. نسخه 1.4.0-alpha01 شامل این کامیت‌ها است.

رفع اشکالات

  • پیشنهادهای اصلاح خودکار سطح کلاس را موقتاً حذف کنید تا مشکل b/301598518 ( ID98b2 ) حل شود.
  • نمایش هشدارها برای استفاده‌های جاوا از ویژگی‌های کاتلین که به صورت آزمایشی حاشیه‌نویسی شده‌اند ( I8bd43 )
  • رفع مشکل قرار دادن حاشیه‌نویسی autofix در متدهای کاتلین ( Id7a41 )

نسخه ۱.۴.۰-dev01

۸ فوریه ۲۰۲۳

androidx.annotation:annotation-experimental:1.4.0-dev01 منتشر شد. نسخه 1.4.0-dev01 شامل این کامیت‌ها است.

  • Annotation-experimental قابلیت چند پلتفرمی بودن کاتلین را برای پیش‌نمایش توسعه‌دهندگان ۱.۴.۰-dev۰۱ فعال کرده است.

حاشیه‌نویسی-نسخه آزمایشی ۱.۳.۱

نسخه ۱.۳.۱

۲۱ ژوئن ۲۰۲۳

androidx.annotation:annotation-experimental:1.3.1 منتشر شد. نسخه ۱.۳.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • هنگام اعمال اصلاح خودکار lint، حاشیه‌نویسی را در ابتدای لیست اصلاح‌کننده قرار دهید. ( b/251172715 )
  • از بررسی lint برای جلوگیری از استفاده از androidx.annotation.RequiresOptIn در منابع Kotlin استفاده کنید ( b/241097743 )

حاشیه‌نویسی-نسخه آزمایشی ۱.۳.۰

نسخه ۱.۳.۰

۷ سپتامبر ۲۰۲۲

androidx.annotation:annotation-experimental:1.3.0 منتشر شد. نسخه ۱.۳.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۲.۰

  • اضافه کردن پشتیبانی برای استفاده در سطح بسته از @androidx.annotation.OptIn ( I24d58 )
  • وابستگی Kotlin stdlib به جای فقط کامپایل، به نوع API منتقل شد. این بدان معناست که همه کلاینت‌های کتابخانه Annotation-Experimental، کتابخانه استاندارد Kotlin را در وابستگی‌های انتقالی خود لحاظ خواهند کرد.

نسخه ۱.۳.۰-rc01

۲۴ آگوست ۲۰۲۲

androidx.annotation:annotation-experimental:1.3.0-rc01 منتشر شد. نسخه 1.3.0-rc01 شامل این کامیت‌ها است.

  • هیچ تغییری نسبت به نسخه قبلی وجود ندارد. پیاده‌سازی برای نسخه RC متوقف شده است.

نسخه ۱.۳.۰-بتا۰۱

۱۰ آگوست ۲۰۲۲

androidx.annotation:annotation-experimental:1.3.0-beta01 منتشر شد. نسخه 1.3.0-beta01 شامل این کامیت‌ها است.

  • هیچ تغییری نسبت به نسخه آلفا وجود ندارد. این کتابخانه برای انتشار بتا تثبیت شده است.

نسخه ۱.۳.۰-آلفا۰۱

۲۷ ژوئیه ۲۰۲۲

androidx.annotation:annotation-experimental:1.3.0-alpha01 منتشر شد. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • اضافه کردن پشتیبانی برای استفاده در سطح بسته از @androidx.annotation.OptIn ( I24d58 )

حاشیه‌نویسی-نسخه آزمایشی ۱.۲.۰

نسخه ۱.۲.۰

۱۵ دسامبر ۲۰۲۱

androidx.annotation:annotation-experimental:1.2.0 منتشر شد. نسخه ۱.۲.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۱.۰

این کتابخانه اکنون سطح زبان جاوا ۸ را هدف قرار داده است.

نسخه ۱.۲.۰-rc01

۱ دسامبر ۲۰۲۱

androidx.annotation:annotation-experimental:1.2.0-rc01 منتشر شد. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

هیچ تغییری نسبت به نسخه بتا وجود ندارد.

نسخه ۱.۲.۰-بتا۰۱

۱۷ نوامبر ۲۰۲۱

androidx.annotation:annotation-experimental:1.2.0-beta01 منتشر شد. نسخه 1.2.0-beta01 شامل این کامیت‌ها است.

تغییرات API

APIها برای نسخه بتا نهایی شده‌اند.

حاشیه‌نویسی-نسخه آزمایشی ۱.۲.۰-alpha01

۳۰ ژوئن ۲۰۲۱

androidx.annotation:annotation-experimental:1.2.0-alpha01 منتشر شد. نسخه 1.2.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • کتابخانه اکنون سطح زبان جاوا ۸ را هدف قرار داده است

نسخه ۱.۲.۰

نسخه ۱.۲.۰

۲۴ مارس ۲۰۲۱

androidx.annotation:annotation:1.2.0 منتشر شد. نسخه ۱.۲.۰ شامل این کامیت‌ها است.

تغییرات عمده از زمان ۱.۱.۰

  • حاشیه‌نویسی @ChecksSdkIntAtLeast اضافه شد که می‌تواند برای شناسایی متدها یا فیلدهای مورد استفاده برای دسترسی در سطح SDK و برآورده کردن بررسی lint NewApi استفاده شود.
  • حاشیه‌نویسی @DoNotInline اضافه شد که با یک قانون Proguard جفت می‌شود تا از inline شدن اعضا در حین بهینه‌سازی جلوگیری کند.
  • اکنون انواع حاشیه‌نویسی‌ها با @Documented حاشیه‌نویسی می‌شوند تا از نمایش آنها در مستندات برای اعضای حاشیه‌نویسی‌شده اطمینان حاصل شود.

نسخه ۱.۲.۰-rc01

۲۴ فوریه ۲۰۲۱

androidx.annotation:annotation:1.2.0-rc01 منتشر شد. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۲.۰-بتا۰۱

۱۳ ژانویه ۲۰۲۱

androidx.annotation:annotation:1.2.0-beta01 منتشر شد. نسخه 1.2.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • حاشیه‌نویسی جدید @DoNotInline که به بهینه‌سازی‌کننده‌های کد (مثلاً Proguard، R8) دستور می‌دهد متد حاشیه‌نویسی‌شده را درون‌خطی نکنند. ( I3dfe8 ، b/141326133 )

نسخه ۱.۲.۰-آلفا۰۱

۱۴ مه ۲۰۲۰

androidx.annotation:annotation:1.2.0-alpha01 منتشر شد. نسخه 1.2.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • حاشیه‌نویسی @ChecksSdkIntAtLeast اضافه شد. این به androidx و کاربران اجازه می‌دهد متدها و فیلدهایی را که نشان‌دهنده بررسی SDK_INT هستند، حاشیه‌نویسی کنند. ( I89a54 , b/120255046 )

حاشیه‌نویسی-نسخه آزمایشی ۱.۱.۰

نسخه ۱.۱.۰

۷ آوریل ۲۰۲۱

androidx.annotation:annotation-experimental:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات عمده از زمان ۱.۰.۰

  • حاشیه‌نویسی‌های آزمایشی جت‌پک در کاتلین بازنویسی شده‌اند تا از کلاس‌های نشانگر چندگانه پشتیبانی کنند و مدیریت استهلاک را بهبود بخشند.
  • حاشیه‌نویسی‌های RequiresOptIn و OptIn برای برابری با کاتلین اضافه شده‌اند و حاشیه‌نویسی‌های Experimental و UsesExperimental منسوخ شده‌اند.

نسخه ۱.۱.۰-rc02

۲۴ مارس ۲۰۲۱

androidx.annotation:annotation-experimental:1.1.0-rc02 منتشر شد. نسخه 1.1.0-rc02 شامل این کامیت‌ها است.

رفع اشکالات

  • قوانین Proguard اضافه شد تا اطمینان حاصل شود که بهینه‌سازی کد در مورد فقدان حاشیه‌نویسی‌های متای کاتلین هشدار نمی‌دهد.

نسخه ۱.۱.۰-rc01

۱۰ مارس ۲۰۲۱

androidx.annotation:annotation-experimental:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

از زمان انتشار نسخه بتای قبلی هیچ تغییری نکرده است.

نسخه ۱.۱.۰-بتا۰۱

۲۷ ژانویه ۲۰۲۱

androidx.annotation:annotation-experimental:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • نوع androidx از حاشیه‌نویسی Experimental برای ارائه قابلیت parity با کاتلین منسوخ شده است. این حاشیه‌نویسی با نوع androidx از حاشیه‌نویسی RequiredOptIn جایگزین شده است و linter مربوط به جاوا نیز به‌روزرسانی شده است تا هم از حاشیه‌نویسی جدید کاتلین و هم از نوع جدید androidx پشتیبانی کند. ( I52495 ، b/151331381 )

نسخه ۱.۱.۰-آلفا۰۱

۲۲ ژوئیه ۲۰۲۰

androidx.annotation:annotation-experimental:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • کتابخانه حاشیه‌نویسی آزمایشی اکنون با کاتلین نوشته شده است، اما نیازی به کتابخانه استاندارد کاتلین به عنوان یک وابستگی ندارد. این کتابخانه شامل یک فایل Proguard است که امکان حذف متادیتای غیرضروری کاتلین را از پروژه‌هایی که فقط از زبان برنامه‌نویسی جاوا استفاده می‌کنند، فراهم می‌کند.
  • @UseExperimental اکنون از کلاس‌های نشانگر چندگانه ( aosp/1185577 ، b/145137892 ) پشتیبانی می‌کند.

حاشیه‌نویسی-نسخه آزمایشی ۱.۰.۰

حاشیه‌نویسی-نسخه آزمایشی ۱.۰.۰

۷ نوامبر ۲۰۱۹

androidx.annotation:annotation-experimental:1.0.0 و androidx.annotation:annotation-experimental-lint:1.0.0 بدون هیچ تغییری از 1.0.0-rc01 منتشر شده‌اند. نسخه 1.0.0 شامل این کامیت‌ها است .

ویژگی‌های اصلی نسخه ۱.۰.۰

  • اجرای مبتنی بر Lint از معانی @Experimental کاتلین در کد منبع جاوا
  • حاشیه‌نویسی‌های جاوا که رفتاری معادل حاشیه‌نویسی‌های @Experimental و @UseExperimental کاتلین ارائه می‌دهند، بدون اینکه نیازی به وابستگی به کاتلین داشته باشند.

حاشیه‌نویسی-نسخه آزمایشی ۱.۰.۰-rc01

۲۳ اکتبر ۲۰۱۹

androidx.annotation:annotation-experimental:1.0.0-rc01 و androidx.annotation:annotation-experimental-lint:1.0.0-rc01 منتشر شدند. نسخه 1.0.0-rc01 شامل این کامیت‌ها است .

مشکلات شناخته شده

هنگام استفاده از Studio 3.5 stable، هشدارهای مربوط به تشخیص‌دهنده‌ی lint با استفاده‌ی @Experimental در IDE برای استفاده‌های نامعتبر جاوا از حاشیه‌نویسی @Experimental در کاتلین نمایش داده نمی‌شوند. به b/140640322 مراجعه کنید.

حاشیه‌نویسی-نسخه آزمایشی ۱.۰.۰-بتا۰۱

۹ اکتبر ۲۰۱۹

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 شامل این کامیت‌ها است .

حاشیه‌نویسی-نسخه آزمایشی ۱.۰.۰-alpha01

۱۸ سپتامبر ۲۰۱۹

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 Experimental یک پیاده‌سازی سازگار با جاوا از نشانگرهای API آزمایشی کاتلین ارائه می‌دهد. -lint artifact یک پیاده‌سازی مبتنی بر Lint از محدودیت‌های استفاده آزمایشی ارائه می‌دهد و محدودیت‌هایی را بر استفاده جاوا از نشانگرهای API آزمایشی بومی کاتلین اعمال می‌کند.

  • هنگام استفاده از مصنوع annotation-experimental به عنوان یک وابستگی، قوانین Lint ارائه شده توسط مصنوع annotation-experimental-lint به طور خودکار اجرا می‌شوند.

نسخه ۱.۱.۰

نسخه ۱.۱.۰

۵ ژوئن ۲۰۱۹

androidx.annotation:annotation:1.1.0 بدون هیچ تغییری نسبت به نسخه ۱.۱.۰-rc01 منتشر شده است.

نسخه ۱.۱.۰-rc01

۷ مه ۲۰۱۹

androidx.annotation:annotation:1.1.0-rc01 بدون هیچ تغییری نسبت به 1.1.0-beta01 منتشر شده است. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

نسخه ۱.۱.۰-بتا۰۱

۳ آوریل ۲۰۱۹

androidx.annotation:annotation:1.1.0-beta01 منتشر شد. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

ویژگی‌های جدید

  • حاشیه‌نویسی جدید @InspectableProperty برای پشتیبانی از APIهای جدید بازرسی نما که در اندروید ۱۰ اضافه شده‌اند. این حاشیه‌نویسی می‌تواند روی getterها در نماها یا سایر عناصر رابط کاربری اعمال شود. ابزارهای تولید کد می‌توانند از آن برای ایجاد اشیاء همراهی استفاده کنند که نام ویژگی‌ها را نگاشت کرده و شناسه‌ها را به مقادیر ویژگی‌ها نسبت می‌دهند، بدون اینکه سربار بازتاب (reflection) را متحمل شوند.

تغییرات API

  • تغییر مهم: @ContentView به یک حاشیه‌نویسی سازنده تغییر یافته و مقدار @LayoutRes حذف شده است. کلاس‌هایی که مایل به پشتیبانی از حاشیه‌نویسی‌های @ContentView هستند باید این حاشیه‌نویسی را به سازنده‌ای اضافه کنند که یک پارامتر @LayoutRes int می‌گیرد. این تغییر، مشکلی را که هنگام استفاده از این حاشیه‌نویسی در ماژول‌های کتابخانه وجود داشت، برطرف می‌کند. ( b/128352521 )

نسخه ۱.۱.۰-آلفا۰۲

۱۳ مارس ۲۰۱۹

androidx.annotation:annotation:1.1.0-alpha02 منتشر شد. لیست کامل کامیت‌های موجود در این نسخه را می‌توانید اینجا بیابید.

ویژگی‌های جدید

  • دامنه محدودیت 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های محدود به آن دامنه را به اشتراک بگذارند. با این حال، کتابخانه com.bar.qux:lib3 قادر به استفاده از API محدود شده نخواهد بود زیرا فقط پیشوند com. را به اشتراک می‌گذارد و نه تا آخرین . (نقطه).

نسخه ۱.۱.۰-آلفا۰۱

۳۰ ژانویه ۲۰۱۹

androidx.annotation:annotation 1.1.0-alpha01 منتشر شد.

ویژگی‌های جدید

  • یک حاشیه‌نویسی @ContentView اضافه شده است که به شما امکان می‌دهد مشخص کنید کدام فایل XML طرح‌بندی باید inflate شود. این قابلیت در ComponentActivity در نسخه 1.0.0-alpha04 و در Fragment در نسخه 1.1.0-alpha04 به عنوان جایگزینی برای استفاده از setContentView() یا override کردن onCreateView() پشتیبانی می‌شود. ( aosp/837619 )

نسخه ۱.۰.۲

نسخه ۱.۰.۲

۲۵ فوریه ۲۰۱۹

androidx.annotation:annotation 1.0.2 منتشر شد.

رفع اشکالات

  • قوانین R8/ProGuard که در فایل jar تعبیه شده‌اند را اصلاح کنید. این قوانین به اشتباه به جای android.support.annotation به نوع‌های قدیمی androidx.annotation اشاره می‌کردند. توجه: این موضوع فقط در صورتی روی ساخت‌های شما تأثیر می‌گذاشت که getDefaultProguardFile استفاده نمی‌کردید، زیرا این قوانین پیش‌فرض شامل قوانین صحیح برای هر دو بسته نیز بودند. ( aosp/891685 )
  • یک قانون R8/ProGuard اضافه کنید که صریحاً خود حاشیه‌نویسی @Keep را نگه دارد. این تضمین می‌کند که ProGuard قبل از رعایت معانی آن، حاشیه‌نویسی را از انواع حذف نکند. توجه: این امر فقط در صورتی روی ساخت‌های شما تأثیر می‌گذاشت که getDefaultProguardFile استفاده نمی‌کردید، زیرا این قوانین پیش‌فرض شامل قوانین صحیح برای هر دو بسته نیز بودند. ( aosp/903818 )