الإصدار 8.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (شباط/فبراير 2024)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الإصدار 8.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو إصدار رئيسي يتضمّن مجموعة متنوّعة من الميزات والتحسينات الجديدة.
التوافق
الحدّ الأقصى لمستوى واجهة برمجة التطبيقات الذي يتوافق معه الإصدار 8.3 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 34 لواجهة برمجة التطبيقات.
في ما يلي معلومات أخرى عن التوافق:
يتيح "استوديو 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 وفقًا لذلك.
يمكنك أيضًا تعديل التبعيات في طريقة عرض التبعيات ضمن مربّع الحوار بنية المشروع (ملف > بنية المشروع > التبعيات). لتعديل الإصدارات باستخدام مربّع الحوار بنية المشروع، انتقِل إلى الوحدة والتبعية التي تريد تعديلها، ثم عدِّل حقل الإصدار المطلوب.
عند حفظ هذه التغييرات، يتم تعديل ملف 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 المتاحة للجميع والتي تنتهك سياسات 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
[الإصدار 8.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android] يتعذّر إجراء اختبار ./gradlew وتظهر رسالة الخطأ "يتعذّر العثور على مخرجات البيان" إذا كانت قيمة كل من splits.abi.isEnable وtestOptions.unitTests.isIncludeAndroidResources هي true
يُلغي الإصدار 8.1.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" تثبيت التطبيق بعد إجراء اختبار لقياس حالة التطبيق، بينما لا يُلغي الإصدار 7.4.2 تثبيته
الإصدار 8.1.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android: ميزة ديناميكية: تؤدي التبعية الضمنية بين exportReleaseConsumerProguardFiles وextractProguardFiles إلى حدوث أخطاء في التجميع
يُنتج الإصدار 8.3.0-alpha11 من المكوّن الإضافي لنظام Gradle المتوافق مع Android حِزمة APK للإصدار تتعطّل عند بدء التشغيل بسبب android.content.res.Resources$NotFoundException
يؤدي استخدام المكوّن الإضافي المخصّص للإصدار 7.4 من "مكوّن Android الإضافي لنظام Gradle" مع دالة toTransform إلى ظهور استثناء "إدخال مكرّر: META-INF/MANIFEST.MF" في جميع الحالات
فشل اختبار SimpleKotlinEnumUnboxingTest على برنامج التتبُّع kotlin_dev
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2026-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]