پشتیبانی از بسته های کتابخانه

توجه: با انتشار Support Library 28.0.0، کتابخانه‌های بسته‌بندی‌شده android.support منسوخ شده و با نسخه‌های جداگانه کتابخانه‌های Jetpack که به‌عنوان androidx بسته‌بندی شده‌اند جایگزین می‌شوند. نسخه اولیه 1.0.0 کتابخانه‌های Jetpack برابری با پشتیبانی کتابخانه 28.0.0 را فراهم می‌کند و نقطه شروعی را برای مهاجرت به بسته‌بندی جدید androidx فراهم می‌کند.

کتابخانه های موجود با بسته بندی android.support به کار خود ادامه خواهند داد. با این حال، آنها هیچ به روز رسانی بیش از 28.0.0 دریافت نخواهند کرد و با کتابخانه های جدید Jetpack سازگار نخواهند بود. مصنوعات تاریخی (آنهایی که نسخه‌های 27 و پیش‌تر و بسته‌بندی‌شده به عنوان android.support ) در Google Maven در دسترس خواهند بود. تمام مصنوعات جدید به عنوان androidx بسته بندی می شوند و به مهاجرت از android.support به androidx نیاز دارند.

توصیه می کنیم از کتابخانه های androidx در کلیه پروژه های جدید استفاده کنید. شما همچنین باید مهاجرت پروژه های موجود را در نظر بگیرید تا اطمینان حاصل کنید که آنها همچنان به رفع اشکال و سایر پیشرفت های کتابخانه پرداختند.

کتابخانه پشتیبانی Android شامل چندین بسته کتابخانه ای است که می تواند در برنامه شما گنجانده شود. هر یک از این کتابخانه ها از طیف خاصی از نسخه های پلت فرم Android و مجموعه ای از ویژگی ها پشتیبانی می کنند.

برای استفاده از هر یک از کتابخانه های زیر ، باید پرونده های کتابخانه را در نصب Android SDK خود بارگیری کنید. برای تکمیل این مرحله ، دستورالعمل های بارگیری کتابخانه های پشتیبانی را در تنظیم کتابخانه پشتیبانی دنبال کنید. شما باید برای گنجاندن یک کتابخانه پشتیبانی خاص در برنامه خود اقدامات دیگری انجام دهید. برای اطلاعات مهم در مورد چگونگی درج کتابخانه در برنامه خود ، به انتهای هر بخش کتابخانه در زیر مراجعه کنید.

توجه: حداقل نسخه SDK برای کلیه بسته های کتابخانه پشتیبانی حداقل سطح API 14 است. برخی از بسته ها همانطور که در زیر ذکر شده است ، به سطح API بالاتر نیاز دارند.

کتابخانه های پشتیبانی v4

این کتابخانه ها شامل بزرگترین مجموعه API در مقایسه با سایر کتابخانه ها ، از جمله پشتیبانی از مؤلفه های کاربردی ، ویژگی های رابط کاربری ، دسترسی ، دسترسی به داده ها ، اتصال شبکه و برنامه های برنامه نویسی هستند.

برای اطلاعات کامل و دقیق در مورد کلاس ها و روش های ارائه شده توسط کتابخانه های پشتیبانی V4 ، به بسته android.support.v4 در مرجع API مراجعه کنید.

توجه: قبل از حمایت از تجدید نظر در کتابخانه 24.2.0 ، یک کتابخانه پشتیبانی V4 واحد وجود داشت. آن کتابخانه برای بهبود کارآیی به ماژول های متعدد تقسیم شد. برای سازگاری به عقب ، اگر support-v4 در اسکریپت Gradle خود لیست کنید ، برنامه شما شامل همه ماژول های V4 خواهد بود. با این حال ، برای کاهش اندازه برنامه ، توصیه می کنیم فقط ماژول های خاص برنامه خود را لیست کنید.

کتابخانه سازگار V4

بسته بندی های سازگاری را برای تعدادی از API های چارچوب مانند Context.obtainDrawable() و View.performAccessibilityAction() فراهم می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-compat:28.0.0

