الإصدار 8.0.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (نيسان/أبريل 2023)

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

التوافق

إصدارات رموز التصحيح

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

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

للاطّلاع على قائمة بالأخطاء التي تم إصلاحها في الإصدار 8.0.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، راجِع المشاكل التي تم إغلاقها في الإصدار 2022.2.1 من "استوديو Android".

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

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

تغيير قد يؤدي إلى عطل: يجب توفير مساحة اسم في نص برمجي للإصدار على مستوى الوحدة

يجب ضبط مساحة الاسم في ملف build.gradle.kts على مستوى الوحدة، وليس في ملف البيان. يمكنك بدء استخدام السمة namespace DSL بدءًا من الإصدار 7.3 من "استوديو Android". لمزيد من المعلومات، يُرجى الاطّلاع على ضبط مساحة اسم.

عند نقل البيانات إلى مساحة الاسم DSL، يُرجى الانتباه إلى المشاكل التالية:

• تستنتج الإصدارات السابقة من "مكوّن Android الإضافي" مساحة الاسم التجريبية من مساحة الاسم الرئيسية أو معرّف التطبيق بشكل غير صحيح في بعض الحالات. يمنع "مساعد ترقية" Android Gradle Plugin الترقية إذا تبيّن له أنّ مساحة الاسم الرئيسية ومساحة اسم الاختبار في مشروعك متطابقتان. إذا تم حظر الترقية، عليك تغيير testNamespace يدويًا وتعديل رمز المصدر وفقًا لذلك.
• بعد تغيير مساحة الاسم الخاصة بالاختبار، من المحتمل أن يتم تجميع الرمز البرمجي، ولكن ستتعذّر الاختبارات المزوّدة بأدوات في وقت التشغيل. يمكن أن يحدث ذلك إذا كان رمز المصدر للاختبار المزوّد بأدوات يتضمّن مرجعًا إلى مورد محدّد في كل من مصادر androidTest ومصادر التطبيق.

لمزيد من المعلومات، يُرجى الاطّلاع على التعليق رقم 19 في المشكلة رقم 191813691.

تغييرات قد تؤدي إلى أعطال: القيم التلقائية لخيارات الإنشاء

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

تغييرات قد تؤدي إلى أعطال: فرض قيم خيار الإنشاء

اعتبارًا من الإصدار 8.0 من "مكوّن Android الإضافي لبرنامج Gradle"، لن يعود بإمكانك تغيير قيم هذه العلامات. إذا حدّدتها في ملف gradle.properties، سيتم تجاهل القيمة وستعرض "مكوّنات Android الإضافية في Gradle" تحذيرات.

علامة ثابتة جديدة لملف التنفيذ

يتضمّن "مكوّن Android Gradle الإضافي" العلامة الجديدة android.settings.executionProfile. استخدِم هذه العلامة لتجاوز ملف التنفيذ التلقائي من SettingsExtension. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات إضافة الإعدادات.

لمعاينة العلامات التجريبية، اطّلِع على ملاحظات إصدار المعاينة.

تعيين خاصية Kotlin الكسولة غير متاح

إذا كنت تستخدم Kotlin DSL من Gradle لبرامج الإصدار، يُرجى العِلم أنّ الإصدار 8.0 من "استوديو Android" و"مكوّن Android الإضافي لبرنامج Gradle" لا يتيحان تعيين الخصائص التجريبية باستخدام عامل التشغيل =. لمزيد من المعلومات حول هذه الميزة، يُرجى الاطّلاع على ملاحظات الإصدار والمستندات.

فئات مهام "أداة تحليل الإصدار"

بدءًا من استوديو Android Flamingo، تتضمّن "أداة تحليل الإصدار" عرضًا تلقائيًا جديدًا للمهام التي تؤثّر في مدة عملية الإصدار. إذا كان مشروعك يستخدم الإصدار 8.0 أو إصدارًا أحدث من "مكوّن Android الإضافي Gradle"، سيصنّف "أداة تحليل الإصدار" المهام حسب الفئة بدلاً من عرضها بشكل فردي. على سبيل المثال، يتم تجميع المهام الخاصة بموارد Android أو Kotlin أو Dexing معًا، ثم يتم ترتيبها حسب مدة الإنشاء. يساعدك ذلك في تحديد الفئة التي لها التأثير الأكبر في مدّة التصميم. يؤدي توسيع كل فئة إلى عرض قائمة بالمهام ذات الصلة. لعرض المهام بشكل فردي، بدون تجميع، استخدِم القائمة المنسدلة تجميع حسب.

