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

الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو إصدار رئيسي يتضمّن تغييرات في واجهة برمجة التطبيقات والسلوك.

للتحديث إلى الإصدار 9.0.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، استخدِم مساعد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android. يساعد "مساعد ترقية" Android Gradle Plugin في الحفاظ على السلوكيات الحالية عند ترقية مشروعك عند الحاجة، ما يتيح لك ترقية مشروعك لاستخدام الإصدار 9.0 من Android Gradle Plugin، حتى إذا لم تكن مستعدًا لاستخدام جميع الإعدادات التلقائية الجديدة في الإصدار 9.0 من المكوّن الإضافي Android Gradle.

تتوفّر أيضًا مهارتان للوكيل لتسهيل عملية الترقية. بالنسبة إلى التطبيقات التي لا تستخدم KMP، يمكنك تجربة مهارة الترقية إلى الإصدار 9 من المكوّن الإضافي Gradle لنظام Android من مستودع مهارات Android. بالنسبة إلى تطبيقات KMP، جرِّب مهارة الترقية إلى الإصدار 9 من المكوّن الإضافي لنظام Gradle المتوافق مع Android من JetBrains. لمزيد من المعلومات حول استخدام المهارات في "استوديو Android"، يُرجى الاطّلاع على توسيع "وضع الوكيل" باستخدام المهارات.

التوافق

الحدّ الأقصى لمستوى واجهة برمجة التطبيقات الذي يتوافق معه الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 36.1 لواجهة برمجة التطبيقات. في ما يلي معلومات أخرى عن التوافق:

فئات android DSL تنفّذ الآن الواجهات العلنية الجديدة فقط

على مدار السنوات القليلة الماضية، قدّمنا واجهات جديدة للغة DSL وواجهة برمجة التطبيقات من أجل التحكّم بشكل أفضل في واجهات برمجة التطبيقات المتاحة للجميع. استمرّ الإصداران 7.x و8.x من المكوّن الإضافي لنظام Gradle المتوافق مع Android في استخدام أنواع DSL القديمة (مثل BaseExtension) التي نفّذت أيضًا الواجهات العامة الجديدة، وذلك للحفاظ على التوافق مع تقدّم العمل على الواجهات.

يستخدم الإصدار 9.0 من Android Gradle Plugin واجهات DSL الجديدة حصريًا، وقد تم تغيير عمليات التنفيذ إلى أنواع جديدة مخفية بالكامل. ويؤدي هذا أيضًا إلى إزالة إمكانية الوصول إلى واجهة برمجة التطبيقات القديمة التي تم إيقافها نهائيًا.

للترقية إلى الإصدار 9.0 من AGP، قد تحتاج إلى إجراء ما يلي:

• تأكَّد من أنّ مشروعك متوافق مع لغة Kotlin المضمَّنة: لا يتوافق المكوّن الإضافي org.jetbrains.kotlin.android مع لغة DSL الجديدة.

• تبديل مشاريع KMP إلى المكوّن الإضافي لمكتبة Gradle المتوافقة مع Android في KMP: إنّ استخدام المكوّن الإضافي org.jetbrains.kotlin.multiplatform في مشروع Gradle الفرعي نفسه الذي يتضمّن المكوّنَين الإضافيَين com.android.library وcom.android.application لا يتوافق مع لغة DSL الجديدة.

• تعديل ملفات الإصدار: على الرغم من أنّ تغيير الواجهات يهدف إلى الحفاظ على لغة DSL قدر الإمكان، قد تكون هناك بعض التغييرات البسيطة.

• عدِّل منطق الإصدار المخصّص للإشارة إلى واجهة برمجة التطبيقات وDSL الجديدَين: استبدِل أي إشارات إلى DSL الداخلي بواجهات DSL العامة. في معظم الحالات، سيكون هذا بديلاً فرديًا. استبدِل أي استخدام لواجهة برمجة التطبيقات applicationVariants وواجهات برمجة التطبيقات المشابهة بواجهة برمجة التطبيقات الجديدة androidComponents. قد يكون ذلك أكثر تعقيدًا، لأنّ واجهة برمجة التطبيقات androidComponents مصمّمة لتكون أكثر ثباتًا من أجل الحفاظ على توافق المكوّنات الإضافية لفترة أطول. يمكنك الاطّلاع على وصفات Gradle للحصول على أمثلة.

