ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Znane podklasy pośrednie

TradefedSandbox

TradefedSandbox Kontener piaskownicy, w którym można uruchomić wywołanie Federacji Handlowej.

Interfejs definiujący piaskownicę, za pomocą której można uruchomić wywołanie.

Streszczenie

Metody publiczne
`abstract String`	`createClasspath (File workingDir)` Utwórz ścieżkę klasy na podstawie środowiska i katalogu roboczego zwróconego przez `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])` .
`abstract IConfiguration`	`createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Tryb specjalny odłączony od głównego uruchomienia: gdy wydaje się, że konfiguracja nie istnieje w elemencie nadrzędnym, wracamy do cienkiego programu uruchamiającego, w którym próbujemy skonfigurować piaskownicę przy użyciu aktualnie znanych informacji i wypełnić katalog roboczy, aby w pełni utworzyć konfigurację w katalogu wersjonowanym .
`default`	`discoverTests ( IInvocationContext context, IConfiguration configuration)` Podetap `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` , który wykrywa testy, czy włączona jest `SandboxOptions.shouldUseTestDiscovery()` .
`default`	`discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args)` Podetap `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` , który pobiera dodatkowe pliki potrzebne do piaskownicy.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Zwraca TF środowiska piaskownicy, które ma zostać użyte na podstawie argumentów wiersza poleceń.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Przygotuj środowisko, aby piaskownica działała poprawnie.
`abstract CommandResult`	`run ( TestInformation info, IConfiguration configuration, ITestLogger logger)` Uruchom piaskownicę w ustawionym środowisku.
`abstract void`	`tearDown ()` Wyczyść wszystkie stany, pliki lub środowisko, które mogły zostać zmienione.

Metody publiczne

utwórz ścieżkę klasy

public abstract String createClasspath (File workingDir)

Utwórz ścieżkę klasy na podstawie środowiska i katalogu roboczego zwróconego przez getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

Parametry
`workingDir`	`File` : bieżący katalog roboczy piaskownicy.

Zwroty
`String`	Ścieżka klas, która ma być używana.

Rzuca
`ConfigurationException`

utwórz ThinLauncherConfig

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

Tryb specjalny odłączony od głównego uruchomienia: gdy wydaje się, że konfiguracja nie istnieje w elemencie nadrzędnym, wracamy do cienkiego programu uruchamiającego, w którym próbujemy skonfigurować piaskownicę przy użyciu aktualnie znanych informacji i wypełnić katalog roboczy, aby w pełni utworzyć konfigurację w katalogu wersjonowanym .

Parametry
`args`	`String` : oryginalne argumenty wiersza poleceń.
`keyStoreClient`	`IKeyStoreClient` : bieżący klient magazynu kluczy używany do tworzenia konfiguracji.
`runUtil`	`IRunUtil` : bieżący `IRunUtil` do uruchamiania poleceń hosta.
`globalConfig`	`File` : konfiguracja globalna używana do uruchamiania podprocesów TF.

Zwroty
`IConfiguration`	a Plik wskazujący konfigurację XML TF dla obiektów NON_VERSIONED. Zwraca wartość null, jeśli nie można utworzyć konfiguracji cienkiego programu uruchamiającego.

odkryjTesty

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Podetap prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) , który wykrywa testy, czy włączona jest SandboxOptions.shouldUseTestDiscovery() .

Parametry
`context`	`IInvocationContext` : bieżące wywołanie `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` dla polecenia do uruchomienia.

Zwroty
	Mapa wykrytych testów lub null, jeśli nie są obsługiwane lub zakończyły się niepowodzeniem.

odkryjTesty

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Parametry
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Zwroty

pobierz dodatkowe artefakty z piaskownicy

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Parametry
`context`	`IInvocationContext` : bieżące wywołanie `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` dla polecenia do uruchomienia.
`args`	`String` : argumenty wiersza poleceń.

Zwroty
`IFolderBuildInfo`	pobrana kompilacja dla dodatkowych plików w trybie piaskownicy.

Rzuca
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	Wyjątek IO
`BuildRetrievalError`
`ConfigurationException`

getTradefedSandboxEnvironment

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

Zwraca TF środowiska piaskownicy, które ma zostać użyte na podstawie argumentów wiersza poleceń.

Parametry
`context`	`IInvocationContext` : `IInvocationContext` elementu nadrzędnego.
`nonVersionedConfig`	`IConfiguration` : `IConfiguration` reprezentująca obiekty niewersjonowane.
`args`	`String` : argumenty wiersza poleceń.

Zwroty
`File`	katalog `ERROR(/File)` zawierający słoiki środowiska piaskownicy TF.

getTradefedSandboxEnvironment

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

Parametry
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Zwroty
`File`

przygotować środowisko

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

Przygotuj środowisko, aby piaskownica działała poprawnie.

Parametry
`context`	`IInvocationContext` : bieżące wywołanie `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` dla polecenia do uruchomienia.
`listener`	`ITestInvocationListener` : bieżące wywołanie `ITestInvocationListener` , do którego powinny zostać przesłane końcowe wyniki.

Zwroty
`Exception`	`Exception` zawierający błąd. lub Null, jeśli się powiedzie.

uruchomić

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

Uruchom piaskownicę w ustawionym środowisku.

Parametry
`info`	`TestInformation` : informacja `TestInformation` opisująca wywołanie
`configuration`	`IConfiguration` : `IConfiguration` dla polecenia do uruchomienia.
`logger`	`ITestLogger` : `ITestLogger` , w którym możemy rejestrować pliki.

Zwroty
`CommandResult`	`CommandResult` ze statusem uruchomienia piaskownicy i dziennikami.

zburzyć

public abstract void tearDown ()

Wyczyść wszystkie stany, pliki lub środowisko, które mogły zostać zmienione.