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

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

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

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

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

com.android.support:support-compat:28.0.0

الإصدار 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. الإصدار 4 صف واحد (Fragment) هو صف مستقل إصلاحات أخطاء تمت إضافتها في إصدارات لاحقة من النظام الأساسي، في حين أن الإصدار 13 من فئة FragmentCompat الذي توفّره الفئة أنظمة التوافق لتنفيذ إطار العمل صف واحد (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

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

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

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

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

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

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

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

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

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

com.android.support:appcompat-v7:28.0.0

الإصدار 7 من مكتبة مشاهدة البطاقة

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

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

com.android.support:cardview-v7:28.0.0

الإصدار 7 من مكتبة تخطيط الشبكة

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

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

com.android.support:gridlayout-v7:28.0.0

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

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

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

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

com.android.support:mediarouter-v7:28.0.0

واجهات برمجة تطبيقات مكتبة mediarouter‏ v7 التي تم تقديمها في الإصدار 18 من مكتبة Support Library подлежат изменению в более поздних версиях مكتبة Support Library. في هذا الوقت نقترح استخدام المكتبة مع ميزة Google Cast فقط.

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

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

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

com.android.support:palette-v7:28.0.0

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

تضيف مكتبة إعادة التدوير 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

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

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

مكتبة v8 renderscript

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

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

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

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

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

ملاحظة: توفّر مكتبة المقاطع في الإصدار 4 فئة Fragment. الإصدار 4 صف واحد (Fragment) هو صف مستقل إصلاحات أخطاء تمت إضافتها في إصدارات لاحقة من النظام الأساسي، في حين أن الإصدار 13 من فئة FragmentCompat الذي توفّره الفئة أنظمة التوافق لتنفيذ إطار العمل صف واحد (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. للحصول على تفاصيل للحصول على معلومات حول الإصدار 17 من Preference Support Library API، يمكنك الاطّلاع على الخيار المفضّل حزمة في مرجع واجهة برمجة التطبيقات.

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

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

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

توفّر حزمة 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

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

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

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

com.android.support:support-annotations:28.0.0

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

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

تضيف مكتبة دعم التصميم دعمًا لمختلف مكونات وأنماط تصميم المواد تطوير التطبيقات، مثل أدراج التنقّل وأزرار الإجراءات العائمة (FAB) وعلامات التبويب

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

com.android.support:design:28.0.0

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

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

تضيف مكتبة "دعم علامات التبويب المخصصة" دعمًا لفئات متنوعة، مثل علامات التبويب المخصّصة الخدمة أو علامات التبويب المخصصة معاودة الاتصال:

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

com.android.support:customtabs:28.0.0

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

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

ملاحظة: اعتبارًا من الإصدار 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 تنسيق أولي (DNG وCR2 وNEF وNRW وARW وRW2 وORF وPEF وSRW وRAF) وإعداد معلومات Exif على ملفات صور JPEG.

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

com.android.support:exifinterface:28.0.0

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

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

وتتيح مكتبة التطبيقات استخدام التعليقات التوضيحية مثل Contentrecommended.ContentMaturity وفئات مختلفة، مثل المحتوى المقترَح أو أداة توسيع الاقتراحات

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

com.android.support:recommendation:28.0.0

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

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

لمزيد من المعلومات، يُرجى مراجعة باستخدام مكتبة واجهة المستخدم على Wear

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

com.android.support:wear:28.0.0