• تحديث المكوّنات الإضافية التابعة لجهات خارجية: قد تظل بعض المكوّنات الإضافية التابعة لجهات خارجية تعتمد على واجهات أو واجهات برمجة تطبيقات لم تعُد متاحة. يجب نقل البيانات إلى إصدارات من هذه المكوّنات الإضافية المتوافقة مع الإصدار 9.0 من "مكوّن Android الإضافي في Gradle".

يمنع التبديل إلى واجهات DSL الجديدة المكوّنات الإضافية ونصوص Gradle البرمجية الخاصة بعملية الإنشاء من استخدام واجهات برمجة التطبيقات المتعدّدة المتوقفة نهائيًا، بما في ذلك:

androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}

androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }

إذا أجريت الترقية إلى الإصدار 9.0 من Android Gradle Plugin وظهرت لك رسالة الخطأ التالية، يعني ذلك أنّ مشروعك لا يزال يشير إلى بعض الأنواع القديمة:

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

إذا تم حظرك بسبب مكوّنات إضافية غير متوافقة تابعة لجهات خارجية، يمكنك إيقاف هذه الميزة واستعادة عمليات التنفيذ القديمة للغة DSL، بالإضافة إلى واجهة برمجة التطبيقات القديمة الخاصة بالصيغ. أثناء إجراء ذلك، تتوفّر أيضًا الواجهات الجديدة، ولا يزال بإمكانك تعديل منطق الإصدار الخاص بك إلى واجهة برمجة التطبيقات الجديدة. لإيقاف هذه الميزة، أدرِج هذا السطر في ملف gradle.properties:

android.newDsl=false

بدلاً من ذلك، لإجراء عملية نقل تدريجية، يتيح لك الإصدار 9.4 من AGP إيقاف الوحدات الفردية. لمعرفة كيفية إجراء ذلك، يُرجى الاطّلاع على إيقاف وحدة Variant API.

تم وضع علامة على الفئات السابقة على أنّها متوقفة نهائيًا في الإصدار 9.0 من AGP. هذا يعني أنّ المشاريع التي لا تستخدم العلامة newDsl ستظهر لها تحذيرات بشأن الإيقاف النهائي، بما في ذلك على كتلة android نفسها.

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

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

إذا تبيّن لك أنّ واجهة برمجة التطبيقات الجديدة DSL أو Variant API تفتقر إلى إمكانات أو ميزات، يُرجى الإبلاغ عن مشكلة في أقرب وقت ممكن.

لغة Kotlin المضمّنة

يقدّم الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android دعمًا مدمجًا للغة Kotlin ويتم تفعيله تلقائيًا. يعني ذلك أنّه لم يعُد عليك تطبيق المكوّن الإضافي org.jetbrains.kotlin.android (أو kotlin-android) في ملفات الإصدار لتجميع ملفات مصدر Kotlin. يؤدي ذلك إلى تبسيط عملية دمج Kotlin مع AGP، وتجنُّب استخدام واجهات برمجة التطبيقات المتوقفة نهائيًا، وتحسين الأداء في بعض الحالات.

لذلك، عند ترقية مشروعك إلى الإصدار 9.0 من AGP، عليك أيضًا نقل البيانات إلى Kotlin المضمّنة أو إيقافها.

يمكنك أيضًا إيقاف دعم Kotlin المضمّن بشكل انتقائي لمشاريع Gradle الفرعية التي لا تحتوي على مصادر Kotlin.

تبعية وقت التشغيل على المكوّن الإضافي Kotlin Gradle

لتوفير دعم مضمّن للغة Kotlin، يعتمد الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android الآن على الإصدار 2.2.10 من المكوّن الإضافي Kotlin Gradle‏ (KGP) في وقت التشغيل. يعني ذلك أنّه لم يعُد عليك تحديد إصدار KGP، وإذا كنت تستخدم إصدار KGP أقدم من 2.2.10، سيقوم Gradle تلقائيًا بترقية إصدار KGP إلى 2.2.10. وبالمثل، إذا كنت تستخدم إصدارًا من KSP أقدم من 2.2.10-2.0.2، سيقوم AGP بترقيته إلى 2.2.10-2.0.2 ليتوافق مع إصدار KGP.

