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

تنفيذ الاستدعاء

public class InvocationExecution
extends Object implements IInvocationExecution

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

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

DelegateInvocationExecution ، ParentSandboxInvocationExecution ، RemoteInvocationExecution ، SandboxedInvocationExecution

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

فئة تصف جميع خطوات الاستدعاء: تنزيل البناء، و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.
`void`	`doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)` قم بتنفيذ خطوة الإعداد target_preparer وmulti_target_preparer.
`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)` امنح فرصة لتخصيص بعض أجزاء الجهاز قبل إعداد preInvocationSetup.
`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` لهذا التشغيل الاختباري.

com.doCleanUp

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

قم بتنفيذ خطوة التنظيف target_preparer وmulti_target_preparer. هل تنظف الأجهزة.

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

com.doSetup

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

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

حدود
`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)

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

حدود
`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` لنتائج الاختبار

تكوين القشرة

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`

الأساليب المحمية

اجمعAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

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

حدود
`config`	`IConfiguration`
`info`	`TestInformation`

رميات
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

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

عائدات
`IShardHelper`

CustomDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

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

حدود
`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`