IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

واجهة تصف الإجراءات التي سيتم تنفيذها كجزء من طلب. يضمن طلب الإجراء TestInvocation نفسه ترتيب المكالمات.

ملخّص

الطرق العامة

default void cleanUpBuilds(IInvocationContext context, IConfiguration config)

نفِّذ خطوة تنظيف build_provider.

default void doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)

نفِّذ خطوة cleanUp في target_preparer وmulti_target_preparer.

default void doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)

نفِّذ خطوة إعداد target_preparer وmulti_target_preparer.

default void doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

نفِّذ خطوة إيقاف target_preparer وmulti_target_preparer.

default boolean fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

نفِّذ خطوة build_provider من طلب التشغيل.

abstract void reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)

الإبلاغ عن بعض سجلات الجهاز في مراحل مختلفة من الاستدعاء

default void runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)

استخدِم ITestDevice.postInvocationTearDown(Throwable) لكل جزء من أجزاء الاستدعاء الخاص بالجهاز.

default void runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)

استخدِم ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) لكل جزء من أجزاء الاستدعاء الخاص بالجهاز.

default void runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)

يُجري الاختبار.

default boolean shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

حاوِل تقسيم الإعداد إلى إعدادات فرعية، وإعادة جدولتها لتشغيلها على موارد متعددة بشكل متزامن.

الطرق العامة

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

نفِّذ خطوة تنظيف build_provider. مرتبط بجلب الإصدار.

المعلمات
context ‫IInvocationContext: IInvocationContext الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

نفِّذ خطوة cleanUp في target_preparer وmulti_target_preparer. هل يتم تنظيف الأجهزة؟

المعلمات
context ‫IInvocationContext: IInvocationContext الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.
exception Throwable: الاستثناء الأصلي الذي تم طرحه أثناء تشغيل الاختبار.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

نفِّذ خطوة إعداد target_preparer وmulti_target_preparer. هل تم إعداد جميع الأجهزة المطلوبة لإجراء الاختبار؟

المعلمات
testInfo ‫TestInformation: TestInformation الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.
logger ITestLogger: ITestLogger للإبلاغ عن سجلات أخطاء الإعداد
عمليات الرمي
com.android.tradefed.targetprep.TargetSetupError
com.android.tradefed.targetprep.BuildError
com.android.tradefed.device.DeviceNotAvailableException
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

نفِّذ خطوة إيقاف target_preparer وmulti_target_preparer. هل يتم إيقاف الأجهزة المرتبطة بالإعداد؟

المعلمات
testInfo ‫TestInformation: TestInformation الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.
logger ITestLogger: ITestLogger للإبلاغ عن السجلات
exception Throwable: الاستثناء الأصلي الذي تم طرحه أثناء تشغيل الاختبار.
عمليات الرمي
Throwable

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

نفِّذ خطوة build_provider من طلب التشغيل.

المعلمات
testInfo ‫TestInformation: TestInformation الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.
rescheduler ‫IRescheduler: IRescheduler، لإعادة جدولة أجزاء من الطلب لتنفيذه على موارد أخرى

listener ITestInvocationListener: ITestInvocation للإبلاغ عن حالات تعذُّر تنزيل الإصدار
المرتجعات
boolean صحيح إذا تم تنزيل الإصدار بنجاح، وخطأ في الحالات الأخرى.
عمليات الرمي
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.device.DeviceNotAvailableException
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

الإبلاغ عن بعض سجلات الجهاز في مراحل مختلفة من الاستدعاء على سبيل المثال: logcat

المعلمات
device ITestDevice: الجهاز الذي يتم الإبلاغ عن السجلات منه
logger ITestLogger: أداة تسجيل السجلات
stage TestInvocation.Stage: المرحلة التي وصلنا إليها في عملية الاستدعاء

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

استخدِم ITestDevice.postInvocationTearDown(Throwable) لكل جزء من أجزاء الاستدعاء الخاص بالجهاز.

المعلمات
context ‫IInvocationContext: IInvocationContext الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.
exception ‫Throwable: الاستثناء الأصلي الذي تم طرحه أثناء تشغيل الاختبار، إن توفّر.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

استخدِم ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) لكل جزء من أجزاء الاستدعاء الخاص بالجهاز.

المعلمات
context ‫IInvocationContext: IInvocationContext الاستدعاء
config IConfiguration: IConfiguration من عملية الاختبار هذه.
logger ITestLogger: ITestLogger للإبلاغ عن السجلات
عمليات الرمي
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

يُجري الاختبار.

المعلمات
info TestInformation: TestInformation لإجراء الاختبارات.
config IConfiguration: IConfiguration المطلوب تنفيذه
listener ITestInvocationListener: ITestInvocationListener من نتائج الفحص
عمليات الرمي
Throwable

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

حاوِل تقسيم الإعداد إلى إعدادات فرعية، وإعادة جدولتها لتشغيلها على موارد متعددة بشكل متزامن.

إذا كان عدد الأجزاء أكبر من 1، سيتم ببساطة إنشاء إعدادات لكل جزء من خلال ضبط فهارس الأجزاء وإعادة جدولتها. في حال عدم ضبط عدد الأجزاء، سيتم الرجوع إلى IShardHelper.shardConfig.

المعلمات
config ‫IConfiguration: IConfiguration الحالي
testInfo TestInformation: TestInformation التي تتضمّن معلومات عن الاختبارات
rescheduler IRescheduler: IRescheduler
logger ITestLogger: ITestLogger المستخدَم لتسجيل الملف أثناء التجزئة
المرتجعات
boolean صحيح إذا تم تقسيم الاختبار. بخلاف ذلك، يُرجى إدخال false.