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

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

زیر کلاس های غیر مستقیم شناخته شده

TradefedSandbox ظرف سندباکس که می تواند فراخوانی فدراسیون تجارت را اجرا کند.

رابطی که یک جعبه شنی را تعریف می کند که می تواند برای اجرای فراخوانی استفاده شود.

خلاصه

روش های عمومی
`abstract String`	`createClasspath (File workingDir)` یک classpath بر اساس محیط و دایرکتوری کاری که توسط `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])` ایجاد کنید.
`abstract IConfiguration`	`createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` حالت ویژه از اجرای اصلی قطع شده است: هنگامی که به نظر می‌رسد پیکربندی در والد وجود ندارد، به راه‌انداز نازک باز می‌گردیم که در آن سعی می‌کنیم جعبه ایمنی را با اطلاعات شناخته شده فعلی تنظیم کنیم و دایرکتوری کاری را پر می‌کنیم تا پیکربندی را به طور کامل در مسیر نسخه‌سازی شده ایجاد کنیم. .
`default`	`discoverTests ( IInvocationContext context, IConfiguration configuration)` یک مرحله فرعی از `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` که تست‌های قابل کشف در صورتی که `SandboxOptions.shouldUseTestDiscovery()` .
`default`	`discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args)` مرحله فرعی `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` که فایل های اضافی مورد نیاز برای sandbox را واکشی می کند.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` محیط sandbox TF را برمی‌گرداند تا براساس آرگومان‌های خط فرمان استفاده شود.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` محیط را برای اجرای صحیح سندباکس آماده کنید.
`abstract CommandResult`	`run ( TestInformation info, IConfiguration configuration, ITestLogger logger)` sandbox را با محیطی که تنظیم شده است اجرا کنید.
`abstract void`	`tearDown ()` هر وضعیت، فایل یا محیطی را که ممکن است تغییر کرده باشد را پاک کنید.

روش های عمومی

createClasspath

public abstract String createClasspath (File workingDir)

یک classpath بر اساس محیط و دایرکتوری کاری که توسط getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) ایجاد کنید.

پارامترها
`workingDir`	`File` : دایرکتوری فعلی در حال کار برای sandbox.

برمی گرداند
`String`	مسیر کلاسی که باید استفاده شود.

پرتاب می کند
`ConfigurationException`

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

حالت ویژه از اجرای اصلی قطع شده است: هنگامی که به نظر می‌رسد پیکربندی در والد وجود ندارد، به راه‌انداز نازک باز می‌گردیم که در آن سعی می‌کنیم جعبه ایمنی را با اطلاعات شناخته شده فعلی تنظیم کنیم و دایرکتوری کاری را پر می‌کنیم تا پیکربندی را به طور کامل در مسیر نسخه‌سازی شده ایجاد کنیم. .

پارامترها
`args`	`String` : خط فرمان اصلی آرگ می شود.
`keyStoreClient`	`IKeyStoreClient` : کلاینت ذخیره کلید فعلی که برای ایجاد تنظیمات استفاده می شود.
`runUtil`	`IRunUtil` : `IRunUtil` فعلی برای اجرای دستورات میزبان.
`globalConfig`	`File` : پیکربندی جهانی برای اجرای زیرفرایندهای TF.

برمی گرداند
`IConfiguration`	یک فایل که به پیکربندی XML TF برای اشیاء NON_VERSIONED اشاره دارد. اگر پیکربندی لانچر نازکی ایجاد نشود، پوچ برمی‌گرداند.

کشف تست ها

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

یک مرحله فرعی از prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) که تست‌های قابل کشف در صورتی که SandboxOptions.shouldUseTestDiscovery() .

پارامترها
`context`	`IInvocationContext` : فراخوان فعلی `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` برای اجرای دستور.

برمی گرداند
	نقشه آزمایش‌های کشف‌شده یا در صورت عدم پشتیبانی یا عدم موفقیت، صفر است.

کشف تست ها

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

پارامترها
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

برمی گرداند

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

مرحله فرعی prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) که فایل های اضافی مورد نیاز برای sandbox را واکشی می کند.

پارامترها
`context`	`IInvocationContext` : فراخوان فعلی `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` برای اجرای دستور.
`args`	`String` : آرگومان های خط فرمان.

برمی گرداند
`IFolderBuildInfo`	ساخت واکشی شده برای فایل های سندباکس اضافی.

پرتاب می کند
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	IOException
`BuildRetrievalError`
`ConfigurationException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

محیط sandbox TF را برمی‌گرداند تا براساس آرگومان‌های خط فرمان استفاده شود.

پارامترها
`context`	`IInvocationContext` : `IInvocationContext` والد.
`nonVersionedConfig`	`IConfiguration` : `IConfiguration` که نشان دهنده اشیاء نسخه نشده است.
`args`	`String` : آرگومان های خط فرمان.

برمی گرداند
`File`	یک دایرکتوری `ERROR(/File)` حاوی شیشه های محیط جعبه ایمنی TF.

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

پارامترها
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

برمی گرداند
`File`

محیط زیست را آماده کنید

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

محیط را برای اجرای صحیح سندباکس آماده کنید.

پارامترها
`context`	`IInvocationContext` : فراخوان فعلی `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` برای اجرای دستور.
`listener`	`ITestInvocationListener` : فراخوانی فعلی `ITestInvocationListener` که در آن نتایج نهایی باید لوله شود.

برمی گرداند
`Exception`	یک `Exception` شامل شکست. یا در صورت موفقیت نول.

اجرا کنید

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

sandbox را با محیطی که تنظیم شده است اجرا کنید.

پارامترها
`info`	`TestInformation` : `TestInformation` که فراخوان را توصیف می کند
`configuration`	`IConfiguration` : `IConfiguration` برای اجرای دستور.
`logger`	`ITestLogger` : یک `ITestLogger` که در آن می‌توانیم فایل‌ها را ثبت کنیم.

برمی گرداند
`CommandResult`	یک `CommandResult` با وضعیت اجرای سندباکس و گزارش‌ها.

پاره کردن

public abstract void tearDown ()

هر وضعیت، فایل یا محیطی را که ممکن است تغییر کرده باشد را پاک کنید.