از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

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

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox گسترش می دهد

java.lang.object
↳	com.android.tradefed.sandbox.TradefedSandbox

ظرف سندباکس که می تواند فراخوانی فدراسیون تجارت را اجرا کند. TODO: اجازه دهید گزینه ها به جعبه شنی منتقل شوند.

خلاصه

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

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

روش های محافظت شده
`File`	`dumpGlobalConfig ( IConfiguration config, exclusionPatterns)` `dumpGlobalConfig ( IConfiguration config, exclusionPatterns)` پیکربندی جهانی فیلتر شده از برخی اشیاء را تخلیه کنید.
`Exception`	`prepareConfiguration (IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` `IConfiguration` را آماده کنید که به زیر فرآیند ارسال می شود و اجرای کانتینر را هدایت می کند.
`File`	`prepareContext (IInvocationContext context, IConfiguration config)` `IInvocationContext` را آماده و سریال کنید.

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

TradefedSandbox

public TradefedSandbox ()

روش های عمومی

createClasspath

public String createClasspath (File workingDir)

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

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

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

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

createThinLauncherConfig

public 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 اشاره دارد. اگر پیکربندی لانچر نازکی ایجاد نشود، پوچ برمی‌گرداند.

getTradefedSandboxEnvironment

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

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

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

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

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

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

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

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

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

اجرا کنید

public CommandResult run (IConfiguration config, 
                ITestLogger logger)

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

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

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

پاره کردن

public void tearDown ()

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

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

پیکربندی جهانی فیلتر شده از برخی اشیاء را تخلیه کنید.

پارامترها
`config`	`IConfiguration`
`exclusionPatterns`

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

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

آماده پیکربندی

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

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

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

برمی گرداند
`Exception`	یک استثنا اگر مشکلی پیش آمد، در غیر این صورت باطل است.

آماده کنتست

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

IInvocationContext را آماده و سریال کنید.

پارامترها
`context`	`IInvocationContext` : `IInvocationContext` که باید آماده شود.
`config`	`IConfiguration` : `IConfiguration` جعبه ماسه‌بازی.

برمی گرداند
`File`	`IInvocationContext` سریالی.