حِزم مكتبة الدعم

ملاحظة: مع إصدار مكتبة الدعم 28.0.0، تم إيقاف مكتبات حزمة android.support نهائيًا واستبدالها بمكتبات Jetpack ذات الإصدارات الفردية والمجمّعة في حزمة androidx. يوفّر الإصدار الأولي 1.0.0 من مكتبات Jetpack التكافؤ مع Support Library 28.0.0، كما يوفّر نقطة بداية للانتقال إلى حزمة migrating الجديدة androidx.

ستستمر مكتبات حزمة android.support-الحالية في العمل، ولكنها لن تتلقّى أي تحديثات بعد الإصدار 28.0.0 ولن تكون متوافقة مع مكتبات Jetpack الجديدة. ستظل العناصر القديمة (الإصدارات 27 والإصدارات الأقدم، والمجمّعة في حزمة android.support) متاحة على Google Maven. سيتم تجميع كل العناصر الجديدة في حزمة androidx وستتطلّب نقل البيانات من android.support إلى androidx.

ننصح باستخدام مكتبات androidx في جميع المشاريع الجديدة. عليك أيضًا التفكير في نقل المشاريع الحالية لضمان استمرار تلقّيها لإصلاحات الأخطاء والتحسينات الأخرى في المكتبة.

تحتوي مكتبة دعم Android على عدة حزم مكتبات يمكن تضمينها في تطبيقك. تتوافق كل من هذه المكتبات مع نطاق محدّد من إصدارات نظام Android الأساسي ومجموعة من الميزات.

لاستخدام أي من المكتبات التالية، عليك تنزيل ملفات المكتبة إلى تثبيت حزمة تطوير البرامج (SDK) لنظام التشغيل Android. اتّبِع التعليمات الخاصة بتنزيل مكتبات الدعم في إعداد مكتبة الدعم لإكمال هذه الخطوة. عليك اتّخاذ خطوات إضافية لتضمين مكتبة دعم معيّنة في تطبيقك. اطّلِع على نهاية كل قسم من أقسام المكتبة أدناه للحصول على معلومات مهمة حول كيفية تضمين المكتبة في تطبيقك.

ملاحظة: الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) لجميع حزم مكتبة الدعم هو المستوى 14 من واجهة برمجة التطبيقات على الأقل. تتطلّب بعض الحزم مستوى أعلى من واجهة برمجة التطبيقات، كما هو موضّح أدناه.

مكتبات الدعم v4

تتضمّن هذه المكتبات أكبر مجموعة من واجهات برمجة التطبيقات مقارنةً بالمكتبات الأخرى، بما في ذلك إمكانية استخدام مكوّنات التطبيق وميزات واجهة المستخدم، إمكانية الوصول ومعالجة البيانات والاتصال بالشبكة وبرامج الخدمات.

للحصول على معلومات كاملة ومفصّلة عن الفئات والطرق التي توفّرها مكتبات الدعم v4، اطّلِع على حزمة android.support.v4 في المستندات المرجعية لواجهة برمجة التطبيقات.

ملاحظة: قبل الإصدار 24.2.0 من Support Library، كانت هناك مكتبة دعم واحدة فقط من الإصدار v4. تم تقسيم هذه المكتبة إلى وحدات متعددة لتحسين الكفاءة. لضمان التوافق مع الإصدارات السابقة، إذا أدرجت support-v4 في نص Gradle البرمجي، سيشمل تطبيقك جميع وحدات الإصدار v4. ومع ذلك، لتقليل حجم التطبيق، ننصحك بإدراج الوحدات المحدّدة التي يحتاجها تطبيقك فقط.

مكتبة التوافق v4

توفّر هذه المكتبة أغلفة التوافق لعدد من واجهات برمجة التطبيقات الخاصة بالإطار، مثل Context.obtainDrawable() و View.performAccessibilityAction().

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:support-compat:28.0.0

مكتبة core-utils v4

