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

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

ParentSandboxInvocationExecution

public class ParentSandboxInvocationExecution
extends InvocationExecution

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

إصدار InvocationExecution لإجراءات الاستدعاء الخاصة بالعنصر الرئيسي عند تشغيل مساحة محاكاة

ملخّص

وظائف الإنشاء العامة
`ParentSandboxInvocationExecution()`

الطرق العامة
`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 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)` يُجري الاختبار.

الطرق المحمية
`IConfigurationFactory`	`getFactory()` تعرِض هذه السمة `IConfigurationFactory` المستخدَم لإنشاء الإعدادات.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` استرداد قائمة بإعدادات المختبرات لتشغيلها على هذا الجهاز
`IRunUtil`	`getRunUtil()`
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` استرداد قائمة بالمعدّين المستهدَفين لتشغيلها على هذا الجهاز
`boolean`	`prepareAndRunSandbox(TestInformation info, IConfiguration config, ITestInvocationListener listener)` تعرِض حالة النتيجة لتشغيل وضع الحماية الآمن.

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

ParentSandboxInvocationExecution

public ParentSandboxInvocationExecution ()

الطرق العامة

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 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` من نتائج الفحص

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

getFactory

protected IConfigurationFactory getFactory ()

تعرِض هذه السمة IConfigurationFactory المستخدَم لإنشاء الإعدادات.

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

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

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

المرتجعات

getRunUtil

protected IRunUtil getRunUtil ()

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

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

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

المرتجعات

prepareAndRunSandbox

protected boolean prepareAndRunSandbox (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

تعرِض حالة النتيجة لتشغيل وضع الحماية الآمن.

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

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