الإصدار 8.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (شباط/فبراير 2024)

الإصدار 8.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو إصدار رئيسي يتضمّن مجموعة متنوّعة من الميزات والتحسينات الجديدة.

التوافق

الحدّ الأقصى لمستوى واجهة برمجة التطبيقات الذي يتوافق معه الإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 34 لواجهة برمجة التطبيقات. في ما يلي معلومات أخرى عن التوافق:

الإصدار الأدنى الإصدار التلقائي الملاحظات
Gradle 8.4 8.4 لمزيد من المعلومات، اطّلِع على تحديث Gradle.
أدوات تصميم حزمة تطوير البرامج (SDK) 34.0.0 34.0.0 تثبيت أو ضبط أدوات إنشاء حزمة تطوير البرامج (SDK).
NDK لا ينطبق 25.1.8937393 ثبِّت أو اضبط إصدارًا مختلفًا من NDK.
JDK 17 17 لمزيد من المعلومات، يُرجى الاطّلاع على ضبط إصدار حزمة تطوير البرامج في Java‏ (JDK).

في ما يلي الميزات الجديدة في الإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.

الإصدارات التصحيحية

في ما يلي قائمة بإصدارات رموز التصحيح في إصدار Iguana من "استوديو Android" والمكوّن الإضافي لنظام Gradle المتوافق مع Android 8.3.

الإصدار Iguana من "استوديو Android" | الإصدار 2 من حزمة تصحيح ‎2023.2.1 والإصدار 8.3.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (أبريل 2024)

يتضمّن هذا التحديث البسيط إصلاحات الأخطاء هذه.

الإصدار Iguana من "استوديو Android" | الإصدار 2023.2.1 من التصحيح 1 وAGP 8.3.1 (مارس 2024)

يتضمّن هذا التحديث البسيط إصلاحات الأخطاء هذه.

إتاحة كتالوجات إصدارات Gradle

يتيح "استوديو Android" استخدام كتالوجات إصدارات Gradle المستندة إلى TOML، وهي ميزة تتيح لك إدارة التبعيات في موقع مركزي واحد ومشاركة التبعيات في جميع الوحدات أو المشاريع. يسهّل "استوديو Android" الآن ضبط كتالوجات الإصدارات من خلال اقتراحات المحرِّر والتكامل مع مربّع حوار بنية المشروع. تعرَّف على كيفية إعداد Gradle Version Catalogs وضبطها أو كيفية نقل عملية الإنشاء إلى كتالوجات الإصدارات.

إكمال الرموز البرمجية والتنقّل

يوفّر "استوديو Android" ميزة الإكمال التلقائي للرموز عند تعديل قائمة إصدارات بتنسيق ملف TOML أو إضافة تبعية من قائمة إصدارات إلى ملف إصدار. لاستخدام ميزة "إكمال الرمز"، اضغط على Ctrl+Space (Command+Space على نظام التشغيل macOS). بالإضافة إلى ذلك، يمكنك الانتقال بسرعة من مرجع تبعية في ملف build.gradle الخاص بتطبيقك إلى مكان تعريفه في قائمة الإصدارات من خلال الضغط على Ctrl+b (Command+b على نظام التشغيل macOS).

إكمال الرموز البرمجية عند إضافة تبعية

الدمج مع مربّع حوار "بنية المشروع" (Project Structure)

إذا كان مشروعك يستخدم قائمة إصدارات محدّدة بتنسيق ملف TOML، يمكنك تعديل المتغيّرات التي حدّدتها هناك من خلال عرض المتغيّرات في مربّع حوار بنية المشروع (ملف > بنية المشروع > المتغيّرات) في "استوديو Android". لكل كتالوج إصدارات، هناك قائمة منسدلة تعرض المتغيّرات من ذلك الكتالوج. لتعديل متغيّر، انقر على قيمته واستبدِلها. عند حفظ هذه التغييرات، يتم تعديل ملف TOML وفقًا لذلك.

متغيّرات من قائمة إصدارات في مربّع حوار "بنية المشروع" (Project Structure)

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

التبعيات من كتالوج الإصدارات في مربّع حوار "بنية المشروع" (Project Structure)

الحدود والمشاكل المعروفة

في ما يلي المشاكل أو القيود المعروفة في ما يتعلّق بتوافق "قوائم إصدارات 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 المتاحة للجميع والتي تنتهك سياسات Google Play في Google Play SDK Index. يجب تحديث أي تبعيات تنتهك سياسات Google Play لأنّ هذه الانتهاكات قد تمنعك من نشر التطبيقات على Google Play Console في المستقبل. تُعدّ تحذيرات انتهاك السياسة مكمّلة لتحذيرات الإصدارات القديمة التي يعرضها "استوديو Android".

