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

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

7.2.2 (آب/أغسطس 2022)

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

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

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

للاطّلاع على إصلاحات الأخطاء الأخرى المضمَّنة في هذا الإصدار، يمكنك الاطّلاع على ملاحظات إصدار Android Studio Chipmunk 1.

التوافق

الحد الأدنى للإصدار الإصدار التلقائي
مبرّد 7.3.3 7.3.3
أدوات إنشاء حِزم تطوير البرامج (SDK) 30.0.3 30.0.3
العُقدة (NDK) لا ينطبق 21.4.7075529
JDK 11 11

تحذير Jetifier والتحقّق منها في "أداة تحليل الإصدار"

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

توفير أدوات الاختبار

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

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

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

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

لإيقاف نشر ميزة "الاقتراحات المطبّقة تلقائيًا" لمكتبة ضِمن صيغة الإصدار، أضِف ما يلي إلى ملف build.gradle على مستوى المكتبة: 

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

للاطّلاع على استخدام ميزة "الاقتراحات المطبّقة تلقائيًا" في إحدى مكتبات Android المنشورة، يمكنك استخدام طريقة المساعدة testFixtures() وفقًا لمنصة Gradle. 

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

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

android {
  lint {
    ignoreTestFixturesSources true
  }
}

لا يمكن استخدام شهادات الجذر للمحتوى المكرّر.

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