ويستند نظام تصميم "استوديو Android" إلى نظام Gradle ونظام Gradle المتوافق مع Android. العديد من الميزات الخاصة بإنشاء تطبيقات Android. رغم عادةً ما يتم تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) في خطوة القفل باستخدام نظام التشغيل Android يمكن أن يعمل المكون الإضافي (وبقية نظام Gradle) بشكل مستقل عن "استوديو Android" ويتم تحديثه بشكل منفصل.
تشرح هذه الصفحة كيفية الحفاظ على استمرارية أدوات Gradle التاريخ وما تحتوي عليه التحديثات الأخيرة. بالنسبة إلى ملاحظات الإصدار لتطبيقات Android السابقة إصدارات المكوّن الإضافي لنظام Gradle، راجع ملاحظات الإصدار السابقة.
لمعرفة ما تم إصلاحه في هذا الإصدار من المكوّن الإضافي لنظام Gradle المتوافق مع Android، يُرجى الاطّلاع على المشاكل المغلقة.
للحصول على ملخّص عام للتغييرات التي قد تؤدي إلى أعطال في نظام Gradle المتوافق مع Android المكون الإضافي، راجع Android خارطة طريق مكوّن Gradle الإضافي
للاطّلاع على تفاصيل حول طريقة ضبط إصدارات Android باستخدام Gradle، يمكنك الاطّلاع على الصفحات التالية:
لمزيد من المعلومات حول نظام إصدار Gradle، يمكنك الاطلاع على دليل مستخدم Gradle.
تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android
عند تحديث "استوديو Android"، قد تتلقى رسالة مطالبة تلقائيًا عليك تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android إلى أحدث إصدار متاح. إِنْتَ يمكنك اختيار قبول التحديث أو تحديد إصدار يدويًا استنادًا إلى متطلبات إنشاء مشروعك.
يمكنك تحديد إصدار المكون الإضافي في
إما الملف > المشروع
البنية > قائمة المشروع في "استوديو Android"
ملف build.gradle.kts ذي المستوى الأعلى. ينطبق إصدار المكون الإضافي على
جميع الوحدات المضمَّنة في مشروع استوديو Android هذا. توضح الأمثلة التالية
المكون الإضافي إلى الإصدار 8.5.0 من
ملف build.gradle.kts:
Kotlin
plugins {
id("com.android.application") version "8.5.0" apply false
id("com.android.library") version "8.5.0" apply false
id("org.jetbrains.kotlin.android") version "1.9.23" apply false
}
Groovy
plugins {
id 'com.android.application' version '8.5.0' apply false
id 'com.android.library' version '8.5.0' apply false
id 'org.jetbrains.kotlin.android' version '1.9.23' apply false
}
تنبيه: يجب عدم استخدام الاعتماديات الديناميكية في الإصدار.
أرقامًا، مثل
'com.android.tools.build:gradle:8.5.+'
قد يؤدي استخدام هذه الميزة إلى حدوث صعوبات وتحديثات غير متوقعة في الإصدار.
وحل الاختلافات في الإصدارات.
إذا لم يتم تنزيل إصدار المكوّن الإضافي المحدّد، تنزِّله Gradle في المرة القادمة التي تنشئ فيها مشروعك أو انقر على ملف > مزامنة المشروع مع ملفات Gradle من شريط القوائم في "استوديو Android"
تحديث Gradle
عند تحديث "استوديو Android"، قد تتلقّى إشعارًا إلى يُرجى تحديث Gradle إلى أحدث إصدار متاح. يمكنك اختيار قبول تحديث أو تحديد إصدار يدويًا بناءً على إصدار مشروعك متطلبات المشروع.
يسرد الجدول التالي إصدار Gradle المطلوب لكل منها المكوّن الإضافي لنظام Gradle المتوافق مع Android. للحصول على أفضل أداء، يجب عليك استخدام أحدث إصدار ممكن من كل من أداة Gradle والمكون الإضافي.
| إصدار المكوِّن الإضافي | الحد الأدنى المطلوب لإصدار Gradle |
|---|---|
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | من نظام التشغيل Android |
| من نظام التشغيل Android | من نظام التشغيل Android |
| 7.4 | 7.5 |
إصدارات سابقة
| إصدار المكوِّن الإضافي | إصدار Gradle المطلوب |
|---|---|
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7 | 7 |
| 4.2.0 أو أحدث | 6.7.1 |
| 4.1.0 أو أحدث | 6.5 أو الأحدث |
| 4.0.0 أو الأحدث | 6.1.1 أو الأحدث |
| 3.6.0 - 3.6.4 | 5.6.4 أو الأحدث |
| 3.5.0 - 3.5.4 | 5.4.1 والإصدارات الأحدث |
| 3.4.0 - 3.4.3 | 5.1.1 أو أحدث |
| 3.3.0 - 3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | الإصدار 4.6 أو الإصدارات الأحدث |
| 3.1.0 أو الأحدث | الإصدار 4.4 أو الإصدارات الأحدث |
| 3.0.0 أو الأحدث | الإصدار 4.1 أو الإصدارات الأحدث |
| الإصدار 2.3.0 أو الإصدارات الأحدث | الإصدار 3.3 أو الإصدارات الأحدث |
| من 2.1.3 إلى 2.2.3 | 2.14.1 - 3.5 |
| من 2.0.0 إلى 2.1.2 | من 2,10 إلى 2,13 |
| 1.5.0 | من 2.2.1 إلى 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
يمكنك تحديد إصدار Gradle في ملف >
بنية المشروع > قائمة المشروع في "استوديو Android"
أو تحديث إصدار Gradle باستخدام سطر الأوامر.
الطريقة المفضلة هي استخدام
ملف التفاف الخرز
أداة سطر الأوامر، التي تحدّث نصوص gradlew البرمجية. ما يلي:
على سبيل المثال، يحدد إصدار Gradle على 8.5 باستخدام ملف Gradle Wrapper.
تجدر الإشارة إلى أنّه يجب تشغيل هذا الأمر مرّتَين لترقية كلّ من أداة Gradle
برنامج Gradle Wrapper نفسه (لمزيد من المعلومات، راجع
جارٍ ترقية ملف Gradle المغلّف).
gradle wrapper --gradle-version 8.5
ومع ذلك، قد يتعذّر تنفيذ ذلك في بعض الحالات، على سبيل المثال إذا كنت قد حدّثت تنسيق AGP
ولم يعُد متوافقًا مع إصدار Gradle الحالي. وفي هذه الحالة،
تحتاج إلى تعديل مرجع توزيع Gradle في
ملف gradle/wrapper/gradle-wrapper.properties. ما يلي:
على سبيل المثال، يحدد إصدار Gradle على 8.5 في
ملف gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.5-bin.zip
...
نظام Gradle المتوافق مع Android المكوّن الإضافي والتوافق مع "استوديو Android"
ويستند نظام تصميم "استوديو Android" إلى نظام Gradle ونظام Gradle المتوافق مع Android. (AGP) العديد من الميزات الخاصة بإنشاء تطبيقات Android. تشير رسالة الأشكال البيانية يدرج الجدول التالي إصدار AGP المطلوب لكل إصدار من "استوديو Android".
| إصدار "استوديو Android" | إصدار AGP المطلوب |
|---|---|
| كوالا | 1 تشرين الأول (أكتوبر) 2024 | 8.5-3.2 |
| قنديل بحر | 1 تشرين الأول (أكتوبر) 2023 | 8.4-3.2 |
| إغوانا | 1 تشرين الأول (أكتوبر) 2023 | 3.2-8.3 |
| القنفذ | 1 تشرين الأول (أكتوبر) 2023 | من 3.2 إلى 8.2 |
| زرافة | 1 آذار (مارس) 2022 | من 3.2 إلى 8.1 |
| زهري مرجاني | 1 تشرين الثاني (نوفمبر) 2022 | من 3.2 إلى 8.0 |
إصدارات سابقة
| إصدار "استوديو Android" | إصدار AGP المطلوب |
|---|---|
| الأنقليس الكهربائي | 1 تشرين الأول (أكتوبر) 2022 | 3.2-7.4 |
| دولفين | 1 تشرين الثاني (نوفمبر) 2021 | 3.2-7.3 |
| سنجاب | 1 تشرين الثاني (نوفمبر) 2021 | 3.2-7.2 |
| نحلة | 1 تشرين الأول (أكتوبر) 2021 | 3.2-7.1 |
| الثعلب القطبي | 1/3/2020 | من 3.1 إلى 7.0 |
للحصول على معلومات بشأن الميزات الجديدة في المكوّن الإضافي لنظام Gradle المتوافق مع Android، يمكنك الاطّلاع على ملاحظات إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android
الحد الأدنى من إصدارات الأدوات لمستوى واجهة برمجة تطبيقات Android
هناك حدّ أدنى من إصدارات "استوديو Android" وAGP يتوافق مع واجهة برمجة تطبيقات معيّنة.
المستوى. إذا كنت تستخدم إصدارات من "استوديو Android" أو AGP أقلّ من تلك التي تتطلّبها
أن يؤدي targetSdk أو compileSdk للمشروع إلى مشاكل غير متوقعة. أر
ننصحك باستخدام أحدث إصدار معاينة من "استوديو Android" وAGP للعمل على
للمشروعات التي تستهدف إصدارات المعاينة من نظام التشغيل Android. يمكنك
تثبيت
إصدارات معاينة "استوديو Android" إلى جانب إصدار ثابت.
في ما يلي الحد الأدنى لإصدارات "استوديو Android" وAGP:
| مستوى واجهة برمجة التطبيقات | الحدّ الأدنى لإصدار "استوديو Android" | الحد الأدنى لإصدار AGP |
|---|---|---|
| معاينة VanillaIceCream | قنديل بحر | 1 تشرين الأول (أكتوبر) 2023 | 8.4 |
| 34 | القنفذ | 1 تشرين الأول (أكتوبر) 2023 | 8.1.1 |
| 33 | زهري مرجاني | 1 تشرين الثاني (نوفمبر) 2022 | 7.2 |
التغييرات في الإصدارات (تشرين الثاني/نوفمبر 2020)
نعمل على تعديل ترقيم إصدارات المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) إلى تطابق بشكل وثيق أداة إنشاء Gradle الأساسية.
في ما يلي التغييرات البارزة:
سيستخدم AGP الآن الإصدارات الدلالية، وسيتم إجراء التغييرات التي قد تؤدي إلى تستهدف الإصدارات الرئيسية.
سيتم إطلاق إصدار رئيسي واحد من AGP سنويًا، بما يتوافق مع الإصدار الرئيسي لنظام Gradle.
سيكون الإصدار بعد AGP 4.2 هو الإصدار 7.0 وسيتطلب ترقية إلى الإصدار 7.x من Gradle. سيتطلب كل إصدار رئيسي من AGP عرضًا في أداة Gradle الأساسية.
سيتم إيقاف واجهات برمجة التطبيقات نهائيًا قبل عام واحد تقريبًا، توفير وظيفة الاستبدال بالتزامن. واجهات برمجة التطبيقات التي تم إيقافها نهائيًا ستتم إزالتها بعد عام واحد تقريبًا خلال الفترة الرئيسية اللاحقة تحديث.
التوافق
الحدّ الأقصى لمستوى واجهة برمجة التطبيقات 8.5 للمكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 34 من واجهة برمجة التطبيقات. في ما يلي معلومات أخرى عن التوافق:
| الحد الأدنى للإصدار | الإصدار التلقائي | ملاحظات | |
|---|---|---|---|
| قاعدة مخروطية | 8.7 | 8.7 | لمعرفة المزيد من المعلومات، يمكنك الاطّلاع على تحديث Gradle. |
| أدوات إنشاء حِزم تطوير البرامج (SDK) | 34.0.0 | 34.0.0 | تثبيت أدوات إنشاء حزمة تطوير البرامج (SDK) أو ضبطها |
| كرونة دنماركية | لا ينطبق | 26.1.10909125 | تثبيت أو ضبط إصدار مختلف من NDK. |
| JDK | 17 | 17 | لمزيد من المعلومات، راجِع إعداد إصدار JDK. |
إصدارات التصحيح
في ما يلي قائمة بإصدارات التصحيح في تطبيق Android Studio Koala الإصدار 8.5 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
Android Studio Koala | إصدارا 2024.1.1 Patch 1 وAGP 8.5.1 (تموز/يوليو 2024)
يتضمن هذا التحديث الثانوي إصلاح الأخطاء هذه.