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

على غرار أداة إعداد الأجهزة المستهدَفة، تتيح أداة إعداد الأجهزة المتعدّدة إعداد أجهزة متعدّدة معًا. على سبيل المثال، سيتم استخدام هذا الإذن عند ربط جهازَين باستخدام البلوتوث لإجراء اختبار.

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

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

تقدّم أدوات إعداد المستندات المتعددة الأهداف أيضًا طريقة tearDown مباشرةً لتنفيذ أي عملية تنظيف.

الاقتراح

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

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

ما مِن حدّ أقصى لعدد الأجهزة التي يمكن لمعدّ مستندات متعددة الأهداف إعدادها. تتوفّر جميع الأجهزة في IInvocationContext من الواجهة لتنفيذها.

إعدادات XML

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

<multi_target_preparer class="com.android.tradefed.targetprep.multi.HelloWorldMultiTargetPreparer">
</multi_target_preparer>

ترتيب العمليات

1. ينفّذ multi_target_preparer setUp بعد target_preparer.
2. يتم تنفيذ multi_target_preparer tearDown قبل أدوات تنظيف الأهداف.

لا يتيح ذلك دائمًا تنفيذ جميع خطوات الإعداد، لذا من الممكن تحديد أداة الإعداد المتعددة الأهداف في ملف XML على النحو multi_pre_target_preparer وتنفيذها قبل مثيلات target_preparer.

<multi_pre_target_preparer class="com.android.tradefed.targetprep.multi.HelloWorldMultiTargetPreparer">
</multi_pre_target_preparer>

يكون ترتيب العمليات الإجمالي على النحو التالي:

1. multi_pre_target_preparer setUp
2. target_preparer setUp
3. multi_target_preparer setUp
4. multi_target_preparer tearDown
5. target_preparer tearDown
6. multi_pre_target_preparer tearDown

يمكن تعريف أي أداة إعداد متعددة الأهداف على أنّها multi_target_preparer أو multi_pre_target_preparer حسب ترتيب الإعداد المطلوب.