کتابخانه V4 Core-UTILS

تعدادی کلاس ابزار مانند AsyncTaskLoader و PermissionChecker را ارائه می دهد.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-core-utils:28.0.0

کتابخانه V4 Core-UI

انواع مؤلفه های مرتبط با UI ، مانند ViewPager ، NestedScrollView و ExploreByTouchHelper را پیاده سازی می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-core-ui:28.0.0

کتابخانه رسانه ای V4

بخش هایی از چارچوب رسانه ، از جمله MediaBrowser و MediaSession .

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-media-compat:28.0.0

کتابخانه قطعه v4

پشتیبانی از محاصره رابط کاربری و عملکرد با قطعات را اضافه می کند و برنامه ها را قادر می سازد تا طرح هایی را ارائه دهند که بین دستگاه های کوچک و بزرگ تنظیم شود. این ماژول وابستگی به سازهای سازگار ، هسته اصلی ، هسته اصلی و رسانه ای دارد.

توجه: کتابخانه پشتیبانی V13 یک کلاس FragmentCompat را ارائه می دهد. کلاس Fragment V4 یک کلاس مستقل است که اشکالات را ارائه می دهد که در نسخه های بعدی پلت فرم اضافه شده است ، در حالی که کلاس V13 FragmentCompat باعث ایجاد سازگاری برای اجرای چارچوب کلاس Fragment می شود.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-fragment:28.0.0

کتابخانه پشتیبانی چند منظوره

این کتابخانه پشتیبانی از برنامه های ساختمانی با چندین پرونده اجرایی Dalvik (DEX) را فراهم می کند. برنامه هایی که به بیش از 65536 روش مراجعه می کنند ، برای استفاده از تنظیمات Multidex مورد نیاز هستند. برای کسب اطلاعات بیشتر در مورد استفاده از MultIDEX ، به برنامه های ساختمان با بیش از 64K روش مراجعه کنید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:multidex:1.0.0

کتابخانه های پشتیبانی V7

این کتابخانه ها مجموعه های خاص را ارائه می دهند و می توانند به طور مستقل از یکدیگر در برنامه شما گنجانده شوند.

کتابخانه V7 AppCompat بخشی از Android Jetpack .

توجه: کتابخانه AppCompat به کتابخانه Androidx که یک مؤلفه Android Jetpack است ، مهاجرت کرده است. آن را در برنامه نسخه ی نمایشی آفتابگردان مشاهده کنید.

این کتابخانه پشتیبانی از الگوی طراحی رابط کاربری Action Bar را اضافه می کند. این کتابخانه شامل پشتیبانی از پیاده سازی رابط کاربری طراحی مواد است.

توجه: این کتابخانه به کتابخانه پشتیبانی V4 بستگی دارد.

در اینجا تعدادی از کلاسهای کلیدی موجود در کتابخانه V7 AppCompat آورده شده است:

• ActionBar - اجرای الگوی رابط کاربری Action Bar را ارائه می دهد. برای اطلاعات بیشتر در مورد استفاده از نوار عمل ، به راهنمای توسعه دهنده Action Bar مراجعه کنید.
• AppCompatActivity - یک کلاس فعالیت برنامه را اضافه می کند که می تواند به عنوان یک کلاس پایه برای فعالیت هایی که از اجرای نوار اقدام کتابخانه پشتیبانی استفاده می کنند ، استفاده شود.
• AppCompatDialog - یک کلاس گفتگو را اضافه می کند که می تواند به عنوان یک کلاس پایه برای گفتگوی مضمون AppCompat استفاده شود.
• ShareActionProvider - پشتیبانی از یک اقدام به اشتراک گذاری استاندارد (مانند ایمیل یا ارسال به برنامه های اجتماعی) را که می تواند در یک نوار عمل گنجانده شود ، می افزاید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:appcompat-v7:28.0.0

کتابخانه V7 Cardview

