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

ملاحظة: مع إصدار 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

الإصدار 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 التنفيذية (DEX) المتعددة. ويجب أن تستخدم التطبيقات التي تشير إلى أكثر من 65536 طريقة لاستخدام عمليات ضبط ضبط أمان متعدد. بالنسبة للحصول على مزيد من المعلومات حول استخدام Multidex، يُرجى الاطّلاع على إنشاء تطبيقات باستخدام أكثر من 64 ألف طريقة

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

com.android.support:multidex:1.0.0

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

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

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

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

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

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

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

  • 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 من واجهات برمجة تطبيقات Networklayout Library، يمكنك الاطّلاع على حزمة android.support.v7.widget في مرجع واجهة برمجة التطبيقات.

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

com.android.support:gridlayout-v7:28.0.0

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

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

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

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

com.android.support:mediarouter-v7:28.0.0

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

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

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

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

com.android.support:palette-v7:28.0.0

مكتبة إعادة التدوير - الإصدار 7

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

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

com.android.support:recyclerview-v7:28.0.0

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

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

وتضيف مكتبة الإعدادات المفضّلة للإصدار 7 دعمًا إلى الواجهات، مثل 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. تصاميم تستند إلى الاستوديو ومخطّطات Gradle تشير رسالة الأشكال البيانية تتوفّر مكتبة ReScript في المجلد 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 للحصول على تفاصيل للحصول على معلومات حول الإصدار 14 من Preference Support Library API، يمكنك الاطّلاع على الخيار المفضّل حزمة في مرجع واجهة برمجة التطبيقات.

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

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

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

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

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

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

com.android.support:design:28.0.0

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

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

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

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

com.android.support:customtabs:28.0.0

مكتبة دعم Percent

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

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

تضيف مكتبة دعم Percent دعمًا إلى واجهة PercentLayoutHelper.PercentLayoutParams. وفئات مختلفة، مثل PercentFrameLayout أو 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

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

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

وتتيح مكتبة التطبيقات استخدام التعليقات التوضيحية مثل 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