Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

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

Znane bezpośrednie podklasy

BaseTestSuite, TfSuiteRunner

BaseTestSuite	Test do przeprowadzania pakietu testów zgodności za pomocą nowego systemu.
TfSuiteRunner	Wdrożenie `ITestSuite`, które wczyta testy z folderu res/config/suite/

Znane podklasy pośrednie

TestMappingSuiteRunner

TestMappingSuiteRunner Wdrożenie BaseTestSuite do uruchamiania testów określonych przez opcję include-filter lub pliki TEST_MAPPING z kompilacji jako zestaw.

Klasa abstrakcyjna służąca do uruchamiania pakietu testów. To szkolenie zawiera informacje o tym, jak będzie działać zestaw. 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`	`MAINLINE_PARAMETER_KEY`
`public static final String`	`MODULE_CHECKER_POST`
`public static final String`	`MODULE_CHECKER_PRE`
`public static final String`	`MODULE_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`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`	`REBOOT_BEFORE_TEST`
`public static final String`	`RUNNER_WHITELIST`
`public static final String`	`SKIP_HOST_ARCH_CHECK`
`public static final String`	`SKIP_SYSTEM_STATUS_CHECKER`
`public static final String`	`TOKEN_KEY`

Konstruktory publiczne
`ITestSuite()`

Metody publiczne
`void`	`addModuleMetadataExcludeFilters(MultiMap<String, String> filters)`
`void`	`addModuleMetadataIncludeFilters(MultiMap<String, String> filters)`
`final void`	`enableRebootBeforeTest()` Ustawia parametr reboot-before-test na wartość „true”.
	`getAbis(ITestDevice device)` Pobiera zestaw ABI obsługiwanych przez testy zgodności `AbiUtils.getAbisSupportedByCompatibility()` i testowane urządzenie.
`static`	`getAbisForBuildTargetArchFromSuite()` Zwraca możliwe abis z elementu TestSuiteInfo.
`IBuildInfo`	`getBuildInfo()` Wdrożenie `ITestSuite` może wymagać informacji o wersji, aby wczytać testy.
`final IConfiguration`	`getConfiguration()` Zwraca wywołanie `IConfiguration`.
`ITestLogger`	`getCurrentTestLogger()`
`ITestDevice`	`getDevice()` Przygotuj urządzenie do testowania.
`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).
`IInvocationContext`	`getInvocationContext()` Zwraca kontekst wywołania.
`final String`	`getRequestedAbi()` Zwraca abi żądane za pomocą opcji -a lub --abi.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` Zwraca oczekiwany czas działania testu w milisekundach.
`File`	`getTestsDir()`
`boolean`	`isSplitting()` Zwraca wartość „prawda”, jeśli znajdujemy się obecnie w pozycji `IShardableTest.split(int)`.
`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 `loadTests()`.
`void`	`setAbiName(String abiName)` Ustaw wartość mAbiName
`final void`	`setAbis( abis)`
`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 `IConfiguration` w użyciu.
`void`	`setDevice(ITestDevice device)` Wstrzyknij urządzenie testowe.
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setInvocationInjector(Injector injector)` Pobierz bieżące dane GUICE `Injector` z wywołania.
`void`	`setMetricCollectors( collectors)` Ustawia listę `IMetricCollector` zdefiniowanych na potrzeby testu.
`void`	`setPrimaryAbiRun(boolean primaryAbiRun)` Ustaw wartość mPrimaryAbiRun.
`void`	`setShouldMakeDynamicModule(boolean dynamicModule)` Podczas korzystania z dzielenia na segmenty rozproszonych 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`	`setSystemStatusChecker( systemCheckers)` Ustawia `ISystemStatusChecker` z konfiguracji testu.
`void`	`setTestLogger(ITestLogger testLogger)`
	`split(Integer shardCountHint, TestInformation testInfo)` Alternatywna wersja `split(int)`, która zawiera też `TestInformation`, zawierający wczesne informacje z nadrzędnego elementu tworzącego fragmenty.

Chronione metody
	`createModuleListeners()` Zwraca listę `ITestInvocationListener`, która jest odpowiednia dla poziomu `ModuleListener`.
`boolean`	`filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)` Zastosuj filtr metadanych do konfiguracji i sprawdź, czy powinna ona zostać uruchomiona.
`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.
	`getAbisForBuildTargetArch()` Zwraca abis obsługiwane przez architekturę docelową kompilacji hosta.
	`getHostAbis()` Zwraca abis maszyny hosta.
`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

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_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

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

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

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`

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Ustawia parametr reboot-before-test na wartość „true”.

getAbis

public  getAbis (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
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Zwraca możliwe abis z elementu TestSuiteInfo.

Zwroty

getBuildInfo

public IBuildInfo getBuildInfo ()

Wdrożenie ITestSuite może wymagać informacji o wersji, aby wczytać testy.

Zwroty
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

Zwraca wywołanie IConfiguration.

Zwroty
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Zwroty
`ITestLogger`

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`

getInvocationContext

public IInvocationContext getInvocationContext ()

Zwraca kontekst wywołania.

Zwroty
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

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

Zwroty
`String`

getRequiredTokens

public  getRequiredTokens ()

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ę w bloku IShardableTest.split(int).

Zwroty
`boolean`

loadTests

public abstract  loadTests ()

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 NOT_EXECUTED_FAILURE.

Parametry
`listener`	`ITestInvocationListener`: główny odbiorca, do którego mają być wysyłane informacje o niewykonanych wynikach.
`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 NOT_EXECUTED_FAILURE.

Parametry
`listener`	`ITestInvocationListener`: główny odbiorca, do którego mają być wysyłane informacje o niewykonanych wynikach.

home run

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ogólna metoda wykonywania wszystkich testów załadowanych z loadTests().

Parametry
`testInfo`	`TestInformation`
`listener`	`ITestInvocationListener`

Rzuty
`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)

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

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parametry
`invocationContext`	`IInvocationContext`

setInvocationInjector

public void setInvocationInjector (Injector injector)

Pobierz bieżący interfejs użytkownika Injector z wywołania. Powinna umożliwić nam kontynuowanie wdrażania obiektów w modułach.

Parametry
`injector`	`Injector`

setMetricCollectors

public void setMetricCollectors ( collectors)

Ustawia listę IMetricCollector zdefiniowanych na potrzeby testu.

Parametry
`collectors`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Ustaw wartość mPrimaryAbiRun.

Parametry
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Podczas korzystania z dzielenia na segmenty rozproszonych 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`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Ustawia ISystemStatusChecker z konfiguracji testu.

Parametry
`systemCheckers`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Parametry
`testLogger`	`ITestLogger`

podziel

public  split (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 danych 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

protected  createModuleListeners ()

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

filterByConfigMetadata

protected 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ść false.

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ść true, jeśli moduł konfiguracji może się uruchomić, w przeciwnym razie wartość false.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Zwraca abis obsługiwane przez architekturę docelową kompilacji hosta. Wyeksponowane do testowania.

Zwroty

getHostAbis

protected  getHostAbis ()

Zwraca abis maszyny hosta.

Zwroty

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametry
`module`	`ModuleDefinition`

Zwroty
`boolean`