توافق إصدار compileSdk في "استوديو Android"

يعرض "استوديو Android" تحذيرًا إذا كان مشروعك يستخدم compileSdk غير متوافق مع الإصدار الحالي من "استوديو Android". ويقترح أيضًا، إذا كان ذلك متاحًا، الانتقال إلى إصدار من "استوديو Android" يتوافق مع compileSdk المستخدَم في مشروعك. يُرجى العِلم أنّ ترقية "استوديو Android" قد تتطلّب أيضًا ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android. يعرض المكوّن الإضافي لنظام Gradle المتوافق مع Android أيضًا تحذيرًا في نافذة أداة الإصدار إذا كان الإصدار compileSdk المستخدَم في مشروعك غير متوافق مع الإصدار الحالي من المكوّن الإضافي لنظام Gradle المتوافق مع Android.

تغييرات في سلوك Lint

اعتبارًا من الإصدار 8.3.0-alpha02 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، عند تشغيل أداة lint على وحدة، يتم تشغيل مهام تحليل lint منفصلة للمكوّنات الرئيسية ومكوّنات الاختبار في الوحدة. السبب وراء هذا التغيير هو تحسين الأداء. للرجوع إلى السلوك السابق، اضبط android.experimental.lint.analysisPerComponent=false في ملف gradle.properties.

تفعيل ميزة "تقليص الموارد بدقة" تلقائيًا

يتم تلقائيًا تفعيل ميزة "تقليص الموارد بدقة" التي تزيل الإدخالات غير المستخدَمة من ملف resources.arsc وملفات الموارد غير المستخدَمة. عند تفعيل هذا التقليص، يتم تقليل جدول الموارد ويتم تضمين إدخالات مجلد res المُشار إليها فقط في حزمة APK.

لإيقاف ميزة "تقليص الموارد بدقة"، اضبط android.enableNewResourceShrinker.preciseShrinking على false في ملف gradle.properties الخاص بمشروعك.

المشاكل التي تم حلّها

الإصدار 8.3.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

المشاكل التي تم حلّها
مكوّن إضافي لنظام Gradle المتوافق مع Android
قد يحدث توقّف تام في الإصدار 8.3 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" مع تفعيل ميزة "إزالة التجميل اللغوي"
تعطُّل مهمة zipApksFor في الإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android
دمج Lint
تعذُّر أداة Lint في توضيح تبعية KMP

الإصدار 8.3.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

المشاكل التي تم حلّها
مكوّن إضافي لنظام Gradle المتوافق مع Android
مشكلة في معالجة المدخلات المتزايدة في MergeJavaResourcesTask
دمج Lint
يتعذّر على Lint حلّ أنواع مجموعات رموز المصدر الشقيقة في الإصدار 8.3.0-rc02 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"

الإصدار 8.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

