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_END_TIME |
public static final String | MODULE_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
public static final String | MODULE_START_TIME |
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 | RUNNER_WHITELIST |
public static final String | SKIP_HOST_ARCH_CHECK |
public static final String | SKIP_STAGING_ARTIFACTS |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TEST_TYPE_KEY |
public static final String | TEST_TYPE_VALUE_PERFORMANCE |
public static final String | TOKEN_KEY |
protected boolean | mRecoverDeviceByCvd
|
Konstruktorzy publiczni | |
---|---|
ITestSuite () |
Metody publiczne | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
void | cleanUpSuiteSetup () Możliwość wyczyszczenia wszystkich rzeczy, które były potrzebne podczas konfiguracji pakietów, ale nie są wymagane do uruchomienia testów. |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Zastosuj filtr metadanych do konfiguracji i sprawdź, czy konfiguracja powinna zostać uruchomiona. |
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. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
ITestSuite.MultiDeviceModuleStrategy | getMultiDeviceStrategy () |
final String | getRequestedAbi () Zwraca żądaną wartość abi z opcją -a lub --abi. |
getRequiredTokens ( TestInformation testInfo) Zwraca listę wymaganych tokenów przez test. | |
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 | setDirectModule ( ModuleDefinition module) |
void | setIntraModuleSharding (boolean intraModuleSharding) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Ustawia listę |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
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) Wstrzykuje instancję |
split (Integer shardCountHint, TestInformation testInfo) Alternatywna wersja |
Metody chronione | |
---|---|
createModuleListeners () Zwraca listę | |
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_END_TIME
public static final String MODULE_END_TIME
MODULE_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
MODULE_START_CZAS
public static final String MODULE_START_TIME
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
RUNNER_BIAŁALISTA
public static final String RUNNER_WHITELIST
SKIP_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
SKIP_STAGING_ARTIFACTS
public static final String SKIP_STAGING_ARTIFACTS
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TEST_TYPE_KEY
public static final String TEST_TYPE_KEY
TEST_TYPE_VALUE_PERFORMANCE
public static final String TEST_TYPE_VALUE_PERFORMANCE
TOKEN_KEY
public static final String TOKEN_KEY
mRecoverDeviceByCvd
protected boolean mRecoverDeviceByCvd
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 |
Konfiguracja cleanUpSuite
public void cleanUpSuiteSetup ()
Możliwość wyczyszczenia wszystkich rzeczy, które były potrzebne podczas konfiguracji pakietów, ale nie są wymagane do uruchomienia testów.
filterByConfigMetadata
public 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. |
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 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
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 |
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 |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
Zwroty | |
---|---|
MultiMap <String, String> |
getMultiDeviceStrategy
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
Zwroty | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
getRequestedAbi
public final String getRequestedAbi ()
Zwraca żądaną wartość abi z opcją -a lub --abi.
Zwroty | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
Zwraca listę wymaganych tokenów przez test. Zwraca wartość null, jeśli nie ma obsługi tokenu.
Parametry | |
---|---|
testInfo | TestInformation |
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 : Obiekt TestInformation zawierający informacje przydatne do uruchamiania testów. |
listener | ITestInvocationListener : ITestInvocationListener wyników testów |
Rzuca | |
---|---|
DeviceNotAvailableException |
ustawAbiNazwę
public void setAbiName (String abiName)
Ustaw wartość mAbiName
Parametry | |
---|---|
abiName | String |
ustawAbis
public final void setAbis (abis)
Parametry | |
---|---|
abis |
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 |
moduł setDirect
public void setDirectModule (ModuleDefinition module)
Parametry | |
---|---|
module | ModuleDefinition |
setIntraModuleSharding
public void setIntraModuleSharding (boolean intraModuleSharding)
Parametry | |
---|---|
intraModuleSharding | boolean |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
Parametry | |
---|---|
invocationContext | IInvocationContext |
setMetricCollectors
public void setMetricCollectors (collectors)
Ustawia listę IMetricCollector
zdefiniowanych dla przebiegu testu.
Parametry | |
---|---|
collectors |
setMultiDeviceStrategy
public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
Parametry | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
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)
Wstrzykuje instancję ITestLogger
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 | |
---|---|
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 |