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.

ModuleDefinition

public class ModuleDefinition
extends Object implements 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`

Publiczne konstruktory
`ModuleDefinition()`
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Zespół
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Zespół

Metody publiczne
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` Zwraca unikalną nazwę modułu.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` Zwraca `IInvocationContext` powiązany z modułem.
`TestInformation`	`getModuleTestInformation()`
	`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 całości 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óre ma być używane podczas testów.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Włącza i wyłącza tryb zbierania testów
`void`	`setDevice(ITestDevice device)` Wstrzyknij `ITestDevice`, które ma być używane podczas testów.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Określa, czy w przypadku modułu ma być włączone pobieranie dynamiczne.
`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( collectors)` Wstrzyknij listę `IMetricCollector`, która ma być 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 wartość wskazującą, czy należy odzyskać urządzenie wirtualne.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Skopiuj kilka ustawień konfiguracji pakietu.

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

Stałe

ISOLATION_COST

public static final String ISOLATION_COST

Stała wartość: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Stała wartość: "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.

Stała wartość: „module-cached”

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Stała wartość: "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

Stała wartość: „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

Stała wartość: "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

Stała wartość: „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

Stała wartość: „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.

Stała wartość: "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

Stała wartość: "TEST_TIME"

Publiczne konstruktory

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Zespół

Parametry
`name`	`String`: unikalna nazwa konfiguracji testu.
`tests`	: lista `IRemoteTest`, które muszą zostać uruchomione.
`preparersPerDevice`	: lista `ITargetPreparer`, która będzie używana do konfigurowania urządzenia.
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` konfiguracji modułu bazowego.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Zespół

Parametry
`name`	`String`: unikalna nazwa konfiguracji testu.
`tests`	: lista `IRemoteTest`, które muszą zostać uruchomione.
`preparersPerDevice`	: lista `ITargetPreparer`, która będzie używana do konfigurowania urządzenia.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` konfiguracji modułu bazowego.

Metody publiczne

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parametry
`moduleDef`	`ModuleDefinition`

Zwroty
`int`

getId

public String getId ()

Zwraca unikalną nazwę modułu.

Zwroty
`String`

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Zwroty
`Integer`

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Zwroty
`Integer`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Zwroty
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Zwraca IInvocationContext powiązany z modułem.

Zwroty
`IInvocationContext`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Zwroty
`TestInformation`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parametry
`testInfo`	`TestInformation`

Zwroty

getRuntimeHint

public long getRuntimeHint ()

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

Zwroty
`long`

hasModuleFailed

public boolean hasModuleFailed ()

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

Zwroty
`boolean`

neededDevices

public int neededDevices ()

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

Zwroty
`int`

numTests

public int numTests ()

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

Zwroty
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Raportowanie modułów, które nie zostały w całości 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 zestawu, jeśli zostały określone.

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

Zwroty
`Throwable`	`Throwable` – w przypadku każdego wyjątku zgłoszonego podczas uruchamiania funkcji przygotowujących.

setBuild

public void setBuild (IBuildInfo build)

Wstrzyknij IBuildInfo, które ma być używane podczas testów.

Parametry
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij ITestDevice, które ma być używane podczas testów.

Parametry
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Określa, czy w przypadku modułu ma być włączone pobieranie dynamiczne.

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 ( collectors)

Wstrzyknij listę IMetricCollector, która ma być używana przez moduł.

Parametry
`collectors`

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 wartość wskazującą, czy należy odzyskać urządzenie wirtualne.

Zwroty
`boolean`

toString

public String toString ()

Zwroty
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Skopiuj kilka ustawień konfiguracji pakietu.

Parametry
`mSuiteConfiguration`	`IConfiguration`

Metody chronione

hasTests

protected boolean hasTests ()

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

Zwroty
`boolean`