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

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

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

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

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

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

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

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

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

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

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

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

  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 الخاص بالوحدة. على سبيل المثال، لإضافة مكتبة برامج الاستخدام الأساسية الإصدار 4، أضِف ما يلي:
    dependencies {
        ...
        implementation "com.android.support:support-core-utils:28.0.0"
    }
    

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

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

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

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

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

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

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

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

في حال زيادة التوافق مع الأنظمة القديمة لتطبيقك الحالي إلى إصدار سابق من واجهة برمجة تطبيقات Android مع "مكتبة الدعم"، تأكَّد من تعديل ملف بيان التطبيق. على وجه التحديد، يجب تعديل العنصر 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) هو أعلى إصدار مطلوب من أي من المكتبات المحدّدة. على سبيل المثال، إذا كان تطبيقك يتضمّن كلاً من مكتبة التفضيلات v14 ومكتبة Leanback الإصدار 17، يجب أن يكون الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) 17 أو إصدارًا أحدث.