الإصدار 8.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو إصدار رئيسي يتضمّن مجموعة متنوعة من الميزات والتحسينات الجديدة.
التوافق
الحدّ الأقصى لمستوى واجهة برمجة التطبيقات الذي يتوافق الإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 34. في ما يلي معلومات التوافق الأخرى:
| الحد الأدنى للإصدار | الإصدار التلقائي | Notes | |
|---|---|---|---|
| مبرّد | 8.4 | 8.4 | لمزيد من المعلومات، يمكنك الاطّلاع على تحديث Gradle. |
| أدوات إنشاء حِزم تطوير البرامج (SDK) | 34.0.0 | 34.0.0 | ثبِّت أو ضبط أدوات إصدار SDK. |
| العُقدة (NDK) | لا ينطبق | 25.1.8937393 | ثبِّت أو اضبط نسخة مختلفة من NDK. |
| JDK | 17 | 17 | للاطلاع على مزيد من المعلومات، راجع إعداد إصدار JDK. |
في ما يلي الميزات الجديدة في الإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
إصدارات التصحيح
في ما يلي قائمة بإصدارات التصحيح في الإصدار Android Studio Iguana والإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
Android Studio Iguana | 2023.2.1 Patch 2 وAGP 8.3.2 (نيسان/أبريل 2024)
يتضمّن هذا التحديث الثانوي هذه إصلاحات الأخطاء.
Android Studio Iguana | 2023.2.1 التصحيح 1 وAGP 8.3.1 (آذار/مارس 2024)
يتضمّن هذا التحديث الثانوي هذه إصلاحات الأخطاء.
دعم كتالوجات إصدارات Gradle
يتوافق "استوديو Android" مع ميزة Gradle Version Catalogs المستندة إلى لغة TOML، وهي ميزة تتيح لك إدارة التبعيات في موقع مركزي واحد ومشاركة التبعيات في الوحدات أو المشاريع. يساعد "استوديو Android" الآن في تسهيل عملية ضبط كتالوجات الإصدارات من خلال اقتراحات المحرّرين والدمج مع مربّع حوار بنية المشروع. تعرَّف على كيفية إعداد ميزة Gradle Version Catalogs وضبطها أو كيفية نقل إصدارك إلى كتالوجات الإصدارات.
إكمال الرمز والتنقل
يتيح "استوديو Android" إمكانية إكمال الرمز عند تعديل كتالوج الإصدار بتنسيق ملف TOML أو إضافة تبعية من كتالوج الإصدار إلى ملف إصدار. لاستخدام إكمال الرمز، اضغط على Ctrl+Space
(Command+Space على نظام التشغيل macOS). بالإضافة إلى ذلك، يمكنك الانتقال بسرعة من مرجع التبعية في ملف build.gradle في تطبيقك إلى المكان الذي تم تعريفه به في كتالوج الإصدارات بالضغط على Ctrl+b
(Command+b على نظام التشغيل macOS).
الدمج مع مربّع حوار "بنية المشروع"
إذا كان مشروعك يستخدم كتالوج إصدارات محدّد بتنسيق ملف TOML، يمكنك تعديل المتغيرات التي حدّدتها من خلال مربّع الحوار بنية المشروع في قسم عرض المتغيّرات (ملف > بنية المشروع > المتغيرات) في Android Studio. لكل كتالوج إصدار، توجد قائمة منسدلة تسرد المتغيرات من هذا الكتالوج. لتعديل متغيّر، انقر على قيمته واستبدله. عند حفظ هذه التغييرات، يتم تحديث ملف TOML وفقًا لذلك.
يمكنك أيضًا تعديل التبعيات في عرض مربع الحوار بنية المشروع التبعيات (ملف > بنية المشروع > التبعيات). لتحديث الإصدارات باستخدام مربع الحوار بنية المشروع، انتقِل إلى الوحدة والتبعية التي تريد تعديلها، ثم حدِّث حقل الإصدار المطلوب. وعند حفظ هذه التغييرات، يتم تعديل ملف TOML وفقًا لذلك. لاحظ أنه إذا تم تحديد إصدار التبعية باستخدام متغير، فإن تحديث الإصدار بهذه الطريقة يؤدي مباشرةً إلى استبدال المتغير بقيمة غير قابلة للتغيير. وتجدر الإشارة أيضًا إلى أن إزالة التبعية من ملف الإصدار، سواء كنت تستخدم مربع الحوار بنية المشروع أم لا، لا يؤدي إلى إزالة التبعية من كتالوج الإصدارات.
القيود والمشاكل المعروفة
في ما يلي المشاكل أو القيود المعروفة المتعلّقة بتوافق كتالوجات إصدار Gradle في "استوديو Android":
حدث خطأ أثناء تمييز إعلانات الأسماء المستعارة للمكوّنات الإضافية في ملفات نصوص Kotlin البرمجية: عند إضافة تعريف مكوّن إضافي للنموذج
alias(libs.plugins.example)، يضيف المحرِّر خطًا أحمر تحت الجزءlibs. هذه مشكلة معروفة في الإصدارات 8.0 من Gradle والإصدارات الأقدم، وسيتم حلّها في إصدار مستقبلي من Gradle.لا يتوافق "استوديو Android" إلا مع كتالوجات الإصدارات بتنسيق TOML: في الوقت الحالي، لا يتوفّر دعم "إكمال الرمز البرمجي لـ "استوديو Android" والتنقل و"بنية المشروع" إلا لكتالوجات الإصدارات المحدّدة بتنسيق ملف TOML. مع ذلك، سيظل بإمكانك إضافة كتالوج الإصدارات مباشرةً في ملف
settings.gradleواستخدام العناصر الاعتمادية الخاصة به في مشروعك.التنقل في ملفات إصدار KTS غير متاح: الانتقال إلى تعريف التبعية في كتالوج الإصدار باستخدام Control+النقر (Command+النقر على نظام التشغيل macOS) غير متاح حتى الآن لملفات الإصدار المكتوبة باستخدام نص Kotlin البرمجي.
يضيف "مساعد Firebase" التبعيات مباشرةً في النصوص البرمجية للإصدارات: يضيف مساعد Firebase التبعيات مباشرةً إلى النصوص البرمجية للإصدار، بدلاً من كتالوجات الإصدارات.
وظيفة "البحث عن الاستخدامات" غير متاحة: لا تتوفر بعد إمكانية العثور على الاستخدامات لمتغير كتالوج الإصدار في ملفات الإصدار الأخرى، سواء كان ملف الإصدار بتنسيق KTS أو Groovy. وهذا يعني أنّ استخدام Control+النقر (Command+النقر على نظام التشغيل macOS) على تعريف متغيّر في كتالوج الإصدارات لا يؤدي إلى ملفات الإصدار التي يُستخدَم فيها المتغيّر.
يعرض مربّع حوار "بنية المشروع" في "استوديو Android" عدة ملفات كتالوج إذا كانت في مجلد
gradleالجذر، ولكنها لا تعرض كتالوجات لإصدار مركب. على سبيل المثال، إذا كان لديك ملفا كتالوج - أحدهما لتطبيقك والآخر لإصدار مركب - فإن مربع حوار "بنية المشروع" يعرض ملف كتالوج التطبيق فقط. يمكنك استخدام تصميم مركب، ولكن عليك تعديل ملف TOML مباشرةً.
إحصاءات إضافية عن حِزم SDK: المشاكل المتعلّقة بالسياسات
يعرض "استوديو Android" تحذيرات من الوبر في ملفَي build.gradle.kts وbuild.gradle، وفي مربع حوار بنية المشروع لحِزم تطوير البرامج (SDK) المتاحة للجميع التي تنتهك سياسات Play في أداة Google Play SDK Index. ويجب تعديل أي تبعيات تنتهك سياسات Play لأنّ هذه الانتهاكات قد تمنعك من النشر على Google Play Console في المستقبل. وتُكمِّل التحذيرات بشأن انتهاك السياسة
تحذيرات بشأن الإصدارات القديمة
التي يعرضها "استوديو Android".
إتاحة إصدار Compesdk من استوديو Android
يعرض "استوديو Android" تحذيرًا إذا كان مشروعك يستخدم compileSdk غير متوافق مع الإصدار الحالي من "استوديو Android". وتقترح الأداة أيضًا الانتقال إلى إصدار من "استوديو Android" يتوافق مع compileSdk
الذي يستخدمه مشروعك. يُرجى العلم أنّ
ترقية "استوديو Android" قد تتطلّب أيضًا ترقية AGP.
يعرض AGP أيضًا تحذيرًا في نافذة أداة إنشاء إذا كان الإصدار الحالي من AGP غير متوافق مع compileSdk الذي يستخدمه مشروعك.
تغييرات في سلوك الوبر
بدءًا من الإصدار 8.3.0-alpha02 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، عند تشغيل أداة Lint على إحدى الوحدات، يتم تنفيذ مهام تحليل الوبر المنفصلة للمكوّنات الرئيسية ومكوّنات الاختبار للوحدة. السبب في هذا التغيير هو تحسين الأداء.
للعودة إلى السلوك السابق، يجب ضبط
android.experimental.lint.analysisPerComponent=false في
ملف gradle.properties.
تصغير الموارد بدقة وبشكل تلقائي
يتم تلقائيًا تفعيل ميزة "التصغير الدقيق للموارد" التي تزيل الإدخالات غير المستخدَمة من ملف resources.arsc وتزيل ملفات الموارد غير المستخدَمة.
عند تفعيل عملية التقليص هذه، يتم تقليل جدول الموارد ولا يتم تضمين سوى إدخالات مجلد res المشار إليها في حزمة APK.
لإيقاف التصغير الدقيق للموارد، اضبط
android.enableNewResourceShrinker.preciseShrinking على false في
ملف gradle.properties الخاص بالمشروع.