کتابخانههای Jetpack جدا از سیستمعامل اندروید ارسال میشوند، بنابراین بهروزرسانیهای کتابخانهها میتوانند بهطور مستقل و بیشتر انجام شوند.
کتابخانهها از نسخهسازی معنایی دقیق برای سازگاری باینری با یک توالی بین نسخهای اضافه شده از بازبینیهای پیش از انتشار پیروی میکنند. یک رشته نسخه (مانند 1.0.1-beta02
) شامل سه عدد است که سطوح اصلی، مینور و رفع اشکال را نشان می دهد. نسخه های قبل از انتشار نیز دارای پسوندی هستند که مرحله قبل از انتشار (آلفا ، بتا ، نامزد انتشار) و شماره تجدید نظر (01 ، 02 و غیره) را مشخص می کند.
لطفاً توجه داشته باشید که کتابخانههای androidx
برای حفظ سازگاری منبع در نسخههای کوچک تشویق میشوند، اما الزامی نیستند. دلیل به روزرسانی اصلی نسخه ، تمام مصنوعاتی را که به نسخه اصلی قبلی بستگی دارد ، به صراحت مهاجرت می کند ، و این باعث می شود تا گردش کار توسعه دهندگان را مختل کند.
هر نسخه از یک کتابخانه در مسیر خود برای تبدیل شدن به یک نسخه پایدار در سه مرحله پیش از انتشار حرکت می کند. معیارهای هر مرحله قبل از انتشار عبارتند از:
آلفا
- نسخههای آلفا از نظر عملکردی پایدار هستند، اما ممکن است از نظر ویژگی کامل نباشند.
- در حالی که نسخه آلفا است، API ها ممکن است اضافه، حذف یا تغییر شوند.
بتا
- نسخههای بتا از نظر عملکردی پایدار هستند و سطح API با ویژگیهای کامل دارند.
- آنها برای استفاده در تولید آماده هستند اما ممکن است دارای اشکال باشند.
- نسخه بتا نمیتواند از ویژگیهای کامپایلر آزمایشی (مانند
@UseExperimental
) استفاده کند. - وابستگی به کتابخانه های دیگر باید نسخه های بتا، rc یا پایدار باشد. هیچ وابستگی آلفا مجاز نیست.
کاندید آزاد (RC)
- یک کاندید آزادی، یک نسخه پایدار بالقوه است.
- ممکن است حاوی اصلاحات حیاتی در لحظه آخر باشد.
- سطح API آن نهایی است.
- وابستگی ها به کتابخانه های دیگر باید فقط نسخه های rc یا پایدار باشند.
یک کتابخانه می تواند چندین نسخه را به طور همزمان داشته باشد. هر نسخه دارای مرحله انتشار متفاوتی است. به عنوان مثال ، در حالی که انتشار پایدار androidx.activity
می تواند 1.0.0
باشد ، ممکن است یک نسخه 1.1.0-beta02
و همچنین نسخه 2.0.0-alpha01
نیز وجود داشته باشد.
از این صفحه برای اطلاع از آخرین بهروزرسانیهای کتابخانهها استفاده کنید.
صفحه یادداشتهای انتشار اخیر AndroidX کتابخانههایی را که اخیراً تغییر کردهاند فهرست میکند. مخزن Maven گوگل تاریخچه نسخه کامل را نشان می دهد.
از جدول زیر برای مشاهده آخرین نسخه های پایدار و پیش نمایش هر کتابخانه AndroidX استفاده کنید. پیوندهای موجود در هر ردیف شما را به یادداشت های انتشار کتابخانه می برد. در یادداشت های انتشار خواهید یافت:
- تاریخچه زمانی همه نسخه ها.
- یک قطعه کد با اعلانهای وابستگی پیشفرض Gradle برای استفاده از مصنوعات.
- پیوندهایی به صفحات مرجع Kotlin و Java برای بسته های موجود در هر مصنوع.
کتابخانه های جت پک
برخی از کتابخانه های AndroidX، مانند دوربین، چندین مصنوع دارند که به طور جداگانه نگهداری می شوند. این کتابخانه ها با ستاره (*) مشخص شده اند. برای مشاهده بهروزرسانیهای نسخه برای همه مصنوعات، یادداشتهای انتشار را ببینید.
(*) این کتابخانه چندین مصنوع دارد. برای اطلاعات بیشتر به یادداشت های انتشار آن مراجعه کنید.
آخرین به روز رسانی: 30 ژوئن 2025