ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

תת-כיתות עקיפות ידועות TradefedSandbox TradefedSandbox קונטיינר בארגז חול שיכול להריץ קריאה של Trade Federation.

---

ממשק שמגדיר ארגז חול שאפשר להשתמש בו להפעלת קריאה.

סיכום

שיטות ציבוריות
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 ()

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