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

ويستند نظام تصميم "استوديو Android" إلى نظام Gradle ونظام Gradle المتوافق مع Android. العديد من الميزات الخاصة بإنشاء تطبيقات Android. رغم عادةً ما يتم تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) في خطوة القفل باستخدام نظام التشغيل Android يمكن أن يعمل المكون الإضافي (وبقية نظام Gradle) بشكل مستقل عن "استوديو Android" ويتم تحديثه بشكل منفصل.

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

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

للحصول على ملخّص عام للتغييرات التي قد تؤدي إلى أعطال في نظام Gradle المتوافق مع Android المكون الإضافي، راجع Android خارطة طريق مكوّن Gradle الإضافي

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

• ضبط الإصدار
• مرجع DSL لمكوّن Gradle المتوافق مع Android
• مرجع Gradle DSL
• دليل المستخدم لأداء Gradle

لمزيد من المعلومات حول نظام إصدار Gradle، يمكنك الاطلاع على دليل مستخدم Gradle.

تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android

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

يمكنك تحديد إصدار المكون الإضافي في إما الملف > المشروع البنية > قائمة المشروع في "استوديو Android" ملف build.gradle.kts ذي المستوى الأعلى. ينطبق إصدار المكون الإضافي على جميع الوحدات المضمَّنة في مشروع استوديو Android هذا. توضح الأمثلة التالية المكون الإضافي إلى الإصدار 8.6.0 من ملف build.gradle.kts:

plugins {
    id("com.android.application") version "8.6.0" apply false
    id("com.android.library") version "8.6.0" apply false
    id("org.jetbrains.kotlin.android") version "2.0.20" apply false
}

plugins {
    id 'com.android.application' version '8.6.0' apply false
    id 'com.android.library' version '8.6.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}

تنبيه: يجب عدم استخدام الاعتماديات الديناميكية في الإصدار. أرقامًا، مثل 'com.android.tools.build:gradle:8.6.+' قد يؤدي استخدام هذه الميزة إلى حدوث صعوبات وتحديثات غير متوقعة في الإصدار. وحل الاختلافات في الإصدارات.

إذا لم يتم تنزيل إصدار المكوّن الإضافي المحدّد، تنزِّله Gradle في المرة القادمة التي تنشئ فيها مشروعك أو انقر على ملف > مزامنة المشروع مع ملفات Gradle من شريط القوائم في "استوديو Android"

تعديل Gradle

عند تحديث "استوديو Android"، قد تتلقّى إشعارًا إلى يُرجى تحديث Gradle إلى أحدث إصدار متاح. يمكنك اختيار قبول تحديث أو تحديد إصدار يدويًا بناءً على إصدار مشروعك متطلبات المشروع.

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

يمكنك تحديد إصدار Gradle في ملف > بنية المشروع > قائمة المشروع في "استوديو Android" أو تحديث إصدار Gradle باستخدام سطر الأوامر. الطريقة المفضلة هي استخدام ملف التفاف الخرز أداة سطر الأوامر، التي تحدّث نصوص gradlew البرمجية. ما يلي: على سبيل المثال، يحدد إصدار Gradle على 8.6 باستخدام Gradle Wrapper. تجدر الإشارة إلى أنّه يجب تشغيل هذا الأمر مرّتَين لترقية كلّ من أداة Gradle برنامج Gradle Wrapper نفسه (لمزيد من المعلومات، راجع جارٍ ترقية ملف Gradle المغلّف).

gradle wrapper --gradle-version 8.6

ومع ذلك، قد يتعذّر تنفيذ ذلك في بعض الحالات، على سبيل المثال إذا كنت قد حدّثت تنسيق AGP ولم يعُد متوافقًا مع إصدار Gradle الحالي. وفي هذه الحالة، تحتاج إلى تعديل مرجع توزيع Gradle في ملف gradle/wrapper/gradle-wrapper.properties. ما يلي: على سبيل المثال، يحدد إصدار Gradle على 8.6 في ملف gradle-wrapper.properties.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-bin.zip
...

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

ويستند نظام تصميم "استوديو Android" إلى نظام Gradle ونظام Gradle المتوافق مع Android. (AGP) العديد من الميزات الخاصة بإنشاء تطبيقات Android. تشير رسالة الأشكال البيانية يدرج الجدول التالي إصدار AGP المطلوب لكل إصدار من "استوديو Android".

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

الحد الأدنى من إصدارات الأدوات لمستوى واجهة برمجة تطبيقات Android

هناك حدّ أدنى من إصدارات "استوديو Android" وAGP يتوافق مع واجهة برمجة تطبيقات معيّنة. المستوى. إذا كنت تستخدم إصدارات من "استوديو Android" أو AGP أقلّ من تلك التي تتطلّبها أن يؤدي targetSdk أو compileSdk للمشروع إلى مشاكل غير متوقعة. أر ننصحك باستخدام أحدث إصدار معاينة من "استوديو Android" وAGP للعمل على للمشروعات التي تستهدف إصدارات المعاينة من نظام التشغيل Android. يمكنك تثبيت إصدارات معاينة "استوديو Android" إلى جانب إصدار ثابت.

في ما يلي الحد الأدنى لإصدارات "استوديو Android" وAGP:

التغييرات في الإصدارات (تشرين الثاني/نوفمبر 2020)

نعمل على تعديل ترقيم إصدارات المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) إلى تطابق بشكل وثيق أداة إنشاء Gradle الأساسية.

في ما يلي التغييرات البارزة:

• سيستخدم AGP الآن الإصدارات الدلالية، وسيتم إجراء التغييرات التي قد تؤدي إلى التي تستهدف الإصدارات الرئيسية.

• سيتم إطلاق إصدار رئيسي واحد من AGP سنويًا، بما يتوافق مع الإصدار الرئيسي لنظام Gradle.

• سيكون الإصدار بعد AGP 4.2 هو الإصدار 7.0 وسيتطلب ترقية إلى الإصدار 7.x من Gradle. سيتطلب كل إصدار رئيسي من AGP عرضًا في أداة Gradle الأساسية.

• سيتم إيقاف واجهات برمجة التطبيقات نهائيًا قبل عام واحد تقريبًا، توفير وظيفة الاستبدال بالتزامن. واجهات برمجة التطبيقات التي تم إيقافها نهائيًا ستتم إزالتها بعد عام واحد تقريبًا خلال الفترة الرئيسية اللاحقة تحديث.

التوافق

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