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

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

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

الواجهة الأساسية هي 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) في Android.

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

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

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