W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

Kontener konfiguracji testu. Ta klasa pomaga przygotowywać i przeprowadzać testy.

Podsumowanie

Stałe
`String`	`ISOLATION_COST`
`String`	`MODULE_ABI`
`String`	`MODULE_CACHED` Ta właściwość ma wartość „true”, jeśli wyniki modułu testowego zostały zapisane w pamięci podręcznej.
`String`	`MODULE_CONTROLLER`
`String`	`MODULE_EXTERNAL_DEPENDENCIES`
`String`	`MODULE_ID` Identyfikator modułu to nazwa, która będzie używana do jednoznacznego identyfikowania modułu podczas testRunStart.
`String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`String`	`MODULE_ISOLATED` Ta właściwość ma wartość „true”, jeśli moduł działał na nowo przygotowanym urządzeniu.
`String`	`MODULE_NAME` Nazwa modułu to nazwa podstawowa powiązana z modułem, zwykle pochodząca z pliku konfiguracyjnego XML TF, z którego moduł został wczytany.
`String`	`MODULE_PARAMETERIZATION`
`String`	`MODULE_SKIPPED` Ta właściwość ma wartość „true”, jeśli moduł testowy został pominięty.
`String`	`MODULE_TEST_COUNT`
`String`	`PREPARATION_TIME`
`String`	`RETRY_FAIL_COUNT`
`String`	`RETRY_SUCCESS_COUNT`
`String`	`RETRY_TIME`
`String`	`SPARSE_MODULE` Ta właściwość ma wartość „true”, jeśli zgłaszane są tylko zdarzenia na poziomie modułu.
`String`	`TEAR_DOWN_TIME`
`String`	`TEST_TIME`

Konstruktory publiczne
`ModuleDefinition()`
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` Konstruktor
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` Konstruktor

Metody publiczne
`int`	`compareTo(ModuleDefinition moduleDef)`
`Set<Digest>`	`getFilterDigests()` Zwraca skróty filtrów powiązanych z testami.
`String`	`getId()` Zwraca unikalną nazwę modułu.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` Zwraca `IInvocationContext` powiązany z modułem.
`TestInformation`	`getModuleTestInformation()`
`Set<TokenProperty>`	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` Zwraca przybliżony czas potrzebny na uruchomienie wszystkich testów w module.
`boolean`	`hasModuleFailed()` Zwraca wartość Prawda, jeśli w module * wywołano funkcję testRunFailure.
`int`	`neededDevices()` Zwraca liczbę urządzeń, na których ma zostać przeprowadzony ten test.
`int`	`numTests()` Zwraca bieżącą liczbę zadań `IRemoteTest` oczekujących na wykonanie.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Raportowanie modułów, które nie zostały w ogóle wykonane.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit)` Uruchom wszystkie `IRemoteTest` zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` Uruchom wszystkie `IRemoteTest` zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` Uruchom przygotowania do testu, w tym przygotowania na poziomie pakietu, jeśli zostały określone.
`void`	`setBuild(IBuildInfo build)` Wstrzyknij `IBuildInfo`, który ma być używany podczas testów.
`void`	`setCollectKernelLog(boolean collectKernelLog)`
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Włącza lub wyłącza tryb zbierania testów
`void`	`setDefaultLogCollectors(List<IMetricCollector> collectors)`
`void`	`setDevice(ITestDevice device)` Wstrzyknij `ITestDevice`, który ma być używany podczas testów.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Określa, czy włączyć pobieranie dynamiczne na poziomie modułu.
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` Przekaż do modułu zapisywacz logów wywołania, aby w razie potrzeby mógł go użyć.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Określa, czy wyniki mają być scalane.
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` Wstrzyknij listę `IMetricCollector`, która będzie używana przez moduł.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` Zestawy powinny przywrócić urządzenie wirtualne.
`void`	`setRemoveModuleBuffering(boolean removeModuleBuffering)`
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` Ustawia wartość `IRetryDecision`, która będzie używana do ponawiania prób w ramach modułu.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` Zwraca informację o tym, czy należy odzyskać urządzenie wirtualne.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Skopiuj kilka ustawień konfiguracji na poziomie pakietu.

Metody chronione
`boolean`	`hasTests()` Zwraca wartość Prawda, jeśli moduł nadal ma `IRemoteTest` do uruchomienia w swojej puli.

Stałe

ISOLATION_COST

public static final String ISOLATION_COST

Wartość stała: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Wartość stała: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

Ta właściwość ma wartość „true”, jeśli wyniki modułu testowego zostały zapisane w pamięci podręcznej.

Wartość stała: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Wartość stała: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

Wartość stała: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

Identyfikator modułu to nazwa, która będzie używana do jednoznacznego identyfikowania modułu podczas testRunStart. Zwykle jest to kombinacja MODULE_ABI + MODULE_NAME.

Wartość stała: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Wartość stała: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Ta właściwość ma wartość „true”, jeśli moduł działał na nowo przygotowanym urządzeniu.

Wartość stała: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

Nazwa modułu to nazwa podstawowa powiązana z modułem, zwykle pochodząca z pliku konfiguracyjnego XML TF, z którego moduł został wczytany.

Wartość stała: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

Wartość stała: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Ta właściwość ma wartość „true”, jeśli moduł testowy został pominięty.

Wartość stała: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

Wartość stała: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Wartość stała: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

Wartość stała: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

Wartość stała: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

Wartość stała: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

Ta właściwość ma wartość „true”, jeśli zgłaszane są tylko zdarzenia na poziomie modułu.

Wartość stała: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Wartość stała: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Wartość stała: "TEST_TIME"

Konstruktory publiczne

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Konstruktor

Parametry
`name`	`String`: unikalna nazwa konfiguracji testu.
`tests`	`Collection`: lista `IRemoteTest`, które muszą zostać uruchomione.
`preparersPerDevice`	`Map`: lista `ITargetPreparer`, które mają być używane do konfigurowania urządzenia.
`multiPreparers`	`List`
`moduleConfig`	`IConfiguration`: `IConfiguration` konfiguracji modułu bazowego.

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Konstruktor

Parametry
`name`	`String`: unikalna nazwa konfiguracji testu.
`tests`	`Collection`: lista `IRemoteTest`, które muszą zostać uruchomione.
`preparersPerDevice`	`Map`: lista `ITargetPreparer`, które mają być używane do konfigurowania urządzenia.
`suitePreparersPerDevice`	`Map`
`multiPreparers`	`List`
`moduleConfig`	`IConfiguration`: `IConfiguration` konfiguracji modułu bazowego.

Metody publiczne

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parametry
`moduleDef`	`ModuleDefinition`

Zwraca
`int`

getFilterDigests

public Set<Digest> getFilterDigests ()

Zwraca skróty filtrów powiązanych z testami.

Zwraca
`Set<Digest>`

Zgłasza
`IOException`

getId

public String getId ()

Zwraca unikalną nazwę modułu.

Zwraca
`String`

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Zwraca
`Integer`

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Zwraca
`Integer`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Zwraca
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Zwraca IInvocationContext powiązany z modułem.

Zwraca
`IInvocationContext`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Zwraca
`TestInformation`

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Parametry
`testInfo`	`TestInformation`

Zwraca
`Set<TokenProperty>`

getRuntimeHint

public long getRuntimeHint ()

Zwraca przybliżony czas potrzebny na uruchomienie wszystkich testów w module.

Zwraca
`long`

hasModuleFailed

public boolean hasModuleFailed ()

Zwraca wartość Prawda, jeśli w module * wywołano funkcję testRunFailure.

Zwraca
`boolean`

neededDevices

public int neededDevices ()

Zwraca liczbę urządzeń, na których ma zostać przeprowadzony ten test.

Zwraca
`int`

numTests

public int numTests ()

Zwraca bieżącą liczbę zadań IRemoteTest oczekujących na wykonanie.

Zwraca
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Raportowanie modułów, które nie zostały w ogóle wykonane.

Parametry
`listener`	`ITestInvocationListener`
`message`	`String`

home run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                int maxRunLimit)

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.

Parametry
`moduleInfo`	`TestInformation`: `TestInformation` modułu.
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym mają być raportowane wyniki.
`maxRunLimit`	`int`: maksymalna liczba uruchomień każdego przypadku testowego.

Zgłasza
`DeviceNotAvailableException`	w przypadku przejścia urządzenia w tryb offline.

home run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.

Parametry
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym mają być raportowane wyniki.

Zgłasza
`DeviceNotAvailableException`	w przypadku przejścia urządzenia w tryb offline.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Uruchom przygotowania do testu, w tym przygotowania na poziomie pakietu, jeśli zostały określone.

Parametry
`includeSuitePreparers`	`boolean`: ustaw na `true`, aby uruchomić też przygotowania na poziomie pakietu.

Zwraca
`Throwable`	`Throwable` – dowolny wyjątek zgłoszony podczas uruchamiania funkcji przygotowujących.

setBuild

public void setBuild (IBuildInfo build)

Wstrzyknij IBuildInfo, który ma być używany podczas testów.

Parametry
`build`	`IBuildInfo`

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

Parametry
`collectKernelLog`	`boolean`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Włącza lub wyłącza tryb zbierania testów

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

Parametry
`collectors`	`List`

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij ITestDevice, który ma być używany podczas testów.

Parametry
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Określa, czy włączyć pobieranie dynamiczne na poziomie modułu.

Parametry
`enableDynamicDownload`	`boolean`

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Parametry
`shardCount`	`int`
`shardIndex`	`int`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Przekaż do modułu zapisywacz logów wywołania, aby w razie potrzeby mógł go użyć.

Parametry
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Określa, czy wyniki mają być scalane.

Parametry
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Wstrzyknij listę IMetricCollector, która będzie używana przez moduł.

Parametry
`collectors`	`List`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Zestawy powinny przywrócić urządzenie wirtualne.

Parametry
`recoverVirtualDevice`	`boolean`

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Parametry
`removeModuleBuffering`	`boolean`

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Parametry
`shouldReportModuleEnd`	`boolean`

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

Parametry
`shouldReportModuleStart`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Ustawia wartość IRetryDecision, która będzie używana do ponawiania prób w ramach modułu.

Parametry
`decision`	`IRetryDecision`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parametry
`useModuleResultsForwarder`	`boolean`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Zwraca informację o tym, czy należy odzyskać urządzenie wirtualne.

Zwraca
`boolean`

toString

public String toString ()

Zwraca
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Skopiuj kilka ustawień konfiguracji na poziomie pakietu.

Parametry
`mSuiteConfiguration`	`IConfiguration`

Metody chronione

hasTests

protected boolean hasTests ()

Zwraca wartość Prawda, jeśli moduł nadal ma IRemoteTest do uruchomienia w swojej puli. W przeciwnym razie ma wartość Fałsz.

Zwraca
`boolean`