ITestSuite
public
abstract
class
ITestSuite
extends Object
implements
IBuildReceiver,
IConfigurationReceiver,
IDeviceTest,
IInvocationContextReceiver,
IMetricCollectorReceiver,
IRemoteTest,
IReportNotExecuted,
IRuntimeHintProvider,
IShardableTest,
ISystemStatusCheckerReceiver,
ITestCollector,
ITestLoggerReceiver,
ITokenRequest
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ITestSuite |
Klasa abstrakcyjna służąca do uruchamiania pakietu testów. To szkolenie zawiera informacje o tym, jak będzie działać pakiet.
Każda implementacja może zdefiniować listę testów za pomocą metody loadTests()
.
Podsumowanie
Fieldsem | |
---|---|
public
static
final
String |
ABI_OPTION
|
public
static
final
String |
ACTIVE_MAINLINE_PARAMETER_KEY
|
public
static
final
String |
BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY
|
public
static
final
String |
ENABLE_RESOLVE_SYM_LINKS
|
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 |
STAGE_MODULE_ARTIFACTS
|
public
static
final
String |
TEST_TYPE_KEY
|
public
static
final
String |
TEST_TYPE_VALUE_PERFORMANCE
|
public
static
final
String |
TOKEN_KEY
|
protected
boolean |
mEnableResolveSymlinks
|
protected
boolean |
mRecoverDeviceByCvd
|
Konstruktory publiczne | |
---|---|
ITestSuite()
|
Metody publiczne | |
---|---|
void
|
addModuleMetadataExcludeFilters(MultiMap<String, String> filters)
|
void
|
addModuleMetadataIncludeFilters(MultiMap<String, String> filters)
|
void
|
cleanUpSuiteSetup()
Możliwość usunięcia wszystkich elementów, które były potrzebne podczas konfigurowania zestawów, ale nie są wymagane do przeprowadzania testów. |
boolean
|
filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Zastosuj do konfiguracji filtr metadanych i sprawdź, czy konfiguracja powinna się uruchomić. |
|
getAbis(ITestDevice device)
Pobiera zestaw ABI obsługiwanych przez testy zgodności |
static
|
getAbisForBuildTargetArchFromSuite()
Zwraca możliwe abis z elementu TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
Implementacja |
final
IConfiguration
|
getConfiguration()
Zwraca wywołanie |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
Spraw, by urządzenie zostało poddane testom. |
ModuleDefinition
|
getDirectModule()
Zwraca |
boolean
|
getIntraModuleSharding()
|
IInvocationContext
|
getInvocationContext()
Zwraca kontekst wywołania. |
MultiMap<String, String>
|
getModuleMetadataIncludeFilters()
|
ITestSuite.MultiDeviceModuleStrategy
|
getMultiDeviceStrategy()
|
final
String
|
getRequestedAbi()
Zwraca żądanie Abi z opcją -a lub --abi. |
|
getRequiredTokens(TestInformation testInfo)
Zwraca listę tokenów wymaganych przez test. |
long
|
getRuntimeHint()
Zwraca oczekiwany czas działania testu w milisekundach. |
File
|
getTestsDir()
|
boolean
|
isSplitting()
Zwraca wartość „prawda”, jeśli znajdujemy się obecnie w |
abstract
|
loadTests()
Abstrakcyjna metoda wczytywania konfiguracji testów, która zostanie uruchomiona. |
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
Zgłoś niewykonane testy do głównego detektora. |
void
|
reportNotExecuted(ITestInvocationListener listener)
Zgłoś niewykonane testy do głównego detektora. |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
Ogólna metoda uruchamiania dla wszystkich testów wczytanych z |
void
|
setAbiName(String abiName)
Ustaw wartość mAbiName |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Uruchomienie zestawu testów w trybie tylko dla kolektora wymaga, aby wszystkie podtesty implementowały ten interfejs. |
void
|
setConfiguration(IConfiguration configuration)
Wstawia używany |
void
|
setDevice(ITestDevice device)
Wstrzyknij urządzenie testowe. |
void
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
Ustawia listę |
void
|
setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
|
void
|
setPrimaryAbiRun(boolean primaryAbiRun)
Ustaw wartość mPrimaryAbiRun. |
void
|
setShouldMakeDynamicModule(boolean dynamicModule)
Podczas fragmentacji rozproszonej nie możemy użyć parametru ModuleDefinition, który udostępnia testy w puli. W przeciwnym razie fragmentacja w obrębie modułu nie będzie działać, więc zezwalamy na jego wyłączenie. |
void
|
setSkipContext(SkipContext skipContext)
|
void
|
setSystemStatusChecker(
Ustawia elementy |
void
|
setTestLogger(ITestLogger testLogger)
Wstrzykuje instancję |
|
split(Integer shardCountHint, TestInformation testInfo)
Alternatywna wersja |
Chronione metody | |
---|---|
|
createModuleListeners()
Zwraca listę wartości |
boolean
|
filterByRunnerType(IConfiguration config,
Zastosuj filtrowanie białej listy wykonawców, usuwając każdego wykonawcę, który nie został dodany do białej listy. |
|
getAbisForBuildTargetArch()
Zwraca abis obsługiwane przez architekturę docelową kompilacji hosta. |
|
getHostAbis()
Zwraca identyfikator Abis hosta. |
boolean
|
shouldModuleRun(ModuleDefinition module)
|
Fieldsem
OPCJA_ABI
public static final String ABI_OPTION
ACTIVE_MAINLINE_PARAMETER_KEY
public static final String ACTIVE_MAINLINE_PARAMETER_KEY
BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY
public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY
ENABLE_RESOLVE_SYM_LINKS
public static final String ENABLE_RESOLVE_SYM_LINKS
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_TIME
public static final String MODULE_START_TIME
PARAMETER_KEY
public static final String PARAMETER_KEY
PREPARER_WHITELIST
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_WHITELIST
public static final String RUNNER_WHITELIST
SKIP_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
POMIŃ_STAGING_ARTIFACTS
public static final String SKIP_STAGING_ARTIFACTS
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
STAGE_MODULE_ARTIFACTS
public static final String STAGE_MODULE_ARTIFACTS
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
mEnableResolveSymlinks
protected boolean mEnableResolveSymlinks
mRecoverDeviceByCvd
protected boolean mRecoverDeviceByCvd
Konstruktory publiczne
ITestSuite
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 data clean room
public void cleanUpSuiteSetup ()
Możliwość usunięcia wszystkich elementów, które były potrzebne podczas konfigurowania zestawów, ale nie są wymagane do przeprowadzania testów.
filterByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Zastosuj filtr metadanych do konfiguracji i sprawdź, czy powinna ona zostać uruchomiona.
Parametry | |
---|---|
config |
IConfiguration : oceniany IConfiguration . |
include |
MultiMap : filtr uwzględniania metadanych |
exclude |
MultiMap : filtr wykluczania metadanych, |
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli moduł ma się uruchomić. W przeciwnym razie ma wartość „fałsz”. |
getAbis
publicgetAbis (ITestDevice device)
Pobiera zestaw ABI obsługiwanych przez testy zgodności AbiUtils.getAbisSupportedByCompatibility()
i testowane urządzenie.
Parametry | |
---|---|
device |
ITestDevice |
Zwroty | |
---|---|
|
zestaw ABI, na których mają być przeprowadzane testy; |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PobierzAbisDoKompilacji
public staticgetAbisForBuildTargetArchFromSuite ()
Zwraca możliwe abis z elementu TestSuiteInfo.
Zwroty | |
---|---|
|
getBuildInfo
public IBuildInfo getBuildInfo ()
Implementacja ITestSuite
może wymagać informacji o kompilacji, aby wczytać testy.
Zwroty | |
---|---|
IBuildInfo |
getConfiguration;
public final IConfiguration getConfiguration ()
Zwraca wywołanie IConfiguration
.
Zwroty | |
---|---|
IConfiguration |
getDevice
public ITestDevice getDevice ()
Przygotuj urządzenie do testowania.
Zwroty | |
---|---|
ITestDevice |
ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Zwraca ModuleDefinition
do bezpośredniego wykonania lub wartość null, jeśli nie ma jeszcze żadnego (gdy ITestSuite nie został jeszcze podzielony na fragmenty).
Zwroty | |
---|---|
ModuleDefinition |
getIntraModuleSharding
public boolean getIntraModuleSharding ()
Zwroty | |
---|---|
boolean |
getInvocationContext
public IInvocationContext getInvocationContext ()
Zwraca kontekst wywołania.
Zwroty | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
Zwroty | |
---|---|
MultiMap<String, String> |
Strategia getna wiele urządzeń
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
Zwroty | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
getRequestedAbi
public final String getRequestedAbi ()
Zwraca żądanie Abi z opcją -a lub --abi.
Zwroty | |
---|---|
String |
getWymaganeTokeny
publicgetRequiredTokens (TestInformation testInfo)
Zwraca listę tokenów wymaganych przez test. Zwraca wartość null, jeśli token nie jest obsługiwany.
Parametry | |
---|---|
testInfo |
TestInformation |
Zwroty | |
---|---|
|
getRuntimeHint
public long getRuntimeHint ()
Zwraca oczekiwany czas działania testu w milisekundach. Czas jest używany do równoważenia obciążenia w ramach sekcji.
Zwroty | |
---|---|
long |
getTestsDir,
public File getTestsDir ()
Zwroty | |
---|---|
File |
isSplitting
public boolean isSplitting ()
Zwraca wartość „prawda”, jeśli znajdujemy się obecnie w IShardableTest.split(int)
.
Zwroty | |
---|---|
boolean |
loadTests
public abstractloadTests ()
Abstrakcyjna metoda wczytywania konfiguracji testów, która zostanie uruchomiona. Każdy test jest zdefiniowany przez IConfiguration
i wyjątkową nazwę, pod którą będą raportowane wyniki.
Zwroty | |
---|---|
|
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener, String message)
Prześlij niewykonane testy do głównego odbiorcy. Powinny być zgłaszane jako błąd z komunikatem NOT_EXECUTED_FAILURE
.
Parametry | |
---|---|
listener |
ITestInvocationListener : główny detektor, w którym zgłaszają niewykonane wyniki. |
message |
String : komunikat, który ma być powiązany z niewykonanym błędem. |
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener)
Prześlij niewykonane testy do głównego odbiorcy. Powinny być zgłaszane jako błąd z komunikatem NOT_EXECUTED_FAILURE
.
Parametry | |
---|---|
listener |
ITestInvocationListener : główny odbiorca, do którego mają być wysyłane niewykonane wyniki. |
home run
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Ogólna metoda wykonywania wszystkich testów załadowanych z loadTests()
.
Parametry | |
---|---|
testInfo |
TestInformation : obiekt TestInformation zawierający przydatne informacje do przeprowadzania testów. |
listener |
ITestInvocationListener : ITestInvocationListener wyników testu |
Rzuty | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
Ustaw wartość mAbiName
Parametry | |
---|---|
abiName |
String |
setAbis
public final void setAbis (abis)
Parametry | |
---|---|
abis |
|
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Uruchomienie zestawu testów w trybie tylko dla kolektora wymaga, aby wszystkie podtesty implementowały ten interfejs.
setConfiguration
public void setConfiguration (IConfiguration configuration)
Wstrzykuje IConfiguration
w użyciu.
Parametry | |
---|---|
configuration |
IConfiguration |
setDevice
public void setDevice (ITestDevice device)
Wstrzyknij urządzenie testowe.
Parametry | |
---|---|
device |
ITestDevice : ITestDevice do użycia |
setDirectModule
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 na potrzeby testu.
Parametry | |
---|---|
collectors |
|
ustaw strategię na wiele urządzeń
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 korzystania z dzielenia na segmenty rozproszone nie możemy mieć definicji modułu, która udostępnia testy w zbiorze. W przeciwnym razie podział modułu nie będzie działać, dlatego zezwalamy na jego wyłączenie.
Parametry | |
---|---|
dynamicModule |
boolean |
setSkipContext
public void setSkipContext (SkipContext skipContext)
Parametry | |
---|---|
skipContext |
SkipContext |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Ustawia elementy ISystemStatusChecker
z konfiguracji testu.
Parametry | |
---|---|
systemCheckers |
|
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Wstrzykuje instancję ITestLogger
Parametry | |
---|---|
testLogger |
ITestLogger |
podziel
publicsplit (Integer shardCountHint, TestInformation testInfo)
Alternatywna wersja split(int)
, która zawiera też TestInformation
, zawierający wczesne informacje z nadrzędnego elementu tworzącego fragmenty. Jest to przydatne, jeśli podczas dzielenia na fragmenty trzeba uzyskać dostęp do informacji o urządzeniu lub kompilacji.
Parametry | |
---|---|
shardCountHint |
Integer : liczba próbowanych fragmentów. |
testInfo |
TestInformation : element nadrzędny TestInformation |
Zwroty | |
---|---|
|
kolekcję testów podrzędnych do wykonania osobno lub null , jeśli test nie jest obecnie podzielony na części; |
Chronione metody
detektor modułu createModuleListeners
protectedcreateModuleListeners ()
Zwraca listę ITestInvocationListener
, która jest odpowiednia dla poziomu ModuleListener
. Te detektory będą używane w każdym module. Nie zostaną ponownie skonfigurowane, więc nie powinni zakładać stanu wewnętrznego.
Zwroty | |
---|---|
|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Zastosuj filtrowanie białej listy wykonawców, usuwając każdego wykonawcę, który nie został dodany do białej listy. Jeśli konfiguracja ma kilku wykonawców, niektórzy z nich mogą zostać usunięci, a konfiguracja nadal będzie działać.
Parametry | |
---|---|
config |
IConfiguration : oceniany IConfiguration . |
allowedRunners |
: bieżąca lista biała wykonawcy. |
Zwroty | |
---|---|
boolean |
Wartość Prawda, jeśli moduł konfiguracji może się uruchomić. W przeciwnym razie wartość Fałsz. |
Łuk getAbisForBuildTarget
protectedgetAbisForBuildTargetArch ()
Zwraca abis obsługiwane przez architekturę docelową kompilacji hosta. Przedstawione do testów.
Zwroty | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
Zwraca abis hosta.
Zwroty | |
---|---|
|
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Parametry | |
---|---|
module |
ModuleDefinition |
Zwroty | |
---|---|
boolean |