مُعدّو التقارير المستهدَفون

يتم استدعاء أدوات إعداد الأهداف قبل الاختبارات في الـ مستوى الاختبار الذي تم تحديدها فيه. ويسمح ذلك بإعداد أي جهاز لإجراء الاختبارات بسلاسة.

الواجهة الأساسية

الواجهة الأساسية هي ITargetPreparer، التي تسمح بتنفيذ طريقة setUp ليتم تنفيذها. ننصح بتنفيذ فئة أساسية مجرّدة BaseTargetPreparer، التي توفّر ميزة إيقاف مدمجة لإيقاف أداة إعداد بسهولة.

واجهة أبسط

الامتداد الطبيعي لـ setUp هو tearDown، ويتم توفيره من خلال واجهة مختلفة، هي ITargetCleaner. توفّر هذه الواجهة واجهة tearDown التي تسمح بتنظيف أي شيء تم إجراؤه في setUp بعد تنفيذ الاختبار.

تمتد فئة BaseTargetPreparer أيضًا إلى ITargetCleaner.

الاقتراحات

ننصح بأن تقتصر كل أداة إعداد على وظيفة رئيسية واحدة، مثل تثبيت ملف APK أو تنفيذ أمر. يسمح ذلك بإعادة استخدام أدوات الإعداد بسهولة أكبر.

يُرجى أيضًا الاطّلاع على قائمة أدوات الإعداد المتاحة قبل إضافة أداة جديدة لتجنُّب تكرار العمل. تتوفّر أدوات الإعداد في tools/tradefederation/core/src/com/android/tradefed/targetprep/.

ملف إعداد XML

علامة الكائن هي target_preparer، على سبيل المثال:

<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
    <option name="install-arg" value="-d"/>
</target_preparer>

يُرجى أيضًا الرجوع إلى إعداد المجموعات للحصول على السياق.

الإعداد على المستوى الأعلى

إذا تم تحديد أداة الإعداد في عملية إعداد على المستوى الأعلى، يتم تشغيلها مرة واحدة فقط لكل جهاز. أحد الأمثلة على ذلك هو cts-common.xml، وهو إعداد على المستوى الأعلى لاختبارات "مجموعة أدوات اختبار التوافق" (CTS).

الإعداد على مستوى الوحدة

إذا تم تحديد أداة الإعداد على مستوى الوحدة، يتم تشغيلها دائمًا قبل تلك الوحدة. أحد الأمثلة على ذلك هو backup/AndroidTest.xml, الذي يحدّد كيفية تشغيل Tradefed لوحدة backup في CTS.

يُرجى العِلم أنّه على الرغم من تشغيل أداة الإعداد قبل الوحدة، يتم تشغيلها بعد أي أدوات تحقّق من حالة النظام.