جهات إعداد مستهدفة

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

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

الواجهة الأساسية هي 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 وحدة CTS backup.

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