المخطط الزمني لنقل بيانات مكوّنات Android Gradle Plugin أو واجهة برمجة التطبيقات:

مكوّن Android Gradle الإضافي (AGP) هو نظام إنشاء متوافق لتطبيقات Android، ويتضمّن إمكانية تجميع أنواع عديدة مختلفة من المصادر وربطها معًا في تطبيق يمكنك تشغيله على جهاز Android أو محاكي.

يصف القسم التالي التطور المخطط لبرنامج DSL وواجهة برمجة التطبيقات من AGP. ومع تقديم واجهات برمجة تطبيقات جديدة في الإصدارات الثابتة، سيتم وضع علامة على واجهات برمجة التطبيقات القديمة على أنّها متوقفة. بعد ذلك، ستصبح واجهات برمجة التطبيقات التي تم إيقافها نهائيًا غير متوفرة في الإصدار الثابت التالي. ستجد أدناه معلومات حول التغييرات القادمة في كل إصدار AGP رئيسي.

للحصول على سجلّ أكثر تفصيلاً بعمليات إيقاف أو إزالة واجهة AGP API، يمكنك الاطّلاع على تحديثات AGP API.

9.0 AGP (منتصف 2024)

واجهات برمجة التطبيقات الجديدة لخيارات المنتج مستقرة، وواجهات برمجة التطبيقات القديمة متوقفة نهائيًا

  • تُعد واجهات برمجة تطبيقات الصيغ التي كانت ناشئة في الإصدارين 4.1 و4.2 مستقرة.
  • تقع كل هذه الواجهات في عنصر gradle-api.
  • تم إيقاف الواجهات والفئات السابقة المستخدمة في Variable API القديمة نهائيًا.

واجهات DSL الجديدة ثابتة، والواجهات القديمة متوقفة نهائيًا

  • أصبحت واجهات DSL التي كانت ناشئة في الإصدارات 4.1 و4.2 و7.0 مستقرة الآن.
  • تقع كل هذه الواجهات في عنصر gradle-api.
  • تم إيقاف الواجهات والفئات السابقة المستخدمة في DSL.

دروس AGP الداخلية الخاصة لا تزال متاحة

لا يزال من الممكن الوصول إلى الفئات الداخلية الخاصة من AGP، الموجودة في عناصر أخرى، أثناء تجميع ملفات الإصدارات، ولكن لا يُنصح باستخدامها، لأنها قد تتغير في أي وقت.

10.0 AGP (2025)

تمت إزالة واجهات برمجة التطبيقات القديمة

  • يتم حذف جميع الواجهات والفئات السابقة المستخدمة في DSL وVariable API القديمة.
  • العنصر gradle-api هو العنصر الوحيد الذي تحتاجه للوصول إلى واجهات وفئات DSL وواجهات برمجة التطبيقات المتنوعة، ويجب استخدامه عند تطوير المكوّنات الإضافية.
  • باستخدام بيانات Gradle الوصفية التي توفّر رسومات بيانية مختلفة للتبعية للتجميع ووقت التشغيل، لا يتوفّر سوى عنصر gradle-api أثناء تجميع ملفات الإنشاء.

(مبدئي) تمت إزالة إمكانية الوصول إلى صفوف AGP الداخلية الخاصة

تؤدي التبعية إلى أداة gradle الآن إلى إخفاء كل الفئات الداخلية ومنح إمكانية الوصول إلى المجموعة فقط إلى الواجهات والفئات المتاحة في عنصر gradle-api. يؤثر هذا على كل من المكونات الإضافية وتجميع الملفات.

لا يمكن إضافة تبعية يدويًا للوصول إلى الفئات الداخلية.