توفّر هذه المكتبة عددًا من فئات برامج الخدمات، مثل AsyncTaskLoader وPermissionChecker.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

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

مكتبة core-ui v4

تنفّذ هذه المكتبة مجموعة متنوعة من المكوّنات ذات الصلة بواجهة المستخدم، مثل ViewPager وNestedScrollView وExploreByTouchHelper.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

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

مكتبة media-compat v4

توفر هذه المكتبة أجزاء من إطار الوسائط، بما في ذلك MediaBrowser وMediaSession.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

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

مكتبة الأجزاء v4

تضيف هذه المكتبة إمكانية تغليف واجهة المستخدم والوظائف باستخدام الأجزاء، ما يتيح للتطبيقات توفير تنسيقات تتكيّف بين الأجهزة ذات الشاشات الصغيرة و الكبيرة. تعتمد هذه الوحدة على حزم compat وcore-utils وcore-ui وmedia-compat.

ملاحظة: توفّر مكتبة الدعم v13 فئة FragmentCompat. فئة Fragment من الإصدار v4 هي فئة مستقلة توفّر إصلاحات الأخطاء التي تمت إضافتها في إصدارات المنصة اللاحقة، بينما توفّر فئة FragmentCompat من الإصدار v13 أدوات التوافق لتنفيذ الإطار لفئة Fragment.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

com.android.support:support-fragment:28.0.0

مكتبة دعم Multidex

توفّر هذه المكتبة إمكانية إنشاء تطبيقات تتضمّن ملفات Dalvik Executable (DEX) متعددة. يجب أن تستخدم التطبيقات التي تشير إلى أكثر من 65536 طريقة إعدادات multidex. لمزيد من المعلومات عن استخدام multidex، اطّلِع على مقالة إنشاء تطبيقات تتضمّن أكثر من 64 ألف طريقة.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

com.android.support:multidex:1.0.0

مكتبات الدعم v7

توفر هذه المكتبات مجموعات ميزات محددة ويمكن تضمينها في تطبيقك بشكل مستقل عن بعضها البعض.

مكتبة appcompat v7   جزء من Android Jetpack.

ملاحظة: تم نقل مكتبة appcompat إلى مكتبة AndroidX، وهي أحد مكوّنات Android Jetpack. يمكنك الاطّلاع على كيفية استخدامها في تطبيق العرض التوضيحي Sunflower.

تضيف هذه المكتبة إمكانية استخدام نمط تصميم واجهة مستخدم شريط الإجراءات . تتضمّن هذه المكتبة إمكانية استخدام عمليات تنفيذ واجهة مستخدم Material Design.

ملاحظة: تعتمد هذه المكتبة على مكتبة الدعم v4.

في ما يلي بعض الفئات الرئيسية المضمّنة في مكتبة appcompat v7:

  • ActionBar : توفّر هذه الفئة عملية تنفيذ لنمط واجهة مستخدم شريط الإجراءات . لمزيد من المعلومات عن استخدام شريط الإجراءات، اطّلِع على دليل المطوّرين الخاص بشريط الإجراءات.
  • AppCompatActivity : تضيف هذه الفئة فئة نشاط تطبيق يمكن استخدامها كصنف أساسي للأنشطة التي تستخدم عملية تنفيذ شريط الإجراءات في مكتبة الدعم.
  • AppCompatDialog : تضيف هذه الفئة فئة مربّع حوار يمكن استخدامها كفئة أساسية لمربّعات الحوار التي تستخدم مظهر AppCompat.
  • ShareActionProvider : تضيف هذه الفئة إمكانية استخدام إجراء مشاركة موحّد (مثل إرسال رسالة إلكترونية أو النشر على تطبيقات التواصل الاجتماعي) يمكن تضمينه في شريط إجراءات.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:appcompat-v7:28.0.0

مكتبة cardview v7

