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