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

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

نحن نتواصل مع مطوّري المكوّنات الإضافية الشائعة الاستخدام لمساعدتهم في تكييف وإصدار مكوّنات إضافية متوافقة تمامًا مع الأوضاع الجديدة، وسنواصل تحسين "مساعد ترقية مكوّن 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 من المكوّن الإضافي لنظام Gradle المتوافق مع Kotlin ‏ (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 من "مكوّن Gradle الإضافي لنظام Android" إمكانية تضمين تطبيقات 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 الذي يستخدم هذه المَعلمات أو طرق الحظر. على سبيل المثال، تم تعديل المكوّن الإضافي التالي لإزالة مَعلمة النوع وعدم الاعتماد على طرق الحظر التي تمت إزالتها:

  AGP 8.13

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

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

  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

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

خيار ضبط جديد: -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 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android".

تتغيّر سمة ملف المصدر التلقائية المنبعثة للفئة من 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 من 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