הערות לגבי הגרסה של פלאגין Android Gradle‏ 8.13

מאגר JCenter הפך לקריאה בלבד ב-31 במרץ 2021. מידע נוסף זמין במאמר עדכון השירות JCenter.

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

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

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

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

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

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

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

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

Kotlin

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

Groovy

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

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

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

עדכון Gradle

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

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

גרסת הפלאגיןהגרסה המינימלית הנדרשת של Gradle
8.138.13
8.128.13
8.118.13
8.108.11.1
8.98.11.1
8.8‫8.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.1‫8.0
‫8.0‫8.0

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

גרסת הפלאגיןגרסת Gradle הנדרשת
7.47.5
7.37.4
7.2‫7.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.45.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 בתפריט File > Project Structure > Project ב-Android Studio, או לעדכן את גרסת Gradle באמצעות שורת הפקודה. הדרך המומלצת היא להשתמש בכלי שורת הפקודה Gradle Wrapper, שמעדכן את סקריפטים של gradlew. בדוגמה הבאה, הגרסה של Gradle מוגדרת ל-8.13 באמצעות Gradle Wrapper. חשוב לדעת שצריך להריץ את הפקודה הזו פעמיים כדי לשדרג גם את Gradle וגם את Gradle Wrapper עצמו (מידע נוסף זמין במאמר בנושא שדרוג Gradle Wrapper). 

gradle wrapper --gradle-version 8.13

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

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

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

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

גרסת Android Studio גרסת AGP נדרשת
‫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
השקת תכונות חדשות של Ladybug‏ | 2024.2.2 ‫3.2-8.8
Ladybug | 2024.2.1 ‫3.2-8.7
Koala Feature Drop | 2024.1.2 ‫3.2-8.6
קואלה | 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
ג'ירפה | 2022.3.1 ‫3.2-8.1
פלמינגו | 2022.2.1 ‫3.2-8.0

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

גרסת Android Studio גרסת AGP נדרשת
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 זמין בנתוני הגרסה של הפלאגין.

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

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

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

רמת ממשק API: גרסת Android Studio מינימלית גרסת AGP מינימלית
36.0 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 פלמינגו | 2022.2.1 7.2

שינויים בניהול הגרסאות (נובמבר 2020)

אנחנו מעדכנים את מספור הגרסאות של Android Gradle Plugin ‏ (AGP) כדי שיהיה דומה יותר לכלי ה-build הבסיסי של Gradle.

אלה השינויים הבולטים:

  • מעכשיו, AGP ישתמש בניהול גרסאות סמנטי, ושינויים שעלולים לשבור את התאימות יתבצעו בגרסאות ראשיות.

  • אנחנו מתכננים להוציא גרסה ראשית אחת של AGP בכל שנה, בהתאם לגרסה הראשית של Gradle.

  • הגרסה שתצא אחרי AGP 4.2 תהיה גרסה 7.0 ותדרוש שדרוג לגרסה 7.x של Gradle. כל גרסה ראשית של AGP תדרוש שדרוג של הגרסה הראשית בכלי Gradle הבסיסי.

  • הוצאה משימוש של ממשקי API תתבצע בערך שנה מראש, ותוך כדי כך תהיה זמינה פונקציונליות חלופית. ממשקי API שהוצאו משימוש יוסרו בערך שנה לאחר מכן במהלך העדכון הגדול הבא.

תאימות

רמת ה-API המקסימלית שנתמכת על ידי Android Gradle plugin 8.13 היא רמת API ‏36. מידע נוסף על תאימות:

גרסת מינימום גרסת ברירת המחדל הערות
Gradle 8.13 8.13 יש מידע נוסף במאמר בנושא עדכון Gradle.
SDK Build Tools ‫35.0.0 ‫35.0.0 התקנה או הגדרה של SDK Build Tools.
NDK לא רלוונטי 27.0.12077973 התקנה או הגדרה של גרסה אחרת של NDK.
JDK 17 17 מידע נוסף זמין במאמר בנושא הגדרת גרסת ה-JDK.

בעיות שתוקנו

פלאגין Android Gradle‏ 8.13.0

בעיות שתוקנו
‫Android Gradle Plugin
הפעלת CheckAarMetadataTask בפרויקטים של ספריות כשיוצרים AAR
התוסף Fused Library לא יכול לעבד הפניות למשאבים מספרייה חיצונית
הפלאגין Fused Library צריך לאפשר שימוש ב-overrideLibrary
שינוי ערך ברירת המחדל של targetSdk באפליקציה כך שיתבסס על compileSdk במקום על minSdk
‫`com.android.kotlin.multiplatform.library` קורס עם מכשירים בניהול Gradle
Shrinker (R8)
‫ClassCastException מכיתה בלתי אפשרית עם R8
‫ArrayIndexOutOfBoundsException: אינדקס 0 מחוץ לתחום לאורך 0 מאז גרסה 8.10.0
הניתוח של דפוסים ב-API enableExperimentalPartialShrinking הוא מאוד קפדני