إعداد مكتبة الدعم

ملاحظة: مع إصدار Android 9.0 (المستوى 28 من واجهة برمجة التطبيقات)، أصبح هناك إصدار جديد من مكتبة الدعم يُسمى AndroidX وهو جزء من Jetpack. تحتوي مكتبة AndroidX على مكتبة الدعم الحالية، كما تتضمّن أحدث مكونات Jetpack.

يمكنك مواصلة استخدام مكتبة الدعم. ستظلّ العناصر السابقة (الإصدار 27 والإصدارات الأقدم والمُعبَّأة بتنسيق android.support.*) متاحة على Google Maven. ومع ذلك، سيتم تطوير كل المكتبات الجديدة في مكتبة AndroidX.

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

تعتمد طريقة إعداد "مكتبات دعم Android" في مشروع التطوير على الميزات التي تريد استخدامها ونطاق إصدارات نظام Android التي تريد توافق تطبيقك معها.

يرشدك هذا المستند خلال عملية تنزيل حزمة "مكتبة الدعم" وإضافة المكتبات إلى بيئة التطوير.

تتوفّر مكتبات الدعم الآن من خلال مستودع Maven في Google. لم نعُد نتيح تنزيل المكتبات من خلال حزمة تطوير البرامج (SDK). وستتم إزالة هذه الوظيفة قريبًا.

اختيار مكتبات الدعم

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

إضافة مكتبات الدعم

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

لإضافة مكتبة دعم إلى مشروع تطبيقك، اتّبِع الخطوات التالية:

1. أدرِج مستودع Maven من Google في ملف settings.gradle الخاص بمشروعك.

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }

2. لكل وحدة تريد استخدام مكتبة الدعم فيها، أضف المكتبة في dependencies من الملف build.gradle الخاص بالوحدة. على سبيل المثال، لإضافة مكتبة v4 core-utils، أضِف ما يلي:

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }

تنبيه: يؤدي استخدام التبعيات الديناميكية (على سبيل المثال، palette-v7:23.0.+) إلى تحديثات غير متوقعة للإصدار عدم توافق الانحدار. ننصحك بتحديد نسخة المكتبة (على سبيل المثال، palette-v7:28.0.0).

استخدام واجهات برمجة تطبيقات Support Library

عادةً ما تتضمن فئات مكتبة الدعم التي توفر الدعم لواجهات برمجة التطبيقات التي تعمل بإطار العمل الحالي نفس اسم فئة إطار العمل ولكنها موجودة في حزم الفئة android.support، أو تتضمّن اللاحقة *Compat.

تنبيه: عند استخدام صفوف من "مكتبة الدعم"، احرص على استيراد البيانات الفئة من الحزمة المناسبة. على سبيل المثال، عند تطبيق السمة ActionBar الفئة:

• android.support.v7.app.ActionBar عند استخدام "مكتبة الدعم".
• android.app.ActionBar عند تطوير التطبيقات للمستوى 11 أو أعلى من واجهة برمجة التطبيقات فقط

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

يتوفّر في مطوِّر Android إرشادات إضافية حول استخدام بعض ميزات Support Library. دورات تدريبية الأدلّة والعينات. لمزيد من المعلومات عن فئات وطُرق "مكتبة الدعم" الفردية، اطّلِع على حِزم android.support في مرجع واجهة برمجة التطبيقات.

التغييرات في بيان البيان

إذا كنت بصدد زيادة التوافق مع الإصدارات القديمة لتطبيقك الحالي باستخدام مكتبة الدعم لإصدار سابق من واجهة برمجة تطبيقات Android، احرص على تعديل بيان تطبيقك. على وجه التحديد، عليك تعديل عنصر android:minSdkVersion في علامة <uses-sdk> في البيان إلى رقم الإصدار الجديد الأصغر، كما هو موضح أدناه:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

يُعلم إعداد البيان Google Play بأنّه يمكن تثبيت تطبيقك على الأجهزة التي تعمل بالإصدار 4.0 من Android (المستوى 14 من واجهة برمجة التطبيقات) والإصدارات الأحدث.

إذا كنت تستخدم ملفات إنشاء Gradle، سيتم إلغاء إعدادات البيان من خلال الإعداد minSdkVersion في ملف الإنشاء .

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

في هذه الحالة، يُخبر إعداد ملف الإصدار Google Play بأنّ صيغة الإصدار التلقائية يمكن تثبيت التطبيق على الأجهزة التي تعمل بالإصدار 4.1 من نظام التشغيل Android (المستوى 16 من واجهة برمجة التطبيقات) والإصدارات الأحدث. لمزيد من المعلومات، معلومات حول خيارات الإصدار، راجِع نظرة عامة على نظام الإنشاء.

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