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

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

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

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