iSandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox,


Interfejs określający piaskownicę, której można używać do uruchamiania 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(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 konfiguracja wydaje się nie istnieć w przypadku wydawcy nadrzędnego, wracamy do cienkiego programu uruchamiającego, w którym próbujemy skonfigurować piaskownicę i uzupełnij katalog roboczy, aby utworzyć konfigurację w całości katalog z obsługą wersji.

default discoverTests(IInvocationContext context, IConfiguration configuration)

Etap podrzędny funkcji prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener), który wykrywa testy, jeśli włączono zasadę SandboxOptions.shouldUseTestDiscovery().

default discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)

Etap podrzędny 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 plik TF środowiska piaskownicy, który ma być używany 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 do prawidłowego działania piaskownicy.

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

Uruchom piaskownicę w ustawionym środowisku.

abstract void tearDown()

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

Metody publiczne

createClasspath

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 w piaskownicy.

Zwroty
String Ścieżka klasy, która ma zostać użyta.

Rzuty
ConfigurationException

createThinLauncherConfig,

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

Tryb specjalny odłączony od głównego uruchomienia: gdy konfiguracja wydaje się nie istnieć w przypadku wydawcy nadrzędnego, wracamy do cienkiego programu uruchamiającego, w którym próbujemy skonfigurować piaskownicę i uzupełnij katalog roboczy, aby utworzyć konfigurację w całości katalog z obsługą wersji.

Parametry
args String: argumenty pierwotnego wiersza poleceń.

keyStoreClient IKeyStoreClient: bieżący klient magazynu kluczy, który ma być 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 Plik wskazujący kod XML konfiguracji TF dla obiektów NON_VERSIONED. Zwroty Wartość null, jeśli nie można utworzyć konfiguracji cienkiego programu uruchamiającego.

wykrywanieTestów

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Etap podrzędny funkcji prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener), który wykrywa testy, jeśli włączono zasadę SandboxOptions.shouldUseTestDiscovery().

Parametry
context IInvocationContext: bieżące wywołanie IInvocationContext.

configuration IConfiguration: IConfiguration do uruchomienia polecenia.

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

wykrywanieTestów

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

Parametry
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Zwroty

pobieranie dodatkowych artefaktów Piaskownicy

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

Etap podrzędny 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 do uruchomienia polecenia.

args String: argumenty wiersza poleceń.

Zwroty
IFolderBuildInfo pobranej kompilacji na potrzeby dodatkowych plików umieszczonych w piaskownicy.

Rzuty
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOWyjątek
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

Zwraca plik TF środowiska piaskownicy, który ma być używany na podstawie argumentów wiersza poleceń.

Parametry
context IInvocationContext: element IInvocationContext elementu nadrzędnego.

nonVersionedConfig IConfiguration: IConfiguration reprezentujący obiekty bez wersji.

args String: argumenty wiersza poleceń.

Zwroty
File katalog ERROR(/File) zawierający pliki jar ś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

readyEnvironment

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

Przygotuj środowisko do prawidłowego działania piaskownicy.

Parametry
context IInvocationContext: bieżące wywołanie IInvocationContext.

configuration IConfiguration: IConfiguration do uruchomienia polecenia.

listener ITestInvocationListener: bieżące wywołanie ITestInvocationListener, w którym ostateczne wyniki są dostępne powinny być uzupełnione.

Zwroty
Exception Exception zawierający błąd. lub null w przypadku powodzenia.

home run

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

Uruchom piaskownicę w ustawionym środowisku.

Parametry
info TestInformation: element TestInformation opisujący wywołanie

configuration IConfiguration: IConfiguration do uruchomienia polecenia.

logger ITestLogger: ITestLogger, w którym można zapisywać pliki.

Zwroty
CommandResult CommandResult ze stanem uruchomienia piaskownicy i logów.

dezaktywacja

public abstract void tearDown ()

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