أدوات إعداد ذات أهداف متعدّدة

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

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

الواجهة الأساسية هي 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 بناءً على ترتيب الإعداد المطلوب.