לוח הזמנים להעברת ה-DSL/API של פלאגין Android Gradle
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Android Gradle Plugin (AGP) הוא מערכת ה-build הנתמכת לאפליקציות Android, והוא כולל תמיכה בתכנות של סוגים רבים ושונים של מקורות, וקישור שלהם יחד לאפליקציה שאפשר להריץ במכשיר Android פיזי או במהדמ.
בקטע הבא מתוארת האבולוציה המתוכננת של ה-DSL ושל ה-API של AGP.
כשמוציאים ממשקי API חדשים בגרסאות יציבות, ממשקי API ישנים מסומנים כ-deprecated. ממשקי ה-API האלה יוצאו משימוש במהדורה היציבה הבאה. בהמשך מפורט מידע על השינויים הצפויים בכל גרסה ראשית של AGP.
בעדכונים של AGP API מופיע יומן מפורט יותר של הוצאות משימוש או הסרות של ממשקי AGP API.
AGP 9.0 (מחצית שנייה של שנת 2025)
ממשקי ה-API החדשים של הווריאנטים יציבים, ממשקי ה-API הישנים הוצאו משימוש
עדיין אפשר לגשת לכיתות פנימיות פרטיות מ-AGP שנמצאות בפריטי ארטיפקט אחרים במהלך הידור של קובצי build, אבל לא מומלץ להשתמש בהן כי הן עשויות להשתנות באופן שיפגע בקוד בכל שלב.
AGP 10.0 (2026)
ממשקי API ישנים הוסרו
כל הממשקים והכיתות הקודמים ששימשו ב-DSL וב-Variant API הישן נמחקים.
הארטיפקט gradle-api הוא הארטיפקט היחיד שדרוש כדי לגשת לממשקים ולכיתות של DSL ושל API של וריאנט, ויש להשתמש בו כשמפתחים פלאגינים.
באמצעות המטא-נתונים של Gradle, שמציעים תרשימי תלות שונים לזמן הידור ולזמן ריצה, רק הארטיפקט gradle-api זמין במהלך הידור קובצי ה-build.
(בהמתנה) הגישה לכיתות AGP פנימיות פרטיות הוסרה
התלות ב-artifact gradle מסתירה עכשיו את כל הכיתות הפנימיות ומעניקה לגישה ל-compilation רק את הממשקים והכיתות שזמינים ב-artifact gradle-api. הדבר משפיע גם על הידור הפלאגין וגם על הידור קובץ ה-build.
אי אפשר להוסיף באופן ידני יחסי תלות כדי לקבל גישה לכיתות הפנימיות.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Android Gradle Plugin DSL/API migration timeline\n\nThe Android Gradle Plugin (AGP) is the supported build system for Android\napplications and includes support for compiling many different types of sources\nand linking them together into an application that you can run on a physical\nAndroid device or an emulator.\n\nThe following section describes the planned evolution of the AGP's DSL and API.\nAs new APIs are introduced in stable releases, old APIs will be marked as\ndeprecated. Those deprecated APIs will then become unavailable in the next\nstable release. Below you will find information about upcoming changes in each\nmajor AGP release.\n\nFor a more detailed log of AGP API deprecations or removals, see the [AGP API\nupdates](/studio/releases/gradle-plugin-api-updates).\n| **Note:** The timeframes mentioned below are estimates and are subject to change.\n\nAGP 9.0 (Second half of 2025)\n-----------------------------\n\n**New Variant APIs are stable, old APIs are deprecated**\n\n- The [Variant APIs](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1 and 4.2 are stable.\n- All of these interfaces are located in the [`gradle-api`](https://maven.google.com/web/index.html#com.android.tools.build:gradle-api) artifact.\n- The previous interfaces and classes used in the old Variant API are now deprecated.\n\n**New DSL interfaces are stable, old ones are deprecated**\n\n- The [DSL interfaces](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1, 4.2 and 7.0 are now stable.\n- All of these interfaces are located in the `gradle-api` artifact.\n- The previous interfaces and classes used in the DSL are now deprecated.\n\n**Private internal AGP classes still accessible**\n\nPrivate internal classes from AGP, located in other artifacts, are still\naccessible during compilation of build files, but it is **not** recommended\nto use them as they may change in breaking ways at any time.\n\nAGP 10.0 (2026)\n---------------\n\n**Old APIs are removed**\n\n- All previous interfaces and classes used in the DSL and the old Variant API are **deleted**.\n- The `gradle-api` artifact is the only artifact you need to access DSL and variant API interfaces and classes, and should be used when developing plugins.\n- Using Gradle metadata, which offers different dependency graphs for compile and runtime, only `gradle-api` artifact is available during compilation of build files.\n\n**(Tentative) Access to private internal AGP classes is removed**\n\nDependency on the\n[`gradle`](https://maven.google.com/web/index.html#com.android.tools.build:gradle)\nartifact now hides all internal classes and gives compilation access only to the\ninterfaces and classes available in the `gradle-api` artifact. This impacts both\nplugin and build file compilation.\n\nIt isn't possible to manually add a dependency to get access to the internal\nclasses.\n| **Important:** We would like your feedback on the removal of internal AGP classes. Please let us know about your use case, including specific examples of what you need access to, by submitting your feedback on this [tracking issue](https://issuetracker.google.com/219002669)."]]
