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 filtr metadanych do konfiguracji i sprawdź, czy powinna ona zostać uruchomiona. |
|
getAbis(ITestDevice device)
Pobiera zestaw ABI obsługiwanych przez testy zgodności |
static
|
getAbisForBuildTargetArchFromSuite()
Zwraca możliwe abis z elementu TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
Wdrożenie |
final
IConfiguration
|
getConfiguration()
Zwraca wywołanie |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
Przygotuj urządzenie do testowania. |
ModuleDefinition
|
getDirectModule()
Zwraca |
boolean
|
getIntraModuleSharding()
|
IInvocationContext
|
getInvocationContext()
Zwraca kontekst wywołania. |
MultiMap<String, String>
|
getModuleMetadataIncludeFilters()
|
ITestSuite.MultiDeviceModuleStrategy
|
getMultiDeviceStrategy()
|
final
String
|
getRequestedAbi()
Zwraca abi żądane za pomocą opcji -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 pozycji |
abstract
|
loadTests()
Abstrakcyjna metoda wczytywania konfiguracji testów, która zostanie uruchomiona. |
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
Prześlij niewykonane testy do głównego odbiorcy. |
void
|
reportNotExecuted(ITestInvocationListener listener)
Prześlij niewykonane testy do głównego odbiorcy. |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
Ogólna metoda wykonywania wszystkich testów załadowanych 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)
Wstrzykuje |
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 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. |
void
|
setSkipContext(SkipContext skipContext)
|
void
|
setSystemStatusChecker(
Ustawia |
void
|
setTestLogger(ITestLogger testLogger)
Wstrzykuje instancję |
|
split(Integer shardCountHint, TestInformation testInfo)
Alternatywna wersja |
Chronione metody | |
---|---|
|
createModuleListeners()
Zwraca listę |
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 abis hosta. |
void
|
setPrioritizeHostConfig(boolean prioritizeHostConfig)
Ustaw opcję prioritize-host-config. |
boolean
|
shouldModuleRun(ModuleDefinition module)
|
Fieldsem
ABI_OPTION
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
SKIP_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 |
cleanUpSuiteSetup
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ędniający metadane |
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 |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Zwraca możliwe abis z elementu TestSuiteInfo.
Zwroty | |
---|---|
|
getBuildInfo
public IBuildInfo getBuildInfo ()
Wdrożenie 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> |
getMultiDeviceStrategy
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
Zwroty | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
getRequestedAbi
public final String getRequestedAbi ()
Zwraca abi żądane za pomocą opcji -a lub --abi.
Zwroty | |
---|---|
String |
getRequiredTokens
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 wykonania w podziale na części
Zwroty | |
---|---|
long |
getTestsDir
public File getTestsDir ()
Zwroty | |
---|---|
File |
isSplitting
public boolean isSplitting ()
Zwraca wartość „prawda”, jeśli znajdujemy się obecnie w pozycji 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 niepowtarzalną 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 odbiorca, do którego mają być wysyłane 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 |
|
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 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 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ób fragmentacji. |
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
createModuleListeners
protectedcreateModuleListeners ()
Zwraca listę ITestInvocationListener
, która jest odpowiednia dla poziomu ModuleListener
. Te odbiorcy będą używane ponownie w przypadku każdego modułu, nie będą ponownie tworzone, więc nie powinny przyjmować 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 biała lista wykonawców. |
Zwroty | |
---|---|
boolean |
Wartość Prawda, jeśli moduł konfiguracji może się uruchomić. W przeciwnym razie wartość Fałsz. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Zwraca abis obsługiwane przez architekturę docelową hosta. Wyeksponowane do testowania.
Zwroty | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
Zwraca abis hosta.
Zwroty | |
---|---|
|
setPrioritizeHostConfig
protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)
Ustaw opcję prioritize-host-config.
Parametry | |
---|---|
prioritizeHostConfig |
boolean : true, aby nadać priorytet konfiguracji hosta, czyli uruchomić test hosta, jeśli to możliwe. |
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Parametry | |
---|---|
module |
ModuleDefinition |
Zwroty | |
---|---|
boolean |