الإصدار 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 من المكوّن الإضافي لنظام Android Gradle من مستودع مهارات Android. بالنسبة إلى تطبيق KMP، جرِّب مهارة الترقية إلى الإصدار 9 من المكوّن الإضافي لنظام Android Gradle من JetBrains. لمزيد من المعلومات حول استخدام المهارات في "استوديو Android"، يُرجى الاطّلاع على توسيع نطاق "وضع الوكيل" باستخدام المهارات.

التوافق

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

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

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

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

للتحديث إلى الإصدار 9.0 من "استوديو Android"، قد تحتاج إلى إجراء ما يلي:

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

• تبديل مشاريع KMP إلى المكوّن الإضافي لمكتبة Android Gradle المتوافق مع 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.0 من "مكوّن Android الإضافي لنظام Gradle". وهذا يعني أنّ المشاريع التي لا تستخدم العلامة newDsl ستتلقّى تحذيرات بشأن الإيقاف النهائي، بما في ذلك التحذيرات المتعلقة بالكتلة android نفسها.

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

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

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

مضمَّنة في Kotlin

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

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

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

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

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

لاستخدام إصدار أقل من 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 Library Plugin

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

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

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

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

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

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

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

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

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

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

تغيير DSL

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

• تمت إزالة تحديد المَعلمات الخاص بـ CommonExtension.

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

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

  AGP 8.13

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

  AGP 9.0

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

  بالنسبة إلى المكوّنات الإضافية التي تستهدف نطاقًا من إصدارات "مكوّن Android الإضافي لنظام Gradle"، يكون استخدام الدالة getter مباشرةً متوافقًا مع إصدارات "مكوّن Android الإضافي لنظام Gradle" الأقل من 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 واستبداله بـ enableUnitTest الذي يحمل اسمًا أكثر اتساقًا، وذلك في الأنواع الفرعية VariantBuilder التي تتضمّن HasUnitTestBuilder.

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

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

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

إزالة خصائص Gradle

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

خصائص Gradle الإلزامية

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

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

تغييرات 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 إلى إلغاء ذلك. إذا تم تحديدها عدة مرات، سيتم استخدام القيمة الأقوى.

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

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

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

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

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>

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

تتغيّر سمة ملف المصدر التلقائي المنبعث لفئة من 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 أحرف من تجزئة الخريطة التي تم استخدامها سابقًا.

تفعيل استخدام الأسماء الاصطناعية المصغّرة في عملية إزالة السكر من الإصدار 8 من لغة Java

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

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

إزالة التوافق مع -addconfigurationdebugging

يزيل الإصدار 9.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" إمكانية استخدام -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