הערות מוצר של גרסת Preview של הפלאגין Android Gradle

בדף הזה מפורטות הערות על גרסאות טרום-השקה של Android Gradle Plugin‏ (AGP).

פלאגין Android Gradle‏ 9.0

‫Android Gradle plugin 9.0 היא גרסה ראשית חדשה של AGP, והיא כוללת שינויים בממשקי ה-API ובהתנהגות.

כדי לעדכן לפלאגין Android Gradle‏ ‎9.0.0-rc01, צריך להשתמש בעוזר השדרוג של פלאגין Android Gradle ב-Android Studio Panda‏ ‎ | 2025.3.1.

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

תאימות

רמת ה-API המקסימלית של Android שנתמכת ב-Android Gradle plugin‏ ‎9.0.0-rc01 היא 36.

פלאגין Android Gradle‏ ‎9.0.0-rc01 דורש Gradle 9.0.0.

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

המחלקה android DSL מטמיעה עכשיו רק את הממשקים הציבוריים החדשים

במהלך השנים האחרונות השקנו ממשקים חדשים ל-DSL ול-API שלנו כדי לשפר את השליטה ב-API שזמינים לציבור. בגרסאות AGP‏ 7.x ו-8.x עדיין נעשה שימוש בסוגי ה-DSL הישנים (לדוגמה, BaseExtension), שגם יישמו את הממשקים הציבוריים החדשים, כדי לשמור על תאימות בזמן שהעבודה על הממשקים התקדמה.

ב-AGP 9.0 נעשה שימוש בלעדי בממשקי ה-DSL החדשים שלנו, וההטמעות השתנו לסוגים חדשים שמוסתרים לחלוטין. הפעולה הזו מסירה גם את הגישה ל-API הישן של וריאציות שהוצא משימוש.

כדי לעדכן ל-AGP 9.0, יכול להיות שתצטרכו לבצע את הפעולות הבאות:

  • מוודאים שהפרויקט תואם ל-built-in Kotlin: הפלאגין org.jetbrains.kotlin.android לא תואם ל-DSL החדש.

  • מעבירים פרויקטים של KMP אל Android Gradle Library Plugin for KMP: שימוש בפלאגין org.jetbrains.kotlin.multiplatform באותו פרויקט משנה של Gradle כמו הפלאגינים com.android.library ו-com.android.application לא תואם ל-DSL החדש.

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

  • מעדכנים את הלוגיקה של הגרסה המותאמת אישית כדי להפנות ל-DSL ול-API החדשים: מחליפים את כל ההפניות ל-DSL הפנימי בממשקי ה-DSL הציבוריים. ברוב המקרים, מדובר בהחלפה של אחד באחד. צריך להחליף כל שימוש ב-applicationVariants ובממשקי API דומים ב-androidComponents API החדש. יכול להיות שהתהליך יהיה מורכב יותר, כי androidComponents API נועד להיות יציב יותר כדי שהתוספים יהיו תואמים למשך זמן ארוך יותר. כדאי לעיין בדוגמאות ל-Gradle.

  • עדכון פלאגינים של צד שלישי: יכול להיות שחלק מהפלאגינים של צד שלישי עדיין מסתמכים על ממשקים או על ממשקי API שכבר לא חשופים. מעבירים לגרסאות של התוספים האלה שתואמות ל-AGP 9.0.

המעבר לממשקי ה-DSL החדשים מונע שימוש בתוספים ובסקריפטים של Gradle build ב-API שונים שהוצאו משימוש, כולל:

‫API שהוצא משימוש בחסימה android פעולה החלפה
‫applicationVariants,
libraryVariants,
testVariants וגם
unitTestVariants 		נקודות הרחבה לתוספים כדי להוסיף פונקציונליות חדשה ל-AGP. מחליפים את הערך הזה ב-API של androidComponents.onVariants, לדוגמה: 
androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}
 יכול להיות שלא יהיה תחליף ישיר לכל ממשקי ה-API הקודמים. מדווחים על בעיה אם יש תרחיש שימוש שלא מכוסה על ידי ממשקי ה-API החדשים של הווריאנטים.
