اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

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

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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

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

‫DelegatedInvocationExecution وParentSandboxInvocationExecution وRemoteInvocationExecution وSandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` التي تفوض التنفيذ إلى ملف ثنائي آخر من Tradefed
ParentSandboxInvocationExecution	إصدار `InvocationExecution` لإجراءات الاستدعاء الخاصة بالعنصر الرئيسي عند تشغيل مساحة محاكاة
RemoteInvocationExecution	تنفيذ `InvocationExecution` الذي يؤدي إلى تنفيذ عن بُعد
SandboxedInvocationExecution	تنفيذ وضع الحماية الآمن الخاص لطلب التنفيذ: هذا هو 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)` نفِّذ خطوة cleanUp في 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`	`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

وظائف الإنشاء العامة

InvocationExecution

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)

نفِّذ خطوة cleanUp في target_preparer وmulti_target_preparer. هل يتم تنظيف الأجهزة؟

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

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)

الإبلاغ عن بعض سجلات الجهاز في مراحل مختلفة من الاستدعاء على سبيل المثال: 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`

runTests

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`.

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

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

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

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

عمليات الرمي
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

أنشئ IShardHelper ليتم استخدامه.

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

customizeDevicePreInvocation

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)

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

تم إلغاؤه في فئات وضع الحماية لحظر تشغيل أدوات إعداد المختبرات داخل وضع الحماية child

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

المرتجعات

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

استرداد قائمة بالمعدّين المستهدَفين لتشغيلها على هذا الجهاز

تم إلغاؤه في فئات وضع الحماية لحظر تشغيل أدوات إعداد المختبرات داخل وضع الحماية child

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

المرتجعات

linkExternalDirs

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`

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`