المشاكل التي تم حلّها
مكوّن إضافي لنظام Gradle المتوافق مع Android
ذاكرة التخزين المؤقت للإصدار مكرّرة لمهمة PackageForUnitTest
[الإصدار 8.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android] يتعذّر إجراء اختبار ‎./gradlew وتظهر رسالة الخطأ "يتعذّر العثور على مخرجات البيان" إذا كانت قيمة كل من splits.abi.isEnable وtestOptions.unitTests.isIncludeAndroidResources هي true
تعذُّر إنشاء نموذج "مكوّن Android الإضافي في Gradle" (AGP) بسبب عمليات إنشاء مركّبة متداخلة في Gradle
تؤدي أداة تقليص الموارد إلى تشويه أرقام تعريف الموارد، ما يؤدي إلى حدوث أعطال في وقت التشغيل
لا يتم التحقّق من الحدّ الأدنى لإصدار Gradle في الإصدار الثاني وما بعده
تعذّر تنفيذ المهمة ':app:mergeReleaseClasses' بعد تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android من الإصدار 8.0.2 إلى 8.1.0
[Gradle 8.4][upgrade] Integration test failure after upgrade due to use of deprecated feature in kotlin gradle plugin
عدم التحقّق من وجود ملفات تراكب البيان أثناء مرحلة الضبط
رابط معطّل يؤدي إلى مستند Gradle حول خطأ MergeJavaResWorkAction
يؤدي الإصدار 8.1 من Gradle إلى تعطُّل ميزة "التخزين المؤقت للإعدادات" بسبب ‎ .gradle/.android/analytics.settings
يجب ألا يستخدم مكوّن AGP السمة ProjectComponentIdentifier.projectPath بدون السمة ProjectComponentIdentifier.build
يُرجى تقليل/إزالة التسجيل على مستوى المعلومات لـ AGP "Analytics other plugin to proto: ..."
[Gradle 8.4][upgrade] File operation during configuration in ProcessJavaResTask breaks config caching
Variant API للحصول على جدول الرموز (R.txt)
لا يتعامل المكوّن الإضافي المستقل Lint مع تبعية gradleApi()‎ بشكل صحيح
مستندات kDocs رديئة في فئات/سمات AGP تشير السمة `VariantOutput.enable` إلى أنّه يجب استبدالها بالسمة `VariantOutput.enable`
لا يمكن للإصدار 8.3.0-alpha02 من المكوّن الإضافي لنظام Gradle المتوافق مع Android تثبيت ملفات شخصية للإصدار على مضيفات Windows
Enforce `android.enableDexingArtifactTransform=true`
‫[Gradle 8.4][ترقية] تعذّر اختبار الدمج بعد الترقية بسبب معالجة الملفات في مرحلة الضبط
‫AGP 8.3.0-alpha-02 - `Error: Failed to deserialize cached resource repository.`
[Gradle 8.4][upgrade] Integration test failure after upgrade due file handling in configuration phase of TestLabBuildService
يُلغي الإصدار 8.1.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" تثبيت التطبيق بعد إجراء اختبار لقياس حالة التطبيق، بينما لا يُلغي الإصدار 7.4.2 تثبيته
يؤدي تحويل حزمة APK إلى حدوث خطأ في ListingFileRedirectTask
يؤدي تحويل عنصر ASSETS إلى مواقع إدخال/إخراج معطّلة
الترويج لـ android.experimental.r8.dex-startup-optimization=true ليكون الإعداد التلقائي
نقل البيانات إلى واجهة برمجة التطبيقات الجديدة لتسوية إعدادات Gradle
تعذُّر تجميع الموارد عندما يحاول برنامج تجميع Kotlin التحديث إلى IDEA 21.3
واجهة برمجة التطبيقات Reactive get() with artifacts API
تحويل سمة "android.lint.printStackTrace" في "المكوّن الإضافي لنظام Gradle المتوافق مع Android" إلى سمة ثابتة
الإصدار 8.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android: ميزة ديناميكية: تؤدي التبعية الضمنية بين exportReleaseConsumerProguardFiles وextractProguardFiles إلى حدوث أخطاء في التجميع
يبدو أنّ `variant.unitTest.jniLibs.addGeneratedSourceDirectory` لا ينفّذ أي إجراء
تعديل المحلل اللغوي لملفات XML المستخدَم في "المكوّن الإضافي لنظام Gradle المتوافق مع Android" ليتوافق مع الإصدار 8.4 من Gradle
لا يتم تفعيل أداة jacoco في حزمة الإصدار 8.0.1 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"
HEDGEHOG REGRESSION: Run button is delayed by a few seconds (Creating spec)
يُنتج الإصدار 8.3.0-alpha11 من المكوّن الإضافي لنظام Gradle المتوافق مع Android حِزمة APK للإصدار تتعطّل عند بدء التشغيل بسبب android.content.res.Resources$NotFoundException
تحويل سمة "android.lint.printStackTrace" في "المكوّن الإضافي لنظام Gradle المتوافق مع Android" إلى سمة ثابتة
طلب ميزة: ترقية com.android.build.api.extension.impl.CURRENT_AGP_VERSION إلى واجهة برمجة تطبيقات علنية
يجب أن يتوقف SDK Manager عن إرسال معلومات السجلّ غير المرغوب فيها إلى stdout
تعذّر تنفيذ DexArchiveBuilderTaskDelegate مع وحدة مكتبة الموارد فقط
يؤدي استخدام المكوّن الإضافي المخصّص للإصدار 7.4 من "مكوّن Android الإضافي لنظام Gradle" مع دالة toTransform إلى ظهور استثناء "إدخال مكرّر: META-INF/MANIFEST.MF" في جميع الحالات
إتاحة علامات Manifest الجديدة
يؤدي الرابط الخاص بـ "المشاريع المنفصلة" في إعدادات "استوديو YouTube" إلى المكان الخطأ.
يُرجى توفير خيارات لتضمين المصادر التي تم إنشاؤها في Javadoc وSourceJar
أحتاج إلى حلّ سريع للتناقض بين compileSdk والتبعية مع minCompileSdkVersion
‫[Gradle] يجب أن تتيح tools:overrideLibrary استخدام علامة النجمة (*)
تجميد واجهة المستخدم عند تعديل البيان
يتعذّر ضبط إصدار JaCoCo في الإصدار 8.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android
تعذُّر تنفيذ مهمة تثبيت الإصدار 8.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android في مشروع يستخدم ميزات ديناميكية
تعذُّر تنفيذ مهمة تثبيت الإصدار 8.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android في مشروع يستخدم ميزات ديناميكية
Dexer (D8)
[desugared library] الإصدار 2.1 من مكتبة desugared غير متوافق مع الإصدارات السابقة من R8
هل يتم تشغيل التحسينات حتى مع D8 فقط؟
Lint
[Lint] يتعطّل TranslucentViewDetector في دالة filterIncident ويتسبب في ظهور نتيجة خاطئة في lint
يجب أن يقبل TranslucentViewDetector القيمة "behind"
تعذُّر تنفيذ Android Lint في مكتبة KMP مع ظهور رسالة الخطأ "لا تتضمّن السمة variantInputs.name قيمة تم ضبطها".
يُبلغ TranslucentViewDetector عن سطر خاطئ في البيان
يُبلغ lintDebug بشكل خاطئ عن تحذيرات UseTomlInstead عند استخدام تبعيات المشروع
مشاكل غير متوقعة من مشروع آخر تم الإبلاغ عنها بواسطة Android Lint
فحص LINT: رصد موجب خاطئ لمورد غير مستخدَم داخل متتبِّع النقرات والربط
تعذّر تحميل ملف jar المخصّص للتحقّق من الأخطاء: لا يمكن تحويل Node إلى TreeNode
لم يتم استدعاء Lint visitAnnotationUsage لاستخدامات الفئات التي تم التعليق عليها في تعريفات المتغيّرات
يتعذّر تنفيذ Lint 31.0.2 مع ظهور الخطأ java.util.NoSuchElementException: Array is empty.
لا يوجد تحذير من Lint بشأن kotlin.text.MatchNamedGroupCollection#get(String) الذي يتطلب الإصدار 26 من واجهة برمجة التطبيقات
lint:TypographyQuotes false negatives: more than one escaped apostrophe are ignored
موجب خاطئ في أداة رصد InvalidId في الإصدار 8.0.2 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"
تمت إضافة مشاكل LintError إلى المراجع الأساسية لـ lint
لا تعمل أداة Quickfix Lint وتؤدي إلى حدوث خطأ في بيئة التطوير المتكاملة (IDE)
تعذُّر الاختبار بشكل غير متّسق بسبب التحليل الجزئي
تمييز غير صالح لتحذير موجب خاطئ
لم يتم استدعاء Lint visitAnnotationUsage لاستخدامات الفئات التي تم التعليق عليها في تعريفات المتغيّرات
قد يحذف معالج الموارد غير المستخدَمة ملف إصدار Gradle
لا يفهم فحص NewApi lint الحقل النهائي "isAtleastU() && otherCondition()"
‫StackOverflow من `LintClient.getSdkHome`
لا يخبرك "استوديو Android" أو Lint عندما تكون تبعيات "النظام الأساسي" قديمة
خطأ: لا يوجد اقتراح لتحديث تبعية Firebase-bom
لا تكتشف ميزة "بنية المشروع" (Project Structure) (وGradle (?)) تبعيات قائمة مواد Firebase التي يجب ترقيتها إلى إصدار أحدث.
دمج Lint
خطأ DuplicatePlatformClasses lint من تبعية testImplementation
Shrinker (R8)
لا يعمل R8 بعد الترقية من الإصدار 8.0.2 إلى الإصدار 8.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android
يُحسِّن isShrinkResources الموارد بشكل مفرط في الإصدارات من 8.3.0-alpha11 إلى alpha14
تعطُّل حزمة تطوير البرامج (SDK) من R8 Flurry مع الإصدار 8.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android
‫Android - أداة R8 تؤدي إلى تعطُّل الفئة الفرعية من LinearLayoutManager
‫R8 v8.2.33، تعطُّل وقت التشغيل "java.lang.VerifyError: Bad type on operand stack" بعد الترقية
[R8 8.3.21] R8 8.3.21 is 1.57MB larger than R8 8.1.56
[R8 8.3.21] R8 8.3.21 is 1.57MB larger than R8 8.1.56
‫class.getInterfaces()‎ فارغة
فشل اختبار SimpleKotlinEnumUnboxingTest على برنامج التتبُّع kotlin_dev