variantFilter מאפשרת להשבית וריאציות נבחרות. מחליפים את הערך הזה ב-API של androidComponents.beforeVariants, לדוגמה: 
androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }
‫deviceProvider and
testServer 		רישום של סביבות בדיקה בהתאמה אישית להרצת בדיקות במכשירי Android ובאמולטורים. עוברים אל מכשירים בניהול Gradle.
‫sdkDirectory,
ndkDirectory,
bootClasspath,
adbExecutable וגם
adbExe 		שימוש ברכיבים שונים של Android SDK למשימות בהתאמה אישית. מעבר אל androidComponents.sdkComponents.
‫registerArtifactType,
registerBuildTypeSourceProvider,
registerProductFlavorSourceProvider,
registerJavaArtifact,
registerMultiFlavorSourceProvider וגם
wrapJavaSourceSet		 הפונקציונליות שהוצאה משימוש קשורה בעיקר לטיפול במקורות שנוצרו ב-Android Studio, שהפסיקו לפעול ב-AGP 7.2.0. אין תחליף ישיר לממשקי ה-API האלה.
dexOptions הגדרות מיושנות שקשורות לכלי dx, שהוחלף בכלי d8. אף אחת מההגדרות לא משפיעה מאז גרסה 7.0 של הפלאגין Android Gradle. אין תחליף ישיר.
generatePureSplits יצירת פיצולים של הגדרות לאפליקציות ללא התקנה. האפשרות לשלוח פיצולים של הגדרות מובנית עכשיו בחבילות של אפליקציות ל-Android.
aidlPackagedList קובצי AIDL לאריזה ב-AAR כדי לחשוף אותו כממשק API לספריות ולאפליקציות שתלויות בספרייה הזו. היא עדיין חשופה ב-LibraryExtension, אבל לא בסוגים אחרים של תוספים.

אם אתם מעדכנים ל-AGP 9.0 ורואים את הודעת השגיאה הבאה, המשמעות היא שהפרויקט שלכם עדיין מפנה לחלק מהסוגים הישנים:

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

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

android.newDsl=false

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

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

אם גיליתם שהיכולות או התכונות של ה-DSL החדש או של Variant API חסרות, חשוב לשלוח דיווח על בעיה בהקדם האפשרי.

‫Kotlin מובנה

פלאגין Android Gradle 9.0 כולל תמיכה מובנית ב-Kotlin, והתמיכה הזו מופעלת כברירת מחדל. כלומר, כבר לא צריך להחיל את הפלאגין org.jetbrains.kotlin.android (או kotlin-android) בקובצי ה-build כדי לקמפל קובצי מקור של Kotlin. השינוי הזה מפשט את השילוב של Kotlin עם AGP, מונע שימוש בממשקי API שיצאו משימוש ומשפר את הביצועים במקרים מסוימים.

לכן, כשמשדרגים את הפרויקט ל-AGP 9.0, צריך גם לעבור ל-Kotlin מובנה או לבטל את ההסכמה.

אפשר גם להשבית באופן סלקטיבי את התמיכה המובנית ב-Kotlin בפרויקטים משניים של Gradle שלא כוללים מקורות Kotlin.

תלות בזמן ריצה בפלאגין Kotlin Gradle

כדי לספק תמיכה מובנית ב-Kotlin, פלאגין Android Gradle בגרסה 9.0 כולל עכשיו תלות בזמן ריצה בפלאגין Kotlin Gradle‏ (KGP) בגרסה 2.2.10. כלומר, אתם לא צריכים יותר להצהיר על גרסת KGP, ואם אתם משתמשים בגרסת KGP נמוכה מ-2.2.10,‏ Gradle ישדרג אוטומטית את גרסת KGP ל-2.2.10. באופן דומה, אם אתם משתמשים בגרסת KSP נמוכה מ-2.2.10-2.0.2, ‏ AGP ישדרג אותה ל-2.2.10-2.0.2 כדי להתאים לגרסת KGP.

שדרוג לגרסה גבוהה יותר של KGP

כדי להשתמש בגרסה מתקדמת יותר של KGP או KSP, מוסיפים את השורה הבאה לקובץ build ברמה העליונה:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

שדרוג לאחור לגרסה קודמת של KGP

אפשר לשנמך את גרסת KGP רק אם ביטלתם את ההסכמה לשימוש ב-Kotlin המובנה. הסיבה לכך היא ש-AGP 9.0 מפעיל כברירת מחדל Kotlin מובנה, ו-Kotlin מובנה דורש KGP בגרסה 2.2.10 ואילך.

כדי להשתמש בגרסה ישנה יותר של KGP או KSP, צריך להצהיר על הגרסה הזו בקובץ build ברמה העליונה באמצעות הצהרה על גרסה מדויקת:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

