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), שבו מאחזרים קבצים נוספים שנדרשים לארגז החול.

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)

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

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

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

discoverTests

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 של הפקודה להרצה.

החזרות
המפה של הבדיקות שהתגלו, או null אם אין תמיכה בבדיקות או שהן נכשלו.

discoverTests

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), שבו מאחזרים קבצים נוספים שנדרשים לארגז החול.

פרמטרים
context IInvocationContext: ההפעלה הנוכחית IInvocationContext.

configuration IConfiguration: ה-IConfiguration של הפקודה להרצה.

args String: הארגומנטים בשורת הפקודה.

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

זריקות
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) שמכילה את קובצי ה-jar של סביבת ה-sandbox של TF.

getTradefedSandboxEnvironment

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

פרמטרים
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

החזרות
File

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

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

פרמטרים
context IInvocationContext: ההפעלה הנוכחית IInvocationContext.

configuration IConfiguration: ה-IConfiguration של הפקודה להרצה.

listener ITestInvocationListener: ההפעלה הנוכחית ITestInvocationListener שבה צריך להעביר את התוצאות הסופיות באמצעות צינור.

החזרות
Exception Exception שמכיל את הכישלון. או Null אם הפעולה בוצעה בהצלחה.

ראן

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

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

פרמטרים
info TestInformation: ה-TestInformation שמתאר את ההפעלה

configuration IConfiguration: ה-IConfiguration של הפקודה להרצה.

logger ITestLogger: ITestLogger שבו נוכל לתעד קבצים.

החזרות
CommandResult קובץ CommandResult עם סטטוס ההרצה ב-sandbox והיומנים.

tearDown

public abstract void tearDown ()

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