ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Znane podklasy pośrednie GoogleTradefedSandbox, TradefedSandbox GoogleTradefedSandbox Wewnętrzna specjalizacja TradefedSandbox do wykorzystania w infrastrukturze laboratorium.  TradefedSandbox Kontener piaskownicy, który może uruchamiać wywołanie Trade Federation.

---

Interfejs definiujący piaskownicę, której można użyć do uruchomienia wywołania.

Podsumowanie

Metody publiczne
abstract String	createClasspath(File workingDir) Utwórz ścieżkę klasy na podstawie środowiska i katalogu roboczego zwróconego przez getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).
abstract IConfiguration	createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) Tryb specjalny odłączony od głównego uruchomienia: gdy konfiguracja nie występuje w procesie nadrzędnym, przełączamy się na uproszczony program uruchamiający, 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 z wersją.
default Map<String, List<String>>	discoverTests(IInvocationContext context, IConfiguration configuration) Podetap prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), który wykrywa testy, jeśli funkcja SandboxOptions.shouldUseTestDiscovery() jest włączona.
default Map<String, List<String>>	discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo	fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args) Podetap prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), który pobiera dodatkowe pliki potrzebne do piaskownicy.
default File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args) Zwraca środowisko piaskownicy TF, które ma być używane 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 prawidłowo.
abstract CommandResult	run(TestInformation info, IConfiguration configuration, ITestLogger logger) Uruchom piaskownicę w ustawionym środowisku.
abstract void	tearDown() Przywróć wszystkie stany, pliki lub środowiska, które mogły ulec zmianie.

Metody publiczne

createClasspath

public abstract String createClasspath (File workingDir)

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

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

Zwraca
String	Ścieżka klasy do użycia.

Zgłasza
ConfigurationException

createThinLauncherConfig

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

Tryb specjalny odłączony od głównego uruchomienia: gdy konfiguracja nie występuje w procesie nadrzędnym, przełączamy się na uproszczony program uruchamiający, 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 z wersją.

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

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

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Podetap prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), który wykrywa testy, jeśli funkcja SandboxOptions.shouldUseTestDiscovery() jest włączona.

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

Zwraca
Map<String, List<String>>	Mapa wykrytych testów lub wartość null, jeśli testy nie są obsługiwane lub nie udało się ich wykryć.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Parametry
context	IInvocationContext
configuration	IConfiguration
logger	ITestLogger

Zwraca
Map<String, List<String>>

fetchSandboxExtraArtifacts

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

Podetap prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), który pobiera dodatkowe pliki potrzebne do piaskownicy.

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

Zwraca
IFolderBuildInfo	pobrana kompilacja dodatkowych plików w piaskownicy.

Zgłasza
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
BuildRetrievalError
ConfigurationException
IOException

getTradefedSandboxEnvironment

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

Zwraca środowisko piaskownicy TF, które ma być używane na podstawie argumentów wiersza poleceń.

Parametry
context	IInvocationContext: IInvocationContext elementu nadrzędnego.
nonVersionedConfig	IConfiguration: IConfiguration reprezentujący obiekty bez obsługi wersji.
args	String: argumenty wiersza poleceń.

Zwraca
File	File katalog zawierający pliki JAR środowiska piaskownicy TF.

Zgłasza
Exception

getTradefedSandboxEnvironment

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

Parametry
context	IInvocationContext
nonVersionedConfig	IConfiguration
logger	ITestLogger
args	String

Zwraca
File

Zgłasza
Exception

prepareEnvironment

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

Przygotuj środowisko, aby piaskownica działała prawidłowo.

Parametry
context	IInvocationContext: bieżące wywołanie IInvocationContext.
configuration	IConfiguration: IConfiguration polecenia do uruchomienia.
listener	ITestInvocationListener: bieżące wywołanie ITestInvocationListener, do którego należy przekazać wyniki końcowe.

Zwraca
Exception	obiekt Exception zawierający przyczynę niepowodzenia lub wartość null, jeśli operacja się powiodła.

home run

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

Uruchom piaskownicę w ustawionym środowisku.

Parametry
info	TestInformation: TestInformation opisujące wywołanie.
configuration	IConfiguration: IConfiguration polecenia do uruchomienia.
logger	ITestLogger: ITestLogger, w którym możemy zapisywać pliki dziennika.

Zwraca
CommandResult	CommandResult ze stanem uruchomienia piaskownicy i logami.

Zgłasza
Throwable

tearDown

public abstract void tearDown ()

Przywróć wszystkie stany, pliki lub środowiska, które mogły ulec zmianie.