الترقية إلى إصدار أعلى من KGP

لاستخدام إصدار أحدث من KGP أو KSP، أضِف ما يلي إلى ملف الإنشاء ذي المستوى الأعلى:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtools.ksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

الرجوع إلى إصدار أقدم من KGP

لا يمكنك الرجوع إلى إصدار سابق من KGP إلا إذا أوقفت Kotlin المضمَّنة. ويرجع ذلك إلى أنّ الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android يفعّل Kotlin المدمج تلقائيًا، ويتطلّب Kotlin المدمج الإصدار 2.2.10 أو إصدارًا أحدث من المكوّن الإضافي Kotlin لنظام Gradle.

لاستخدام إصدار أقدم من KGP أو KSP، يجب الإعلان عن هذا الإصدار في ملف الإنشاء ذي المستوى الأعلى باستخدام بيان الإصدار الصارم:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtools.ksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

يُرجى العِلم أنّ الحدّ الأدنى لإصدار KGP الذي يمكنك الرجوع إليه هو 2.0.0.

دعم IDE لتركيبات الاختبار

يوفّر الإصدار 9.0 من "مكوّن Android الإضافي لنظام Gradle" توافقًا كاملاً مع بيئة التطوير المتكاملة (IDE) في "استوديو Android" من أجل أدوات الاختبار.

المكوّن الإضافي لمكتبة Fused

يتيح لك المكوّن الإضافي Fused Library (نسخة حصرية) نشر مكتبات متعددة كمكتبة Android واحدة بتنسيق AAR. يمكن أن يسهّل ذلك على المستخدمين الاعتماد على العناصر المنشورة.

لمزيد من المعلومات حول كيفية البدء، يُرجى الاطّلاع على مقالة نشر مكتبات Android متعددة كمكتبة واحدة باستخدام Fused Library.

التغييرات في السلوك

يتضمّن الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android السلوكيات الجديدة التالية:

يتضمّن الإصدار 9.0 من AGP تعديلات على الإعدادات التلقائية التالية لسمات Gradle. يمنحك هذا الخيار إمكانية الحفاظ على سلوك الإصدار 8.13 من AGP عند الترقية:

