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

تحتوي هذه الصفحة على ملاحظات الإصدار للإصدارات التجريبية من المكوّن الإضافي لنظام Gradle المتوافق مع Android‏ (AGP).

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

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

للتحديث إلى الإصدار 9.0.0-alpha04 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، استخدِم مساعد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android في الإصدار 4 من تحديث Narwhal من "استوديو Android" | 2025.1.4.

يساعد "مساعد ترقية" AGP في الحفاظ على السلوكيات الحالية عند ترقية مشروعك عند الاقتضاء، ما يتيح لك ترقية مشروعك لاستخدام الإصدار 9.0 من AGP، حتى إذا لم تكن مستعدًا لاستخدام جميع الإعدادات التلقائية الجديدة في الإصدار 9.0 من AGP.

التوافق

الحد الأقصى لمستوى واجهة برمجة تطبيقات Android الذي يتيحه الإصدار 9.0.0-alpha04 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 36 من واجهة برمجة التطبيقات.

يتطلّب الإصدار 9.0.0-alpha04 من المكوّن الإضافي لنظام Gradle المتوافق مع Android استخدام الإصدار 9.0.0 من Gradle.

تتطلّب الآن عمليات التنفيذ الداخلية للغة DSL وواجهة برمجة التطبيقات المتوقّفة للنوع موافقة صريحة

يحتوي المكوّن الإضافي لنظام Gradle المتوافق مع Android الآن على مساحة واجهة برمجة تطبيقات محدّدة، مع تحديد واجهات برمجة التطبيقات المتوافقة في العنصر com.android.tools.build:gradle-api من Maven.

للتوافق مع المكوّنات الإضافية الثنائية الحالية وبرامج النصوص الخاصة بالإنشاء، ظلّت عمليات تنفيذ DSL السابقة التي تسبق مساحة واجهة برمجة التطبيقات المحدّدة متاحة تلقائيًا في الإصدار 8.13 والإصدارات الأقدم من "مكوّن Android الإضافي". يتيح ذلك للرمز البرمجي في مكوّنات Gradle الإضافية ونصوص الإصدار البرمجية الوصول إلى تفاصيل التنفيذ الداخلية للغة الخاصة بالمجال، بالإضافة إلى واجهات برمجة التطبيقات android.applicationVariants وandroid.libraryVariants وandroid.testVariants وandroid.unitTestVariants المتوقّفة نهائيًا، والتي ستتم إزالتها في عام 2026 في الإصدار 10.0 من "مكوّن Android الإضافي في Gradle".

لإبراز هذا الانتقال، لن يكون كلّ من واجهة برمجة التطبيقات القديمة الخاصة بمتغيرات الإصدار ونظام DSL الداخلي متاحًا تلقائيًا في الإصدار 9.0.0-alpha04 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.

يمكنك إعادة تفعيل واجهة برمجة التطبيقات المتوقّفة نهائيًا من خلال ضبط android.newDsl=false في gradle.properties.

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

Kotlin المضمَّنة

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

يحتوي الإصدار 9 من المكوّن الإضافي لنظام Gradle المتوافق مع Android على تبعية وقت التشغيل للإصدار 2.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Kotlin، وهو الحد الأدنى للإصدار المطلوب لتوفير دعم مدمج للغة Kotlin.

يمكنك إيقاف استخدام Kotlin المضمّنة من خلال ضبط android.builtInKotlin=false. إذا اخترت عدم استخدام الإصدار الجديد وكنت بحاجة أيضًا إلى استخدام إصدار قديم من مكوّن Gradle الإضافي للغة Kotlin، يمكنك فرض الرجوع إلى الإصدار القديم.

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

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

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

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

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

تغيير DSL

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

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

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

  عند ترقية مشروعك إلى الإصدار 9.0 من "مكوّن Android الإضافي في Gradle"، أعِد تصميم رمز المكوّن الإضافي في 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)
          }
      }
  }
  

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

إزالة DSL

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

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

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

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

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

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

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

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

• الكتلة التجريبية PostProcessing التي لم يتم تثبيتها أبدًا.

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

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

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

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

• تمت إزالة VariantBuilder.unitTestEnabled واستبداله بـ enableUnitTest الذي يحمل اسمًا أكثر اتساقًا، وذلك في الأنواع الفرعية VariantBuilder التي تتضمّن HasUnitTestBuilder.

إزالة خصائص Gradle

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

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

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

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

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

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

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