הערה: הגרסה המינימלית של KGP שאפשר לשנמך אליה היא 2.0.0.

תמיכה ב-IDE עבור מבני בדיקה

‫AGP 9.0 כולל תמיכה מלאה ב-IDE של Android Studio בtest fixtures.

תוסף Fused Library

התוסף Fused Library (גרסת Preview) מאפשר לכם לפרסם כמה ספריות כספריית Android אחת מסוג AAR. כך יהיה קל יותר למשתמשים להסתמך על הארטיפקטים שפרסמתם.

מידע על תחילת העבודה זמין במאמר פרסום של כמה ספריות Android כאחת באמצעות Fused Library.

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

לפלאגין Android Gradle בגרסה 9.0 יש התנהגויות חדשות:

התנהגות המלצה
פלאגין Android Gradle בגרסה 9.0 משתמש ב-NDK בגרסה r28c כברירת מחדל. מומלץ לציין במפורש את גרסת ה-NDK שבה רוצים להשתמש.
כברירת מחדל, פלאגין Android Gradle 9.0 מחייב את הצרכנים של ספרייה להשתמש באותה גרסה או בגרסה חדשה יותר של SDK למהדר. כשמשתמשים בספרייה, צריך להשתמש באותו SDK או ב-SDK חדש יותר. אם זה לא אפשרי, או שאתם רוצים לתת לצרכני ספרייה שפרסמתם יותר זמן לעבור לגרסה החדשה, אתם צריכים להגדיר את AarMetadata.minCompileSdk באופן מפורש.

‫AGP 9.0 כולל עדכונים בערכי ברירת המחדל של מאפייני Gradle הבאים. כך תוכלו לבחור אם לשמור על ההתנהגות של AGP 8.13 כשמשדרגים:

נכס פעולה שינוי מ-AGP 8.13 ל-AGP 9.0 המלצה
android.newDsl שימוש בממשקי DSL החדשים, בלי לחשוף את ההטמעות הקודמות של בלוק android.
המשמעות היא גם שאי אפשר יותר לגשת לגרסה הקודמת של Variant API, כמו android.applicationVariants. 		false‏ ← true אפשר לבטל את ההצטרפות על ידי הגדרת android.newDsl=false.
אחרי שמוודאים שכל הפלאגינים והלוגיקה של הבנייה שבהם הפרויקט משתמש תואמים, מסירים את ההסכמה.
android.builtInKotlin ההגדרה הזו מפעילה את Kotlin המובנה false‏ ← true מעבר ל-Kotlin מובנה אם אפשר או ביטול ההסכמה.
android.uniquePackageNames האפשרות הזו מוודאת שלכל ספרייה יש שם חבילה ייחודי. false‏ ← true מציינים שמות חבילות ייחודיים לכל הספריות בפרויקט. אם זה לא אפשרי, אפשר להשבית את הדגל הזה בזמן ההעברה.
android.useAndroidx שימוש בהתנהגויות ברירת המחדל של androidx. false‏ ← true אימוץ יחסי התלות של androidx.
android.default.androidx.test.runner הפעלת בדיקות במכשיר באמצעות המחלקה androidx.test.runner.AndroidJUnitRunner כברירת מחדל, במקום ברירת המחדל של המחלקה InstrumentationTestRunner שהוצאה משימוש 
android {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}
 		false‏ ← true ‫Adopt AndroidJUnitRunner, או מציינים במפורש את testInstrumentationRunner המותאם אישית.
