TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

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

خلاصه

ثابت‌ها

String EXTRA_TARGET_LAB

String GENERAL_TESTS_ZIP

String SANDBOX_ENABLED

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

TradefedSandbox ()

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

String createClasspath (File workingDir)

یک classpath بر اساس محیط و دایرکتوری کاری برگردانده شده توسط getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) ایجاد کنید.

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

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

File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

با توجه به نام پیکربندی آزمایشی، اهداف ساخت اضافی را از اهداف ساخت اضافی Sandbox مطابقت دهید.

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

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

static String[] removeIncompatibleFlags (String[] args)
CommandResult run ( TestInformation info, IConfiguration config, ITestLogger logger)

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

void tearDown ()

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

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

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

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

String getJava ()
Exception prepareConfiguration ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

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

File prepareContext ( IInvocationContext context, IConfiguration config)

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

ثابت‌ها

آزمایشگاه هدف اضافی 

public static final String EXTRA_TARGET_LAB

مقدار ثابت: "آزمایشگاه"

فایل فشرده آزمون‌های عمومی 

public static final String GENERAL_TESTS_ZIP

مقدار ثابت: "general-tests.zip"

فعال بودن جعبه شنی (SANDBOX_ENABLED) 

public static final String SANDBOX_ENABLED

مقدار ثابت: "SANDBOX_ENABLED"

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

TradefedSandbox 

public TradefedSandbox ()

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

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

public String createClasspath (File workingDir)

یک classpath بر اساس محیط و دایرکتوری کاری برگردانده شده توسط getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) ایجاد کنید.

پارامترها
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 را برمی‌گرداند.

محیط getTradedefedSandbox 

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

پارامترها
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

بازگشت‌ها
File

پرتاب‌ها
Exception

matchSandboxExtraBuildTargetByConfigName 

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

با توجه به نام پیکربندی آزمایشی، اهداف ساخت اضافی را از اهداف ساخت اضافی Sandbox مطابقت دهید.

پارامترها
configName String

بازگشت‌ها
Set<String>

آماده‌سازی محیط 

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

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

پارامترها
context IInvocationContext : فراخوانی فعلی IInvocationContext .

config IConfiguration : IConfiguration مربوط به دستوری که قرار است اجرا شود.

listener ITestInvocationListener : فراخوانی فعلی ITestInvocationListener که نتایج نهایی باید به آن pipe شوند.

بازگشت‌ها
Exception یک Exception شامل شکست. یا در صورت موفقیت، Null.

حذف پرچم‌های ناسازگار 

public static String[] removeIncompatibleFlags (String[] args)

پارامترها
args String

بازگشت‌ها
String[]

دویدن 

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

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

پارامترها
info TestInformation : TestInformation فراخوانی را توصیف می‌کند.

config IConfiguration : IConfiguration مربوط به دستوری که قرار است اجرا شود.

logger ITestLogger : یک ITestLogger که می‌توانیم فایل‌ها را در آن ثبت کنیم.

بازگشت‌ها
CommandResult یک CommandResult با وضعیت اجرای sandbox و گزارش‌ها.

پرتاب‌ها
Throwable

اشک‌ریزان 

public void tearDown ()

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

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

dumpGlobalConfig 

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

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

پارامترها
config IConfiguration

exclusionPatterns Set

بازگشت‌ها
File

پرتاب‌ها
ConfigurationException
IOException

دریافت جاوا 

protected String getJava ()

بازگشت‌ها
String

آماده‌سازیپیکربندی 

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

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

پارامترها
context IInvocationContext : IInvocationContext فعلی.

config IConfiguration : IConfiguration که باید آماده شود.

listener ITestInvocationListener : فراخوانی فعلی ITestInvocationListener .

بازگشت‌ها
Exception اگر مشکلی پیش بیاید، یک استثنا و در غیر این صورت، تهی (null) است.

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

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

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

پارامترها
context IInvocationContext : IInvocationContext که باید آماده شود.

config IConfiguration : IConfiguration مربوط به محیط سندباکس.

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

پرتاب‌ها
استثنای java.io.IO
IOException