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

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

פלאגין Android Gradle 9.0

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

כדי לעדכן לגרסה Android Gradle plugin 9.0.0-alpha04, צריך להשתמש בAndroid Gradle plugin Upgrade Assistant ב-Android Studio Narwhal 4 Feature Drop | 2025.1.4.

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

תאימות

רמת ה-API המקסימלית של Android שנתמכת על ידי Android Gradle plugin בגרסה 9.0.0-alpha04 היא רמת API‏ 36.

פלאגין Android ל-Gradle 9.0.0-alpha04 דורש Gradle 9.0.0.

הטמעות פנימיות של DSL וממשק API של וריאנטים שהוצא משימוש מחייבות עכשיו הבעת הסכמה מפורשת

לפלאגין Android Gradle יש עכשיו משטח API מוגדר, עם ממשקי API נתמכים שמוגדרים ב-com.android.tools.build:gradle-api maven artifact.

כדי לשמור על תאימות לתוספים בינאריים קיימים ולסקריפטים לבנייה, ההטמעות הקודמות של DSL שקדמו לממשק ה-API המוגדר הזה עדיין נחשפו כברירת מחדל ב-AGP 8.13 ובגרסאות קודמות. האפשרות הזו מאפשרת לקוד בתוספים של Gradle ולסקריפטים של build לגשת גם לפרטי ההטמעה הפנימיים של ה-DSL וגם לממשקי ה-API שהוצאו משימוש android.applicationVariants,‏ android.libraryVariants,‏ android.testVariants ו-android.unitTestVariants, שיוסרו בשנת 2026 ב-AGP 10.

כדי להבליט את המעבר הזה, אי אפשר לגשת כברירת מחדל ל-API של גרסת ה-legacy ול-DSL הפנימי בפלאגין Android Gradle בגרסה 9.0.0-alpha04.

כדי לחזור להשתמש ב-API שהוצא משימוש, צריך להגדיר את הערך android.newDsl=false ב-gradle.properties.

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

‫Kotlin מובנה

הפלאגין Android Gradle 9 כולל תמיכה מובנית בהידור של Kotlin, ומחליף את הפלאגין Kotlin שמוחל בנפרד. כך קל יותר לשלב את התוסף עם AGP, נמנעים משימוש בממשקי API שיצאו משימוש ומשפרים את הביצועים במקרים מסוימים.

לפלאגין Android Gradle 9 יש תלות בזמן ריצה בפלאגין Kotlin Gradle 2.2.0, שהיא הגרסה המינימלית שנדרשת לתמיכה מובנית ב-Kotlin.

אפשר לבטל את ההסכמה לשימוש ב-Kotlin המובנה על ידי הגדרת android.builtInKotlin=false. אם ביטלתם את ההסכמה ואתם צריכים להשתמש בגרסה ישנה יותר של הפלאגין kotlin Gradle, אתם יכולים לכפות את השדרוג לאחור

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

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

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

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

android {
  buildFeatures {
    shaders = true
  }
}

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

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

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

שינוי ב-DSL

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

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

  השינוי הזה הוא שינוי שובר תאימות ברמת המקור, שמטרתו למנוע שינויים שוברי תאימות עתידיים ברמת המקור. אבל המשמעות שלו היא גם ששיטות החסימה צריכות לעבור מ-CommonExtension ל-ApplicationExtension, ‏LibraryExension, ‏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 מסיר את:

• AndroidSourceSet.jni, כי הוא לא היה תקין.

• ‫AndroidSourceSet.wearAppConfigurationName, כי הוא קשור להסרת התמיכה באפליקציית Wear OS המוטמעת.

• BuildType.isRenderscriptDebuggable, כי הוא לא היה תקין.

• ‫ComponentBuilder.enabled. הוא הוחלף ב-ComponentBuilder.enable.

• ‫DependencyVariantSelection. הוא הוחלף ב-DependencySelection, שמוצג כ-kotlin.android

• ‫Installation.installOptions(String). הוא מוחלף במאפיין הניתן לשינוי של Installation.installOptions.

• ‫VariantBuilder.targetSdk ו-targetSdkPreview, כי הן לא היו משמעותיות בספריות. במקום זאת, אתם צריכים להשתמש ב-GeneratesApkBuilder.targetSdk או ב-GeneratesApkBuilder.targetSdkPreview.

• הבלוק PostProcessing, שהוא ניסיוני אבל אף פעם לא יציב.

• ‫ProductFlavor.setDimension, שמוחלף במאפיין dimension

• ‫LanguageSplitOptions, שהיה שימושי רק ל-Google Play ללא התקנה, שהוצא משימוש.

• ‫Variant.unitTest, כי הוא לא רלוונטי לפלאגין com.android.test. המאפיין unitTest זמין בסוגי המשנה VariantBuilder של HasUnitTest.

• ‫VariantBuilder.enableUnitTest, כי הוא לא רלוונטי לפלאגין com.android.test. המאפיין enableUnitTest זמין בסוגי המשנה VariantBuilder של HasUnitTestBuilder.

• הסוג VariantBuilder.unitTestEnabled הוסר לטובת הסוג enableUnitTest, ששמו עקבי יותר, בסוגי המשנה VariantBuilder שמרחיבים את HasUnitTestBuilder.

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

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

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

הפלאגין Android Gradle 9.0 מסיר את:

• ממשקי ה-API שהוצאו משימוש והושבתו, BaseExtension.registerTransformשנותרו רק כדי לאפשר קומפילציה מול הגרסה העדכנית ביותר של AGP תוך טירגוט הפעלה ב-AGP 4.2 או בגרסאות קודמות.

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

אם מגדירים את מאפייני Gradle הבאים, AGP 9.0 מחזיר שגיאה.

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