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

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

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

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

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

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

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

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

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

للحصول على معلومات كاملة ومفصّلة حول الفئات والطرق التي توفّرها مكتبات الدعم الإصدار 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

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

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

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

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

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

تنفِّذ هذه السمة مجموعة متنوعة من المكوّنات ذات الصلة بواجهة المستخدم، مثل 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

v4 fragment library

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

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

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

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

v7 appcompat library   جزء من Android Jetpack.

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

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

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

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

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

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

com.android.support:appcompat-v7:28.0.0

v7 cardview library

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

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

com.android.support:cardview-v7:28.0.0

مكتبة v7 gridlayout

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

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

com.android.support:gridlayout-v7:28.0.0

مكتبة MediaRouter المتوافقة مع الإصدار 7 من نظام التشغيل

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

بشكل عام، توفّر واجهات برمجة التطبيقات في مكتبة mediarouter الإصدار 7 وسيلة للتحكّم في توجيه قنوات الوسائط وتدفّقاتها من الجهاز الحالي إلى الشاشات ومكبرات الصوت والأجهزة الوجهة الأخرى الخارجية. تتضمّن المكتبة واجهات برمجة تطبيقات لنشر موفّري مسارات الوسائط الخاصة بالتطبيقات، ولاكتشاف الأجهزة الوجهة واختيارها، وللتحقّق من حالة الوسائط، وغير ذلك. للحصول على معلومات تفصيلية حول واجهات برمجة التطبيقات الخاصة بمكتبة 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

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

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

com.android.support:palette-v7:28.0.0

v7 recyclerview library

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

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

com.android.support:recyclerview-v7:28.0.0

مكتبة دعم v7 Preference

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

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

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

com.android.support:preference-v7:28.0.0

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

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

v8 renderscript library

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

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

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

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

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

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

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

com.android.support:support-v13:28.0.0

v14 Preference Support Library

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

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

com.android.support:preference-v14:28.0.0

مكتبة دعم v17 Preference Support Library للتلفزيون

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

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

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

الإصدار 17 من Leanback Library

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

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

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

com.android.support:leanback-v17:28.0.0

مكتبة Vector Drawable

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

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

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

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

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

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

com.android.support:design:28.0.0

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

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

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

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

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

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

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

com.android.support:wear:28.0.0