android {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

الميزات التي تمت إزالتها

يزيل الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android الوظائف التالية:

• إتاحة تطبيقات Wear OS المضمّنة
  يزيل الإصدار 9.0 من AGP إمكانية تضمين تطبيقات Wear OS، وهو أمر لم يعُد متاحًا في Play. ويشمل ذلك إزالة إعدادات wearApp و AndroidSourceSet.wearAppConfigurationName DSL. يُرجى الاطّلاع على صفحة النشر على Wear OS لمعرفة كيفية نشر تطبيقك على Wear OS.
• androidDependencies وsourceSets يبلغان عن مهمة
• إتاحة حِزم APK المجزّأة حسب الكثافة
  يزيل الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android إمكانية إنشاء حِزم APK مجزّأة حسب كثافة الشاشة. وتمت إزالة هذه الوظيفة وواجهات برمجة التطبيقات ذات الصلة. لتقسيم حِزم APK استنادًا إلى كثافة الشاشة باستخدام الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android أو إصدار أحدث، استخدِم حِزم التطبيقات.

تم تغيير DSL

يتضمّن الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android التغييرات التالية غير المتوافقة في DSL:

• تمت إزالة مَعلمات CommonExtension.

  في حد ذاته، هذا مجرد تغيير قد يؤدي إلى عطل على مستوى المصدر للمساعدة في تجنُّب التغييرات المستقبلية التي قد تؤدي إلى عطل على مستوى المصدر، ولكنه يعني أيضًا أن طرق الحظر يجب أن تنتقل من CommonExtension إلى ApplicationExtension وLibraryExtension وDynamicFeatureExtension وTestExtension.

  عند ترقية مشروعك إلى الإصدار 9.0 من Android Gradle Plugin، عليك إعادة تصميم رمز المكوّن الإضافي لنظام Gradle الذي يستخدم هذه المَعلمات أو طرق الحظر. على سبيل المثال، تم تعديل المكوّن الإضافي التالي لإزالة مَعلمة النوع وعدم الاعتماد على طرق الحظر التي تمت إزالتها:

  الإصدار 8.13 من AGP

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

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

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  بالنسبة إلى المكوّنات الإضافية التي تستهدف مجموعة من إصدارات AGP، فإنّ استخدام دالة getter مباشرةً يتوافق مع إصدارات AGP الأقدم من 9.0.

تمت إزالة DSL

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

• AndroidSourceSet.jni، لأنّه لم يكن يعمل.

• AndroidSourceSet.wearAppConfigurationName، لأنّها تتعلّق بإزالة ميزة إتاحة تطبيقات Wear OS المضمّنة.

• BuildType.isRenderscriptDebuggable، لأنّه لم يكن يعمل.

• DependencyVariantSelection. تم استبداله بـ DependencySelection، والذي يتم عرضه على نحو kotlin.android.localDependencySelection

• Installation.installOptions(String). تم استبداله بالسمة القابلة للتغيير Installation.installOptions.

• كتلة PostProcessing التجريبية التي لم يتم تثبيتها مطلقًا

• ProductFlavor.setDimension، والتي تم استبدالها بالسمة dimension

• ‫LanguageSplitOptions، الذي كان مفيدًا فقط في تطبيقات Google Play الفورية، التي تم إيقافها نهائيًا.

• DensitySplit، لأنّ الميزة لم تعُد متاحة. والبديل هو استخدام حِزم التطبيقات.

واجهات برمجة التطبيقات التي تمت إزالتها

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

• AndroidComponentsExtension.finalizeDSl. تم استبداله بـ finalizeDsl

• Component.transformClassesWith. تم استبداله بـ Instrumentation.transformClassesWith

• Component.setAsmFramesComputationMode. تم استبداله بـ Instrumentation.setAsmFramesComputationMode

• ComponentBuilder.enabled. تم استبداله بـ ComponentBuilder.enable.

• DependenciesInfoBuilder.includedInApk. تم استبداله بـ includeInApk

• DependenciesInfoBuilder.includedInBundle. تم استبداله بـ includeInBundle

• GeneratesApk.targetSdkVersion: تم استبداله بـ targetSdk

• Variant.minSdkVersion: تم استبداله بـ minSdk

• Variant.maxSdkVersion: تم استبداله بـ maxSdk

• Variant.targetSdkVersion: تم استبداله بـ targetSdk

• Variant.unitTest، لأنّه لا ينطبق على المكوّن الإضافي com.android.test. يتوفّر unitTest في الأنواع الفرعية VariantBuilder التي تمدّد HasUnitTest.

• VariantBuilder.targetSdk وtargetSdkPreview، لأنّهما لم يكونا مفيدَين في المكتبات. يُرجى استخدام GeneratesApkBuilder.targetSdk أو GeneratesApkBuilder.targetSdkPreview بدلاً من ذلك.

• VariantBuilder.enableUnitTest، لأنّه لا ينطبق على المكوّن الإضافي com.android.test. يتوفّر enableUnitTest في الأنواع الفرعية VariantBuilder التي تمدّد HasUnitTestBuilder.

• VariantBuilder.unitTestEnabled is removed in favor of the more consistently named enableUnitTest on the VariantBuilder subtypes extending HasUnitTestBuilder.

• VariantOutput.enable: تم استبداله بـ enabled

• السمتان FeaturePlugin وFeatureExtension اللتان تم إيقافهما نهائيًا.

• واجهات برمجة التطبيقات BaseExtension.registerTransform التي تم إيقافها أو إزالتها نهائيًا، والتي كانت متاحة فقط للسماح بالتجميع باستخدام أحدث إصدار من "مكوّن Android الإضافي" مع استهداف الإصدار 4.2 أو الإصدارات الأقدم من "مكوّن Android الإضافي"

خصائص Gradle التي تمت إزالتها

تمت إضافة سمات Gradle التالية في البداية كطرق لإيقاف الميزات التي تم تفعيلها تلقائيًا على مستوى العالم.

تم إيقاف هذه الميزات تلقائيًا منذ الإصدار 8.0 من "مكوّن Android الإضافي لـ Gradle" أو الإصدارات الأقدم. يمكنك تفعيل هذه الميزات في المشاريع الفرعية التي تستخدمها فقط لإنشاء إصدار أكثر كفاءة.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

خصائص Gradle المفروضة

يعرض الإصدار 9.0 من AGP خطأً في حال ضبط سمات Gradle التالية.

لن يعمل مساعد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android على ترقية المشاريع إلى الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android التي تستخدم هذه السمات.

تغييرات R8

تم تضمين تغييرات R8 التالية في الإصدار 9.0.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.

خيار إعداد جديد: -processkotlinnullchecks

أضفنا خيار R8 الجديد -processkotlinnullchecks لضبط R8 من أجل معالجة عمليات التحقّق من القيم الفارغة في Kotlin. يتطلّب الخيار وسيطة إلزامية يجب أن تكون إحدى القيم الثلاث التالية: keep وremove_message وremove. يعالج الخيار عمليات التحقّق من القيم الفارغة التالية التي يضيفها برنامج تجميع Kotlin:

class kotlin.jvm.internal.Intrinsics {
  void checkNotNull(java.lang.Object);
  void checkNotNull(java.lang.Object, java.lang.String);
  void checkExpressionValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkNotNullExpressionValue(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkFieldIsNotNull(java.lang.Object, java.lang.String);
  void checkFieldIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkParameterIsNotNull(java.lang.Object, java.lang.String);
  void checkNotNullParameter(java.lang.Object, java.lang.String);
}

تؤدي قيم الخيارات، مرتبة من الأضعف إلى الأقوى، إلى التأثير التالي:

• لا يغيّر "keep" عمليات التحقّق.
• يُعيد remove_message كتابة كل طلب إجراء تحقّق إلى طلب إجراء getClass() في الوسيطة الأولى من الطلب (مع الاحتفاظ بفعالية التحقّق من القيمة الفارغة، ولكن بدون أي رسالة).
• يؤدي استخدام remove إلى إزالة عمليات التحقّق تمامًا.

يستخدم R8 تلقائيًا remove_message. وسيتم تجاهل ذلك في حال تحديد -processkotlinnullchecks. في حال تحديدها عدة مرات، يتم استخدام القيمة الأقوى.

إيقاف نشر معلومات الاحتفاظ إلى طرق المرافقة

عندما تتطابق قواعد الاحتفاظ مع طرق الواجهة التي تخضع لإزالة التجميل اللغوي، كانت أداة R8 تنقل داخليًا وحدات بت عدم السماح بالتحسين وعدم السماح بالتصغير إلى طرق المرافقة المركّبة.

بدءًا من الإصدار 9.0 من Android Gradle Plugin، لن تنطبق قواعد الاحتفاظ على الأساليب المصاحبة. يتوافق ذلك مع حقيقة أنّ قواعد الاحتفاظ لا تنطبق على الحقول أو الطرق أو الفئات الأخرى التي تم إنشاؤها بواسطة برنامج التجميع.

من خلال نقل وحدات بت عدم السماح بالتحسين وعدم السماح بالتقليص إلى الطرق المصاحبة، كانت حالة الاستخدام التالية متاحة في السابق:

1. تجميع مكتبة تتضمّن طرق واجهة default/static/private في DEX مع minSdk < 24 وقواعد تحتفظ بطرق الواجهة
2. تجميع تطبيق باستخدام المكتبة في مسار الفئة و-applymapping
3. دمج التطبيق والمكتبة

يُرجى العِلم أنّ هذا الإجراء لا يعمل إلا مع -applymapping لأنّه لا يتم نقل الجزء disallow obfuscation إلى الطرق المصاحبة، أي أنّ الفئات المصاحبة التي تم إنشاؤها من الخطوة 1 ستتضمّن أسماء طرق مخفية.

لن تكون حالة الاستخدام هذه متاحة بعد الآن للإصدارات الأقدم من minSdk < 24. الحلّ البديل هو تنفيذ ما يلي:

1. تحويل المكتبة باستخدام طرق واجهة default/static/private إلى ملفات فئة باستخدام minSdk < 24.
2. تجميع العناصر التي تمت إزالة التجميل اللغوي منها باستخدام R8 والقواعد التي تحتفظ بطُرق الواجهة في الفئات المصاحبة
3. جمِّع التطبيق باستخدام المكتبة في مسار الفئة.
4. دمج التطبيق مع العنصر الذي تمت إزالة التجميل اللغوي منه

ومن الآثار الجانبية الأخرى لذلك أنّه لم يعُد من الممكن الاحتفاظ بسمات الفئة الداخلية والطريقة المضمّنة للفئات المجهولة والمحلية داخل طرق الواجهة المصاحبة.

تغيير ملف المصدر التلقائي الذي تم إصداره إلى r8-map-id-<MAP_ID>

يسري هذا التغيير في الإصدار 8.12.0 من "مكوّن Android Gradle الإضافي".

تتغيّر سمة ملف المصدر التلقائية المنبعثة للفئة من SourceFile إلى r8-map-id-<MAP_ID> عندما تكون إعادة التتبّع مطلوبة (أي عند تفعيل ميزة التعتيم أو التحسين).

عند توفُّر تتبُّع تسلسل استدعاء الدوال البرمجية بشكل مخفي، تتيح سمة ملف المصدر الجديدة استخراج رقم تعريف ملف الربط المطلوب لإعادة التتبُّع، والذي يمكن استخدامه لإتاحة إعادة التتبُّع الآلي لتسلسل استدعاء الدوال البرمجية في Logcat.

في حال استخدام سمة ملف مصدر مخصّصة (-renamesourcefileattribute)، ستبقى الأولوية لهذه السمة.

في وضع التوافق مع ProGuard (عندما يحتوي gradle.properties على android.enableR8.fullMode=false)، لا يتم تفعيل سمة ملف المصدر r8-map-id-<MAP_ID> إلا إذا لم يتم الاحتفاظ بالسمة SourceFile. على التطبيقات التي تستخدم وضع التوافق مع ProGuard وتريد تضمين معرّف ملف الربط في تتبُّع تسلسل استدعاء الدوال البرمجية إزالة -keepattributes SourceFile (أو الانتقال إلى وضع R8 الكامل).

رقم تعريف الخريطة المستخدَم في r8-map-id-<MAP_ID> هو تجزئة الخريطة الكاملة، وليس بادئة من 7 أحرف لتجزئة الخريطة التي تم استخدامها سابقًا.

تفعيل استخدام الأسماء الاصطناعية المصغّرة في عملية إزالة التجميل اللغوي في L8

يحتوي اسم الفئات الاصطناعية التي تم إنشاؤها بواسطة D8 عادةً على السلسلة الفرعية $$ExternalSynthetic التي تخبرك بأنّ هذه فئة اصطناعية تم إنشاؤها بواسطة D8. بالإضافة إلى ذلك، يرمّز اسم العنصر الاصطناعي أيضًا نوعه (على سبيل المثال، Backport وLambda)، ما يؤثر سلبًا في حجم ملف DEX الناتج، لأنّ أسماء الفئات تشغل مساحة أكبر في مجموعة السلاسل.

يضبط الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android‏ (AGP) أداة L8 (إزالة التجميل اللغوي من المكتبة الأساسية) بحيث يستخدم ملف DEX الذي يحتوي على جميع فئات j$ تنسيقًا جديدًا ومختصرًا لأسماء الفئات الاصطناعية. يستخدم اسم الفئة الجديد معرّفًا رقميًا (على سبيل المثال، $1).

إزالة إمكانية استخدام -addconfigurationdebugging

يزيل الإصدار 9.0 من &quot;المكوّن الإضافي لنظام Gradle المتوافق مع Android&quot; إمكانية استخدام -addconfigurationdebugging. يُبلغ برنامج التجميع الآن عن تحذير في حال استخدام العلامة.

إزالة إمكانية إنشاء قواعد L8 من D8/R8

لا ينطبق هذا التغيير إلا على المطوّرين الذين يستخدمون سطر أوامر D8/R8 أو واجهات برمجة التطبيقات مباشرةً.

يزيل الإصدار 9.0 من R8 إمكانية إنشاء قواعد الاحتفاظ بالبيانات لـ L8 من D8 وR8. يجب استخدام TraceReferences بدلاً من ذلك لهذا الغرض.

وبشكل أكثر تحديدًا، ستتم إزالة الطريقتين D8Command.builder.setDesugaredLibraryKeepRuleConsumer وR8Command.Builder.setDesugaredLibraryKeepRuleConsumer، وستتم إزالة إمكانية استخدام --desugared-lib-pg-conf-output من خيارات سطر الأوامر في D8 وR8.

المشاكل التي تم حلّها

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