ITestsSuite

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 używana do uruchamiania pakietu testów. Ta klasa stanowi podstawę działania pakietu. Każda implementacja może zdefiniować listę testów za pomocą metody loadTests().

Podsumowanie

Stałe

String ABI_OPTION

String ACTIVE_MAINLINE_PARAMETER_KEY

String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

String ENABLE_RESOLVE_SYM_LINKS

String MAINLINE_PARAMETER_KEY

String MODULE_CHECKER_POST

String MODULE_CHECKER_PRE

String MODULE_END_TIME

String MODULE_METADATA_EXCLUDE_FILTER

String MODULE_METADATA_INCLUDE_FILTER

String MODULE_START_TIME

String PARAMETER_KEY

String PREPARER_WHITELIST

String PRIMARY_ABI_RUN

String RANDOM_SEED

String RUNNER_WHITELIST

String SKIP_HOST_ARCH_CHECK

String SKIP_STAGING_ARTIFACTS

String SKIP_SYSTEM_STATUS_CHECKER

String STAGE_MODULE_ARTIFACTS

String TEST_TYPE_KEY

String TEST_TYPE_VALUE_PERFORMANCE

String TOKEN_KEY

Fieldsem

protected boolean mEnableResolveSymlinks

protected boolean mRecoverDeviceByCvd

Publiczne konstruktory

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 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 zarówno przez testy zgodności AbiUtils.getAbisSupportedByCompatibility(), jak i testowane urządzenie.

static getAbisForBuildTargetArchFromSuite()

Zwraca możliwe interfejsy ABI z obiektu TestSuiteInfo.

IBuildInfo getBuildInfo()

Wdrożenie ITestSuite może wymagać wczytania informacji o kompilacji w celu przeprowadzenia testów.

final IConfiguration getConfiguration()

Zwraca wywołanie IConfiguration.

ITestLogger getCurrentTestLogger()
ITestDevice getDevice()

Przygotuj testowane urządzenie.

ModuleDefinition getDirectModule()

Zwraca element ModuleDefinition, który ma być wykonany bezpośrednio, lub wartość null, jeśli jeszcze nie ma takiego elementu (gdy element ITestSuite nie został jeszcze podzielony na fragmenty).

boolean getIntraModuleSharding()
IInvocationContext getInvocationContext()

Zwraca kontekst wywołania.

MultiMap<String, String> getModuleMetadataIncludeFilters()
ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy()
final String getRequestedAbi()

Zwraca interfejs ABI żądany za pomocą opcji -a lub --abi.

getRequiredTokens(TestInformation testInfo)

Zwraca listę wymaganych tokenów według testu.

long getRuntimeHint()

Zwraca oczekiwany czas działania testu w milisekundach.

File getTestsDir()
boolean isRemoveModuleBuffering()
boolean isSplitting()

Zwraca wartość „prawda”, jeśli obecnie jesteśmy w IShardableTest.split(int).

abstract loadTests()

Metoda abstrakcyjna służąca do wczytywania konfiguracji testów, które zostaną uruchomione.

void reportNotExecuted(ITestInvocationListener listener, String message)

Zgłoś niewykonane testy do głównego odbiorcy.

void reportNotExecuted(ITestInvocationListener listener)

Zgłoś niewykonane testy do głównego odbiorcy.

final void run(TestInformation testInfo, ITestInvocationListener listener)

Ogólna metoda uruchamiania wszystkich testów wczytanych z loadTests().

void setAbiName(String abiName)

Ustaw wartość mAbiName

final void setAbis( abis)
void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

Uruchom pakiet testów w trybie tylko zbierania danych. Wymaga to, aby wszystkie testy podrzędne również implementowały ten interfejs.

void setConfiguration(IConfiguration configuration)

Wstawia używany element IConfiguration.

void setDevice(ITestDevice device)

Wstrzyknij testowane urządzenie.

void setDirectModule(ModuleDefinition module)
void setIntraModuleSharding(boolean intraModuleSharding)
void setInvocationContext(IInvocationContext invocationContext)

void setMetricCollectors( collectors)

Ustawia listę IMetricCollector zdefiniowanych dla testu.

void setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
void setPrimaryAbiRun(boolean primaryAbiRun)

Ustaw wartość mPrimaryAbiRun

void setShouldMakeDynamicModule(boolean dynamicModule)

