פלאגין של Android Gradle 3.3.0 (ינואר 2019)

הגרסה הזו של הפלאגין של Android דורשת את הדברים הבאים:

גרסת המינימום גרסת ברירת המחדל הערות
Gradle 4.10.1 4.10.1 מידע נוסף זמין במאמר בנושא עדכון Gradle. כשמשתמשים ב-Gradle מגרסה 5.0 ואילך, גודל ברירת המחדל של ה-heap בזיכרון של ה-daemon של Gradle יורד מ-1GB ל-512MB. זה עלול לגרום לרגרסיה בביצועי ה-build. כדי לשנות את הגדרת ברירת המחדל הזו, צריך לציין את גודל ה-heap של ה-daemon של Gradle בקובץ gradle.properties של הפרויקט.
SDK Build Tools 28.0.3 28.0.3 התקנה או הגדרה של SDK Build Tools.

‫3.3.3 (יולי 2020)

העדכון הקטן הזה תומך בתאימות עם הגדרות ברירת מחדל ותכונות חדשות של הרשאות גישה לחבילה ב-Android 11.

פרטים נוספים זמינים בנתוני הגרסה של 4.0.1.

‫3.3.2 (מרץ 2019)

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

‫3.3.1 (פברואר 2019)

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

תכונות חדשות

  • סנכרון משופר של classpath: כשפותרים יחסי תלות ב-classpath של זמן הריצה ושל זמן הקימפול, הפלאגין של Android Gradle מנסה לתקן התנגשויות מסוימות בגרסאות של יחסי תלות שמופיעים בכמה classpath.

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

    עם זאת, אם ה-classpath של זמן הריצה כולל את גרסה 1.0 של ספרייה א' וה-classpath של ההידור כולל את גרסה 2.0 של ספרייה א', הפלאגין לא משדרג לאחור את התלות ב-classpath של ההידור לגרסה 1.0 של ספרייה א', ותופיע שגיאה. מידע נוסף זמין במאמר פתרון התנגשויות בין נתיבי classpath.

  • הידור מצטבר משופר של Java כשמשתמשים במעבדי אנוטציות: העדכון הזה מקצר את זמן ה-build על ידי שיפור התמיכה בהידור מצטבר של Java כשמשתמשים במעבדי אנוטציות.

    הערה: התכונה הזו תואמת ל-Gradle מגרסה 4.10.1 ואילך, חוץ מ-Gradle מגרסה 5.1 בגלל בעיה 8194 ב-Gradle.

    • בפרויקטים שמשתמשים ב-Kapt (רוב הפרויקטים שכוללים רק Kotlin ופרויקטים היברידיים של Kotlin-Java): הידור מצטבר של Java מופעל, גם כשמשתמשים בקישור נתונים או בפלאגין retro-lambda. עיבוד ההערות על ידי המשימה Kapt עדיין לא מצטבר.

    • בפרויקטים שלא משתמשים ב-Kapt (פרויקטים ב-Java בלבד): אם כל מעבדי האנוטציות שבהם אתם משתמשים תומכים בעיבוד אנוטציות מצטבר, הידור מצטבר של Java מופעל כברירת מחדל. כדי לעקוב אחרי ההטמעה של מעבד אנוטציות (Annotation processor) מצטבר, אפשר לעיין בבעיה 5277 ב-Gradle.

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

      android.enableSeparateAnnotationProcessing=true
                  

      כשמוסיפים את הדגל הזה, הפלאגין של Android Gradle מריץ את מעבדי האנוטציות (Annotation processor) במשימה נפרדת ומאפשר למשימת הקימפול של Java לפעול באופן מצטבר.

  • מידע משופר על תוצאות ניפוי הבאגים כשמשתמשים ב-API מיושן: כשהפלאגין מזהה שאתם משתמשים ב-API שכבר לא נתמך, הוא יכול עכשיו לספק מידע מפורט יותר שיעזור לכם לקבוע איפה נעשה שימוש ב-API הזה. כדי לראות את המידע הנוסף, צריך לכלול את הפרטים הבאים בקובץ gradle.properties של הפרויקט:

              android.debug.obsoleteApi=true
            

    אפשר גם להפעיל את הדגל על ידי העברת -Pandroid.debug.obsoleteApi=true משורת הפקודה.

  • אפשר להריץ בדיקות אינסטרומנטציה במודולים של תכונות משורת הפקודה.

