الدعاء
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) |
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 |
CustomDevicePreInvocation
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 |