W przypadku rozproszonego dzielenia na fragmenty nie możemy mieć elementu ModuleDefinition, który udostępnia testy w puli, ponieważ w przeciwnym razie dzielenie na fragmenty w ramach modułu nie będzie działać. Dlatego zezwalamy na jego wyłączenie.

void setSkipContext(SkipContext skipContext)
void setSystemStatusChecker( systemCheckers)

Ustawia ISystemStatusCheckers z konfiguracji testu.

void setTestLogger(ITestLogger testLogger)

Wstrzykuje instancję ITestLogger

split(Integer shardCountHint, TestInformation testInfo)

Alternatywna wersja split(int), która zawiera też TestInformation , czyli wczesne informacje od rodzica tworzącego fragmenty.

Metody chronione

createModuleListeners()

Zwraca listę ITestInvocationListener, które mają zastosowanie na poziomie ModuleListener.

boolean filterByRunnerType(IConfiguration config, allowedRunners)

Zastosuj filtrowanie według białej listy biegaczy, usuwając wszystkich biegaczy, którzy nie zostali dodani do białej listy.

getAbisForBuildTargetArch()

Zwraca interfejsy ABI obsługiwane przez architekturę docelową kompilacji hosta.

getHostAbis()

Zwraca interfejsy ABI maszyny hosta.

void setPrioritizeHostConfig(boolean prioritizeHostConfig)

Ustaw opcję prioritize-host-config.

boolean shouldModuleRun(ModuleDefinition module)

Stałe

ABI_OPTION

public static final String ABI_OPTION

Wartość stała: "abi"

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

Wartość stała: „active-mainline-parameter”

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

Wartość stała: „flag-overrides” 

public static final String ENABLE_RESOLVE_SYM_LINKS

Stała wartość: "enable-resolve-sym-links"

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

Stała wartość: "mainline-param"

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

Constant Value: "PostModuleChecker"

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

Constant Value: "PreModuleChecker"

MODULE_END_TIME

public static final String MODULE_END_TIME

Stała wartość: „MODULE_END_TIME”

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

Stała wartość: "module-metadata-exclude-filter"

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

Wartość stała: "module-metadata-include-filter"

MODULE_START_TIME

public static final String MODULE_START_TIME

Wartość stała: "MODULE_START_TIME"

PARAMETER_KEY

public static final String PARAMETER_KEY

Wartość stała: „parameter”

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

Stała wartość: „preparer-whitelist”

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

Constant Value: "primary-abi-only"

RANDOM_SEED

public static final String RANDOM_SEED

Wartość stała: „random-seed”

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

Constant Value: "runner-whitelist"

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

Wartość stała: „skip-host-arch-check”

SKIP_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

Wartość stała: "skip-staging-artifacts"

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

Wartość stała: "skip-system-status-check"

STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

Wartość stała: "stage-module-artifacts"

TEST_TYPE_KEY

public static final String TEST_TYPE_KEY

Wartość stała: „test-type”

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

Wartość stała: „performance”

TOKEN_KEY

public static final String TOKEN_KEY

Stała wartość: "token"

Fieldsem

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

Publiczne konstruktory

ITestsSuite

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 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, które jest oceniane.
include MultiMap: filtr uwzględniania metadanych;
exclude MultiMap: filtr wykluczania metadanych;
Zwroty
boolean Wartość „prawda”, jeśli moduł ma zostać uruchomiony. W przeciwnym razie wartość „fałsz”.

getAbis

public  getAbis (ITestDevice device)

Pobiera zestaw interfejsów ABI obsługiwanych zarówno przez testy zgodności AbiUtils.getAbisSupportedByCompatibility(), jak i testowane urządzenie.

Parametry
device ITestDevice

Zwroty
Zestaw interfejsów ABI, na których mają być przeprowadzane testy
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Zwraca możliwe interfejsy ABI z obiektu TestSuiteInfo.

Zwroty

getBuildInfo

public IBuildInfo getBuildInfo ()

Wdrożenie ITestSuite może wymagać wczytania informacji o kompilacji w celu przeprowadzenia testów.

Zwroty
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Zwraca wywołanie IConfiguration.

Zwroty
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Zwroty
ITestLogger

getDevice

public ITestDevice getDevice ()

Przygotuj testowane urządzenie.