android.dependency.useConstraints ההגדרה הזו קובעת את השימוש באילוצי תלות בין תצורות.
ברירת המחדל ב-AGP 9.0 היא false, שמשתמשת רק באילוצים בבדיקות של מכשירי אפליקציה (AndroidTest). הגדרת הערך true תחזיר את ההתנהגות של גרסה 8.13. 		true‏ ← false אל תשתמשו באילוצי תלות בכל מקום אלא אם אתם צריכים אותם. אישור ברירת המחדל החדשה של הדגל הזה מאפשר גם לבצע אופטימיזציות בתהליך ייבוא הפרויקט, וכך לקצר את זמן הייבוא של גרסאות build עם הרבה פרויקטים משניים של ספריות Android.
android.enableAppCompileTimeRClass הידור קוד באפליקציות מול מחלקת R לא סופית, כדי שהידור האפליקציה יהיה זהה להידור הספרייה.
השינוי הזה משפר את המדד 'המרות מצטברות' וסולל את הדרך לשיפורים עתידיים בביצועים של תהליך עיבוד המשאבים. 		false‏ ← true בפרויקטים רבים אפשר פשוט לאמץ את ההתנהגות החדשה בלי לבצע שינויים בקוד המקור. אם משתמשים בשדות של מחלקת R במקומות שבהם נדרש קבוע, כמו במקרים של switch, צריך לבצע refactoring כדי להשתמש בהצהרות if בשרשרת.
android.sdk.defaultTargetSdkToCompileSdkIfUnset משתמש בגרסת ה-SDK של הקומפילציה כערך ברירת המחדל של גרסת ה-SDK של היעד באפליקציות ובבדיקות.
לפני השינוי הזה, גרסת ה-SDK לטירגוט הייתה מוגדרת כברירת מחדל לגרסת ה-SDK המינימלית. 		false‏ ← true צריך לציין במפורש את גרסת ה-SDK של היעד לאפליקציות ולבדיקות.
android.onlyEnableUnitTestForTheTestedBuildType יוצר רק רכיבי בדיקת יחידות לסוג ה-build שנבדק.
בפרויקט ברירת המחדל, התוצאה היא בדיקת יחידה אחת לניפוי באגים, בעוד שההתנהגות הקודמת הייתה הפעלת בדיקות יחידה לניפוי באגים או לגרסה. 		false‏ ← true אם הפרויקט לא דורש הפעלת בדיקות גם עבור ניפוי באגים וגם עבור גרסת הפצה, לא צריך לבצע שינוי.
android.proguard.failOnMissingFiles ה-build נכשל עם שגיאה אם אחד מקובצי השמירה שצוינו ב-AGP DSL לא קיים בדיסק. לפני השינוי הזה, שגיאות כתיב בשמות של קבצים היו גורמות למערכת להתעלם מהקבצים בלי להציג הודעה. false‏ ← true הסרת הצהרות לא תקינות של קובצי ProGuard
android.r8.optimizedResourceShrinking מאפשר ל-R8 לשמור פחות משאבי Android על ידי התייחסות משותפת למחלקות ולמשאבי Android. false‏ ← true אם כללי השימור של הפרויקט כבר הושלמו, לא צריך לבצע שינוי.
android.r8.strictFullModeForKeepRules מאפשר ל-R8 לשמור פחות, כי הוא לא שומר באופן מרומז את בנאי ברירת המחדל כששומרים מחלקה. כלומר, -keep class A כבר לא מרמז על -keep class A { <init>(); }
 false‏ ← true אם כללי השימור של הפרויקט כבר הושלמו, לא צריך לבצע שינוי. ‫

