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

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

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

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

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

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

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

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

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

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

com.android.support:support-fragment:28.0.0

مكتبة دعم Multidex

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

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

com.android.support:multidex:1.0.0

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

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

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

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

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

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

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

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

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

com.android.support:appcompat-v7:28.0.0

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

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

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

com.android.support:cardview-v7:28.0.0

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

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

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

com.android.support:gridlayout-v7:28.0.0

الإصدار 7 من مكتبة أداة توجيه الوسائط (mediarouter)

توفّر هذه المكتبة صفوف MediaRouter وMediaRouteProvider وصفوف وسائط ذات صلة تتوافق مع Google Cast.

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

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

com.android.support:mediarouter-v7:28.0.0

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

مكتبة لوحة الألوان 7

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

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

com.android.support:palette-v7:28.0.0

الإصدار 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 من مكتبة الدعم

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

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

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

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

يوضّح المثال التالي خصائص النص البرمجي لإنشاء Gradle لهذه المكتبة:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

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

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

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

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

com.android.support:support-v13:28.0.0

الإصدار 14 من مكتبة Favorite Support

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

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

com.android.support:preference-v14:28.0.0

الإصدار 17 من مكتبة التفضيلات المتوافقة مع التلفزيون

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

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

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

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

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

com.android.support:support-annotations:28.0.0

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

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

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

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

com.android.support:design:28.0.0

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

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

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

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

com.android.support:customtabs:28.0.0

مكتبة دعم Percent

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

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

تضيف مكتبة Percent Support واجهة PercentLayoutHelper.PercentLayoutParams وفئات مختلفة، مثل PercentFrameLayout و PercentPercentLayout.

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

com.android.support:percent:28.0.0

مكتبة دعم ExifInterface

تخزِّن علامات EXIF معلومات، مثل الاتجاه والتاريخ والوقت ومعلومات الكاميرا والموقع الجغرافي مباشرةً في ملف بتنسيق JPEG أو RAW. تتيح الفئة ExifInterface إمكانية قراءة معلومات Exif من ملفات JPEG وROL (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 OS. وتحلّ واجهات برمجة التطبيقات المتوفّرة في حزمة android.support.wear.Widget محلّ واجهات برمجة التطبيقات المقابلة في مكتبة الدعم للأجهزة القابلة للارتداء.

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

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

com.android.support:wear:28.0.0