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

الدعاء

public class InvocationExecution
extends Object implements IInvocationExecution

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

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

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

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

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