פלאגין של Android Gradle‏ ‎9.2.0 (אפריל 2026)

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

תאימות

רמת ה-API המקסימלית שנתמכת בפלאגין של Android Gradle 9.2 היא 37.0. מידע נוסף על תאימות:

גרסת המינימום גרסת ברירת המחדל הערות
Gradle 9.4.1 9.4.1 יש מידע נוסף במאמר בנושא עדכון Gradle.
SDK Build Tools 36.0.0 36.0.0 צריך להתקין או להגדיר את SDK Build Tools.
NDK לא רלוונטי 28.2.13676358 צריך להתקין או להגדיר גרסה אחרת של NDK.
JDK 17 17 מידע נוסף זמין במאמר בנושא הגדרת גרסת ה-JDK.

דוחות בדיקה וכיסוי מאוחדים

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

שינויים בגרסה R8

השינויים הבאים ב-R8 כלולים ב-AGP 9.2.0.

סמנטיקה מחמירה יותר של -keepattributes לשמירה על הערות בלתי נראות בזמן ריצה

אי אפשר לקרוא בזמן ריצה הערות בלתי נראות בזמן ריצה. לכן,‏ D8 מסיר ללא תנאי הערות בלתי נראות בזמן ריצה, ואין אפשרות לשנות את זה.

כדי להבטיח תאימות ל-ProGuard, ‏ R8 תומכת בפלט של הערות לא גלויות בזמן ריצה. אבל כשמבצעים קומפילציה ל-DEX, בדרך כלל לא צריך לשמור הערות שאינן גלויות בזמן הריצה. עם זאת, נהוג לכלול את הכלל הנוח -keepattributes *Annotation* (ישירות או בעקיפין מכללי שמירה של צרכנים) כדי ש-R8 ישמור הערות שניתן לראות בזמן הריצה. לצערנו, הפעולה הזו גם גורמת לכך שההערות בזמן הריצה לא יהיו גלויות.

כדי לפתור את הבעיה הזו ולשפר את ההתאמה להתנהגות של D8, דפוסי -keepattributes עם תווים כלליים לחיפוש כבר לא תואמים ל-RuntimeInvisibleAnnotations,‏ RuntimeInvisibleParameterAnnotations ו-RuntimeInvisibleTypeAnnotations. לכן, הערות בלתי נראות בזמן ריצה יישמרו רק אם שם המאפיין מוזכר באופן מפורש ללא תווים כלליים.

אף אחד מהכללים הבאים לא ישמור עכשיו הערות בלתי נראות בזמן ריצה:

-keepattributes *
-keepattributes *Annotation*
-keepattributes *Invisible*

כדי לשמור על הערות בלתי נראות בזמן הריצה, משתמשים בכלל הבא:

-keepattributes RuntimeInvisibleAnnotations,
                RuntimeInvisibleParameterAnnotations,
                RuntimeInvisibleTypeAnnotations

תמיכה בשמות מוכחשים בכללי חברים

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

לדוגמה, כדי להתאים את כל השיטות שלא מסתיימות ב-'ForTesting', משתמשים בכלל הבא:

-keepclassmembers class com.example.MyClass {
  *** !*ForTesting(...);
}

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

בעיות שתוקנו

פלאגין של Android Gradle 9.2.1

בעיות שתוקנו
Android Gradle Plugin
‪java.lang.ClassNotFoundException: Didn't find class "com.android.tools.r8.RecordTag" after upgrading gradle to 9.2.0

פלאגין של Android Gradle 9.2.0

בעיות שתוקנו
Android Gradle Plugin
הצגת אזהרה למשתמשים אם יש להם commonTest אבל הם שכחו להשתמש ב-withHostTestBuilder
‫[fused lib - public] OkHttp includes sources
אי אפשר להריץ androidDeviceTest עם placeholders של מניפסט בספרייה (AGP 9.0.0 עם התוסף com.android.kotlin.multiplatform.library)
‫AGP צריך להציג אזהרה אם למשתמש יש src/androidDeviceTest/java עם java מושבת
‫AGP 9.0 No androidComponents.onVariant equivalent for applicationVariants.all.mergeAssetsProvider
קבצים מסוג `‎*.xml.flat` מכילים נתיבי קבצים מוחלטים
‫R8D8ThreadPoolBuildService לא רשום
כשל ב-JdkImageTransform עם JDK 26
קידוד אוטומטי של minAgpVersion במטא-נתונים של AAR ב-AGP 10.0
שינוי השם של קובץ APK באמצעות AGP DSL חדש
שגיאה בגישה (אבל לא בהערכה) של bootClasspath IllegalStateException: targetCompatibility is not yet finalized
ה-sourceset של keepRules לא פועל בספריות
הטמעת הצהרת תאימות ל-CC ב-AGP
עדכון התלות של פלאגין Kotlin Gradle לגרסה 2.3.10
הגדרה של compileSdk גבוה יותר לבדיקות מאשר ל-main
Lint
הפעלת Lint לשגיאת הקלדה בהודעה
חלון הקשר נחתך בדוחות Lint SARIF בגלל מצביע אופסט תקוע ב-`SarifReporter.kt`
חסרה ללקוח Lint Gradle תכונה קריטית, ולכן הוא לא אמין במקרה הטוב
שגיאת Lint כשכיווץ מקורות המידע מושבת
‫AGP 9 Lint מדווח על WrongConstant כשמשתמשים בקבועים מקוננים של IntDef
שגיאת Lint כשכיווץ מקורות המידע מושבת
שילוב Lint
‫Android Lint נכשל בבדיקות Lint בהתאמה אישית שעברו קומפילציה ל-Java 21 bytecode
משימות Lint Gradle מתעלמות מהדגל ‎--quiet
Shrinker (R8)
נראה שהטירגוט של Java 11 גורם לבעיות ב-d8