کتابخانههای 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، مانند دوربین، چندین مصنوع دارند که به طور جداگانه نگهداری می شوند. این کتابخانه ها با ستاره (*) مشخص شده اند. برای مشاهده بهروزرسانیهای نسخه برای همه مصنوعات، یادداشتهای انتشار را ببینید.