کتابخانههای Jetpack جدا از سیستمعامل اندروید ارسال میشوند، بنابراین بهروزرسانیهای کتابخانهها میتوانند بهطور مستقل و بیشتر انجام شوند.
کتابخانهها از نسخهسازی معنایی دقیق برای سازگاری باینری با یک توالی بین نسخهای اضافه شده از بازبینیهای پیش از انتشار پیروی میکنند. A version string (like 1.0.1-beta02
) contains three numbers representing major, minor, and bugfix levels. نسخه های پیش از انتشار نیز دارای پسوندی هستند که مرحله پیش از انتشار (آلفا، بتا، نامزد انتشار) و شماره ویرایش (01، 02 و غیره) را مشخص می کند.
لطفاً توجه داشته باشید که کتابخانههای androidx
برای حفظ سازگاری منبع در نسخههای کوچک تشویق میشوند، اما الزامی نیستند. دلیل بهروزرسانی نسخه اصلی، تمام مصنوعات وابسته به نسخه اصلی قبلی را مجبور میکند که به صراحت منتقل شوند، که باعث اختلال در گردش کار توسعهدهندگان میشود.
هر نسخه از یک کتابخانه در مسیر خود برای تبدیل شدن به یک نسخه پایدار در سه مرحله پیش از انتشار حرکت می کند. معیارهای هر مرحله قبل از انتشار عبارتند از:
آلفا
- نسخههای آلفا از نظر عملکردی پایدار هستند، اما ممکن است از نظر ویژگی کامل نباشند.
- در حالی که نسخه آلفا است، API ها ممکن است اضافه، حذف یا تغییر شوند.
بتا
- نسخههای بتا از نظر عملکردی پایدار هستند و سطح API با ویژگیهای کامل دارند.
- آنها برای استفاده در تولید آماده هستند اما ممکن است دارای اشکال باشند.
- A beta release cannot use experimental compiler features (such as
@UseExperimental
). - وابستگی به کتابخانه های دیگر باید نسخه های بتا، rc یا پایدار باشد. هیچ وابستگی آلفا مجاز نیست.
کاندید آزاد (RC)
- یک کاندید آزادی، یک نسخه پایدار بالقوه است.
- ممکن است حاوی اصلاحات حیاتی در لحظه آخر باشد.
- سطح API آن نهایی است.
- وابستگی ها به کتابخانه های دیگر باید فقط نسخه های rc یا پایدار باشند.
یک کتابخانه می تواند چندین نسخه را به طور همزمان داشته باشد. هر نسخه دارای مرحله انتشار متفاوتی است. For example, while the stable release of androidx.activity
could be 1.0.0
, there might also be a 1.1.0-beta02
release as well as a 2.0.0-alpha01
release.
از این صفحه برای اطلاع از آخرین بهروزرسانیهای کتابخانهها استفاده کنید.
صفحه یادداشتهای انتشار اخیر AndroidX کتابخانههایی را که اخیراً تغییر کردهاند فهرست میکند. مخزن Maven گوگل تاریخچه نسخه کامل را نشان می دهد.
از جدول زیر برای مشاهده آخرین نسخه های پایدار و پیش نمایش هر کتابخانه AndroidX استفاده کنید. پیوندهای موجود در هر ردیف شما را به یادداشت های انتشار کتابخانه می برد. در یادداشت های انتشار خواهید یافت:
- تاریخچه زمانی همه نسخه ها.
- یک قطعه کد با اعلانهای و��بستگی پیشفرض Gradle برای استفاده از مصنوعات.
- پیوندهایی به صفحات مرجع Kotlin و Java برای بسته های موجود در هر مصنوع.
کتابخانه های جت پک
برخی از کتابخانه های AndroidX، مانند دوربین، چندین مصنوع دارند که به طور جداگانه نگهداری می شوند. این کتابخانه ها با ستاره (*) مشخص شده اند. برای مشاهده بهروزرسانیهای نسخه برای همه مصنوعات، یادداشتهای انتشار را ببینید.