اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

DelegatedInvocationExecution

public class DelegatedInvocationExecution
extends InvocationExecution

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

‫InvocationExecution التي تفوّض التنفيذ إلى ملف Tradefed ثنائي آخر.

ملخّص

الثوابت
`String`	`DELEGATED_MODE_VAR` في حال توفُّرها، يتم تنفيذ عملية الاستدعاء في وضع مفوَّض

الإنشاءات العامة
`DelegatedInvocationExecution()`

الطُرق العامة
`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.
`void`	`reportLogs(ITestDevice device, ITestLogger logger, 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)` حاوِل تقسيم الإعداد إلى إعدادات فرعية، ثم إعادة جدولة هذه الإعدادات الفرعية لتنفيذها على موارد متعددة بالتوازي.

الثوابت

DELEGATED_MODE_VAR

public static final String DELEGATED_MODE_VAR

إذا كان العنصر الحالي ينفّذ في وضع مفوّض

القيمة الثابتة: "DELEGATED_MODE"

الإنشاءات العامة

DelegatedInvocationExecution

public DelegatedInvocationExecution ()

الطُرق العامة

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

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

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

المعلمات
`device`	`ITestDevice`: الجهاز الذي سيتم إعداد التقارير منه.
`logger`	‫`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`