النماذج والعناصر التي يتم تضمينها في إعدادات مقايضة XML

إنّ إنشاء تنسيق XML واحد متجانس لتحديد الاختبار ليس دائمًا عملية. إذا كنت تريد إعادة استخدام جزء من الإعداد لإجراء اختبارات مماثلة، نسخ ملفي XML عملاقين والاحتفاظ به

هذا هو المكان الذي تظهر فيه علامتا template وinclude في إعدادات ملفات XML التجارية. التعريف سيكون مفيدًا. فهي تسمح لك بتعيين عناصر نائبة في ملف XML إضافة جزء من تهيئة XML أخرى.

مثال على تعريف للنماذج

<configuration description="Common base configuration for local runs with minimum overhead">
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <template-include name="preparers" default="empty" />

    <template-include name="test" default="empty" />

    <template-include name="reporters" default="empty" />
</configuration>

النماذج هي عناصر نائبة تحتوي على name للإشارة إليها، بالإضافة إلى عنصر اختياري. حقل default. يحدد الحقل التلقائي ملف XML الافتراضي الذي يكون تنبؤي.

لاستبدال نموذج لإعدادات معينة، الأمر التالي يجب إضافة المعلمة إلى سطر الأوامر:

--template:map <name of template>=<replacement XML config path>

--template:map preparers=empty

مثلاً:

<template-include name="preparers" default="empty" />

يشير مرجع empty في هذه الحالة إلى إعدادات empty.xml التي لا يحتوي على أي شيء؛ فإننا نستخدمه كمرجع لنا لاستبداله بلا شيء.

يمكن أن يكون مسار إعدادات XML مطلقًا أو مرتبطًا بمجلد res/config. داخل موارد JAR من Tradefed. وفي ما يلي بعض مواقعها الجغرافية:

• Tools/tradefederation/core/res/config
• Tools/tradefederation/core/tests/res/config
• Tools/tradedeferation/contrib/res/config

مثال على تعريف التضمين

<configuration description="Common base configuration for local runs with minimum overhead">
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <include name="empty"/>
</configuration>

تُعدّ عمليات التضمين أبسط من "النماذج" لأنّها لا تتطلّب وسيطات سطر أوامر. يتم توسيع ملف XML المُشار إليه مباشرةً في العلامة name. على غرار القوالب، يمكن أن يكون المسار إلى التهيئة مطلقًا أو نسبيًا. ومع ذلك، بالنسبة لـ includes ننصح باستخدام المسارات النسبية فقط لأنها أكثر قابلية للنقل في Tradefed. لن تكون المسارات المطلقة صالحة إذا تم نقل Tradefed إلى جهاز آخر.

الإعداد الخاطئ

في حال حدوث خطأ في الضبط، مثلاً عند تعذّر العثور على ملف XML البديل في حال تبادل القيمة، يتم عرض ConfigurationException مع وصف لما يبدو أنّه مفقودة أو تم إعدادها بشكل خاطئ.