تضيف هذه المكتبة إمكانية استخدام أداة CardView، التي تتيح لك عرض المعلومات داخل بطاقات ذات مظهر متّسق في أي تطبيق. وتُعدّ هذه البطاقات مفيدة لعمليات تنفيذ Material Design، ويتم استخدامها على نطاق واسع في تنسيقات تطبيقات التلفزيون.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:cardview-v7:28.0.0

مكتبة gridlayout v7

بعد تنزيل مكتبات دعم Android، تضيف هذه المكتبة إمكانية استخدام فئة GridLayout، التي تتيح لك ترتيب عناصر واجهة المستخدم باستخدام شبكة من الخلايا المستطيلة. للحصول على معلومات مفصّلة عن واجهات برمجة التطبيقات في مكتبة gridlayout v7، اطّلِع على حزمة android.support.v7.widget في المستندات المرجعية لواجهة برمجة التطبيقات.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:gridlayout-v7:28.0.0

مكتبة mediarouter v7

توفر هذه المكتبة الفئات MediaRouter وMediaRouteProvider وفئات الوسائط ذات الصلة التي تتيح استخدام Google Cast.

بشكل عام، توفّر واجهات برمجة التطبيقات في مكتبة mediarouter v7 وسيلة للتحكّم في توجيه قنوات الوسائط وتدفّقاتها من الجهاز الحالي إلى الشاشات الخارجية ومكبّرات الصوت وأجهزة الوجهة الأخرى. تتضمّن المكتبة واجهات برمجة تطبيقات لنشر موفّري مسارات الوسائط الخاصة بالتطبيق، ولاكتشاف أجهزة الوجهة واختيارها، وللاطّلاع على حالة الوسائط، وغير ذلك. للحصول على معلومات مفصّلة عن واجهات برمجة التطبيقات في مكتبة mediarouter v7، اطّلِع على حزمة android.support.v7.media في المستندات المرجعية لواجهة برمجة التطبيقات.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:mediarouter-v7:28.0.0

تخضع واجهات برمجة التطبيقات في مكتبة mediarouter v7 التي تم طرحها في الإصدار r18 من Support Library للتغيير في الإصدارات اللاحقة من Support Library. ننصحك حاليًا باستخدام المكتبة فقط بالاقتران مع Google Cast.

مكتبة palette v7

تتضمّن مكتبة دعم palette v7 فئة Palette، التي تتيح لك استخراج الألوان البارزة من صورة. على سبيل المثال، يمكن لتطبيق موسيقى استخدام عنصر Palette لاستخراج الألوان الرئيسية من غلاف ألبوم، واستخدام هذه الألوان لإنشاء بطاقة عنوان أغنية منسّقة الألوان.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:palette-v7:28.0.0

مكتبة recyclerview v7

تضيف مكتبة recyclerview فئة RecyclerView. توفّر هذه الفئة إمكانية استخدام أداة RecyclerView ، وهي طريقة عرض لعرض مجموعات البيانات الكبيرة بكفاءة من خلال توفير نافذة محدودة لعناصر البيانات.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:recyclerview-v7:28.0.0

مكتبة دعم الإعدادات v7

توفر حزمة الإعدادات واجهات برمجة تطبيقات لإضافة عناصر الإعدادات، مثل CheckBoxPreference و ListPreference، ليتمكن المستخدمون من تعديل إعدادات واجهة المستخدم.

تضيف مكتبة الإعدادات v7 إمكانية استخدام الواجهات، مثل Preference.OnPreferenceChangeListener وPreference.OnPreferenceClickListener، والفئات، مثل CheckBoxPreference وListPreference.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:preference-v7:28.0.0

مكتبة الدعم v8

توفر هذه المكتبة مجموعات ميزات محددة ويمكن تضمينها في تطبيقك بشكل مستقل عن المكتبات الأخرى.

مكتبة renderscript v8