مكوّن إضافي جديد للإعدادات

يقدّم الإصدار ‎8.0.0-alpha09 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" المكوّن الإضافي الجديد للإعدادات. يتيح لك المكوّن الإضافي للإعدادات تجميع الإعدادات العامة، أي الإعدادات التي تنطبق على جميع الوحدات، في مكان واحد، ما يغنيك عن نسخ الإعدادات ولصقها في وحدات متعددة. بالإضافة إلى ذلك، يمكنك استخدام مكوّن الإعدادات الإضافي لإنشاء ملفات تنفيذ الأدوات أو تعليمات مختلفة حول كيفية تشغيل أداة، والتبديل بينها.

لاستخدام المكوّن الإضافي للإعدادات، طبِّقه في ملف settings.gradle:

apply plugin 'com.android.settings'

تجميع الإعدادات العامة

لضبط الإعدادات العامة، استخدِم الحظر الجديد android في ملف settings.gradle. وفي ما يلي مثال لذلك:

android {
  compileSdk 31
  minSdk 28
  ...
}

ملفات تنفيذ الأدوات

يتيح لك مكوّن إضافي للإعدادات أيضًا إنشاء ملفات تنفيذية لبعض الأدوات. يحدّد ملف التنفيذ طريقة تشغيل الأداة، ويمكنك اختيار ملفات تنفيذ مختلفة حسب البيئة. في ملف تنفيذ، يمكنك ضبط وسيطات JVM لأداة وإعدادها ليتم تشغيلها في عملية منفصلة. لا يتوفّر سوى أداة R8.

أنشئ ملفات تعريف التنفيذ واضبط ملف تعريف التنفيذ التلقائي في الملف settings.gradle، كما هو موضّح في المثال التالي:

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

لإلغاء الملف الشخصي التلقائي، اختَر ملفًا شخصيًا مختلفًا باستخدام السمة android.experimental.settings.executionProfile في الملف gradle.properties:

android.experimental.settings.executionProfile=high

يمكنك أيضًا ضبط هذه السمة باستخدام سطر الأوامر، ما يتيح لك إعداد سير عمل مختلفة. على سبيل المثال، إذا كان لديك سير عمل متكامل مستمر، يمكنك استخدام سطر الأوامر لتغيير ملف التنفيذ بدون الحاجة إلى تغيير ملف settings.gradle:

./gradlew assembleRelease \
-Pandroid.experimental.settings.executionProfile=ci

يجب استخدام الإصدار 17 من حزمة تطوير البرامج Java (JDK) لتشغيل الإصدار 8.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"

عند استخدام الإصدار 8.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android لإنشاء تطبيقك، يجب الآن استخدام الإصدار 17 من JDK لتشغيل Gradle. يضم الإصدار Android Studio Flamingo حزمة تطوير البرامج Java‏ (JDK) 17 ويضبط Gradle لاستخدامها تلقائيًا، ما يعني أنّ معظم مستخدمي "استوديو Android" لن يحتاجوا إلى إجراء أي تغييرات في إعدادات مشاريعهم.

إذا كنت بحاجة إلى ضبط إصدار JDK الذي يستخدمه "مكوّن Android الإضافي لبرنامج Gradle" يدويًا داخل "استوديو Android"، عليك استخدام الإصدار 17 من JDK أو إصدار أحدث.

عند استخدام AGP بشكل مستقل عن "استوديو Android"، عليك ترقية إصدار JDK من خلال ضبط JAVA_HOME متغيّر البيئة أو -Dorg.gradle.java.home خيار سطر الأوامر على دليل تثبيت JDK 17.

المشاكل التي تم إصلاحها

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

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

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