מחליפים את -keep class A ב--keep class A { <init>(); } בכללים לשמירה של הפרויקט, בכל המקרים שבהם צריך לשמור את בנאי ברירת המחדל.
android.defaults.buildfeatures.resvalues הפעלת resValues בכל פרויקטי המשנה true‏ ← false מפעילים את resValues רק בפרויקטים המשניים שזקוקים לו, על ידי הגדרת הפקודה הבאה בקובצי ה-build של Gradle של הפרויקטים האלה: 
android {
  buildFeatures {
    resValues = true
  }
}
android.defaults.buildfeatures.shaders הפעלת קומפילציה של Shader בכל פרויקטי המשנה true‏ ← false כדי להפעיל קומפילציה של Shader רק בפרויקטים משניים שמכילים Shader שצריך לקמפל, מגדירים את האפשרויות הבאות בקובצי ה-build של Gradle של הפרויקטים האלה: 
android {
  buildFeatures {
    shaders = true
  }
}
android.r8.proguardAndroidTxt.disallowed ב-AGP 9.0, ‏ getDefaultProguardFile() יתמוך רק ב-proguard-android-optimize.txt ולא ב-proguard-android.txt. המטרה היא למנוע שימוש לא מכוון בדגל ­dontoptimize, שנכלל ב-proguard-android.txt. false‏ ← true כדי להימנע מאופטימיזציה, אפשר לציין באופן מפורש את ­dontoptimize בקובץ proguardFile מותאם אישית, בנוסף לשימוש ב-proguard-android-optimize.txt. אם אפשר, חשוב להסיר את הדגל ­dontoptimize מהקובץ הזה, כי הוא מצמצם את היתרונות של האופטימיזציה של R8. אם לא, צריך להגדיר את android.r8.globalOptionsInConsumerRules.disallowed=false כדי לבטל את ההסכמה.
android.r8.globalOptionsInConsumerRules.disallowed מגרסה AGP 9.0 ואילך, פרסום של ספריות Android ומודולים של תכונות ייכשל אם קובצי השמירה של הצרכנים מכילים הגדרות בעייתיות של Proguard. קובצי צרכן שכוללים אפשרויות גלובליות כמו ­dontoptimize או ­dontobfuscate צריכים לשמש רק במודולים של אפליקציות, והם עלולים להפחית את היתרונות של האופטימיזציה למשתמשי הספריות. אם אפשרויות גלובליות כאלה מוטמעות בתלות שעברה קומפילציה מראש (JAR או AAR), המערכת תתעלם מהן בשקט במהלך הקומפילציה של מודול אפליקציית Android. כדי לראות מתי זה קורה, אפשר לבדוק את הקובץ configuration.txt (בדרך כלל בנתיב כמו <app_module>/build/outputs/mapping/<build_variant>/configuration.txt) ולחפש הערות כמו: # REMOVED CONSUMER RULE: ­dontoptimize false‏ ← true בספריות שפורסמו, צריך להסיר כללים לא תואמים. במקום זאת, בספריות פנימיות צריך להעביר כללים לא תואמים אבל נדרשים אל proguardFile במודול של אפליקציה. כדי לבטל את ההצטרפות, לוחצים על סמל ההגדרות android.r8.globalOptionsInConsumerRules.disallowed=false. אחרי שכל הקבצים שלכם ב-Keep לשימוש אישי יהיו תואמים, תוכלו להסיר את הביטול.
android.sourceset.disallowProvider אפשר להגדיר שלא תהיה אפשרות להעביר ספקים למקורות שנוצרו באמצעות AndroidSourceSet DSL. false‏ ← true משתמשים ב-API‏ Sources ב-androidComponents כדי לרשום מקורות שנוצרו.
android.custom.shader.path.required אם הידור השיידרים מופעל, צריך להגדיר באופן מפורש את הנתיב של מהדר השיידרים ב-local.properties. false‏ ← true מוסיפים את glslc.dir=/path/to/shader-tools ל-local.properties של הפרויקט.

תכונות שהוסרו

בפלאגין Android Gradle בגרסה 9.0 הוסרה הפונקציונליות הבאה:

  • התמיכה בהטמעת אפליקציות ל-Wear OS
    ב-AGP 9.0 הוסרה התמיכה בהטמעת אפליקציות ל-Wear OS, שלא נתמכת יותר ב-Play. זה כולל הסרה של הגדרות wearApp ושל AndroidSourceSet.wearAppConfigurationName DSL. במאמר הפצה ב-Wear OS מוסבר איך לפרסם את האפליקציה ב-Wear OS.
  • androidDependencies וsourceSets דיווח על משימה
  • תמיכה בחבילות APK מפוצלות לדחיסות
    ב-AGP 9.0 הוסרה התמיכה ביצירת חבילות APK מפוצלות על סמך צפיפות פיקסלים. הפונקציונליות וממשקי ה-API שקשורים אליה הוסרו. כדי לפצל קובצי APK על סמך צפיפות המסך באמצעות AGP בגרסה 9.0 ואילך, צריך להשתמש ב-App Bundle.

שינוי ב-DSL

בפלאגין Android Gradle בגרסה 9.0 בוצעו שינויים הבאים ב-DSL שעלולים לגרום לכשלים:

  • הוסרה הפרמטריזציה של CommonExtension.

    השינוי הזה הוא שינוי שובר תאימות ברמת המקור, שמטרתו למנוע שינויים שוברי תאימות ברמת המקור בעתיד. אבל המשמעות שלו היא גם שצריך להעביר את שיטות החסימה מ-CommonExtension אל ApplicationExtension, ‏LibraryExtension, ‏DynamicFeatureExtension ו-TestExtension.

    כשמשדרגים את הפרויקט ל-AGP 9.0, צריך לבצע רפקטורינג של קוד הפלאגין Gradle שמשתמש בפרמטרים האלה או בשיטות הבלוק. לדוגמה, התוסף הבא עודכן כדי להסיר את פרמטר הסוג ולא להסתמך על שיטות הבלוק שהוסרו:

    ‫AGP 8.13

    val commonExtension: CommonExtension<*, *, *, *, *, *> =
        extensions.getByType(CommonExtension::class)