Zwroty
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Zwraca element ModuleDefinition, który ma być wykonany bezpośrednio, lub wartość null, jeśli jeszcze nie ma takiego elementu (gdy element 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 interfejs ABI żądany za pomocą opcji -a lub --abi.

Zwroty
String

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Zwraca listę wymaganych tokenów według testu. Jeśli token nie jest obsługiwany, zwraca wartość null.

Parametry
testInfo TestInformation

Zwroty

getRuntimeHint

public long getRuntimeHint ()

Zwraca oczekiwany czas działania testu w milisekundach. Ten czas jest używany do równoważenia obciążenia podczas wykonywania podzielonego na fragmenty.

Zwroty
long

getTestsDir

public File getTestsDir ()

Zwroty
File

isRemoveModuleBuffering

public boolean isRemoveModuleBuffering ()

Zwroty
boolean

isSplitting

public boolean isSplitting ()

Zwraca wartość „prawda”, jeśli obecnie jesteśmy w IShardableTest.split(int).

Zwroty
boolean

loadTests

public abstract  loadTests ()

Metoda abstrakcyjna służąca do wczytywania konfiguracji testów, które zostaną uruchomione. Każdy test jest określony przez IConfiguration i unikalną nazwę, pod którą będą raportowane wyniki.

Zwroty

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Zgłoś niewykonane testy do głównego odbiorcy. Powinny być zgłaszane jako nieudane z komunikatem NOT_EXECUTED_FAILURE.

Parametry
listener ITestInvocationListener: główny odbiornik, do którego należy zgłaszać wyniki, które nie zostały wykonane.
message String: wiadomość, która ma być powiązana z błędem niewykonania.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Zgłoś niewykonane testy do głównego odbiorcy. Powinny być zgłaszane jako nieudane z komunikatem NOT_EXECUTED_FAILURE.

Parametry
listener ITestInvocationListener: główny odbiornik, do którego należy zgłaszać wyniki, które nie zostały wykonane.

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 przydatne informacje do przeprowadzania testów.
listener ITestInvocationListener: ITestInvocationListener wyników testu
Zgłasza
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

Ustaw wartość mAbiName

Parametry
abiName String

setAbis

public final void setAbis ( abis)

Parametry
abis

setBuild

public void setBuild (IBuildInfo buildInfo)

Parametry
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Uruchom pakiet testów w trybie tylko zbierania danych. Wymaga to, aby wszystkie testy podrzędne również implementowały ten interfejs.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Wstawia używany element IConfiguration.

Parametry
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij testowane urządzenie.

Parametry
device ITestDevice: ITestDevice, którego chcesz użyć

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 dla 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)

W przypadku rozproszonego dzielenia na fragmenty nie możemy mieć elementu ModuleDefinition, który udostępnia testy w puli, ponieważ w przeciwnym razie dzielenie na fragmenty w ramach 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 ISystemStatusCheckers z konfiguracji testu.

Parametry
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Wstrzykuje instancję ITestLogger

Parametry
testLogger ITestLogger

podziel

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Alternatywna wersja split(int), która zawiera też TestInformation , czyli wczesne informacje od rodzica 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 fragmentów, które próbowano utworzyć.
testInfo TestInformation: Reklamodawca TestInformation
Zwroty
zbiór podtestów do wykonania osobno lub null, jeśli test nie jest obecnie podzielony na części.

Metody chronione

createModuleListeners

protected  createModuleListeners ()

Zwraca listę ITestInvocationListener, które mają zastosowanie na poziomie ModuleListener. Te odbiorniki będą ponownie używane w każdym module i nie będą ponownie tworzone, więc nie powinny zakładać stanu wewnętrznego.

Zwroty

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Zastosuj filtrowanie według białej listy biegaczy, usuwając wszystkich biegaczy, którzy nie zostali dodani do białej listy. Jeśli konfiguracja ma kilka modułów wykonawczych, niektóre z nich mogą zostać usunięte, a konfiguracja nadal będzie działać.

Parametry
config IConfiguration: IConfiguration, które jest oceniane.
allowedRunners : aktualna biała lista wykonawców.
Zwroty
boolean Wartość true, jeśli moduł konfiguracji może działać. W przeciwnym razie wartość false.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Zwraca interfejsy ABI obsługiwane przez architekturę docelową kompilacji hosta. Udostępniono do testowania.

Zwroty

getHostAbis

protected  getHostAbis ()

Zwraca interfejsy ABI maszyny hosta.

Zwroty

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

Ustaw opcję prioritize-host-config.

Parametry
prioritizeHostConfig boolean: wartość true, aby nadać priorytet konfiguracji hosta, czyli w miarę możliwości uruchamiać test hosta.

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametry
module ModuleDefinition

Zwroty
boolean