מערכת ה-build של Android Studio מבוססת על Gradle ועל Android Gradle ומוסיף כמה תכונות שספציפיות לבניית אפליקציות ל-Android. למרות הפלאגין Android Gradle (AGP) מתעדכן בדרך כלל בשלב הנעילה ב-Android Studio, הפלאגין (ושאר מערכת Gradle) יכולים לפעול בנפרד Android Studio ויתעדכנו בנפרד.
בדף הזה מוסבר איך לוודא שהכלים של Gradle ועל העדכונים האחרונים. לנתוני הגרסה של Android בגרסה הקודמת לגרסאות פלאגין של Gradle: נתוני גרסה קודמים.
כדי לראות מה תוקן בגרסה הזו של הפלאגין Android Gradle, אפשר לעיין בקטע הבעיות שנסגרו.
לסיכום כללי של שינויי תוכנה שעלולים לגרום לכשל ב-Android Gradle פלאגין, ראו Android מפת הדרכים של הפלאגין של Gradle
לפרטים על אופן ההגדרה של גרסאות ה-build של Android עם Gradle, תראו את הדפים הבאים:
- הגדרת ה-build
- חומר עזר בנושא DSL של הפלאגין ל-Android Gradle
- חומר עזר של Gradle DSL
- מדריך למשתמש בנושא ביצועי Gradle
למידע נוסף על מערכת ה-build של Gradle, אפשר לעיין ב מדריך למשתמש של Gradle.
עדכון הפלאגין של Android Gradle
כשאתם מעדכנים את Android Studio, יכול להיות שתתבקשו לבצע אוטומטית לעדכן את הפלאגין של Android Gradle לגרסה האחרונה. שלך לבחור אם לקבל את העדכון או לציין באופן ידני גרסה בהתאם לדרישות ה-build של הפרויקט שלכם.
ניתן לציין את גרסת הפלאגין בכתובת
באחת מהאפשרויות הבאות: File > פרויקט
מבנה > התפריט פרויקט ב-Android Studio, או
את הקובץ build.gradle.kts
ברמה העליונה. גרסת הפלאגין חלה על
את כל המודולים המובנים באותו פרויקט של Android Studio. הדוגמאות הבאות מגדירות
את הפלאגין לגרסה 8.6.0
קובץ build.gradle.kts
:
Kotlin
plugins { id("com.android.application") version "8.6.0" apply false id("com.android.library") version "8.6.0" apply false id("org.jetbrains.kotlin.android") version "2.0.20" apply false }
מגניב
plugins { id 'com.android.application' version '8.6.0' apply false id 'com.android.library' version '8.6.0' apply false id 'org.jetbrains.kotlin.android' version '2.0.20' apply false }
זהירות: לא משתמשים בגרסה של יחסי תלות דינמיים
מספרים, כמו
'com.android.tools.build:gradle:8.6.+'
.
השימוש בתכונה הזו עלול לגרום לקושי ועדכונים לא צפויים בגרסאות
פתרון הבדלים בין גרסאות.
אם גרסת הפלאגין שצוינה לא הורדה, Gradle תוריד אותה בפעם הבאה שתיצרו את הפרויקט שלכם או לחצו על קובץ > סנכרון הפרויקט עם קובצי Gradle מסרגל התפריטים ב-Android Studio.
עדכון Gradle
כשאתם מעדכנים את Android Studio, יכול להיות שתתבקשו גם לבצע לעדכן את Gradle לגרסה האחרונה שזמינה. אפשר לבחור לקבל את מעדכנים או מציינים באופן ידני גרסה על סמך גרסת ה-build של הפרויקט בדרישות שלנו.
בטבלה הבאה מפורטות הגרסה של Gradle שנדרשת לכל אחת מהן של הפלאגין Android Gradle. כדי לקבל את הביצועים הטובים ביותר, להשתמש בגרסה העדכנית ביותר האפשרית של Gradle וגם של הפלאגין.
גרסת פלאגין | הגרסה המינימלית הנדרשת של Gradle |
---|---|
8.5 | 8.7 |
8.4 | 8.6 |
8.3 | 8.4 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7.4 | 7.5 |
גרסאות ישנות יותר
גרסת פלאגין | הגרסה הנדרשת של Gradle |
---|---|
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 בקטע File >
מבנה הפרויקט > התפריט פרויקט ב-Android Studio,
או לעדכן את גרסת Gradle באמצעות שורת הפקודה.
הדרך המועדפת היא להשתמש
Gradle Wrapper
כלי שורת הפקודה, שמעדכן את הסקריפטים gradlew
. הבאים
בדוגמה הזו מוגדרת הגרסה של Gradle ל-8.6 באמצעות Gradle Wrapper.
הערה: צריך להריץ את הפקודה הזו פעמיים כדי לשדרג את Gradle וגם
Gradle Wrapper עצמו (למידע נוסף, אפשר לעיין במאמר בנושא
שדרוג של Gradle Wrapper).
gradle wrapper --gradle-version 8.6
עם זאת, במקרים מסוימים הדבר עשוי להיכשל, למשל אם עדכנת לאחרונה את AGP
וכבר לא תואמות לגרסה הנוכחית של Gradle. במקרה הזה,
צריך לערוך את הפניית ההתפלגות של Gradle
קובץ gradle/wrapper/gradle-wrapper.properties
. הבאים
מגדירה את הגרסה של Gradle כ-8.6
קובץ gradle-wrapper.properties
.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-bin.zip
...
גרדל Android יישומי פלאגין ותאימות ל-Android Studio
מערכת ה-build של Android Studio מבוססת על Gradle ועל Android Gradle יישומי פלאגין (AGP) מוסיפים כמה תכונות שספציפיות לפיתוח אפליקציות ל-Android. הטבלה הבאה מפרטת איזו גרסה של AGP נדרשת לכל גרסה של ב-Android Studio.
גרסת Android Studio | גרסת AGP נדרשת |
---|---|
פרת משה רבנו | 1.2.2024 | 3.2-8.7 |
השקת תכונות קואלה | 2.1.2024 | 3.2-8.6 |
קואלה | 1.1.2024 | 3.2-8.5 |
מדוזה | 1.3.2023 | 3.2-8.4 |
איגואנה | 1.2.2023 | 3.2-8.3 |
קיפוד | 1.1.2023 | 3.2-8.2 |
ג'ירפה | 1.3.2022 | 3.2-8.1 |
פלמינגו | 1.2.2022 | 3.2-8.0 |
גרסאות ישנות יותר
גרסת Android Studio | גרסת AGP נדרשת |
---|---|
צלוץ חשמלי | 1.1.2022 | 3.2-7.4 |
דולפין | 1.3.2021 | 3.2-7.3 |
סנאי | 1.2.2021 | 3.2-7.2 |
דבורה | 1.1.2021 | 3.2-7.1 |
שועל השלג | 1.3.2020 | 3.1-7.0 |
מה חדש בפלאגין של Android Gradle? נתוני הגרסה של הפלאגין ל-Android Gradle
מספר גרסאות מינימלי של כלים לרמת API של Android
קיימות גרסאות מינימליות של Android Studio ו-AGP שתומכות ב-API ספציפי
ברמה. שימוש בגרסאות נמוכות יותר של Android Studio או של AGP מהנדרש
targetSdk
או compileSdk
של הפרויקט עלולים להוביל לבעיות בלתי צפויות. רביעי
מומלץ להשתמש בגרסת טרום-השקה (Preview) עדכנית של Android Studio ו-AGP כדי לעבוד
פרויקטים שמתמקדים בגרסאות תצוגה מקדימה של מערכת ההפעלה Android. אפשר
להתקין
גרסאות טרום-השקה (Preview) של Android Studio לצד גרסה יציבה.
אלה הגרסאות המינימליות של Android Studio ו-AGP:
רמת ממשק API: | הגרסה המינימלית של Android Studio | גרסת AGP מינימלית |
---|---|---|
תצוגה מקדימה של VanillaIceCream | מדוזה | 1.3.2023 | 8.4 |
34 | קיפוד | 1.1.2023 | 8.1.1 |
33 | פלמינגו | 1.2.2022 | 7.2 |
שינויים בגרסאות (נובמבר 2020)
אנחנו מעדכנים את מספור הגרסאות של הפלאגין Android Gradle (AGP) מאוד מתאימים לכלי ה-build של Gradle.
הנה השינויים הבולטים:
ב-AGP ייעשה עכשיו שימוש בניהול גרסאות סמנטיות, ושינויי תוכנה שעלולים לגרום לכשל מטורגטים לגרסאות ראשיות.
תושק גרסה ראשית אחת של AGP בכל שנה, בהתאמה את הגרסה הראשית של Gradle.
המהדורה שאחרי AGP 4.2 תהיה גרסה 7.0 ותדרוש שדרוג לגרסה 7.x של Gradle. לכל גרסה ראשית של AGP נדרשת לשדרג בכלי הבסיסי של Gradle.
ממשקי ה-API יצאו משימוש כשנה מראש, כאשר פונקציונליות חלופית זמינה בו-זמנית. ממשקי API שהוצאו משימוש תוסר כשנה לאחר מכן במהלך
תאימות
רמת ה-API המקסימלית שבה תומך הפלאגין Android Gradle בגרסה 8.6, היא רמת API 34. הנה מידע נוסף על תאימות: