ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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

خلاصه

روش های عمومی

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 ()

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