این کتابخانه پشتیبانی از ویجت CardView را اضافه می کند ، که به شما امکان می دهد اطلاعات را در داخل کارت هایی که نگاه مداوم به هر برنامه دارند ، نشان دهید. این کارت ها برای پیاده سازی های طراحی مواد مفید هستند و به طور گسترده در چیدمان برای برنامه های تلویزیونی استفاده می شوند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:cardview-v7:28.0.0

کتابخانه v7 gridlayout

پس از بارگیری کتابخانه های پشتیبانی Android ، این کتابخانه پشتیبانی از کلاس GridLayout را اضافه می کند ، که به شما امکان می دهد عناصر رابط کاربری را با استفاده از یک شبکه از سلولهای مستطیل شکل ترتیب دهید. برای کسب اطلاعات دقیق در مورد API های کتابخانه V7 GridLayout ، به بسته android.support.v7.widget در مرجع API مراجعه کنید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:gridlayout-v7:28.0.0

کتابخانه V7 Mediarouter

این کتابخانه MediaRouter ، MediaRouteProvider و کلاس های رسانه ای مرتبط را ارائه می دهد که از Google Cast پشتیبانی می کند.

به طور کلی ، API های موجود در کتابخانه V7 Mediarouter وسیله ای برای کنترل مسیریابی کانال های رسانه ای و جریان از دستگاه فعلی به صفحه های خارجی ، بلندگوها و سایر دستگاه های مقصد ارائه می دهند. این کتابخانه شامل API برای انتشار ارائه دهندگان مسیر رسانه ای خاص ، برای کشف و انتخاب دستگاه های مقصد ، بررسی وضعیت رسانه و موارد دیگر است. برای کسب اطلاعات دقیق در مورد API های کتابخانه V7 Mediarouter ، به بسته android.support.v7.media در مرجع API مراجعه کنید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:mediarouter-v7:28.0.0

API های کتابخانه V7 Mediarouter که در کتابخانه پشتیبانی R18 معرفی شده اند ، در اصلاحات بعدی کتابخانه پشتیبانی تغییر می کنند. در این زمان ، توصیه می کنیم فقط در ارتباط با Google Cast از کتابخانه استفاده کنید.

کتابخانه پالت V7

کتابخانه پشتیبانی پالت V7 شامل کلاس Palette است که به شما امکان می دهد رنگ های برجسته ای را از یک تصویر استخراج کنید. به عنوان مثال ، یک برنامه موسیقی می تواند از یک شیء Palette برای استخراج رنگ های اصلی از یک جلد آلبوم استفاده کند و از آن رنگ ها برای ساخت کارت عنوان آهنگ هماهنگ رنگ استفاده کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:palette-v7:28.0.0

کتابخانه بازیافت V7

کتابخانه Recyclerview کلاس RecyclerView را اضافه می کند. این کلاس با ارائه یک پنجره محدود از موارد داده ، پشتیبانی از ویجت RecyClerview را ارائه می دهد ، منظره ای برای نمایش کارآمد مجموعه داده های بزرگ.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:recyclerview-v7:28.0.0

کتابخانه پشتیبانی اولویت V7

بسته اولویت API ها را برای پشتیبانی از اضافه کردن اشیاء ترجیح ، مانند CheckBoxPreference و ListPreference ، برای کاربران برای تغییر تنظیمات UI فراهم می کند.

کتابخانه اولویت V7 پشتیبانی از رابط ها ، مانند Preference.OnPreferenceChangeListener و Preference.OnPreferenceClickListener و کلاس ها مانند CheckBoxPreference و ListPreference را اضافه می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:preference-v7:28.0.0

کتابخانه پشتیبانی V8

این کتابخانه مجموعه های خاص را ارائه می دهد و می تواند به طور مستقل از سایر کتابخانه ها در برنامه شما گنجانده شود.

کتابخانه v8 renderscript

این کتابخانه پشتیبانی از چارچوب محاسبه Renderscript را اضافه می کند. این API ها در بسته android.support.v8.renderscript گنجانده شده اند. باید توجه داشته باشید که مراحل شامل این API ها در برنامه شما با سایر API های کتابخانه پشتیبانی بسیار متفاوت است. برای کسب اطلاعات بیشتر در مورد استفاده از این API ها در برنامه خود ، به راهنمای توسعه دهنده Renderscript مراجعه کنید.

