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

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

گوگل تریدفد سندباکس

public class GoogleTradefedSandbox
extends TradefedSandbox

شیء جاوا
↳	com.android.tradefed.sandbox.TradefedSandbox
	↳	com.google.android.tradefed.sandbox.GoogleTradedefedSandbox

تخصص داخلی TradefedSandbox برای استفاده در زیرساخت آزمایشگاهی. این امر نیاز به دانلود نسخه مناسب مرتبط با ساخت را برطرف می‌کند. اگر روزی بتوانیم برای دانلود ساخت‌ها به API AOSP تکیه کنیم، ممکن است بتوانیم این را به AOSP منتقل کنیم.

خلاصه

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

روش‌های عمومی
`String`	`createClasspath (File workingDir)` سندباکس تجاری گوگل فقط از فایل‌های jar داخل دایرکتوری کاری استفاده می‌کند.
`IConfiguration`	`createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` حالت ویژه جدا از اجرای اصلی: وقتی به نظر نمی‌رسد پیکربندی در والد وجود داشته باشد، به thin launcher برمی‌گردیم که در آن سعی می‌کنیم sandbox را با اطلاعات شناخته‌شده‌ی فعلی راه‌اندازی کنیم و دایرکتوری کاری را پر کنیم تا پیکربندی به‌طور کامل در دایرکتوری نسخه‌بندی‌شده ایجاد شود.
`Map<String, List<String>>`	`discoverTests ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger)`
`IFolderBuildInfo`	`fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)`
`File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`void`	`tearDown ()` هر حالت، فایل یا محیطی را که ممکن است تغییر کرده باشد، پاک کنید.

روش‌های محافظت‌شده
`File`	`dumpGlobalConfig ( IConfiguration config, Set<String> exclusionPatterns)` پیکربندی سراسری فیلتر شده از برخی اشیاء را حذف کنید.
`File`	`prepareContext ( IInvocationContext context, IConfiguration config)` `IInvocationContext` را آماده و سریالایز کنید.

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

گوگل تریدفد سندباکس

public GoogleTradefedSandbox ()

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

ایجادکلاس‌مسیر

public String createClasspath (File workingDir)

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

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

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

پرتاب‌ها
`ConfigurationException`

ایجادThinLauncherConfig

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

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

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

بازگشت‌ها
`IConfiguration`	فایلی که به پیکربندی XML مربوط به TF برای اشیاء NON_VERSIONED اشاره می‌کند. در صورتی که نتوان پیکربندی thin launcher ایجاد کرد، مقدار null را برمی‌گرداند.

کشف تست‌ها

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger)

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

بازگشت‌ها
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

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

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

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

پرتاب‌ها
`BuildRetrievalError`
`ConfigurationException`
`IOException`

محیط getTradedefedSandbox

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

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

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

پرتاب‌ها
`Exception`

اشک‌ریزان

public void tearDown ()

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

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

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

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

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

پرتاب‌ها
`ConfigurationException`
`IOException`

آماده‌سازیزمینه

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

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

پارامترها
`context`	`IInvocationContext` : `IInvocationContext` که باید آماده شود.
`config`	`IConfiguration` : `IConfiguration` مربوط به محیط سندباکس.

بازگشت‌ها
`File`	`IInvocationContext` سریالیزه شده.

پرتاب‌ها
`IOException`