إنّ "إضافة Gradle لنظام Android" (AGP) هي نظام التصميم المتوافق مع تطبيقات Android، وهي تتضمّن إمكانية تجميع العديد من أنواع المصادر المختلفة وربطها معًا في تطبيق يمكنك تشغيله على جهاز Android فعلي أو محاكي.
يوضّح القسم التالي التطور المخطط له في لغة DSL وواجهة برمجة التطبيقات (API) الخاصة بـ AGP. عند طرح واجهات برمجة تطبيقات جديدة في الإصدارات الثابتة، سيتم وضع علامة "متوقّفة نهائيًا" على واجهات برمجة التطبيقات القديمة. بعد ذلك، لن تصبح واجهات برمجة التطبيقات المتوقّفة نهائيًا متاحة في الإصدار الثابت التالي. في ما يلي معلومات حول التغييرات القادمة في كل إصدار رئيسي من "المكوّن الإضافي لنظام Gradle المتوافق مع Android".
للحصول على سجلّ أكثر تفصيلاً لعمليات إيقاف واجهات برمجة التطبيقات في "منصة Google الإعلانية" نهائيًا أو إزالتها، يُرجى الاطّلاع على تعديلات واجهات برمجة التطبيقات في "منصة Google الإعلانية".
الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (يناير 2026)
واجهات برمجة التطبيقات الجديدة للمتغيرات مستقرة، وتم إيقاف واجهات برمجة التطبيقات القديمة نهائيًا
- أصبحت واجهات برمجة التطبيقات الخاصة بإنشاء صيغ التطبيق التي كانت في مرحلة التجربة في الإصدارَين 4.1 و4.2 مستقرة.
- تتوفّر جميع هذه الواجهات في العنصر
gradle-api. - تم الآن إيقاف الواجهات والفئات السابقة المستخدَمة في واجهة برمجة التطبيقات القديمة الخاصة بالصيغ، ويجب الموافقة صراحةً على استخدامها.
واجهات DSL الجديدة ثابتة، والواجهات القديمة متوقفة نهائيًا
- أصبحت واجهات DSL التي كانت في مرحلة التجربة في الإصدارات 4.1 و4.2 و7.0 مستقرة الآن.
- تتوفّر جميع هذه الواجهات في العنصر
gradle-api. - تم إيقاف الواجهات والفئات السابقة المستخدَمة في DSL نهائيًا، ويجب تفعيلها بشكل صريح لاستخدامها.
تظل صفوف AGP الداخلية الخاصة متاحة
تظل الفئات الداخلية الخاصة من "مكوّن Android الإضافي لبرنامج Gradle"، والموجودة في عناصر أخرى، متاحة أثناء تجميع ملفات الإنشاء والمكوّنات الإضافية، ولكن لا يُنصح باستخدامها لأنّها قد تتغير بطرق غير متوافقة في أي وقت.
الإصدار 10.0 من "مكوّن Android الإضافي لنظام Gradle" (أواخر 2026)
إزالة واجهات برمجة التطبيقات القديمة
- يتم حذف جميع الواجهات والفئات السابقة المستخدَمة في لغة DSL وواجهة برمجة التطبيقات القديمة الخاصة بإنشاء التطبيقات المتنوعة.
- عنصر
gradle-apiهو العنصر الوحيد الذي تحتاج إليه للوصول إلى واجهات وفئات برمجة التطبيقات الخاصة بلغة DSL وVariant، ويجب استخدامه عند تطوير المكوّنات الإضافية.
(مؤقتًا) تمت إزالة إذن الوصول إلى فئات AGP الداخلية الخاصة
تؤدي التبعية على العنصر gradle إلى إخفاء جميع الفئات الداخلية ومنح إذن التجميع فقط للواجهات والفئات المتاحة في العنصر gradle-api. ويؤثر ذلك في تجميع المكوّنات الإضافية.
لا يمكن إضافة عنصر تابع يدويًا للوصول إلى الفئات الداخلية.