Android Gradle Plugin (AGP) הוא מערכת ה-build הנתמכת לאפליקציות Android, והוא כולל תמיכה בהידור של סוגים רבים ושונים של מקורות וקישור שלהם לאפליקציה שאפשר להפעיל במכשיר Android פיזי או באמולטור.
בקטע הבא מתוארת האבולוציה המתוכננת של ה-DSL ושל ה-API של AGP. כשנשיק ממשקי API חדשים בגרסאות יציבות, נסמן ממשקי API ישנים ככאלה שיצאו משימוש. ממשקי ה-API שהוצאו משימוש לא יהיו זמינים בגרסה היציבה הבאה. בהמשך מפורטים השינויים הצפויים בכל גרסה מרכזית של AGP.
לרישום מפורט יותר של הוצאות משימוש או הסרות של AGP API, אפשר לעיין בעדכונים של AGP API.
AGP 9.0 (ינואר 2026)
ממשקי API חדשים של וריאציות הם יציבים, ממשקי API ישנים הוצאו משימוש
- Variant APIs שהיו בשלב פיתוח בגרסאות 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 ולמחלקות של Variant API, וצריך להשתמש בו כשמפתחים פלאגינים.
(זמני) הגישה לשיעורים פרטיים פנימיים של AGP הוסרה
התלות בארטיפקט gradle מסתירה עכשיו את כל המחלקות הפנימיות ומאפשרת גישה לקומפילציה רק לממשקים ולמחלקות שזמינים בארטיפקט gradle-api. ההגדרה הזו משפיעה על קומפילציה של תוספים.
אי אפשר להוסיף תלות באופן ידני כדי לקבל גישה למחלקות פנימיות.