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

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

public class InvocationExecution
extends Object implements IInvocationExecution

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

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

AuthorizedInvocationExecution وParentSandboxInvocationExecution وRemoteInvocationExecution وSandboxedInvocationExecution

تنفيذ الاستدعاء المفوَّض	`InvocationExecution` الذي يفوّض التنفيذ إلى برنامج ثنائي آخر من Tradefed.
ParentSandboxInvocationExecution	إصدار `InvocationExecution` للإجراءات الخاصة للاستدعاء الرئيسي عند تشغيل وضع الحماية.
تنفيذ الاستدعاء عن بُعد	تنفيذ `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.
`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)` يمكنك منح فرصة لتخصيص بعض الجهاز قبل إعداد PreInvocation Setup.
`String`	`getAdbVersion()` عرض نسخة adb المستخدَمة للاستدعاء.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` استرجع قائمة بأدوات إعداد المختبرات لتشغيلها على هذا الجهاز.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` استرجع قائمة بأدوات الاستعداد المستهدفة لتشغيلها على هذا الجهاز.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`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)`
`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 ()

الطرق العامة

عمليات التنظيف

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`: الاستثناء الأصلي الذي تم طرحه من خلال إجراء الاختبار.

إعداد

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`

دوTeardown

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`: الاستثناء الأصلي الذي تم طرحه من خلال إجراء الاختبار.

إنشاء الجلب

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`

سجلات التقارير

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`

اختبارات Run

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`	true إذا تم تجزئة الاختبار. في الحالات الأخرى، يجب إرجاع مبلغ `false`.

الطرق المحمية

جمع AutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

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

المعلمات
`config`	`IConfiguration`
`info`	`TestInformation`

الرميات
`DeviceNotAvailableException`

CreateShardHelper

protected IShardHelper createShardHelper ()

أنشئ عملية إرجاع IShardHelper لاستخدامها.

المرتجعات
`IShardHelper`

تخصيص معرف الجهاز

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

يمكنك منح فرصة لتخصيص بعض الجهاز قبل إعداد PreInvocation Setup.

المعلمات
`config`	`IConfiguration`: إعدادات الاستدعاء.
`context`	`IInvocationContext`: سياق الاستدعاء الحالي

getAdbVersion

protected String getAdbVersion ()

عرض نسخة adb المستخدَمة للاستدعاء.

المرتجعات
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

استرجع قائمة بأدوات إعداد المختبرات لتشغيلها على هذا الجهاز.

تم تجاوزها في فئات وضع الحماية لمنع تشغيل برامج تحضير المعمل داخل وضع الحماية ابن/ابنة

المعلمات
`config`	`IConfiguration`
`deviceName`	`String`

المرتجعات

الحصول على عناصر التحكّم في الاستهداف

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

استرجع قائمة بأدوات الاستعداد المستهدفة لتشغيلها على هذا الجهاز.

تم تجاوزها في فئات وضع الحماية لمنع تشغيل برامج تحضير المعمل داخل وضع الحماية ابن/ابنة

المعلمات
`config`	`IConfiguration`
`deviceName`	`String`

المرتجعات

الرابط الخارجي

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

المعلمات
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

LogHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

اجمَع السجلات من $TMPDIR/adb.$UID.log.

المعلمات
`config`	`IConfiguration`
`logger`	`ITestLogger`

جري

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`