פלאגין 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 ברמת המודול, ולא בקובץ המניפסט. אפשר להתחיל להשתמש במאפיין namespace DSL החל מ-AGP 7.3. מידע נוסף זמין במאמר בנושא הגדרת מרחב שמות.

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

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

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

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

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

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

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

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

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

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

אין תמיכה בהקצאת מאפיינים עצלים ב-Kotlin

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

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

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

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

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

כדי להשתמש בפלאגין ההגדרות, צריך להחיל את הפלאגין בקובץ 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

נדרשת JDK 17 כדי להריץ AGP 8.0

כשמשתמשים בפלאגין של 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 plugin 8.0.1

פלאגין של Android Gradle 8.0.0