פרויקט: /studio/_project.yaml ספר: /studio/_book.yaml description: בדף הזה מתוארת ההתפתחות המתוכננת של ה-DSL ושל ה-API של Android Gradle Plugin.
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 הישנים הוצאו משימוש
- ממשקי ה-API של Variant שהיו בגרסת בטא בגרסאות 4.1 ו-4.2 הם יציבים.
- כל הממשקים האלה נמצאים ב-artifact
gradle-api. - הממשקים והכיתות הקודמים ששימשו ב-Variant API הישן הוצאו משימוש.
ממשקי ה-DSL החדשים יציבים, והישנים הוצאו משימוש
- ממשקי ה-DSL שהיו בגרסת בטא בגרסאות 4.1, 4.2 ו-7.0 הם עכשיו יציבים.
- כל הממשקים האלה נמצאים ב-artifact
gradle-api. - הממשקים והכיתות הקודמים ששימשו ב-DSL הוצאו משימוש.
עדיין יש גישה לכיתות AGP פנימיות פרטיות
עדיין אפשר לגשת לכיתות פנימיות פרטיות מ-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.
אי אפשר להוסיף באופן ידני יחסי תלות כדי לקבל גישה לכיתות הפנימיות.