TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

קונטיינר בארגז חול שיכול להריץ קריאה של Trade Federation. TODO: Allow Options to be passed to the sandbox.

סיכום

קונסטרוקטורים גלויים לכולם

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)

מריצים את ארגז החול עם הסביבה שהוגדרה.

void tearDown()

מנקים את כל המצבים, הקבצים או הסביבה שעשויים להשתנות.

שיטות מוגנות

File dumpGlobalConfig(IConfiguration config, exclusionPatterns)

יצירת גרסת dump של התצורה הגלובלית שסוננה מכמה אובייקטים.

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: ספריית העבודה הנוכחית של ארגז החול.
החזרות
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. הפונקציה מחזירה ערך null אם לא ניתן ליצור הגדרות של מרכז אפליקציות דק.

getTradefedSandboxEnvironment

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

הפונקציה מחזירה את סביבת ה-sandbox של TF לשימוש על סמך הארגומנטים של שורת הפקודה.

פרמטרים
context IInvocationContext: ה-IInvocationContext של ההורה.
nonVersionedConfig IConfiguration: ה-IConfiguration שמייצג את האובייקטים ללא גרסאות.
args String: הארגומנטים בשורת הפקודה.
החזרות
File ספרייה ERROR(/File) שמכילה את קובצי ה-jar של סביבת ה-sandbox של TF.

prepareEnvironment

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

מכינים את הסביבה כדי שארגז החול יפעל כמו שצריך.

פרמטרים
context IInvocationContext: ההפעלה הנוכחית IInvocationContext.
config IConfiguration: ה-IConfiguration של הפקודה להרצה.
listener ITestInvocationListener: ההפעלה הנוכחית ITestInvocationListener שבה צריך להעביר את התוצאות הסופיות באמצעות צינור.
החזרות
Exception Exception שמכיל את הכישלון. או Null אם הפעולה בוצעה בהצלחה.

ראן

public CommandResult run (IConfiguration config, 
                ITestLogger logger)

מריצים את ארגז החול עם הסביבה שהוגדרה.

פרמטרים
config IConfiguration: ה-IConfiguration של הפקודה להרצה.
logger ITestLogger: ITestLogger שבו נוכל לתעד קבצים.
החזרות
CommandResult קובץ CommandResult עם סטטוס ההרצה ב-sandbox והיומנים.

tearDown

public void tearDown ()

מנקים את כל המצבים, הקבצים או הסביבה שעשויים להשתנות.

שיטות מוגנות

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

יצירת גרסת dump של התצורה הגלובלית שסוננה מכמה אובייקטים.

פרמטרים
config IConfiguration

exclusionPatterns

החזרות
File

זריקות
ConfigurationException

prepareConfiguration

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

מכינים את IConfiguration שיועברו לתהליך המשנה ויניעו את ההפעלה של הקונטיינר.

פרמטרים
context IInvocationContext: ה-IInvocationContext הנוכחי.
config IConfiguration: ה-IConfiguration שרוצים להכין.
listener ITestInvocationListener: ההפעלה הנוכחית ITestInvocationListener.
החזרות
Exception חריגה אם משהו השתבש, null אחרת.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

מכינים את IInvocationContext ומעבירים אותו לסריאליזציה.

פרמטרים
context IInvocationContext: ה-IInvocationContext שרוצים להכין.
config IConfiguration: ה-IConfiguration של ארגז החול.
החזרות
File IInvocationContext בסריאליזציה.