تضيف هذه المكتبة إمكانية استخدام إطار عمل الحساب RenderScript. تتضمّن حزمة android.support.v8.renderscript واجهات برمجة التطبيقات هذه. يجب أن تعلم أنّ خطوات تضمين واجهات برمجة التطبيقات هذه في تطبيقك تختلف كثيرًا عن واجهات برمجة التطبيقات الأخرى في Support Library. لمزيد من المعلومات عن استخدام واجهات برمجة التطبيقات هذه في تطبيقك، اطّلِع على دليل المطوّرين الخاص بـ RenderScript.

ملاحظة: يمكن استخدام RenderScript مع Support Library في الإصدارات المستندة إلى Gradle وAndroid Studio. تقع مكتبة renderscript في المجلد build-tools/$VERSION/renderscript/.

يعرض المثال التالي خصائص نص Gradle البرمجي للإصدار لهذه المكتبة:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

مكتبة الدعم v13

تضيف هذه المكتبة إمكانية استخدام نمط واجهة مستخدم Fragment مع فئة (FragmentCompat) وفئات إضافية لدعم الأجزاء. لمزيد من المعلومات عن الأجزاء، اطّلِع على دليل المطوّرين الخاص بالأجزاء. للحصول على معلومات مفصّلة عن واجهات برمجة التطبيقات في مكتبة الدعم v13، اطّلِع على حزمة android.support.v13 في المستندات المرجعية لواجهة برمجة التطبيقات.

ملاحظة: توفّر مكتبة الأجزاء v4 فئة Fragment. فئة Fragment من الإصدار v4 هي فئة مستقلة توفّر إصلاحات الأخطاء التي تمت إضافتها في إصدارات المنصة اللاحقة، بينما توفّر فئة FragmentCompat من الإصدار v13 أدوات التوافق لتنفيذ الإطار لفئة Fragment.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:support-v13:28.0.0

مكتبة دعم الإعدادات v14

توفر حزمة android.support.v14.preference واجهات برمجة تطبيقات لإضافة إمكانية استخدام واجهات الإعدادات، مثل PreferenceFragment.OnPreferenceStartFragmentCallback و PreferenceFragment.OnPreferenceStartScreenCallback، بالإضافة إلى فئات، مثل MultiSelectListPreference و PreferenceFragment. للحصول على معلومات مفصّلة عن واجهات برمجة التطبيقات في مكتبة دعم الإعدادات v14، اطّلِع على حزمة الإعدادات في المستندات المرجعية لواجهة برمجة التطبيقات.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:preference-v14:28.0.0

مكتبة دعم الإعدادات v17 للتلفزيون

توفر حزمة android.support.v17.preference واجهات برمجة تطبيقات لتوفير واجهات الإعدادات على أجهزة التلفزيون، بما في ذلك إمكانية استخدام واجهة LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener والفئات، مثل BaseLeanbackPreferenceFragment وLeanbackPreferenceFragment. للحصول على معلومات مفصّلة عن واجهات برمجة التطبيقات في مكتبة دعم الإعدادات v17، اطّلِع على حزمة الإعدادات في المستندات المرجعية لواجهة برمجة التطبيقات.

تتطلّب هذه الحزمة المستوى 17 من واجهة برمجة التطبيقات أو مستوى أعلى. معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

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

مكتبة Leanback v17

توفر حزمة android.support.v17.leanback واجهات برمجة تطبيقات لإمكانية إنشاء واجهات مستخدم على أجهزة التلفزيون. توفّر هذه الحزمة عددًا من الأدوات المهمة لتطبيقات التلفزيون. في ما يلي بعض الفئات البارزة:

تتطلّب هذه الحزمة المستوى 17 من واجهة برمجة التطبيقات أو مستوى أعلى. معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:leanback-v17:28.0.0

مكتبة الرسومات المتّجهة

توفّر هذه المكتبة إمكانية استخدام الرسومات المتّجهة الثابتة.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

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

مكتبة الرسومات المتّجهة المتحركة

توفّر هذه المكتبة إمكانية استخدام الرسومات المتّجهة المتحركة.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

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

مكتبة دعم التعليقات التوضيحية

