الدعاء

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
com.android.tradefed.invoker.InvocationExecution


فئة تصف جميع خطوات الاستدعاء: إنشاء التنزيل ، والهدف_prep ، وتشغيل الاختبارات ، والتنظيف. يمكن تمديده لتجاوز السلوك الافتراضي لبعض الخطوات. ترتيب الخطوات مدفوع بواسطة TestInvocation .

ملخص

مجالات

public static final String ADB_VERSION_KEY

public static final String JAVA_CLASSPATH_KEY

public static final String JAVA_VERSION_KEY

المنشئون العامة

InvocationExecution ()

الطرق العامة

void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

قم بتنفيذ خطوة تنظيف build_provider.

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

نفّذ الخطوة target_preparer و multi_target_preparer cleanUp.

void doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)

نفذ الخطوة target_preparer و multi_target_preparer setUp.

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

نفِّذ خطوة تمزيق target_preparer و multi_target_preparer.

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

نفّذ خطوة build_provider من الاستدعاء.

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

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

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

ITestDevice#postInvocationTearDown(Throwable) لكل جزء من أجزاء الجهاز في الاستدعاء.

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)) .

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

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

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

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

الطرق المحمية

void collectAutoInfo ( IConfiguration config, TestInformation info)

اجمع بعض المعلومات تلقائيًا على الجهاز الأساسي قيد الاختبار.

IShardHelper createShardHelper ()

قم بإنشاء إرجاع IShardHelper ليتم استخدامه.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

امنح فرصة لتخصيص بعض الأجهزة قبل الإعداد المسبق.

String getAdbVersion ()

إرجاع إصدار adb المستخدم للاستدعاء.

getLabPreparersToRun ( IConfiguration config, String deviceName)

استرجع قائمة بأجهزة تحضير المعامل لتشغيلها على هذا الجهاز.

getTargetPreparersToRun ( IConfiguration config, String deviceName)

استرجع قائمة المُعدِّين المستهدفين للتشغيل على هذا الجهاز.

void logHostAdb ( IConfiguration config, ITestLogger logger)

اجمع السجلات من $ TMPDIR / adb $ UID.log.

Throwable runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)
void setTestTag ( IBuildInfo info, IConfiguration config)

التعامل مع إعداد علامة الاختبار على معلومات البناء.

مجالات

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

المنشئون العامة

الدعاء

public InvocationExecution ()

الطرق العامة

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)

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

المعلمات
context IInvocationContext : IInvocationContext الخاص بالاستدعاء.

config IConfiguration : تكوين IConfiguration لهذا الاختبار التجريبي.

exception Throwable : الاستثناء الأصلي الذي تم طرحه بواسطة الاختبار قيد التشغيل.

doSetup

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

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

المعلمات
testInfo TestInformation : TestInformation الاحتجاج.

config IConfiguration : تكوين IConfiguration لهذا الاختبار التجريبي.

listener ITestLogger : ITestLogger للإبلاغ عن سجلات فشل الإعداد.

رميات
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 : الاستثناء الأصلي الذي تم طرحه بواسطة الاختبار قيد التشغيل.

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 صحيح إذا نجحنا في تنزيل الإصدار ، فسيكون خطأ بخلاف ذلك.

رميات
BuildRetrievalError
DeviceNotAvailableException

ReportLogs

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

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

المعلمات
device ITestDevice : الجهاز المراد الإبلاغ عن السجلات منه.

listener 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 للإبلاغ عن السجلات.

رميات
DeviceNotAvailableException
TargetSetupError

تشغيل الاختبارات

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

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

المعلمات
info TestInformation : TestInformation لإجراء الاختبارات باستخدام.

config IConfiguration : رمز IConfiguration للتشغيل

listener ITestInvocationListener : ITestInvocationListener لنتائج الاختبار

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

الطرق المحمية

جمع المعلومات التلقائية

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

اجمع بعض المعلومات تلقائيًا على الجهاز الأساسي قيد الاختبار.

المعلمات
config IConfiguration

info TestInformation

رميات
DeviceNotAvailableException

خلق قويالمساعدة

protected IShardHelper createShardHelper ()

قم بإنشاء إرجاع IShardHelper ليتم استخدامه.

عائدات
IShardHelper

CustomDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

امنح فرصة لتخصيص بعض الأجهزة قبل الإعداد المسبق.

المعلمات
config IConfiguration : تكوين الاستدعاء.

context IInvocationContext : سياق الاستدعاء الحالي.

getAdbVersion

protected String getAdbVersion ()

إرجاع إصدار adb المستخدم للاستدعاء.

عائدات
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

استرجع قائمة بأجهزة تحضير المعامل لتشغيلها على هذا الجهاز.

تم التجاوز في فصول وضع الحماية لتقييد مُعدّي المختبرات من العمل داخل بيئة الحماية الفرعية

المعلمات
config IConfiguration

deviceName String

عائدات

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

استرجع قائمة المُعدِّين المستهدفين للتشغيل على هذا الجهاز.

تم التجاوز في فصول وضع الحماية لتقييد مُعدّي المختبرات من العمل داخل بيئة الحماية الفرعية

المعلمات
config IConfiguration

deviceName String

عائدات

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

اجمع السجلات من $ TMPDIR / adb $ UID.log.

المعلمات
config IConfiguration

logger ITestLogger

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

المعلمات
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

trackPreparersMap

عائدات
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

التعامل مع إعداد علامة الاختبار على معلومات البناء.

المعلمات
info IBuildInfo

config IConfiguration