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

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

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

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

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

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

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

مكتبات الدعم من الإصدار 4

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

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

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

مكتبة التوافق مع الإصدار 4

يوفّر وظائف لفّ التوافق لعدد من واجهات برمجة تطبيقات الإطارات، مثل Context.obtainDrawable() و View.performAccessibilityAction().

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

com.android.support:support-compat:28.0.0

مكتبة core-utils الإصدار 4

يوفّر عددًا من فئات الأدوات، مثل AsyncTaskLoader وPermissionChecker.

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

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

مكتبة واجهة المستخدم الأساسية للإصدار 4

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

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

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

مكتبة media-compat الإصدار 4

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

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

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

مكتبة الأجزاء في الإصدار 4

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

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

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

com.android.support:support-fragment:28.0.0

مكتبة دعم Multidex

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

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

com.android.support:multidex:1.0.0

مكتبات الدعم في الإصدار 7

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

مكتبة appcompat الإصدار 7   جزء من Android Jetpack.

ملاحظة: تم نقل مكتبة appcompat إلى مكتبة AndroidX، وهي مكوّن من Android Jetpack. يمكنك الاطّلاع على هذه الميزة في تطبيق الإصدار التجريبي من Sunflower.

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

ملاحظة: تعتمد هذه المكتبة على مكتبة الدعم الإصدار 4.

في ما يلي بعض الفئات الرئيسية المضمّنة في مكتبة appcompat الإصدار 7:

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

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

com.android.support:appcompat-v7:28.0.0

مكتبة cardview الإصدار 7

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

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

com.android.support:cardview-v7:28.0.0

مكتبة تنسيق الشبكة في الإصدار 7

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

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

com.android.support:gridlayout-v7:28.0.0

مكتبة v7 mediarouter

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

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

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

com.android.support:mediarouter-v7:28.0.0

إنّ واجهات برمجة تطبيقات مكتبة mediarouter من الإصدار 7 التي تم تقديمها في الإصدار 18 من مكتبة Support Library قد تتغيّر في النُسخ اللاحقة من مكتبة Support Library. في الوقت الحالي، ننصح باستخدام المكتبة فقط مع Google Cast.

مكتبة لوحة الألوان في الإصدار 7

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

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

com.android.support:palette-v7:28.0.0

مكتبة recyclerview الإصدار 7

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

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

com.android.support:recyclerview-v7:28.0.0

مكتبة دعم الإعدادات المفضّلة من الإصدار 7

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

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

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

com.android.support:preference-v7:28.0.0

مكتبة دعم V8

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

مكتبة v8 renderscript

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

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

يعرض المثال التالي سمات نص Gradle البرمجي لإنشاء هذه المكتبة:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

مكتبة الدعم الإصدار 13

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

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

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

com.android.support:support-v13:28.0.0

مكتبة دعم الإعدادات المفضّلة في الإصدار 14

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

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

com.android.support:preference-v14:28.0.0

مكتبة دعم الإعدادات المفضّلة في الإصدار 17 لأجهزة التلفزيون

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

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

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

الإصدار 17 من مكتبة Leanback

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

  • BrowseFragment: مقتطف لإنشاء تنسيق أساسي لتصفّح فئات وصفوف عناصر الوسائط
  • DetailsFragment - مقتطف ملف لفٍ لشاشات تفاصيل Leanback
  • ‫PlaybackOverlayFragment: ملف شخصي فرعي من DetailsFragment لأجل عرض عناصر التحكّم في التشغيل والمحتوى ذي الصلة
  • SearchFragment - مقتطف لمعالجة عمليات البحث يتلقّى المقتطف طلب البحث من المستخدم ويمرّره إلى SearchResultProvider المقدَّمة من التطبيق. يعرض العنصر SearchResultProvider نتائج البحث في الجدول SearchFragment، ما يؤدي إلى عرضها كجدول RowsFragment.

تتطلّب هذه الحزمة المستوى 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

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

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

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

com.android.support:support-annotations:28.0.0

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

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

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

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

com.android.support:design:28.0.0

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

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

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

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

com.android.support:customtabs:28.0.0

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

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

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

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

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

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 البرمجي لهذه المكتبة: 

com.android.support:exifinterface:28.0.0

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

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

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

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

com.android.support:recommendation:28.0.0

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

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

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

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

com.android.support:wear:28.0.0