נתוני גרסה של פלאגין Android Gradle 8.8

מאגר 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 זמין ב תוכנית הפיתוח של הפלאגין של 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. בדוגמה הבאה מוגדר הפלאגין לגרסה 8.8.0 מהקובץ build.gradle.kts:

Kotlin

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

Groovy

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

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

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

עדכון Gradle

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

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

גרסת הפלאגיןהגרסה המינימלית הנדרשת של Gradle
8.88.0
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0
7.47.5

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

גרסת הפלאגיןגרסת Gradle הנדרשת
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.45.6.4 ואילך
3.5.0 עד 3.5.45.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.32.14.1 עד 3.5
2.0.0 עד 2.1.22.10 עד 2.13
1.5.02.2.1 עד 2.13
1.2.0 עד 1.3.12.2.1 עד 2.9
1.0.0 עד 1.1.32.2.1 עד 2.3

אפשר לציין את גרסת Gradle בתפריט File‏ > Project Structure‏ > Project ב-Android Studio, או לעדכן את גרסת Gradle באמצעות שורת הפקודה. הדרך המועדפת היא להשתמש בכלי שורת הפקודה Gradle Wrapper, שמעדכן את הסקריפטים של gradlew. בדוגמה הבאה נקבע שגרסת Gradle תהיה 8.8 באמצעות Gradle Wrapper. שימו לב: צריך להריץ את הפקודה הזו פעמיים כדי לשדרג גם את Gradle וגם את Gradle Wrapper עצמו (למידע נוסף, ראו שדרוג של Gradle Wrapper). 

gradle wrapper --gradle-version 8.8

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

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

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

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

גרסת Android Studio גרסת AGP הנדרשת
השקת תכונות בגרסה Ladybug | 2.2.2024 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

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

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

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

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

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

רמת ממשק API: הגרסה המינימלית של Android Studio הגרסה המינימלית של AGP
תצוגה מקדימה של Baklava Meerkat | 2024.3.1 8.9.0
35 השקת תכונות ב-Koala | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2

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

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

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

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

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

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

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

תאימות

רמת ה-API המקסימלית שנתמכת בפלאגין Android Gradle 8.8 היא רמת API 35. מידע נוסף על תאימות:

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