توفر حزمة التعليقات التوضيحية واجهات برمجة تطبيقات لإضافة بيانات وصفية للتعليقات التوضيحية إلى تطبيقاتك.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:support-annotations:28.0.0

مكتبة دعم التصميم

توفر حزمة التصميم واجهات برمجة تطبيقات لإضافة مكونات وأنماط Material Design إلى تطبيقاتك.

تضيف مكتبة دعم التصميم إمكانية استخدام مكوّنات وأنماط Material Design المختلفة لـ يتمكّن مطوّرو التطبيقات من الاستفادة منها، مثل أدراج التنقّل والأزرار العائمة (FAB)، والوجبات الخفيفة وعلامات التبويب.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:design:28.0.0

مكتبة دعم علامات التبويب المخصّصة

توفر حزمة علامات التبويب المخصصة واجهات برمجة تطبيقات لإضافة علامات تبويب مخصصة وإدارتها في تطبيقاتك.

تضيف مكتبة دعم علامات التبويب المخصّصة إمكانية استخدام فئات مختلفة، مثل خدمة علامات التبويب المخصّصة و عودة الاتصال بعلامات التبويب المخصّصة.

تتطلّب هذه الحزمة مستوى واجهة برمجة التطبيقات 15 أو مستوى أعلى. معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:customtabs:28.0.0

مكتبة دعم النسب المئوية

توفر حزمة النسب المئوية واجهات برمجة تطبيقات لإضافة أبعاد تستند إلى النسب المئوية وإدارتها في تطبيقك.

ملاحظة: اعتبارًا من الإصدار 26.0.0، تم إيقاف مكتبة دعم النسب المئوية نهائيًا. على العملاء الذين يستخدمون هذه الوحدة الانتقال إلى أداة ConstraintLayout الجديدة، التي يتم توفيرها كعنصر منفصل في "مدير حزمة تطوير البرامج (SDK)".

تضيف مكتبة دعم النسب المئوية إمكانية استخدام واجهة PercentLayoutHelper.PercentLayoutParams وفئات مختلفة، مثل PercentFrameLayout و PercentRelativeLayout.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:percent:28.0.0

مكتبة دعم ExifInterface

تخزّن علامات Exif معلومات مثل الاتجاه والتاريخ والوقت ومعلومات الكاميرا والموقع الجغرافي مباشرةً في ملف JPEG أو RAW. توفر فئة ExifInterface إمكانية قراءة معلومات Exif من ملفات JPEG والملفات الأولية (DNG وCR2 وNEF وNRW وARW وRW2 وORF وPEF وSRW وRAF) وتعيين معلومات Exif في ملفات صور JPEG.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

com.android.support:exifinterface:28.0.0

مكتبة دعم اقتراحات التطبيقات للتلفزيون

توفر حزمة اقتراحات التطبيقات واجهات برمجة تطبيقات لإضافة اقتراحات المحتوى في تطبيقك الذي يتم تشغيله على أجهزة التلفزيون.

تضيف مكتبة التطبيقات إمكانية استخدام التعليقات التوضيحية، مثل ContentRecommendation.ContentMaturity والفئات المختلفة، مثل ContentRecommendation و RecommendationExtender.

تتطلّب هذه الحزمة المستوى 21 من واجهة برمجة التطبيقات أو مستوى أعلى. معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي:

com.android.support:recommendation:28.0.0

مكتبة واجهة مستخدمي Wear

تتضمّن هذه المكتبة واجهات برمجة تطبيقات لإنشاء واجهات مستخدم لتطبيقات Wear. تحلّ واجهات برمجة التطبيقات المتاحة في حزمة android.support.wear.widget محلّ واجهات برمجة التطبيقات المقابلة في Wearable Support Library.

لمزيد من المعلومات، اطّلِع على مقالة استخدام مكتبة واجهة مستخدمي Wear.

معرّف الاعتمادية في نص Gradle البرمجي للإصدار هو كما يلي: 

com.android.support:wear:28.0.0