تتتبّع هذه الصفحة واجهات برمجة التطبيقات الخاصة بالمكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) التي تم إيقافها نهائيًا أو إزالتها، وتوفّر معلومات حول كيفية تعديل الرمز البرمجي وفقًا لذلك.
أداة تتبُّع واجهات برمجة التطبيقات التي تم إيقافها نهائيًا وإزالتها
يلخّص الجدول التالي حالات إيقاف واجهات برمجة التطبيقات في "مكوّن Android الإضافي" نهائيًا وإزالتها، من حيث إصدار "مكوّن Android الإضافي".
| واجهة برمجة التطبيقات | تم إيقافها نهائيًا في إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" | تمت إزالته من إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" |
|---|---|---|
Component.setAsmFramesComputationMode |
7.2 | |
Component.transformClassesWith |
7.2 | |
| RenderScript | 7.2 | |
| التحويل | 7.2 | من نظام التشغيل Android |
AGP 8.12
يتضمّن الإصدار 8.12.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android التغييرات البارزة التالية في واجهة برمجة التطبيقات.
تغيير في السلوك: يدمج الخيار includeAndroidResources ملف البيان من دليل الاختبار
يمكنك الآن إنشاء ملف AndroidManifest.xml في دليل ملفات المصدر للاختبار لتخصيص ملف البيان لاختبارات الوحدات باستخدام خيار android.testOptions.unitTests.includeAndroidResources. سيتم دمج ملف بيان الاختبار في ملف البيان الأساسي للتطبيق. المشكلة رقم 127986458
AGP 8.10
يتضمّن الإصدار 8.10.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android التغييرات الملحوظة التالية في واجهة برمجة التطبيقات.
تغيير قد يؤدي إلى عطل على مستوى المصدر: يتطلب finalizeDsl الآن استخدام أنواع ذات معلمات
للسماح باستخدام AndroidComponentsExtension مباشرةً مع المكوّن الإضافي com.android.kotlin.multiplatform.library، تم تخفيف قيود النوع في finalizeDsl.
على سبيل المثال، إذا كنت تستخدم أنواعًا أولية من AndroidComponentsExtension
للتعامل مع التطبيقات والمكتبات:
extensions.getByType(AndroidComponentsExtension::class).finalizeDsl { androidExtension ->
androidExtension.experimentalProperties["android.example"] = true
}
يجب تعديل الرمز المصدر قبل الترقية أو أثناءها إلى رمز مثل:
extensions.getByType<AndroidComponentsExtension<CommonExtension<*, *, *, *, *, *>, *, *>>().finalizeDsl { androidExtension ->
androidExtension.experimentalProperties["android.example"] = true
}
ملاحظة: إذا أردت كتابة رمز finalizeDsl يعمل مع كل من المكوّنات الإضافية الحالية com.android.library وcom.android.application والمكوّن الإضافي الجديد com.android.kotlin.multiplatform.library، قد تحتاج إلى التحقّق من الأنواع في وقت التشغيل:
extensions.getByType<AndroidComponentsExtension<*, *, *>>().finalizeDsl { androidExtension ->
when(androidExtension) {
is CommonExtension<*, *, *, *, *, *> -> androidExtension.experimentalProperties["android.example"] = true
is KotlinMultiplatformAndroidLibraryExtension -> androidExtension.experimentalProperties["android.example"] = true
}
}
هذا تغيير قد يؤدي إلى عطل على مستوى المصدر فقط، ولن يؤثر في المكوّنات الإضافية الثنائية.
AGP 8.8
في ما يلي تعديلات مهمة على واجهة برمجة التطبيقات للإصدار 8.8 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
تم إيقاف إعدادات الموارد نهائيًا
إعدادات الموارد متوقفة نهائيًا اعتبارًا من الإصدار 8.8 من AGP. تم إجراء ذلك لأنّ AGP لم يعد يتيح كثافات الموارد المختلفة، ويتطلب Google Play Console الآن نشر التطبيقات كحِزم تطبيقات. لضبط اللغة، يمكنك تحديد اللغات التي يتيحها تطبيقك باستخدام لغة localeFilters DSL لربط إعدادات اللغة بالمراجع المقابلة.
AGP 8.0
في ما يلي تحديثات مهمة لواجهة برمجة التطبيقات في الإصدار 8.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
تمت إزالة Transform API
بدءًا من الإصدار 8.0 من "مكوّن Android الإضافي في Gradle"، تمت إزالة واجهة برمجة التطبيقات Transform. وهذا يعني أنّه ستتم إزالة جميع
الصفوف في الحزمة com.android.build.api.transform.
ستتم إزالة Transform API لتحسين أداء عملية الإنشاء. تفرض المشاريع التي تستخدم Transform API على "المكوّن الإضافي لنظام Gradle المتوافق مع Android" استخدام مسار أقل تحسينًا للإصدار، ما قد يؤدي إلى تراجعات كبيرة في أوقات الإصدار. من الصعب أيضًا استخدام Transform API ودمجها مع ميزات Gradle الأخرى، وتهدف واجهات برمجة التطبيقات البديلة إلى تسهيل توسيع نطاق AGP بدون التسبّب في مشاكل في الأداء أو صحة عملية الإنشاء.
واجهات برمجة التطبيقات البديلة
لا يوجد بديل واحد لواجهة Transform API، بل هناك واجهات برمجة تطبيقات جديدة ومخصّصة لكل حالة استخدام. تتوفّر جميع واجهات برمجة التطبيقات البديلة في مجموعة androidComponents
{}. تتوفّر واجهات برمجة التطبيقات هذه جميعها في الإصدار 7.2 من "مكوّن Android الإضافي لـ Gradle".
إتاحة تحويل الرموز الثنائية
لتحويل الرمز الثانوي، استخدِم واجهة برمجة التطبيقات Instrumentation API. بالنسبة إلى المكتبات، يمكنك
تسجيل قياس حالة التطبيق لفئات المشاريع على جهاز المستخدم فقط، أمّا بالنسبة إلى التطبيقات والاختبارات،
فيمكنك اختيار تسجيل قياس حالة التطبيق للفئات المحلية فقط أو لجميع
الفئات، بما في ذلك الاعتماديات المحلية والبعيدة. لاستخدام واجهة برمجة التطبيقات هذه، يتم تشغيل الأدوات بشكل مستقل في كل فئة، مع إمكانية وصول محدودة إلى الفئات الأخرى في مسار الفئة (لمزيد من المعلومات، يُرجى الاطّلاع على createClassVisitor()).
يؤدي هذا التقييد إلى تحسين أداء عمليات الإنشاء الكاملة والمتزايدة، ويحافظ على تبسيط واجهة برمجة التطبيقات. يتم تجهيز كل مكتبة بالتوازي بمجرد أن تصبح جاهزة، بدلاً من الانتظار حتى اكتمال عملية التجميع. بالإضافة إلى ذلك، يعني التغيير في فئة واحدة أنّه يجب إعادة قياس الفئات المتأثرة فقط في عملية إنشاء تزايدية. للاطّلاع على مثال على كيفية استخدام واجهة برمجة التطبيقات Instrumentation API، يمكنك الاطّلاع على وصفة تحويل الفئات باستخدام ASM في "مكوّن Android الإضافي لـ Gradle".
إتاحة إضافة الفئات التي تم إنشاؤها إلى تطبيقك
لإضافة صفوف أخرى تم إنشاؤها إلى التطبيق، استخدِم واجهة برمجة التطبيقات Artifacts مع
MultipleArtifact.ALL_CLASSES_DIRS. على وجه التحديد، استخدِم
artifacts.use(TaskProvider)
.wiredWith(...)
.toAppend(Artifact.Multiple)
باستخدام MultipleArtifact.ALL_CLASSES_DIRS لإلحاق أدلة إضافية
تم إنشاؤها بفئات المشروع. ستختار واجهة Artifacts API تلقائيًا
موقعًا فريدًا لإخراج مهمتك المخصّصة. يمكنك الاطّلاع على
وصفة addToAllClasses للحصول على مثال على كيفية استخدام واجهة برمجة التطبيقات هذه.
دعم التحويلات المستندة إلى تحليل البرنامج بالكامل
لتنفيذ عمليات التحويل استنادًا إلى تحليل البرنامج بالكامل، يمكن تحويل جميع الفئات معًا في مهمة واحدة. يجب استخدام هذا النهج بحذر لأنّ تكلفة أداء الإصدار أعلى بكثير من استخدام واجهة برمجة التطبيقات Instrumentation API. إذا كان المكوّن الإضافي يستخدم واجهة برمجة التطبيقات هذه، ننصحك بأن تكون عملية التحويل اختيارية لكل نوع إصدار، حتى يتمكّن مطوّر التطبيق من إيقافها لإصدارات التطوير.
لتسجيل مهمة تحوّل جميع الفئات معًا، يقدّم الإصدار 7.4 من المكوّن الإضافي لنظام Gradle المتوافق مع Android واجهة برمجة التطبيقات Artifacts.forScope. لتحويل جميع الفئات في المشروع الحالي، استخدِم Artifacts.forScope.PROJECT. لتحويل جميع الصفوف في المشروع الحالي والمشاريع المستورَدة وجميع التبعيات الخارجية، استخدِم Artifacts.forScope.ALL. يوضّح الرمز التالي كيفية استخدام Artifacts.forScope.ALL لتسجيل مهمة تحوّل جميع الفئات معًا:
variant.artifacts.forScope(ScopedArtifacts.Scope.ALL)
.use(taskProvider)
.toTransform(
ScopedArtifact.CLASSES,
ModifyClassesTask::allJars,
ModifyClassesTask::allDirectories,
ModifyClassesTask::output,
)
يمكنك الاطّلاع على وصفة modifyProjectClasses للحصول على مثال على كيفية استخدام واجهة برمجة التطبيقات هذه، ووصفة customizeAgpDsl للحصول على مثال على كيفية تسجيل الإضافات المخصّصة لأنواع إصدارات Android.
إذا لم تكن حالة الاستخدام الخاصة بك مشمولة في أي من واجهات برمجة تطبيقات AndroidComponents، يمكنك الإبلاغ عن خطأ.
تم نقل العديد من المكوّنات الإضافية الشائعة الاستخدام إلى واجهات برمجة التطبيقات الجديدة هذه، بما في ذلك المكوّن الإضافي لمراقبة الأداء في Firebase (الإصدار 1.4.1 متوافق مع الإصدار 8.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android) والمكوّن الإضافي Hilt Gradle (الإصدار 2.40.1 متوافق مع الإصدار 8.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android). سيساعد "مساعد ترقية" Android Gradle Plugin أيضًا مطوّري المشاريع في ترقية المكوّنات الإضافية الشائعة الاستخدام حسب الحاجة.
إذا كنت تستخدم Transform API من خلال مكوّن إضافي تابع لجهة خارجية، يمكنك إعلام المؤلف بأنّه يجب تحديث المكوّن الإضافي ليعمل مع واجهات برمجة التطبيقات الجديدة لـ AGP 8.0.
الإصدار 7.2 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"
في ما يلي تحديثات مهمة لواجهة برمجة التطبيقات في الإصدار 7.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
تم إيقاف RenderScript نهائيًا
بدءًا من الإصدار 7.2 من "مكوّن Android الإضافي في Gradle"، تم إيقاف واجهات برمجة تطبيقات RenderScript نهائيًا. وستستمر في العمل، ولكنها ستؤدي إلى ظهور تحذيرات، وستتم إزالتها تمامًا في الإصدارات المستقبلية من المكوّن الإضافي لنظام Gradle المتوافق مع Android. للحصول على إرشادات حول كيفية الانتقال من RenderScript، يُرجى الاطّلاع على نقل البيانات من RenderScript.
تم إيقاف Component.transformClassesWith وComponent.setAsmFramesComputationMode نهائيًا
بدءًا من الإصدار 7.2 من "مكوّن Android الإضافي في Gradle"، تم إيقاف واجهات برمجة التطبيقات الخاصة بأدوات رمز بايت للفئة نهائيًا
Component.transformClassesWith وComponent.setAsmFramesComputationMode. وقد تم نقلها إلى
مجموعة جديدة، Component.instrumentation، تحتوي على جميع واجهات برمجة التطبيقات ذات الصلة
بإعداد عملية القياس. لمواصلة استخدام ميزات القياس هذه، استخدِم واجهات برمجة التطبيقات المقابلة في المجموعة الجديدة بدلاً من ذلك، كما هو موضّح في مقتطف الرمز التالي:
androidComponents {
onVariants(selector().all(), {
instrumentation.transformClassesWith(AsmClassVisitorFactoryImpl.class,
InstrumentationScope.Project) { params ->
params.x = "value"
}
instrumentation.setAsmFramesComputationMode(
COMPUTE_FRAMES_FOR_INSTRUMENTED_METHODS
)
})
}