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

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

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

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

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

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

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

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

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

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

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

الإصدار 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

مكتبة واجهة مستخدم V4 الأساسية

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

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

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

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

الأجزاء الخلفية من إطار عمل media، بما في ذلك 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

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

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

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

com.android.support:multidex:1.0.0

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

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

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

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

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

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

إليك بعض الفئات الأساسية المدرَجة في الإصدار 7 من مكتبة Appcompat:

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

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

com.android.support:appcompat-v7:28.0.0

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

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

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

com.android.support:cardview-v7:28.0.0

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

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

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

com.android.support:gridlayout-v7:28.0.0

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

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

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

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

com.android.support:mediarouter-v7:28.0.0

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

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

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

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

com.android.support:palette-v7:28.0.0

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

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

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

com.android.support:recyclerview-v7:28.0.0

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

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

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

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

com.android.support:preference-v7:28.0.0

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

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

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

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

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

يوضّح المثال التالي سمات النص البرمجي للإصدار Gradle من هذه المكتبة:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

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

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

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

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

com.android.support:support-v13:28.0.0

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

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

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

com.android.support:preference-v14:28.0.0

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

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

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

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

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

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

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

في ما يلي معرّف اعتماد نصوص 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

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

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

تضيف "مكتبة التطبيقات" التعليقات التوضيحية، مثل Contentrecommend.ContentMaturity وفئات مختلفة، مثل Contentrecommend و SuggestExtender

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

com.android.support:recommendation:28.0.0

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

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

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

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

com.android.support:wear:28.0.0
السابق
功能
التالي
设置