שינויים בהתנהגות

  • הגדרת משימות עצלה: הפלאגין משתמש עכשיו ב-API החדש ליצירת משימות של Gradle כדי להימנע מהפעלה ומהגדרה של משימות שלא נדרשות להשלמת ה-build הנוכחי (או משימות שלא נמצאות בתרשים המשימות לביצוע). לדוגמה, אם יש לכם כמה וריאנטים של build, כמו "release" ו-"debug", ואתם יוצרים את גרסת ה-"debug" של האפליקציה, הפלאגין לא יאתחל ולא יגדיר משימות לגרסת ה-"release" של האפליקציה.

    קריאה ל-methods ישנות מסוימות ב-Variants API, כמו variant.getJavaCompile(), עדיין עשויה לאלץ הגדרת משימה. כדי לוודא שה-build עבר אופטימיזציה להגדרת משימות עצלה, צריך להפעיל שיטות חדשות שמחזירות אובייקט TaskProvider, כמו variant.getJavaCompileProvider().

    אם אתם מריצים משימות build בהתאמה אישית, כדאי לקרוא איך להתאים אותן ל-API החדש של Gradle ליצירת משימות.

  • בסוג build נתון, כשמגדירים את useProguard false, הפלאגין משתמש עכשיו ב-R8 במקום ב-ProGuard כדי לכווץ ולהסתיר את הקוד והמשאבים של האפליקציה. מידע נוסף על R8 זמין בפוסט הזה בבלוג למפתחי Android.

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

  • כשיוצרים קובץ Android App Bundle, קובצי ה-APK שנוצרים מאותו קובץ App Bundle ומטרגטים ל-Android 6.0 (רמת API‏ 23) ומעלה כוללים עכשיו גרסאות לא דחוסות של ספריות ה-Native כברירת מחדל. האופטימיזציה הזו מונעת את הצורך של המכשיר ליצור עותק של הספרייה, וכך מקטינה את גודל האפליקציה בדיסק. אם אתם מעדיפים להשבית את האופטימיזציה הזו, הוסיפו את הקוד הבא לקובץ gradle.properties:

    android.bundle.enableUncompressedNativeLibs = false
            
  • הפלאגין אוכף גרסאות מינימליות של פלאגינים מסוימים של צד שלישי.

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

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

    כדי להפעיל את האופטימיזציה הזו באופן ידני, לוחצים על File > Settings > Experimental > Gradle (Android Studio > Preferences > Experimental > Gradle ב-Mac) ובוחרים את תיבת הסימון Only sync the active variant.

    הערה: האופטימיזציה הזו תומכת באופן מלא בפרויקטים שכוללים את השפות Java ו-++C, ויש לה תמיכה מסוימת ב-Kotlin. כשמפעילים את האופטימיזציה לפרויקטים עם תוכן Kotlin, הסנכרון של Gradle חוזר להשתמש בגרסאות מלאות באופן פנימי.

  • הורדה אוטומטית של חבילות SDK חסרות: הפונקציונליות הזו הורחבה כדי לתמוך ב-NDK. מידע נוסף זמין במאמר הורדה אוטומטית של חבילות חסרות באמצעות Gradle.

תיקוני באגים

  • בגרסה 3.3.0 של הפלאגין של Android Gradle תוקנו הבעיות הבאות:

    • תהליך ה-build קורא ל-android.support.v8.renderscript.RenderScript במקום לגרסת AndroidX, למרות ש-Jetifier מופעל
    • התנגשויות בגלל androidx-rs.jar, כולל annotation.AnyRes שנכלל באופן סטטי
    • כשמשתמשים ב-RenderScript, לא צריך יותר להגדיר ידנית את גרסת כלי ה-build בקובצי build.gradle