דף זה תורגם על ידי Cloud Translation API.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

תתי-מחלקות עקיפות ידועות

TradeifiedSandbox קונטיינר של Sandbox שאפשר להפעיל בו את Federation (התאחדות הסחר).

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

סיכום

שיטות ציבוריות
`abstract String`	`createClasspath(File workingDir)` יצירת נתיב כיתה שמבוסס על הסביבה וספריית העבודה שהוחזרה על ידי `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` מצב מיוחד מנותק מההפעלה הראשית: כאשר נראה שלא קיימת הגדרה בתוך ההורה, אנחנו נעזרים במרכז אפליקציות דק שבו אנחנו מנסים להגדיר את ה-Sandbox בינתיים ולמלא את ספריית העבודה כדי ליצור את ההגדרות באופן מלא גרסאות dir.
`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)` מחזירה את 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)

יצירת נתיב כיתה שמבוסס על הסביבה וספריית העבודה שהוחזרה על ידי 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)

מצב מיוחד מנותק מההפעלה הראשית: כאשר נראה שלא קיימת הגדרה בתוך ההורה, אנחנו נעזרים במרכז אפליקציות דק שבו אנחנו מנסים להגדיר את ה-Sandbox בינתיים ולמלא את ספריית העבודה כדי ליצור את ההגדרות באופן מלא גרסאות dir.

פרמטרים
`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`

החזרות

אחזורSandboxExtraArtifacts

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`	את ה-build שאוחזר לקבצים הנוספים בארגז החול.

קליעות
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.Configuration וכל החריגות
	חריגת IO
`BuildRetrievalError`
`ConfigurationException`

סביבת getTradeifiedSandbox

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

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

פרמטרים
`context`	`IInvocationContext`: `IInvocationContext` של ההורה.
`nonVersionedConfig`	`IConfiguration`: ה-`IConfiguration` שמייצג את האובייקטים ללא גרסאות.
`args`	`String`: הארגומנטים בשורת הפקודה.

החזרות
`File`	ספריית `ERROR(/File)` שמכילה את צנצנות סביבת ה-TF של ארגז החול.

סביבת getTradeifiedSandbox

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` שמכיל את הכשל. או Null אם הפעולה הצליחה.

ראן

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

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

פרמטרים
`info`	`TestInformation`: `TestInformation` שמתאר את ההפעלה
`configuration`	`IConfiguration`: ה-`IConfiguration` של הפקודה.
`logger`	`ITestLogger`: `ITestLogger` שבו אנחנו יכולים לרשום קבצים ביומן.

החזרות
`CommandResult`	`CommandResult` בסטטוס של ההרצה והיומנים של ה-Sandbox.

פירעון

public abstract void tearDown ()

מוחקים מצבים, קבצים או סביבה שהשתנו.