commonExtension.apply {
    defaultConfig {
        minSdk {
            version = release(28)
        }
    }
}

    AGP 9.0

    val commonExtension: CommonExtension =
        extensions.getByType(CommonExtension::class)
commonExtension.apply {
    defaultConfig.apply {
        minSdk {
            version = release(28)
        }
    }
}

    בתוספים שמטרגטים טווח של גרסאות AGP, שימוש בשיטת ה-getter ישירות תואם בינארית לגרסאות AGP נמוכות מ-9.0.

הסרת DSL

בפלאגין Android Gradle‏ 9.0 הוסרו:

ממשקי API שהוסרו

בפלאגין Android Gradle‏ 9.0 הוסרו:

הוסרו מאפייני Gradle

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

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

נכס פעולה החלפה
android.defaults.buildfeatures.aidl הפעלת הידור של AIDL בכל פרויקטי המשנה כדי להפעיל קומפילציה של AIDL רק בפרויקטים משניים שבהם יש מקורות AIDL, צריך להגדיר את המאפיין הבא בקובצי ה-build של Gradle של הפרויקטים האלה:
‫
android {
  buildFeatures {
    aidl = true
  }
}
 בקובץ ה-build של Gradle של כל פרויקט משנה שמכיל מקורות AIDL
android.defaults.buildfeatures.renderscript הפעלת הידור של RenderScript בכל פרויקטי המשנה כדי להפעיל קומפילציה של renderscript רק בפרויקטים משניים שבהם יש מקורות renderscript, צריך להגדיר את המאפיין הבא בקובצי ה-build של Gradle של הפרויקטים האלה: 
android {
  buildFeatures {
    renderScript = true
  }
}

מאפייני Gradle שנאכפים

‫AGP 9.0 מציג שגיאה אם מגדירים את מאפייני Gradle הבאים.

הכלי Android Gradle plugin Upgrade Assistant לא ישדרג פרויקטים ל-AGP 9.0 שמשתמשים במאפיינים האלה.

נכס פעולה
android.r8.integratedResourceShrinking הפחתת משאבים מופעלת עכשיו תמיד כחלק מ-R8, וההטמעה הקודמת הוסרה.
android.enableNewResourceShrinker.preciseShrinking כיווץ מקורות המידע מתבצע עכשיו תמיד באמצעות כיווץ מדויק של מקורות המידע, שמאפשר להסיר יותר נתונים.

בעיות שתוקנו

פלאגין Android Gradle‏ ‎9.0.0-rc01

בעיות שתוקנו
לא סומנו בעיות ציבוריות כבעיות שתוקנו ב-AGP 9.0.0-rc01

פלאגין Android Gradle‏ ‎9.0.0-beta05

בעיות שתוקנו
‫Android Gradle Plugin
התמיכה המובנית ב-Kotlin ב-AGP לא אמורה להסתנכרן עם ערכות המקור של Kotlin

פלאגין Android Gradle‏ ‎9.0.0-beta04

בעיות שתוקנו
‫Android Gradle Plugin
התמיכה המובנית ב-Kotlin ב-AGP לא אמורה להסתנכרן עם ערכות המקור של Kotlin
השיטה missingDimensionStrategy מעדיפה טעם שתואם לשם שלה, גם אם הוא מגיע ממאפיין לא קשור

פלאגין Android Gradle‏ ‎9.0.0-beta03

בעיות שתוקנו
לא סומנו בעיות ציבוריות כבעיות שתוקנו ב-AGP 9.0.0-beta03

פלאגין Android Gradle‏ ‎9.0.0-beta02

בעיות שתוקנו
‫Android Gradle Plugin
בקשה להוספת תכונה: הוספת גרסת ה-AGP האידיאלית כמאפיין
ייצוב SingleArtifact.VERSION_CONTROL_INFO_FILE
הפלט של logcat ב-androidTest connectedCheck לא תקין
Lint
‫AGP 8.11.0: המשימה lintAnalyzeRelease קורסת כשמחילים קובצי ‎ .gradle.kts עם apply(from = "...")‎
שילוב Lint
החמצות במטמון של AndroidLintAnalysisTask בקרב ספקים שונים של JDK או גרסאות משניות שונות בגלל הבדלים ב-systemPropertyInputs.javaVersion

