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

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

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

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

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

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

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

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

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

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

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

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

1. ننصحك بتضمين مستودع Maven الخاص بمشروعك في ملف 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 الخاص بالوحدة. بالنسبة لإضافة الإصدار 4 من مكتبة 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 API باستخدام مكتبة الدعم، فتأكد من تحديث ملف البيان. وعلى وجه التحديد، عليك تحديث android:minSdkVersion. العنصر <uses-sdk> في البيان برقم الإصدار الجديد الأدنى، باعتباره كما هو موضح أدناه:

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

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

إذا كنت تستخدم ملفات إصدار Gradle، يجب ضبط الإعداد minSdkVersion في ملف الإصدار إعدادات البيان.

plugins {
  id 'com.android.application'
}

android {
    ...

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

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

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