از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار ترانک و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، android-latest-release استفاده کنید. شاخه مانیفست android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

اجرای فراخوانی ParentSandbox

public class ParentSandboxInvocationExecution
extends InvocationExecution

شیء جاوا
↳	com.android.tradefed.invoker.InvocationExecution
	↳	com.android.tradefed.invoker.sandbox.ParentSandboxInvocationExecution

نسخه‌ای از InvocationExecution برای اقدامات ویژه فراخوانی والد هنگام اجرای یک sandbox.

خلاصه

سازندگان عمومی
`ParentSandboxInvocationExecution ()`

روش‌های عمومی
`void`	`doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception)` مراحل پاکسازی 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` مورد استفاده برای پیکربندی‌های ایجاد شده را برمی‌گرداند.
`List< ITargetPreparer >`	`getLabPreparersToRun ( IConfiguration config, String deviceName)` فهرستی از آماده‌سازهای آزمایشگاهی برای اجرا روی این دستگاه را بازیابی کنید.
`IRunUtil`	`getRunUtil ()`
`List< ITargetPreparer >`	`getTargetPreparersToRun ( IConfiguration config, String deviceName)` فهرستی از آماده‌سازهای هدف برای اجرا روی این دستگاه را بازیابی کنید.
`boolean`	`prepareAndRunSandbox ( TestInformation info, IConfiguration config, ITestInvocationListener listener)` وضعیت نتیجه اجرای sandbox را برمی‌گرداند.

سازندگان عمومی

اجرای فراخوانی ParentSandbox

public ParentSandboxInvocationExecution ()

روش‌های عمومی

انجام پاکسازی

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

مراحل پاکسازی target_preparer و multi_target_preparer را اجرا کنید. آیا دستگاه‌ها پاکسازی می‌شوند؟

پارامترها
`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`

کالبدشکافی

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` : استثنای اصلی که توسط اجرای آزمایشی ایجاد می‌شود.

پرتاب‌ها
`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` برای گزارش خطاهای دانلود build.

بازگشت‌ها
`boolean`	اگر با موفقیت نسخهٔ نهایی را دانلود کرده باشیم، مقدار درست (true) و در غیر این صورت مقدار نادرست (false) خواهد بود.

پرتاب‌ها
`BuildRetrievalError`
`DeviceNotAvailableException`

گزارش‌ها

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

گزارش برخی از گزارش‌های دستگاه در مراحل مختلف فراخوانی. به عنوان مثال: logcat.

پارامترها
`device`	`ITestDevice` : دستگاهی که گزارش‌های لاگ از آن گرفته می‌شود.
`logger`	`ITestLogger` : ثبت‌کننده‌ی گزارش‌ها.
`stage`	`TestInvocation.Stage` : مرحله‌ای از فراخوانی که در آن هستیم.

runDevicePostInvocationقطع ارتباط

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

برای هر بخش دستگاه از فراخوانی ITestDevice.postInvocationTearDown(Throwable) را فراخوانی کنید.

پارامترها
`context`	`IInvocationContext` : همان `IInvocationContext` مربوط به فراخوانی است.
`config`	`IConfiguration` : `IConfiguration` مربوط به این اجرای آزمایشی.
`exception`	`Throwable` : استثنای اصلی که توسط تست در حال اجرا در صورت وجود، ایجاد می‌شود.

اجرای تنظیمات پیش از فراخوانی دستگاه

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` از نتایج تست

پرتاب‌ها
`Throwable`

روش‌های محافظت‌شده

کارخانه را دریافت کنید

protected IConfigurationFactory getFactory ()

IConfigurationFactory مورد استفاده برای پیکربندی‌های ایجاد شده را برمی‌گرداند.

بازگشت‌ها
`IConfigurationFactory`

آماده‌سازان برای اجرای آزمایشگاه

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

فهرستی از آماده‌سازهای آزمایشگاهی برای اجرا روی این دستگاه را بازیابی کنید.

در کلاس‌های sandbox لغو شده است تا مانع از اجرای آماده‌سازهای آزمایشگاهی در داخل کلاس فرزند sandbox شود.

پارامترها
`config`	`IConfiguration`
`deviceName`	`String`

بازگشت‌ها
`List< ITargetPreparer >`

دریافت RunUtil

protected IRunUtil getRunUtil ()

بازگشت‌ها
`IRunUtil`

دریافت هدفآماده‌کنندگانبرایاجرا

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

فهرستی از آماده‌سازهای هدف برای اجرا روی این دستگاه را بازیابی کنید.

در کلاس‌های sandbox لغو شده است تا مانع از اجرای آماده‌کننده‌های آزمایشگاهی در داخل کلاس فرزند sandbox شود.

پارامترها
`config`	`IConfiguration`
`deviceName`	`String`

بازگشت‌ها
`List< ITargetPreparer >`

آماده‌سازیAndRunSandbox

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

وضعیت نتیجه اجرای sandbox را برمی‌گرداند.

پارامترها
`info`	`TestInformation`
`config`	`IConfiguration`
`listener`	`ITestInvocationListener`

بازگشت‌ها
`boolean`

پرتاب‌ها
`Throwable`