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

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

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

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

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

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

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

التوافق

الحد الأدنى للإصدار الإصدار التلقائي الملاحظات
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 والتحقّق منه في "أداة تحليل الإصدار"

يعرض تطبيق Build Analyzer الآن تحذيرًا إذا كان ملف gradle.properties الخاص بمشروعك يتضمّن android.enableJetifier=true. تم طرح هذا الخيار في إصدار سابق من Android Studio لتفعيل 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 على معلومات تتيح لـ Gradle استخدام العنصر الصحيح عند طلب المكوّن testFixtures.

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

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

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

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

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

android {
  lint {
    ignoreTestFixturesSources true
  }
}

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

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