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

מערכת ה-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.5.0 קובץ build.gradle.kts:

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

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

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

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

עדכון Gradle

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

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

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

gradle wrapper --gradle-version 8.5

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

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

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

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

מה חדש בפלאגין של 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:

שינויים בגרסאות (נובמבר 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.5 רמת ה-API היא 34. הנה מידע נוסף על תאימות:

גרסאות של תיקונים

בהמשך מופיעה רשימה של גרסאות התיקונים ב-Android Studio Koala ו-Android Gradle 8.5.

Android Studio Koala | תיקון 1 2024.1.1 ו-AGP 8.5.1 (יולי 2024)

העדכון הקטן הזה כולל תיקוני הבאגים האלה.