מידע על פלאגין של Android Gradle

מערכת ה-build של Android Studio מבוססת על Gradle, והפלאגין של Android Gradle מוסיף כמה תכונות ספציפיות ליצירת אפליקציות ל-Android.

בדף הזה מוסבר איך לעדכן את כלי Gradle. בדף הזה מפורטות הערות המוצר של הפלאגין של Android Gradle.

במדריך לפלאגין של Android Gradle מופיע סיכום כללי של שינויי התוכנה שעלולים לגרום לכשל בפלאגין של Android Gradle.

למידע נוסף על הגדרת גרסאות build של Android באמצעות Gradle, עיינו בדפים הבאים:

מידע נוסף על מערכת ה-build של Gradle זמין במדריך למשתמש של Gradle.

עדכון הפלאגין של Android Gradle

כשמעדכנים את Android Studio, יכול להיות שתופיע בקשה לעדכן באופן אוטומטי את הפלאגין של Android Gradle לגרסה העדכנית ביותר שזמינה. אתם יכולים לאשר את העדכון או לציין גרסה באופן ידני, בהתאם לדרישות ה-build של הפרויקט.

אפשר לציין את גרסת הפלאגין בתפריט File (קובץ) > Project Structure (מבנה הפרויקט) > Project (פרויקט) ב-Android Studio, או בקובץ build.gradle.kts ברמה העליונה. גרסת הפלאגין חלה על כל המודולים שנוצרו בפרויקט הזה ב-Android Studio. בדוגמה הבאה, הפלאגין מוגדר לגרסה 9.4.0 מהקובץ build.gradle.kts:

Kotlin

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

מגניב

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

זהירות: אל תשתמשו ביחסי תלות דינמיים במספרי גרסאות, כמו 'com.android.tools.build:gradle:9.4.+'. השימוש בתכונה הזו עלול לגרום לעדכוני גרסאות לא צפויים ולקושי בפתרון הבדלים בין גרסאות.

אם גרסת הפלאגין שצוינה לא הורדה, Gradle יוריד אותה בפעם הבאה שתבנו את הפרויקט או תלחצו על File (קובץ) > Sync Project with Gradle Files (סנכרון הפרויקט עם קובצי Gradle) בסרגל התפריטים של Android Studio.

עדכון Gradle

כשמעדכנים את Android Studio, יכול להיות שתופיע בקשה לעדכן גם את Gradle לגרסה העדכנית ביותר. אתם יכולים לאשר את העדכון או לציין גרסה באופן ידני, בהתאם לדרישות ה-build של הפרויקט.

בטבלה הבאה מפורטות גרסאות Gradle שנדרשות לכל גרסה של הפלאגין של Android Gradle. כדי ליהנות מהביצועים הטובים ביותר, כדאי להשתמש בגרסה העדכנית ביותר של Gradle ושל הפלאגין.

גרסת הפלאגיןגרסת Gradle המינימלית הנדרשת
9.49.6.0
‫9.39.5.0
‫9.29.4.1
9.19.3.1
9.09.1.0
8.138.13
‫8.128.13
‫8.118.13
‫8.108.11.1
‫8.98.11.1
‫8.88.10.2
‫8.7‫8.9
‫8.6‫8.7
‫8.5‫8.7
8.4‫8.6
8.38.4
8.28.2
8.18.0
8.08.0

גרסאות ישנות יותר

גרסת הפלאגיןגרסת Gradle הנדרשת
7.47.5
7.37.4
7.27.3.3
7.17.2
7.07.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.35.1.1 ומעלה
3.3.0 - 3.3.34.10.1 ומעלה
3.2.0 - 3.2.14.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 בתפריט File > Project Structure > Project ב-Android Studio, או לעדכן את גרסת Gradle באמצעות שורת הפקודה. הדרך המועדפת היא להשתמש בכלי שורת הפקודה Gradle Wrapper, שמעדכן את הסקריפטים של gradlew. בדוגמה הבאה, גרסת Gradle מוגדרת ל-9.6.0 באמצעות Gradle Wrapper. שימו לב שצריך להריץ את הפקודה הזו פעמיים כדי לשדרג גם את Gradle וגם את Gradle Wrapper עצמו (מידע נוסף זמין במאמר שדרוג Gradle Wrapper). 

gradle wrapper --gradle-version 9.6.0

עם זאת, יכול להיות שהפעולה תיכשל במקרים מסוימים, למשל אם עדכנתם את AGP והוא כבר לא תואם לגרסה הנוכחית של Gradle. במקרה כזה, צריך לערוך את ההפניה להפצה של Gradle בקובץ gradle/wrapper/gradle-wrapper.properties. בדוגמה הבאה, גרסת Gradle מוגדרת ל-9.6.0 בקובץ gradle-wrapper.properties. 

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

תאימות בין הפלאגין של Android Gradle לבין Android Studio

מערכת ה-build של Android Studio מבוססת על Gradle, והפלאגין של Android Gradle ‏ (AGP) מוסיף כמה תכונות ספציפיות לפיתוח אפליקציות ל-Android. בטבלה הבאה מפורטות הגרסאות של AGP שנדרשות לכל גרסה של Android Studio.

גרסת Android Studio גרסת AGP נדרשת
‫Rabbit 1 ‏ | 2026.2.1 7.1-9.4
Quail 4 | 2026.1.4 7.1-9.4
‫Quail 3 ‏ | 2026.1.3 7.1-9.3
‫Quail 2 ‏ | 2026.1.2 7.1-9.3
Quail 1 | 2026.1.1 7.1-9.2
‫Panda 4‏ | 2025.3.4 7.1-9.2
‫Panda 3‏ | 2025.3.3 7.0-9.1
‫Panda 2 ‏ | 2025.3.2 7.0-9.1
‫Panda 1‏ | 2025.3.1 7.0-9.0
‫Otter 3 Feature Drop | 2025.2.3 4.2-9.0
‫Otter 2 Feature Drop | 2025.2.2 4.1-8.13
‫Otter‏ | 2025.2.1 4.0-8.13
‫Narwhal 4 Feature Drop | 2025.1.4 4.0-8.13
‫Narwhal 3 Feature Drop | 2025.1.3 4.0-8.13
‫Narwhal Feature Drop | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Meerkat Feature Drop | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3.2-8.9

גרסאות ישנות יותר

גרסת Android Studio גרסת AGP נדרשת
‫Ladybug Feature Drop‏ | 2024.2.2 3.2-8.8
‫Ladybug | ‏2024.2.1 3.2-8.7
השקת תכונות של קואלה | 2.1.2024 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

מידע נוסף על החידושים בפלאגין של Android Gradle זמין בנתוני הגרסה של הפלאגין של Android Gradle.

הגרסאות המינימליות של הכלים לרמת ה-API של Android

יש גרסאות מינימליות של Android Studio ו-AGP שתומכות ברמת API ספציפית. אם תשתמשו בגרסאות של Android Studio או AGP שהן ישנות יותר מהגרסאות שנדרשות ב-targetSdk או ב-compileSdk של הפרויקט, יכול להיות שתיתקלו בבעיות לא צפויות. מומלץ להשתמש בגרסת טרום-ההשקה (Preview) העדכנית של Android Studio ו-AGP כדי לעבוד על פרויקטים שמטרגטים גרסאות טרום-השקה של Android OS. אתם יכולים להתקין גרסאות טרום-השקה (Preview) של Android Studio לצד גרסה יציבה.

אלה הגרסאות המינימליות של Android Studio ו-AGP:

רמת ממשק API: הגרסה המינימלית של Android Studio גרסת AGP מינימלית
37.0 ‫Panda 3‏ | 2025.3.3 תיקון 1 9.1.1
36.1 ‫Narwhal 3 Feature Drop | 2025.1.3 8.13.0
36 Meerkat | 2024.3.1 Patch 1 8.9.1
35 Koala Feature Drop | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 ‫Flamingo‏ | 2022.2.1 7.2