توجه: استفاده از RenderScript با کتابخانه پشتیبانی با استودیوی اندرویدی و ساختهای مبتنی بر Gradle پشتیبانی می شود. کتابخانه Renderscript در build-tools/$VERSION/renderscript/ پوشه واقع شده است.

مثال زیر خصوصیات اسکریپت ساخت Gradle Build را برای این کتابخانه نشان می دهد:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

کتابخانه پشتیبانی V13

این کتابخانه پشتیبانی از الگوی رابط کاربری قطعه را با کلاس ( FragmentCompat ) و کلاس های پشتیبانی قطعه اضافی اضافه می کند. برای کسب اطلاعات بیشتر در مورد قطعات ، به راهنمای توسعه بخش قطعات مراجعه کنید. برای کسب اطلاعات دقیق در مورد API های کتابخانه پشتیبانی V13 ، به بسته android.support.v13 در مرجع API مراجعه کنید.

توجه: کتابخانه قطعه V4 یک کلاس Fragment را ارائه می دهد. کلاس Fragment V4 یک کلاس مستقل است که اشکالات را ارائه می دهد که در نسخه های بعدی پلت فرم اضافه شده است ، در حالی که کلاس V13 FragmentCompat باعث ایجاد سازگاری برای اجرای چارچوب کلاس Fragment می شود.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-v13:28.0.0

کتابخانه پشتیبانی اولویت V14

بسته android.support.v14.preference API را برای اضافه کردن پشتیبانی از رابط های اولویت مانند PreferenceFragment.OnPreferenceStartFragmentCallback و PreferenceFragment.OnPreferenceStartScreenCallback ، همراه با کلاس ها ، مانند کلاس ها ، مانند MultiSelectListPreference و PreferenceFragment . برای کسب اطلاعات دقیق در مورد API های کتابخانه پشتیبانی اولویت V14 ، به بسته اولویت در مرجع API مراجعه کنید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:preference-v14:28.0.0

کتابخانه پشتیبانی اولویت V17 برای تلویزیون

بسته android.support.v17.preference . Prepeference API را برای ارائه رابط های اولویت در دستگاه های تلویزیونی ، از جمله پشتیبانی از LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener و کلاس ها ، مانند BaseLeanbackPreferenceFragment و LeanbackPreferenceFragment فراهم می کند. برای کسب اطلاعات دقیق در مورد API های کتابخانه پشتیبانی اولویت V17 ، به بسته اولویت در مرجع API مراجعه کنید.

این بسته به سطح 17 یا بالاتر API نیاز دارد. شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

 com.android.support:preference-leanback-v17:28.0.0 

کتابخانه Leanback V17

android.support.v17.leanback API ها را برای پشتیبانی از ایجاد رابط های کاربر در دستگاه های تلویزیونی فراهم می کند. تعدادی ابزارک مهم برای برنامه های تلویزیونی فراهم می کند. برخی از کلاسهای قابل توجه عبارتند از:

• BrowseFragment - قطعه ای برای ایجاد طرح اصلی برای مرور دسته ها و ردیف های موارد رسانه ای.
• DetailsFragment - یک قطعه بسته بندی برای صفحه نمایش جزئیات لاغر.
• PlaybackOverlayFragment - یک زیر کلاس از DetailsFragment برای نمایش کنترل های پخش و محتوای مرتبط.
• SearchFragment - قطعه ای برای رسیدگی به جستجو. این قطعه درخواست جستجوی کاربر را دریافت می کند و آن را به SearchResultProvider ارائه شده توسط برنامه منتقل می کند. SearchResultProvider نتایج جستجو را به SearchFragment باز می گرداند ، که آنها را به یک RowsFragment تبدیل می کند.

این بسته به سطح 17 یا بالاتر API نیاز دارد. شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:leanback-v17:28.0.0

کتابخانه قابل ترسیم بردار

پشتیبانی از گرافیک بردار استاتیک را فراهم می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-vector-drawable:28.0.0

کتابخانه کشنده بردار انیمیشن

پشتیبانی از گرافیک های بردار متحرک را فراهم می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:animated-vector-drawable:28.0.0

یادداشت ها کتابخانه پشتیبانی

بسته حاشیه نویسی API را برای پشتیبانی از اضافه کردن ابرداده حاشیه نویسی به برنامه های شما فراهم می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:support-annotations:28.0.0

طراحی کتابخانه پشتیبانی

بسته طراحی API را برای پشتیبانی از افزودن مؤلفه ها و الگوهای طراحی مواد به برنامه های شما فراهم می کند.

کتابخانه پشتیبانی طراحی ، پشتیبانی از مؤلفه ها و الگوهای مختلف طراحی مواد را برای توسعه دهندگان برنامه ، مانند کشوهای ناوبری ، دکمه های اکشن شناور ( FAB ) ، اسنکبر و زبانه ها می افزاید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:design:28.0.0

زبانه های سفارشی از کتابخانه پشتیبانی می کنند

بسته Tabs Custom API را برای پشتیبانی از اضافه کردن و مدیریت زبانه های سفارشی در برنامه های شما فراهم می کند.

کتابخانه پشتیبانی زبانه های سفارشی پشتیبانی از کلاسهای مختلف ، مانند سرویس زبانه های سفارشی و برگه های برگشتی سفارشی را اضافه می کند.

این بسته به سطح 15 یا بالاتر API نیاز دارد. شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:customtabs:28.0.0

درصد کتابخانه پشتیبانی

بسته درصد API ها را برای پشتیبانی از اضافه کردن و مدیریت ابعاد مبتنی بر درصد در برنامه شما فراهم می کند.

توجه: از زمان انتشار 26.0.0 ، کتابخانه پشتیبانی درصد کاهش می یابد. مشتریان این ماژول باید به ویجت جدید ConstraintLayout ، که به عنوان یک مصنوعات جداگانه در SDK Manager ارائه شده است ، مهاجرت کنند.

کتابخانه پشتیبانی درصد پشتیبانی از رابط HESENTLAYOUTHELPER.PERCESTLAYOUTPARAMS و کلاسهای مختلف مانند درصد درصد و درصدی regeRelativeLayout را می افزاید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:percent:28.0.0

کتابخانه پشتیبانی exifinterface

برچسب های EXIF ​​اطلاعاتی مانند جهت گیری ، تاریخ و زمان ، اطلاعات دوربین و مکان را مستقیماً در یک پرونده JPEG یا RAW ذخیره می کنند. پشتیبانی از کلاس ExifInterface از خواندن اطلاعات exif از JPEG و RAW (DNG ، CR2 ، NEF ، NRW ، ARW ، RW2 ، ORF ، PEF ، SRW و RAF) پشتیبانی می کند و اطلاعات EXIF ​​را در پرونده های تصویر JPEG تنظیم می کند.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:exifinterface:28.0.0

کتابخانه پشتیبانی توصیه برنامه برای تلویزیون

بسته توصیه برنامه API را برای پشتیبانی از اضافه کردن توصیه های محتوا در برنامه شما که در دستگاه های تلویزیونی اجرا می شوند ، فراهم می کند.

کتابخانه برنامه پشتیبانی از حاشیه نویسی ها ، مانند ContentRecomendation.ContentMaturation و کلاس های مختلف ، مانند محتوای محتوا و توصیه و توصیه را می افزاید.

این بسته به سطح 21 یا بالاتر API نیاز دارد. شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:recommendation:28.0.0

از کتابخانه UI بپوشید

این کتابخانه دارای API برای ساختن رابط های کاربر برای برنامه های Wear است. API ها ، موجود در بسته Android.support.wear.widget ، API های مربوطه را در کتابخانه پشتیبانی پوشیدنی جایگزین می کنند.

برای اطلاعات بیشتر ، به استفاده از کتابخانه Wear UI مراجعه کنید.

شناسه وابستگی اسکریپت Gradle Build برای این کتابخانه به شرح زیر است:

com.android.support:wear:28.0.0