ITestSuite
public
abstract
class
ITestSuite
extends Object
implements
IRemoteTest,
IDeviceTest,
IBuildReceiver,
ISystemStatusCheckerReceiver,
IShardableTest,
ITestCollector,
IInvocationContextReceiver,
IRuntimeHintProvider,
IMetricCollectorReceiver,
IConfigurationReceiver,
IReportNotExecuted,
ITokenRequest,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ITestSuite |
Klasa abstrakcyjna używana do uruchamiania pakietu Test Suite. Te zajęcia stanowią podstawę uruchamiania pakietu Analytics 360.
W przypadku każdej implementacji można 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 |
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ść uporządkowania wszystkiego, co było potrzebne podczas konfiguracji pakietów, ale nie jest 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 interfejsów ABI obsługiwanych przez test zgodności |
static
|
getAbisForBuildTargetArchFromSuite()
Zwraca możliwy abis z 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 polecenie |
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 oczekiwane środowisko wykonawcze testu w milisekundach. |
File
|
getTestsDir()
|
boolean
|
isSplitting()
Zwraca wartość prawda, jeśli jesteśmy 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 wszystkich testów wczytanych z |
void
|
setAbiName(String abiName)
Ustaw wartość mAbiName |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Uruchom pakiet testowy w trybie tylko kolektora. Wymaga to implementacji tego interfejsu we wszystkich podtestach. |
void
|
setConfiguration(IConfiguration configuration)
Wstawia używany |
void
|
setDevice(ITestDevice device)
Wstrzyknij urządzenie w trakcie testu. |
void
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
Ustawia listę elementów |
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
|
setSystemStatusChecker(
Ustawia elementy |
void
|
setTestLogger(ITestLogger testLogger)
Wstawia instancję |
|
split(Integer shardCountHint, TestInformation testInfo)
Alternatywna wersja |
Metody chronione | |
---|---|
|
createModuleListeners()
Zwraca listę wartości |
boolean
|
filterByRunnerType(IConfiguration config,
Zastosuj filtrowanie białej listy biegaczy, usuwając wszystkie biegacze, których nie ma na białej liście. |
|
getAbisForBuildTargetArch()
Zwraca interfejs Abis obsługiwany 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
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_METADANE_WYKLUCZENIA
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
LOSOWA_LICZBA
public static final String RANDOM_SEED
BIAŁY_LISTA BIEGÓW
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
KLUCZ_TOKENU
public static final String TOKEN_KEY
Dowiązania symboliczne mWłącz
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ść uporządkowania wszystkiego, co było potrzebne podczas konfiguracji pakietów, ale nie jest wymagane do przeprowadzania testów.
filtrByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Zastosuj do konfiguracji filtr metadanych i sprawdź, czy konfiguracja powinna się uruchomić.
Parametry | |
---|---|
config |
IConfiguration : IConfiguration poddawany ocenie. |
include |
MultiMap : filtr zawierający metadane |
exclude |
MultiMap : filtr wykluczania metadanych, |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli moduł ma działać, a wartość false (fałsz) w przeciwnym razie. |
getAbis
publicgetAbis (ITestDevice device)
Pobiera zestaw interfejsów ABI obsługiwanych przez test zgodności AbiUtils.getAbisSupportedByCompatibility()
i testowane urządzenie.
Parametry | |
---|---|
device |
ITestDevice |
Zwroty | |
---|---|
|
Zbiór interfejsów ABI, na których zostaną uruchomione testy |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PobierzAbisDoKompilacji
public staticgetAbisForBuildTargetArchFromSuite ()
Zwraca możliwy abis z 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 ()
Spraw, by urządzenie zostało poddane testom.
Zwroty | |
---|---|
ITestDevice |
ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Zwraca polecenie ModuleDefinition
, które ma zostać wykonane bezpośrednio, lub wartość null, jeśli nie ma jeszcze wartości (gdy ITestSuite nie został jeszcze pofragmentowany).
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 |
getRequestAbi
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. Jeśli brak obsługi tokena, zwraca wartość null.
Parametry | |
---|---|
testInfo |
TestInformation |
Zwroty | |
---|---|
|
metoda getRuntimeHint
public long getRuntimeHint ()
Zwraca oczekiwane środowisko wykonawcze testu w milisekundach. Czas jest używany do równoważenia obciążenia wykonania we fragmentach
Zwroty | |
---|---|
long |
getTestsDir,
public File getTestsDir ()
Zwroty | |
---|---|
File |
Dzielenie
public boolean isSplitting ()
Zwraca wartość prawda, jeśli jesteśmy obecnie w: IShardableTest.split(int)
.
Zwroty | |
---|---|
boolean |
Testy wczytywania
public abstractloadTests ()
Abstrakcyjna metoda wczytywania konfiguracji testów, która zostanie uruchomiona. Każdy test jest określany za pomocą identyfikatora IConfiguration
i unikalnej nazwy, pod którą przedstawia wyniki.
Zwroty | |
---|---|
|
reportNotExecuted (Niewykonano raportu)
public void reportNotExecuted (ITestInvocationListener listener, String message)
Zgłoś niewykonane testy do głównego detektora. Ich niepowodzenie należy zgłosić za pomocą komunikatu NOT_EXECUTED_FAILURE
.
Parametry | |
---|---|
listener |
ITestInvocationListener : główny detektor, w którym zgłaszają niewykonane wyniki. |
message |
String : wiadomość, która ma być powiązana z niewykonanym niepowodzeniem. |
reportNotExecuted (Niewykonano raportu)
public void reportNotExecuted (ITestInvocationListener listener)
Zgłoś niewykonane testy do głównego detektora. Ich niepowodzenie należy zgłosić za pomocą komunikatu NOT_EXECUTED_FAILURE
.
Parametry | |
---|---|
listener |
ITestInvocationListener : główny detektor, w którym zgłaszają niewykonane wyniki. |
home run
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Ogólna metoda uruchamiania wszystkich testów wczytanych z loadTests()
.
Parametry | |
---|---|
testInfo |
TestInformation : obiekt TestInformation zawierający informacje przydatne do przeprowadzenia testów. |
listener |
ITestInvocationListener : wartość 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 |
|
ustawZbierzTylkoTesty
public void setCollectTestsOnly (boolean shouldCollectTest)
Uruchom pakiet testowy w trybie tylko kolektora. Wymaga to implementacji tego interfejsu we wszystkich podtestach.
setConfiguration
public void setConfiguration (IConfiguration configuration)
Wstawia używany IConfiguration
.
Parametry | |
---|---|
configuration |
IConfiguration |
ustawUrządzenie
public void setDevice (ITestDevice device)
Wstrzyknij urządzenie w trakcie testu.
Parametry | |
---|---|
device |
ITestDevice : element ITestDevice , którego należy użyć |
setDirectModule
public void setDirectModule (ModuleDefinition module)
Parametry | |
---|---|
module |
ModuleDefinition |
Fragmentacja 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ę elementów IMetricCollector
zdefiniowanych na potrzeby uruchomienia testowego.
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 |
setmakeMakeDynamicModule
public 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.
Parametry | |
---|---|
dynamicModule |
boolean |
Sprawdzanie stanu systemu
public void setSystemStatusChecker (systemCheckers)
Ustawia elementy ISystemStatusChecker
z konfiguracji testu.
Parametry | |
---|---|
systemCheckers |
|
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Wstawia instancję ITestLogger
Parametry | |
---|---|
testLogger |
ITestLogger |
podziel
publicsplit (Integer shardCountHint, TestInformation testInfo)
Alternatywna wersja split(int)
, która udostępnia też obiekt TestInformation
zawierający wczesne informacje od elementu nadrzędnego tworzącego fragmenty. Jest to przydatne, jeśli podczas fragmentacji 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 | |
---|---|
|
zbiór podtestów do wykonania oddzielnie lub null , jeśli testu nie można obecnie podzielić na fragmenty |
Metody chronione
detektor modułu createModuleListeners
protectedcreateModuleListeners ()
Zwraca listę wartości ITestInvocationListener
mającą zastosowanie do 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 | |
---|---|
|
filtrByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Zastosuj filtrowanie białej listy biegaczy, usuwając wszystkie biegacze, których nie ma na białej liście. Jeśli konfiguracja ma kilka uruchomień, niektóre z nich mogą zostać usunięte, a konfiguracja będzie nadal działać.
Parametry | |
---|---|
config |
IConfiguration : IConfiguration poddawany ocenie. |
allowedRunners |
: obecna biała lista biegaczy. |
Zwroty | |
---|---|
boolean |
Wartość „prawda”, jeśli moduł konfiguracji może być uruchamiany. Wartość false (fałsz) w przeciwnym razie. |
Łuk getAbisForBuildTarget
protectedgetAbisForBuildTargetArch ()
Zwraca interfejs Abis obsługiwany przez architekturę docelową kompilacji hosta. Przedstawione do testów.
Zwroty | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
Zwraca identyfikator Abis hosta.
Zwroty | |
---|---|
|
Uruchomienie modułu
protected boolean shouldModuleRun (ModuleDefinition module)
Parametry | |
---|---|
module |
ModuleDefinition |
Zwroty | |
---|---|
boolean |