Pakiet ITest
public abstract class ITestSuite
extends Object
implements IRemoteTest, IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest, ITestLoggerReceiver
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ITestSuite |
Klasa abstrakcyjna używana do uruchamiania pakietu testów. Ta klasa stanowi podstawę działania pakietu. Każda implementacja może definiować listę testów za pomocą metody loadTests()
.
Streszczenie
Pola | |
---|---|
public static final String | ABI_OPTION |
public static final String | ACTIVE_MAINLINE_PARAMETER_KEY |
public static final String | MAINLINE_PARAMETER_KEY |
public static final String | MODULE_CHECKER_POST |
public static final String | MODULE_CHECKER_PRE |
public static final String | MODULE_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
public static final String | PARAMETER_KEY |
public static final String | PREPARER_WHITELIST |
public static final String | PRIMARY_ABI_RUN |
public static final String | RANDOM_SEED |
public static final String | REBOOT_BEFORE_TEST |
public static final String | RUNNER_WHITELIST |
public static final String | SKIP_HOST_ARCH_CHECK |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
Konstruktorzy publiczni | |
---|---|
ITestSuite () |
Metody publiczne | |
---|---|
void | addModuleMetadataExcludeFilters (MultiMap<String, String> filters) |
void | addModuleMetadataIncludeFilters (MultiMap<String, String> filters) |
final void | enableRebootBeforeTest () Ustawia opcję ponownego uruchomienia przed testem na wartość true. |
getAbis (ITestDevice device) Pobiera zestaw interfejsów ABI obsługiwanych przez testowanie zgodności | |
static | getAbisForBuildTargetArchFromSuite () Zwraca możliwe abis z TestSuiteInfo. |
IBuildInfo | getBuildInfo () Implementacja |
final IConfiguration | getConfiguration () Zwraca wywołanie |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Oddaj urządzenie do testu. |
ModuleDefinition | getDirectModule () Zwraca |
IInvocationContext | getInvocationContext () Zwraca kontekst wywołania. |
final String | getRequestedAbi () Zwraca żądaną wartość abi z opcją -a lub --abi. |
getRequiredTokens () | |
long | getRuntimeHint () Zwróć oczekiwany czas wykonania testu w milisekundach. |
File | getTestsDir () |
boolean | isSplitting () Zwraca wartość true, jeśli aktualnie znajdujemy się w |
abstract | loadTests () Abstrakcyjna metoda ładowania konfiguracji testów, która zostanie uruchomiona. |
void | reportNotExecuted (ITestInvocationListener listener, String message) Zgłoś niezrealizowane testy głównemu dostarczonemu słuchaczowi. |
void | reportNotExecuted (ITestInvocationListener listener) Zgłoś niezrealizowane testy głównemu dostarczonemu słuchaczowi. |
final void | run (TestInformation testInfo, ITestInvocationListener listener) Ogólna metoda uruchamiania dla wszystkich testów ładowanych z |
void | setAbiName (String abiName) Ustaw wartość mAbiName |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild (IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) Uruchom zestaw testów w trybie tylko kolektora, wymaga to wykonania wszystkich testów podrzędnych, aby zaimplementować również ten interfejs. |
void | setConfiguration ( IConfiguration configuration) Wstrzykuje używaną |
void | setDevice (ITestDevice device) Wstrzyknij testowane urządzenie. |
void | setInvocationContext (IInvocationContext invocationContext) |
void | setInvocationInjector (Injector injector) Pobierz bieżący Guice |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Ustawia listę |
void | setPrimaryAbiRun (boolean primaryAbiRun) Ustaw wartość mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) Podczas wykonywania rozproszonego fragmentowania nie możemy mieć ModuleDefinition, który udostępnia testy w puli, w przeciwnym razie fragmentowanie wewnątrz modułu nie będzie działać, więc pozwalamy na jego wyłączenie. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Ustawia |
void | setTestLogger (ITestLogger testLogger) |
split (Integer shardCountHint, TestInformation testInfo) Alternatywna wersja |
Metody chronione | |
---|---|
createModuleListeners () Zwraca listę | |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude) Zastosuj filtr metadanych do konfiguracji i sprawdź, czy konfiguracja powinna zostać uruchomiona. |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Zastosuj filtrowanie białej listy biegaczy, usuwając wszystkich biegaczy, którzy nie byli na białej liście. |
getAbisForBuildTargetArch () Zwróć abis obsługiwany przez docelową architekturę kompilacji hosta. | |
getHostAbis () Zwraca abis komputera hosta. | |
boolean | shouldModuleRun ( ModuleDefinition module) |
Pola
ABI_OPCJA
public static final String ABI_OPTION
ACTIVE_MAINLINE_PARAMETER_KEY
public static final String ACTIVE_MAINLINE_PARAMETER_KEY
MAINLINE_PARAMETER_KEY
public static final String MAINLINE_PARAMETER_KEY
MODULE_CHECKER_POST
public static final String MODULE_CHECKER_POST
MODULE_CHECKER_PRE
public static final String MODULE_CHECKER_PRE
MODULE_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
PARAMETR_KLUCZ
public static final String PARAMETER_KEY
PREPARER_BIAŁA LISTA
public static final String PREPARER_WHITELIST
PRIMARY_ABI_RUN
public static final String PRIMARY_ABI_RUN
RANDOM_SEED
public static final String RANDOM_SEED
REBOOT_BEFORE_TEST
public static final String REBOOT_BEFORE_TEST
RUNNER_BIAŁALISTA
public static final String RUNNER_WHITELIST
SKIP_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
Konstruktorzy publiczni
Pakiet ITest
public ITestSuite ()
Metody publiczne
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
Parametry | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
Parametry | |
---|---|
filters | MultiMap |
włącz opcję ponownego uruchomienia przed testem
public final void enableRebootBeforeTest ()
Ustawia opcję ponownego uruchomienia przed testem na wartość true.
zdobądźAbisa
publicgetAbis (ITestDevice device)
Pobiera zestaw interfejsów ABI obsługiwanych przez testowanie zgodności AbiUtils.getAbisSupportedByCompatibility()
i testowane urządzenie.
Parametry | |
---|---|
device | ITestDevice |
Zwroty | |
---|---|
Zestaw interfejsów ABI, na których będą przeprowadzane testy |
Rzuca | |
---|---|
DeviceNotAvailableException |
pobierzAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Zwraca możliwe abis z TestSuiteInfo.
Zwroty | |
---|---|
pobierz informacje o kompilacji
public IBuildInfo getBuildInfo ()
Implementacja ITestSuite
może wymagać informacji o kompilacji w celu załadowania testów.
Zwroty | |
---|---|
IBuildInfo |
pobierz konfigurację
public final IConfiguration getConfiguration ()
Zwraca wywołanie IConfiguration
.
Zwroty | |
---|---|
IConfiguration |
getCurrentTestLogger
public ITestLogger getCurrentTestLogger ()
Zwroty | |
---|---|
ITestLogger |
pobierz urządzenie
public ITestDevice getDevice ()
Oddaj urządzenie do testu.
Zwroty | |
---|---|
ITestDevice | ITestDevice |
getDirectModuł
public ModuleDefinition getDirectModule ()
Zwraca ModuleDefinition
, który ma zostać wykonany bezpośrednio, lub null, jeśli jeszcze go nie ma (jeśli pakiet ITestSuite nie został jeszcze podzielony na fragmenty).
Zwroty | |
---|---|
ModuleDefinition |
pobierzKontekstInwokacji
public IInvocationContext getInvocationContext ()
Zwraca kontekst wywołania.
Zwroty | |
---|---|
IInvocationContext |
getRequestedAbi
public final String getRequestedAbi ()
Zwraca żądaną wartość abi z opcją -a lub --abi.
Zwroty | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens ()
Zwroty | |
---|---|
pobierz wskazówkę uruchomieniową
public long getRuntimeHint ()
Zwróć oczekiwany czas wykonania testu w milisekundach. Czas jest używany do zrównoważenia obciążenia wykonania podzielonego na fragmenty
Zwroty | |
---|---|
long |
getTestsDir
public File getTestsDir ()
Zwroty | |
---|---|
File |
jestRozdzielanie
public boolean isSplitting ()
Zwraca wartość true, jeśli aktualnie znajdujemy się w IShardableTest.split(int)
.
Zwroty | |
---|---|
boolean |
załaduj testy
public abstractloadTests ()
Abstrakcyjna metoda ładowania konfiguracji testów, która zostanie uruchomiona. Każdy test jest zdefiniowany przez IConfiguration
i unikalną nazwę, pod którą będzie raportował wyniki.
Zwroty | |
---|---|
raportNiewykonany
public void reportNotExecuted (ITestInvocationListener listener, String message)
Zgłoś niezrealizowane testy głównemu dostarczonemu słuchaczowi. Należy je zgłosić jako nieudane za pomocą komunikatu NOT_EXECUTED_FAILURE
.
Parametry | |
---|---|
listener | ITestInvocationListener : główny odbiornik, w którym należy zgłosić niezrealizowane wyniki. |
message | String : komunikat, który ma być powiązany z niezrealizowaną awarią. |
raportNiewykonany
public void reportNotExecuted (ITestInvocationListener listener)
Zgłoś niezrealizowane testy głównemu dostarczonemu słuchaczowi. Należy je zgłosić jako nieudane za pomocą komunikatu NOT_EXECUTED_FAILURE
.
Parametry | |
---|---|
listener | ITestInvocationListener : główny odbiornik, w którym należy zgłosić niezrealizowane wyniki. |
uruchomić
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Ogólna metoda uruchamiania dla wszystkich testów ładowanych z loadTests()
.
Parametry | |
---|---|
testInfo | TestInformation |
listener | ITestInvocationListener |
Rzuca | |
---|---|
DeviceNotAvailableException |
ustawAbiNazwę
public void setAbiName (String abiName)
Ustaw wartość mAbiName
Parametry | |
---|---|
abiName | String |
ustawAbis
public final void setAbis (abis)
Parametry | |
---|---|
abis |
setBuild
public void setBuild (IBuildInfo buildInfo)
Parametry | |
---|---|
buildInfo | IBuildInfo |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Uruchom zestaw testów w trybie tylko kolektora, wymaga to wykonania wszystkich testów podrzędnych, aby zaimplementować również ten interfejs.
ustaw konfigurację
public void setConfiguration (IConfiguration configuration)
Wstrzykuje używaną IConfiguration
.
Parametry | |
---|---|
configuration | IConfiguration |
ustaw urządzenie
public void setDevice (ITestDevice device)
Wstrzyknij testowane urządzenie.
Parametry | |
---|---|
device | ITestDevice : ITestDevice do użycia |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
Parametry | |
---|---|
invocationContext | IInvocationContext |
setInvocationInjector
public void setInvocationInjector (Injector injector)
Pobierz bieżący Guice Injector
z wywołania. Powinno to pozwolić nam na kontynuację wstrzykiwania obiektów do modułów.
Parametry | |
---|---|
injector | Injector |
setMetricCollectors
public void setMetricCollectors (collectors)
Ustawia listę IMetricCollector
zdefiniowanych dla przebiegu testu.
Parametry | |
---|---|
collectors |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
Ustaw wartość mPrimaryAbiRun
Parametry | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
Podczas wykonywania rozproszonego fragmentowania nie możemy mieć ModuleDefinition, który udostępnia testy w puli, w przeciwnym razie fragmentowanie wewnątrz modułu nie będzie działać, więc pozwalamy na jego wyłączenie.
Parametry | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Ustawia ISystemStatusChecker
s z konfiguracji testu.
Parametry | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Parametry | |
---|---|
testLogger | ITestLogger |
podział
publicsplit (Integer shardCountHint, TestInformation testInfo)
Alternatywna wersja split(int)
, która udostępnia również informację TestInformation
zawierającą wczesne informacje od rodzica tworzącego fragmenty. Jest to przydatne, jeśli podczas fragmentowania potrzebny jest dostęp do informacji o urządzeniu lub kompilacji.
Parametry | |
---|---|
shardCountHint | Liczba Integer : liczba próbnych fragmentów. |
testInfo | TestInformation : nadrzędna TestInformation |
Zwroty | |
---|---|
zbiór podtestów, które mają być wykonane osobno lub mają wartość null , jeśli testu nie można obecnie podzielić |
Metody chronione
utwórz moduły słuchaczy
protectedcreateModuleListeners ()
Zwraca listę ITestInvocationListener
mającą zastosowanie do poziomu ModuleListener
. Te odbiorniki zostaną ponownie użyte w każdym module, nie zostaną ponownie utworzone, więc nie powinny przyjmować stanu wewnętrznego.
Zwroty | |
---|---|
filterByConfigMetadata
protected boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Zastosuj filtr metadanych do konfiguracji i sprawdź, czy konfiguracja powinna zostać uruchomiona.
Parametry | |
---|---|
config | IConfiguration : IConfiguration jest oceniana. |
include | MultiMap : metadane obejmują filtr |
exclude | MultiMap : filtr wykluczający metadane |
Zwroty | |
---|---|
boolean | Prawda, jeśli moduł powinien działać, w przeciwnym razie fałsz. |
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Zastosuj filtrowanie białej listy biegaczy, usuwając wszystkich biegaczy, którzy nie byli na białej liście. Jeśli konfiguracja ma kilka modułów uruchamiających, niektóre mogą zostać usunięte, a konfiguracja będzie nadal działać.
Parametry | |
---|---|
config | IConfiguration : IConfiguration jest oceniana. |
allowedRunners |
Zwroty | |
---|---|
boolean | Prawda, jeśli moduł konfiguracyjny może działać, w przeciwnym razie fałsz. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Zwróć abis obsługiwany przez docelową architekturę kompilacji hosta. Wystawiony do testów.
Zwroty | |
---|---|
pobierzHostAbis
protectedgetHostAbis ()
Zwraca abis komputera hosta.
Zwroty | |
---|---|
powinienModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Parametry | |
---|---|
module | ModuleDefinition |
Zwroty | |
---|---|
boolean |