کتابخانههای جتپک جدا از سیستمعامل اندروید عرضه میشوند، بنابراین بهروزرسانیهای کتابخانهها میتوانند بهطور مستقل و با فواصل زمانی بیشتری انجام شوند.
این کتابخانهها برای سازگاری باینری ، از نسخهبندی معنایی دقیقی پیروی میکنند و یک توالی بین نسخهای از نسخههای قبل از انتشار به آنها اضافه شده است. یک رشته نسخه (مانند 1.0.1-beta02 ) شامل سه عدد است که نشاندهنده سطوح اصلی، فرعی و رفع اشکال هستند. نسخههای قبل از انتشار همچنین دارای پسوندی هستند که مرحله قبل از انتشار (آلفا، بتا، کاندید انتشار) و شماره نسخه (01، 02 و غیره) را مشخص میکند.
لطفاً توجه داشته باشید که کتابخانههای androidx برای حفظ سازگاری سورس در نسخههای فرعی تشویق میشوند، اما الزامی نیستند. دلیل این امر این است که بهروزرسانی نسخه اصلی، تمام مصنوعاتی را که به نسخه اصلی قبلی وابسته هستند، مجبور به انتقال صریح میکند که این امر گردش کار توسعهدهندگان را مختل میکند.
هر نسخه از یک کتابخانه در مسیر خود برای تبدیل شدن به یک نسخه پایدار، از سه مرحله پیش از انتشار عبور میکند. معیارهای هر مرحله پیش از انتشار عبارتند از:
آلفا
- نسخههای آلفا از نظر عملکردی پایدار هستند، اما ممکن است از نظر ویژگیها کامل نباشند.
- در حالی که یک نسخه در مرحله آلفا است، APIها ممکن است اضافه، حذف یا تغییر داده شوند.
بتا
- نسخههای بتا از نظر عملکردی پایدار هستند و دارای یک رابط برنامهنویسی کاربردی (API) با تمام امکانات میباشند.
- آنها آماده استفاده در محیط عملیاتی هستند اما ممکن است حاوی اشکالاتی باشند.
- یک نسخه بتا نمیتواند از ویژگیهای کامپایلر آزمایشی (مانند
@UseExperimental) استفاده کند. - وابستگیها به کتابخانههای دیگر باید نسخههای بتا، آر سی یا پایدار باشند. هیچ وابستگی آلفایی مجاز نیست.
کاندیدای انتشار (RC)
- یک نسخه کاندید انتشار، یک نسخه پایدار احتمالی است.
- ممکن است حاوی اصلاحات حیاتی و دقیقه نودی باشد.
- سطح API آن نهایی است.
- وابستگیها به کتابخانههای دیگر فقط باید نسخههای rc یا stable باشند.
یک کتابخانه میتواند همزمان چندین نسخه داشته باشد. هر نسخه مرحله انتشار متفاوتی دارد. برای مثال، در حالی که نسخه پایدار androidx.activity میتواند 1.0.0 باشد، ممکن است یک نسخه 1.1.0-beta02 و همچنین یک نسخه 2.0.0-alpha01 نیز وجود داشته باشد.
برای اطلاع از آخرین بهروزرسانیهای کتابخانهها از این صفحه استفاده کنید.
صفحه یادداشتهای انتشار اخیر AndroidX، کتابخانههایی را که اخیراً تغییر کردهاند فهرست میکند. مخزن Maven گوگل تاریخچه کامل نسخهها را نشان میدهد.
از جدول زیر برای مشاهده جدیدترین نسخههای پایدار و پیشنمایش هر کتابخانه AndroidX استفاده کنید. لینکهای موجود در هر ردیف شما را به یادداشتهای انتشار کتابخانه هدایت میکنند. در یادداشتهای انتشار موارد زیر را خواهید یافت:
- تاریخچه زمانی همه نسخهها.
- یک قطعه کد با اعلانهای پیشفرض وابستگی Gradle برای استفاده از مصنوعات.
- لینکهایی به صفحات مرجع کاتلین و جاوا برای بستههای موجود در هر مصنوع.
حداقل نسخه SDK
کتابخانههای AndroidX مقدار پیشفرض minSdk برابر با ۲۳ دارند. کتابخانههای منفرد ممکن است در مواردی که پشتیبانی از پایینترین نسخه API غیرممکن یا بسیار گران است، از minSdk بالاتری استفاده کنند. minSdk پیشفرض برای پوشش ۹۹٪ از کاربران اندروید بر اساس اطلاعات ورود به فروشگاه Google Play در نظر گرفته شده است، همانطور که در ویزارد پروژه جدید اندروید استودیو نشان داده شده است. مقدار پیشفرض سالانه بهروزرسانی میشود. minSdk پیشفرض فقط بر نسخههای جدید کتابخانه تأثیر میگذارد، بنابراین مصنوعات منتشر شده قبلی تحت تأثیر قرار نمیگیرند و ممکن است از minSdk پایینتری پشتیبانی کنند.
کتابخانههای جتپک
برخی از کتابخانههای AndroidX، مانند دوربین، دارای چندین مصنوعات هستند که به طور جداگانه نگهداری میشوند. این کتابخانهها با ستاره (*) مشخص شدهاند. برای مشاهده بهروزرسانیهای نسخه برای همه مصنوعات، به یادداشتهای انتشار مراجعه کنید.
(*) این کتابخانه مصنوعات متعددی دارد. برای اطلاعات بیشتر به یادداشتهای انتشار آن مراجعه کنید.
آخرین بهروزرسانی: ۶ مه ۲۰۲۶