الدعاء
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
فئة تصف جميع خطوات الاستدعاء: إنشاء التنزيل ، target_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) قم باستدعاء |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) |
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 () إنشاء إرجاع |
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)
حدود | |
---|---|
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 |
تخصيص الجهاز
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
امنح فرصة لتخصيص بعض الأجهزة قبل الإعداد المسبق.
حدود | |
---|---|
config | IConfiguration : تكوين الاستدعاء. |
context | IInvocationContext : سياق الاستدعاء الحالي. |
getAdbVersion
protected String getAdbVersion ()
إرجاع إصدار adb المستخدم للاستدعاء.
عائدات | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
استرجع قائمة بأجهزة تحضير المعامل لتشغيلها على هذا الجهاز.
تم التجاوز في فصول وضع الحماية لتقييد مُعدّي المختبرات من العمل داخل بيئة الحماية الفرعية
حدود | |
---|---|
config | IConfiguration |
deviceName | String |
عائدات | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (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 |