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

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

7.2.2 (أغسطس 2022)

يتوافق هذا التعديل البسيط مع إصدار حزمة التصحيح 2 من استوديو Android Chipmunk ويتضمّن إصلاحات الأخطاء التالية:

  • المشكلة رقم ‎232438924: يؤدي الإصدار 7.2 من AndroidGradlePlugin إلى إيقاف واجهة برمجة التطبيقات transform عند استخدامها مع واجهة برمجة التطبيقات ASM
  • المشكلة رقم ‎231037948: AGP 7.2.0-rc01 :buildSrc:generatePrecompiledScriptPluginAccessors - shadow/bundletool/com/android/prefs/AndroidLocation$AndroidLocationException
7.2.1 (مايو 2022)

يتوافق هذا التعديل البسيط مع إصدار حزمة التصحيح 1 من استوديو Android Chipmunk ويتضمّن إصلاحات الأخطاء التالية:

للاطّلاع على إصلاحات الأخطاء الأخرى المضمّنة في هذا الإصدار، راجِع ملاحظات إصدار حزمة التصحيح 1 من استوديو Android Chipmunk.

التوافق

الإصدار الأدنى الإصدار التلقائي ملاحظات
Gradle 7.3.3 7.3.3 لمزيد من المعلومات، اطّلِع على تحديث Gradle.
أدوات تصميم حزمة تطوير البرامج (SDK) 30.0.3 30.0.3 تثبيت أو ضبط أدوات إنشاء حزمة تطوير البرامج (SDK).
NDK لا ينطبق 21.4.7075529 تثبيت إصدار مختلف من NDK أو ضبطه
JDK 11 11 لمزيد من المعلومات، اطّلِع على مقالة ضبط إصدار JDK.

تحذير Jetifier والفحص في "أداة تحليل الإصدار"

تعرض أداة تحليل الإصدار الآن تحذيرًا إذا كان ملف gradle.properties الخاص بمشروعك يتضمّن android.enableJetifier=true. تم طرح هذا الخيار في إصدار سابق من ”استوديو Android“ لتفعيل AndroidX للمكتبات التي لا تتوافق مع AndroidX بشكلٍ أصلي. ومع ذلك، انتقلت معظم منظومة المكتبات المتكاملة إلى توفير الدعم الأصلي لمكتبة AndroidX، ومن المحتمل أنّ مشروعك لم يعُد بحاجة إلى علامة Jetifier. بالإضافة إلى ذلك، يمكن أن يؤدي الخيار إلى انخفاض أداء عملية الإنشاء. إذا ظهر لك هذا التحذير، يمكنك إجراء فحص ضمن "أداة تحليل الإصدار" للتأكّد مما إذا كان يمكن إزالة العلامة.

دعم بيانات الاختبار الثابتة

بدءًا من الإصدار التجريبي الأول من Android Studio Chipmunk، يتيح Android Studio استخدام أدوات اختبار Android وJava. راجِع دليل Gradle حول استخدام بيانات الاختبار الثابتة{:.external} للحصول على مزيد من المعلومات حول ميزة بيانات الاختبار الثابتة وكيفية استخدامها في مشروع Java.

لتفعيل بيانات الاختبار الثابتة في وحدة مكتبة Android، أضِف ما يلي إلى ملف build.gradle على مستوى المكتبة: 

android {
  testFixtures {
    enable true
    // enable testFixtures's android resources (disabled by default)
    // androidResources true
  }
}

عند نشر مكتبتك، يتم أيضًا نشر ملف AAR لبيانات الاختبار الثابتة مع المكتبة الرئيسية تلقائيًا. سيحتوي ملف Gradle Module Metadata على معلومات ليتمكّن Gradle من استخدام العنصر الصحيح عند طلب مكوّن testFixtures.

لإيقاف نشر ملف AAR لبيانات الاختبار الثابتة لمكتبة في تنويعة الإصدار، أضِف ما يلي إلى ملف build.gradle على مستوى المكتبة: 

afterEvaluate {
  components.release.withVariantsFromConfiguration(
    configurations.releaseTestFixturesVariantReleaseApiPublication) { skip() }
  components.release.withVariantsFromConfiguration(
    configurations.releaseTestFixturesVariantReleaseRuntimePublication) { skip() }
}

لاستخدام ملف AAR لبيانات الاختبار الثابتة لمكتبة Android منشورة، يمكنك استخدام طريقة Gradle المساعدة testFixtures(). 

dependencies {
  testImplementation testFixtures('com.example.company:publishedLib:1.0')
}

تلقائيًا، ستحلّل أداة lint مصادر بيانات الاختبار الثابتة. يمكنك ضبط أداة lint لتجاهل مصادر بيانات الاختبار الثابتة على النحو التالي: 

android {
  lint {
    ignoreTestFixturesSources true
  }
}

جذور المحتوى المكررة غير متاحة

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