פלאגין Android Gradle‏ ‎9.9.0-beta01

בעיות שתוקנו
לא סומנו בעיות ציבוריות כבעיות שתוקנו ב-AGP 9.0.0-beta01

פלאגין Android Gradle‏ ‎9.0.0-alpha14

בעיות שתוקנו
‫Android Gradle Plugin
התמיכה המובנית ב-Kotlin ב-AGP לא אמורה להסתנכרן עם ערכות המקור של Kotlin
הפרסום של ספריית Android נכשל אם קובץ השמירה על נתונים של צרכנים מכיל את המחרוזת ‎-dontobfuscate
אין אפשרויות להדפסת מיפוי למשאבים שעברו אופטימיזציה
הגדרת שגיאה אם מנסים להפעיל את finalizeDsl אחרי שהשלב הזה הסתיים
‫AGP מאתחל את ההגדרה של jetifier גם כש-jetifier מושבת
אם הערך של kotlin.stdlib.default.dependency הוא true בקובצי מודול ו-pom,‏ kotlinStdlib לא מתווסף כתלות בזמן קומפילציה כשיוצרים ב-kotlin
שילוב Lint
‫Lint משתמש אוטומטית ב-SDK המותקן האחרון למרות compileSdk, לא נרשם כקלט של משימה וגורם לשגיאות במטמון
Shrinker (R8)
אם משתמשים במזהי משאבים סופיים, אופטימיזציית המשאבים של R8 נכשלת בשקט

פלאגין Android Gradle‏ ‎9.0.0-alpha13

בעיות שתוקנו
‫Android Gradle Plugin
‫AGP9: הפונקציה `variant.sources.kotlin!!.addGeneratedSourceDirectory()` לא פועלת
בדיקות מטא-נתונים של Aar בהידור של SDK משתמשות ב-DSL הישן
הסרה של המאפיין `com.android.build.api.dsl.ManagedDevices.devices` שיצא משימוש

פלאגין Android Gradle‏ ‎9.0.0-alpha12

בעיות שתוקנו
‫Android Gradle Plugin
לפרויקט Pure Java יש תלות בספריית kotlin stdlib.
הסרת מאפיינים שהוצאו משימוש ב-KotlinMultiplatformAndroidCompilationBuilder ב-AGP 9.0
‫`com.android.tools.build:gradle:9.0.0-alpha05` צריך לכלול תלות ב-API ב-KGP וב-gradle-api
שינוי השם של פלאגין Gradle‏ com.android.experimental.built-in-kotlin

פלאגין Android Gradle‏ ‎9..0.0-alpha11

בעיות שתוקנו
‫Android Gradle Plugin
‫Built-in-kotlin לא מפרסם את אילוץ התלות kotlin-stdlib ב-maven pom
הוספת מקרה בדיקה לפער בין compileSdk לבין targetSdk
ערך ריק של resConfigs מוביל לשגיאת aapt לא ברורה

פלאגין Android Gradle‏ ‎9.0.0-alpha10

בעיות שתוקנו
‫Android Gradle Plugin
המאפיינים extractNativeLibs ו-useEmbeddedDex לא אמורים להגיע מהמניפסט
אזהרות מ-R8 ב-AGP 9.0.0-alpha09
Lint
‫Kotlin מובנה לא מוסיף ‎ .kotlin_module ל-META-INF
נתיב המחלקה של Lint מכיל כפילויות של מחלקות בגרסאות שונות
הפתרון לעקיפת משאבים פרטיים לא עובד (tools:override = "true")

פלאגין Android Gradle‏ ‎9.0.0-alpha09

בעיות שתוקנו
‫Android Gradle Plugin
הפלאגין `legacy-kapt` מדלג על עיבוד ההערות, בניגוד לפלאגין `kotlin-kapt`
המאפיין compileSdkSpec.minorApiLevel לא פועל עם SettingsExtension
‫[fused lib - public] ספרייה מאוחדת שנוצרה לא כוללת מקורות

פלאגין Android Gradle‏ ‎9.0.0-alpha08

בעיות שתוקנו
לא סומנו בעיות ציבוריות כבעיות שתוקנו ב-AGP 9.0.0-alpha08

פלאגין Android Gradle‏ ‎9.0.0-alpha07

