نظرة عامة على AndroidX

تتضمّن مساحة الاسم androidx مكتبات Android Jetpack. على غرار Support Library، يتم شحن المكتبات في مساحة الاسم androidx بشكل منفصل عن نظام Android الأساسي وتوفّر توافقًا مع الأنظمة القديمة في جميع إصدارات Android.

تمثّل AndroidX تحسينًا كبيرًا على مكتبة Android Support Library الأصلية التي لم يعُد يتم صيانتها. تحلّ حِزم androidx محلّ Support Library بالكامل من خلال توفير ميزات مماثلة ومكتبات جديدة.

بالإضافة إلى ذلك، تتضمّن AndroidX الميزات التالية:

  • تتوفّر جميع الحِزم في AndroidX في مساحة اسم متّسقة تبدأ بالسلسلة androidx. تمت مطابقة حِزم مكتبة الدعم مع حِزم androidx.* المقابلة. للاطّلاع على عملية مطابقة كاملة لجميع الفئات القديمة وعناصر الإصدار الجديدة، يُرجى الانتقال إلى صفحة إعادة هيكلة الحِزم.

  • على عكس Support Library، تتم صيانة حِزم androidx وتحديثها بشكل منفصل. تستخدم حِزم androidx نظام الترقيم الدلالي الصارم Semantic Versioning، بدءًا من الإصدار 1.0.0. يمكنك تحديث مكتبات AndroidX في مشروعك بشكل مستقل.

  • الإصدار 28.0.0 هو آخر إصدار من مكتبة الدعم. لن يتم إصدار أي مكتبات android.support أخرى. سيتم تطوير جميع الميزات الجديدة في مساحة الاسم androidx.

استخدام مكتبات androidx في مشروعك

يتيح الإصدار الحالي من المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) استخدام مكتبات androidx تلقائيًا. يُرجى الاطّلاع على مقالة نقل البيانات إلى AndroidX للتعرّف على كيفية نقل مشروع حالي.

بالنسبة إلى المشاريع التي لم يتم نقلها أو التي تتضمّن تبعيات قديمة لم يتم نقلها، يوفّر AGP العلامتَين التاليتَين اللتَين يمكن ضبطهما في ملف gradle.properties الخاص بمشروعك.

  • android.useAndroidX: يتم ضبط هذه العلامة على "صحيح" تلقائيًا في الإصدار ‎9.0.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث، وعلى "خطأ" في الإصدارات الأقدم من ‎9.0.0. عند ضبط هذه العلامة على true، يستخدم المكوّن الإضافي المتوافق مع Android مكتبة AndroidX المناسبة بدلاً من Support Library. من المخطّط إزالة إمكانية ضبط هذه العلامة على false في الإصدار 10 من AGP.
  • android.enableJetifier: عند ضبط هذه العلامة على true، ينقل المكوّن الإضافي المتوافق مع Android تلقائيًا المكتبات الحالية التابعة لجهات خارجية لاستخدام تبعيات AndroidX من خلال إعادة كتابة ملفاتها الثنائية. يتم ضبط العلامة على false تلقائيًا إذا لم يتم تحديدها، ومن المخطّط إزالتها في الإصدار 10 من AGP، لأنّ المكتبات المنشورة قد أكملت عملية النقل بشكل عام.

مرجع حول API

يمكن العثور على جميع الحِزم والفئات في مساحة الاسم androidx في قسم مرجع AndroidX.

موارد إضافية

مزيد من المعلومات عن المكوّنات على الصفحة الرئيسية في Jetpack home page. لمزيد من المعلومات عن إعادة هيكلة الحِزم من Support Library إلى androidx، يُرجى الاطّلاع على منشور المدوّنة حول هذا الموضوع.