تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

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

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

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

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

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

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

أدرِج مستودع 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'
        // }
    }
}

لكل وحدة تريد استخدام "مكتبة الدعم" فيها، أضِف المكتبة في الجزء dependencies من ملف build.gradle الخاص بالوحدة. على سبيل المثال، لإضافة مكتبة الإصدار 4 من الأدوات الأساسية، أضِف ما يلي:
```
dependencies {
    ...
    implementation "com.android.support:support-core-utils:28.0.0"
}
```

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

استخدام واجهات برمجة التطبيقات لمكتبة الدعم

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

تنبيه: عند استخدام صفوف من Support Library، احرص على استيراد الصف من الحزمة المناسبة. على سبيل المثال، عند تطبيق الفئة 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 بأنّه يمكن تثبيت تطبيقك على الأجهزة التي تعمل بالإصدار 4.0 من نظام التشغيل Android (المستوى 14 من واجهة برمجة التطبيقات) والإصدارات الأحدث.

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

plugins {
  id 'com.android.application'
}

android {
    ...

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

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

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

软件包