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

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

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

الواجهة الأساسية هي 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، وهو إعداد من المستوى الأعلى لاختبارات مجموعة أدوات اختبار التوافق مع Android (CTS).

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

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

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