בעיות שתוקנו
‫Android Gradle Plugin
ה-build נכשל אם יש משימות של יצירת קוד
אם android.builtInKotlin=false,‏ android.newDsl=false ו-android.enableLegacyVariantApi=false, השימוש בתוסף kotlin-android ייכשל עם ההודעה 'ה-API ‏applicationVariants יצא משימוש'
ה-Kotlin המובנה לא מצליח לפתור את kotlin-stdlib ללא גרסה כש-kotlin.stdlib.default.dependency=false
‫DexData פותח קובץ בלי לסגור אותו, ומונע ניקוי
החל מ-AGP 9.0,‏ AndroidSourceDirectorySet לא יורחב יותר על ידי PatternFilterable
שגיאת Test Fixture במודולים לבדיקה בלבד
שגיאה לא נכונה כשמשתמשים במקבלים של הקשר ב-test fixtures
שגיאות שגויות ב-IDE עבור קוד Kotlin ב-testFixtures

פלאגין Android Gradle‏ ‎9.0.0-alpha06

בעיות שתוקנו
‫Android Gradle Plugin
ה-DSL החדש לאופטימיזציה לא יוצר את הקובץ configuration.txt כברירת מחדל
גרסה AGP 8.13.0 לא מצליחה לאמת את תרשים הניווט במודול
‫AGP משתמש ב-Gradle API שהוצא משימוש: סימון של כמה מחרוזות
אזהרה למשתמשים שמנסים להשתמש בספריית multidex מדור קודם עם minSdkVersion ‏ >=21
Lint
‫Lint ChecksSdkIntAtLeast Check does not check if the annotated value is correct

פלאגין Android Gradle‏ ‎9.0.0-alpha05

בעיות שתוקנו
‫Android Gradle Plugin
‫android.proguard.failOnMissingFiles לא פועל עבור consumerProguardFiles
עדכון התלות בפלאגין Kotlin Gradle לגרסה 2.2.10
יצירת KotlinJvmAndroidCompilation באמצעות KGP API
מצב Kotlin explicit API מוחל על מקורות בדיקה
Lint
‫Lint מציג את האזהרה 'Could not clean up K2 caches'

פלאגין Android Gradle‏ ‎9.0.0-alpha04

בעיות שתוקנו
‫Android Gradle Plugin
החלפת גרסת ברירת המחדל של Java במקור או ביעד מ-Java 8 ל-Java 11 ב-AGP 9.0
החלפת ברירת המחדל של android.useAndroidX ל-true
שיפור היוצא מן הכלל כשמחילים את התוסף kapt עם Kotlin מובנה.
Lint
‫Lint מציג את האזהרה 'Could not clean up K2 caches'

פלאגין Android Gradle‏ ‎9.0.0-alpha03

בעיות שתוקנו
‫Android Gradle Plugin
כשהאפשרות `isIncludeAndroidResources` מופעלת, הפעולה `process{Variant}UnitTestManifest` נכשלת במיזוג של שימושים ב-tools:overrideLibrary ב-AGP 8.12.0
‫AGP גורם להצגת אזהרות לגבי הוצאה משימוש ב-Gradle למשימות בדיקה של JVM
‫DependencyReportTask לא תואם למטמון ההגדרות
Lint
באג: הסרה של משאבים שלא נמצאים בשימוש לא מסירה גם את התרגומים שלהם, ולא מוצגת שאלה לגבי זה

פלאגין Android Gradle‏ ‎9.0.0-alpha02

בעיות שתוקנו
‫Android Gradle Plugin
ה-build נכשל אם קובץ ה-proguard לא קיים
remove buildconfig defaults gradle.properties flags
שינוי ערך ברירת המחדל של targetSdk באפליקציה כך שיתבסס על compileSdk במקום על minSdk

פלאגין Android Gradle‏ ‎9.0.0-alpha01

בעיות שתוקנו
‫Android Gradle Plugin
הסרה של AndroidSourceSet.jni שהוצא משימוש ב-AGP 9.0
הסרה של Installation.installOptions()‎ ב-AGP 9.0
הסרת BuildType.isRenderscriptDebuggable ב-AGP 9.0.
הסרה של android.defaults.buildfeatures.renderscript
קריסה של ‎`com.android.kotlin.multiplatform.library` ‎ עם מכשירים בניהול Gradle
הסרה של ברירות המחדל של הדגל `android.defaults.buildfeatures.aidl` בקובץ gradle.properties