פלאגין Android Gradle 8.0.0 (אפריל 2023)

‫פלאגין של Android Gradle 8.0.0 הוא גרסה מרכזית שכוללת מגוון של תכונות ושיפורים חדשים.

תאימות

גרסאות תיקון

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

פלאגין של Android Gradle גרסה 8.0.2 (מאי 2023)

רשימת הבאגים שתוקנו ב-AGP 8.0.2 מופיעה בקטע הבעיות שנסגרו ב-Android Studio 2022.2.1.

פלאגין של Android Gradle גרסה 8.0.1 (מאי 2023)

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

שינוי תוכנה שעלול לגרום לכשל: נדרש מרחב שמות בסקריפט ה-build ברמת המודול

צריך להגדיר את מרחב השמות בקובץ build.gradle.kts ברמת המודול, ולא בקובץ המניפסט. אתם יכולים להתחיל להשתמש במאפיין DSL של namespace החל מ-AGP 7.3. מידע נוסף זמין במאמר הגדרת מרחב שמות.

כשעוברים למרחב השמות DSL, חשוב לשים לב לבעיות הבאות:

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

מידע נוסף זמין בתגובה מספר 19 בבעיה מספר 191813691.

שינויים בתוכנה שעלולים לגרום לכשלים: ערכי ברירת המחדל של אפשרויות ה-build

החל מגרסה 8.0 של AGP, ערכי ברירת המחדל של הדגלים האלה השתנו כדי לשפר את ביצועי ה-build. כדי לקבל עזרה בהתאמת הקוד לתמיכה בחלק מהשינויים האלה, אפשר להשתמש ב-AGP Upgrade Assistant (Tools > AGP Upgrade Assistant). הכלי Upgrade Assistant ידריך אתכם איך לעדכן את הקוד כדי להתאים אותו להתנהגות החדשה, או איך להגדיר דגלים כדי לשמור על ההתנהגות הקודמת.

שינויים בתוכנה שעלולים לגרום לכשלים: ערכים של אפשרויות build שנאכפים

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

דגל יציב חדש לפרופיל הביצוע

‫AGP כולל את הדגל החדש android.settings.executionProfile. משתמשים בדגל הזה כדי לשנות את פרופיל הביצוע שמוגדר כברירת מחדל ב-SettingsExtension. מידע נוסף זמין במאמרי העזרה בנושא פלאגין ההגדרות.

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

אין תמיכה בהקצאת מאפיינים מסוג lazy ב-Kotlin

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

קטגוריות של משימות ב-Build Analyzer

החל מגרסת Android Studio Flamingo, ל-Build Analyzer יש תצוגת ברירת מחדל חדשה למשימות שמשפיעות על משך ה-build. אם הפרויקט שלכם משתמש ב-AGP בגרסה 8.0 ומעלה, במקום להציג משימות בנפרד, Build Analyzer מקבץ אותן לפי קטגוריה. לדוגמה, משימות שספציפיות למשאבי Android, ל-Kotlin או ל-Dexing מקובצות יחד ואז ממוינות לפי משך ה-build. כך תוכלו לזהות איזו קטגוריה משפיעה הכי הרבה על זמן ה-build. כשמרחיבים כל קטגוריה, מוצגת רשימה של המשימות שקשורות אליה. כדי להציג משימות בנפרד, בלי קיבוץ, משתמשים בתפריט הנפתח קיבוץ לפי.

פלאגין חדש להגדרות

ב-AGP 8.0.0-alpha09 יש פלאגין הגדרות חדש. הפלאגין של ההגדרות מאפשר לרכז את ההגדרות הגלובליות (הגדרות שחלות על כל המודולים) במקום אחד, כדי שלא תצטרכו להעתיק ולהדביק את ההגדרות בכמה מודולים. בנוסף, אתם יכולים להשתמש בפלאגין ההגדרות כדי ליצור פרופילי הפעלה של כלים, או הוראות שונות להפעלת כלי, ולעבור ביניהם.

כדי להשתמש בפלאגין ההגדרות, צריך להחיל את הפלאגין בקובץ settings.gradle:

apply plugin 'com.android.settings'

ריכוז ההגדרות הגלובליות

כדי להגדיר הגדרות גלובליות, משתמשים בבלוק החדש android בקובץ settings.gradle. הנה דוגמה:

android {
  compileSdk 31
  minSdk 28
  ...
}

פרופילים של הרצת כלים

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

יוצרים פרופילי הפעלה ומגדירים את פרופיל ההפעלה שמוגדר כברירת מחדל בקובץ settings.gradle, כמו בדוגמה הבאה:

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

כדי לשנות את פרופיל ברירת המחדל, בוחרים פרופיל אחר באמצעות המאפיין android.experimental.settings.executionProfile בקובץ gradle.properties:

android.experimental.settings.executionProfile=high

אפשר גם להגדיר את המאפיין הזה באמצעות שורת הפקודה, שמאפשרת להגדיר תהליכי עבודה שונים. לדוגמה, אם יש לכם תהליך עבודה של אינטגרציה רציפה (CI), אתם יכולים להשתמש בשורת הפקודה כדי לשנות את פרופיל ההפעלה בלי לשנות את הקובץ settings.gradle:

./gradlew assembleRelease \
-Pandroid.experimental.settings.executionProfile=ci

כדי להפעיל את AGP 8.0 נדרש JDK 17

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

אם אתם צריכים להגדיר ידנית את גרסת ה-JDK שבה AGP משתמש ב-Android Studio, אתם צריכים להשתמש ב-JDK 17 ואילך.

כשמשתמשים ב-AGP בלי קשר ל-Android Studio, משדרגים את גרסת ה-JDK על ידי הגדרת משתנה הסביבה JAVA_HOME או האפשרות של שורת הפקודה -Dorg.gradle.java.home לספריית ההתקנה של JDK 17.

בעיות שתוקנו

פלאגין של Android Gradle‏ ‎8.0.2

פלאגין של Android Gradle‏ ‎8.0.1

פלאגין של Android Gradle‏ 8.0.0