معدي الهدف

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

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

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

لاحظ أنه أثناء تشغيل المُعد قبل الوحدة، فإنه يتم تشغيله بعد أي مدقق لحالة النظام .