تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الدعاء

public class InvocationExecution
extends Object implements IInvocationExecution

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

الفئات الفرعية المباشرة المعروفة

التفويضات التنفيذية ، ParentSandboxInvocationExecution ، RemoteInvocationExecution ، SandboxedInvocationExecution

تنفيذ المفوضين	`InvocationExecution` التنفيذ الذي يفوض التنفيذ إلى ثنائي Tradefed آخر.
ParentSandboxInvocationExecution	إصدار `InvocationExecution` لإجراءات استدعاء الأصل الخاصة عند تشغيل sandbox.
RemoteInvocationExecution	تنفيذ `InvocationExecution` الذي يقود التنفيذ عن بعد.
SandboxedInvocationExecution. التنفيذ	تنفيذ وضع الحماية الخاص للاستدعاء: هذا هو الاستدعاء عندما نكون داخل صندوق الحماية نقوم بتشغيل الأمر.

فئة تصف جميع خطوات الاستدعاء: إنشاء التنزيل ، 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)` قم باستدعاء `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`

تخصيص الجهاز

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`