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.device.DeviceNotAvailableException
com.android.tradefed.targetprep.BuildError
com.android.tradefed.targetprep.TargetSetupError
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: الاستثناء الأصلي الذي تم طرحه أثناء تنفيذ الاختبار.
عمليات الطرح
java.lang.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 نتائج الاختبار
عمليات الطرح
java.lang.Throwable
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