يستند نظام التصميم في "استوديو Android" إلى Gradle، ويضيف المكوّن الإضافي لنظام Gradle المتوافق مع Android العديد من الميزات الخاصة بإنشاء تطبيقات Android.
توضّح هذه الصفحة كيفية إبقاء أدوات Gradle محدَّثة. للاطّلاع على ملاحظات الإصدار الخاصة بالمكوّن الإضافي لنظام Gradle المتوافق مع Android، يُرجى الانتقال إلى صفحة ملاحظات الإصدار.
للحصول على ملخّص عام للتغييرات غير المتوافقة القادمة في المكوّن الإضافي لنظام Gradle المتوافق مع Android، اطّلِع على خارطة طريق المكوّن الإضافي لنظام Gradle المتوافق مع Android.
للحصول على تفاصيل حول كيفية ضبط إصدارات Android باستخدام Gradle، راجِع الصفحات التالية:
- ضبط الإصدار
- مرجع لغة DSL الخاصة بالمكوّن الإضافي لنظام Gradle المتوافق مع Android
- مرجع Gradle DSL
- دليل المستخدم حول أداء Gradle
لمزيد من المعلومات حول نظام التصميم المستند إلى Gradle، راجِع دليل مستخدم Gradle.
تحديث "المكوّن الإضافي لنظام Gradle المتوافق مع Android"
عند تحديث "استوديو Android"، قد تتلقّى طلبًا بتحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android تلقائيًا إلى أحدث إصدار متاح. يمكنك اختيار قبول التحديث أو تحديد إصدار يدويًا استنادًا إلى متطلبات الإصدار في مشروعك.
يمكنك تحديد إصدار المكوّن الإضافي في القائمة ملف > بنية المشروع > المشروع في "استوديو Android"، أو في ملف build.gradle.kts ذي المستوى الأعلى. ينطبق إصدار المكوّن الإضافي على جميع الوحدات التي تم إنشاؤها في مشروع "استوديو Android" هذا. يضبط المثال التالي الإصدار 9.0 من المكوّن الإضافي من الملف build.gradle.kts:
Kotlin
plugins { id("com.android.application") version "9.0" apply false id("com.android.library") version "9.0" apply false id("org.jetbrains.kotlin.android") version "2.2.21" apply false }
Groovy
plugins { id 'com.android.application' version '9.0' apply false id 'com.android.library' version '9.0' apply false id 'org.jetbrains.kotlin.android' version '2.2.21' apply false }
تنبيه: يجب عدم استخدام الاعتمادية الديناميكية في أرقام الإصدارات، مثل 'com.android.tools.build:gradle:9.+'.
قد يؤدي استخدام هذه الميزة إلى حدوث تحديثات غير متوقّعة للإصدارات وصعوبة في حلّ الاختلافات بين الإصدارات.
إذا لم يتم تنزيل إصدار المكوّن الإضافي المحدّد، سيقوم Gradle بتنزيله في المرة التالية التي تنشئ فيها مشروعك أو تنقر على ملف > مزامنة المشروع مع ملفات Gradle من شريط قائمة "استوديو Android".
تحديث Gradle
عند تحديث "استوديو Android"، قد تتلقّى طلبًا بتحديث Gradle أيضًا إلى أحدث إصدار متاح. يمكنك قبول التحديث أو تحديد إصدار يدويًا استنادًا إلى متطلبات الإصدار في مشروعك.
يسرد الجدول التالي إصدار Gradle المطلوب لكل إصدار من المكوّن الإضافي لنظام Gradle المتوافق مع Android. للحصول على أفضل أداء، عليك استخدام أحدث إصدار ممكن من كل من Gradle والمكوّن الإضافي.
| إصدار المكوّن الإضافي | الحد الأدنى لإصدار Gradle المطلوب |
|---|---|
| 9.0 | 9.1.0 |
| 8.13 | 8.13 |
| 8.12 | 8.13 |
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
إصدارات سابقة
| إصدار المكوّن الإضافي | إصدار Gradle المطلوب |
|---|---|
| 7.4 | 7.5 |
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 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 باستخدام سطر الأوامر.
الطريقة المفضّلة هي استخدام أداة سطر الأوامر
Gradle Wrapper،
التي تعدّل النصوص البرمجية gradlew. يضبط المثال التالي إصدار Gradle على 9.1.0 باستخدام أداة Gradle Wrapper.
يُرجى العِلم أنّه عليك تنفيذ هذا الأمر مرّتين لترقية كل من Gradle وGradle Wrapper (لمزيد من المعلومات، اطّلِع على ترقية Gradle Wrapper).
gradle wrapper --gradle-version 9.1.0
ومع ذلك، قد يتعذّر ذلك في بعض الحالات، مثلاً إذا كنت قد حدّثت إصدارًا أقدم من AGP
ولم يعُد متوافقًا مع إصدار Gradle الحالي. في هذه الحالة، عليك تعديل مرجع توزيع Gradle في ملف gradle/wrapper/gradle-wrapper.properties. يضبط المثال التالي إصدار Gradle على 9.1.0 في الملف gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
...
توافق "استوديو Android" و"المكوّن الإضافي لنظام Gradle المتوافق مع Android"
يستند نظام الإنشاء في "استوديو Android" إلى Gradle، ويضيف المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) العديد من الميزات الخاصة بإنشاء تطبيقات Android. يوضّح الجدول التالي إصدار AGP المطلوب لكل إصدار من "استوديو Android".
| إصدار "استوديو Android" | إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" المطلوب |
|---|---|
| تحديث Otter 3 | 2025.2.3 | 4.0-9.0 |
| تحديث الإصدار 2 من Otter (Otter 2 Feature Drop) | 2025.2.2 | 4.0-8.13 |
| تحديث Otter | 2025.2.1 | 4.0-8.13 |
| تحديث Narwhal 4 | 2025.1.4 | 4.0-8.13 |
| تحديث Narwhal 3 | 2025.1.3 | 4.0-8.13 |
| تحديث Narwhal | 2025.1.2 | 4.0-8.12 |
| Narwhal | 2025.1.1 | 3.2-8.11 |
| تحديث Meerkat | 2024.3.2 | 3.2-8.10 |
| Meerkat | 2024.3.1 | 3.2-8.9 |
إصدارات سابقة
| إصدار "استوديو Android" | إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" المطلوب |
|---|---|
| تحديث Ladybug | 2024.2.2 | 3.2-8.8 |
| Ladybug | 2024.2.1 | 3.2-8.7 |
| تحديث Koala | 2024.1.2 | 3.2-8.6 |
| Koala | 2024.1.1 | 3.2-8.5 |
| Jellyfish | 2023.3.1 | 3.2-8.4 |
| Iguana | 2023.2.1 | 3.2-8.3 |
| Hedgehog | 2023.1.1 | 3.2-8.2 |
| Giraffe | 2022.3.1 | 3.2-8.1 |
| Flamingo | 2022.2.1 | 3.2-8.0 |
| تحديث Electric Eel | 2022.1.1 | 3.2-7.4 |
| Dolphin | 2021.3.1 | 3.2-7.3 |
| Chipmunk | 2021.2.1 | 3.2-7.2 |
| Bumblebee | 2021.1.1 | 3.2-7.1 |
| Arctic Fox | 2020.3.1 | 3.1-7.0 |
للحصول على معلومات حول الميزات الجديدة في "المكوّن الإضافي لنظام Gradle المتوافق مع Android"، راجِع ملاحظات إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android".
الإصدارات الدنيا من الأدوات لمستوى واجهة برمجة تطبيقات Android
تتوفّر إصدارات دنيا من "استوديو Android" و"المكوّن الإضافي لنظام Gradle المتوافق مع Android" تتوافق مع مستوى معيّن من واجهة برمجة التطبيقات. قد يؤدي استخدام إصدارات من "استوديو Android" أو "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (AGP) أقدم من الإصدارات المطلوبة في targetSdk أو compileSdk لمشروعك إلى حدوث مشاكل غير متوقّعة. ننصحك باستخدام أحدث إصدار مبكر حصري من "استوديو Android" وAGP للعمل على المشاريع التي تستهدف إصدارات مبكرة حصرية من نظام التشغيل Android. يمكنك
تثبيت
إصدارات مبكرة حصرية من "استوديو Android" إلى جانب إصدار ثابت.
في ما يلي الإصدارات الدنيا من "استوديو Android" وAGP:
| مستوى واجهة برمجة التطبيقات | أدنى إصدار من "استوديو Android" | أدنى إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" |
|---|---|---|
| 36.1 | تحديث Narwhal 3 | 2025.1.3 | 8.13.0 |
| 36.0 | Meerkat | 2024.3.1 Patch 1 | 8.9.1 |
| 35 | تحديث Koala | 2024.2.1 | 8.6.0 |
| 34 | Hedgehog | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |