ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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)

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.

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.