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 przygotować i przeprowadzić testy.

Podsumowanie

Fieldsem
`public static final String`	`ISOLATION_COST`
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CACHED` Ta właściwość ma wartość „true” (prawda), jeśli wyniki modułu testowego zostały zapisane w pamięci podręcznej.
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` Identyfikator modułu to nazwa, która będzie używana do jednoznacznego identyfikowania modułu podczas testRunStart.
`public static final String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`public static final String`	`MODULE_ISOLATED` Ta właściwość ma wartość Prawda, jeśli moduł działał na świeżo przygotowanym urządzeniu.
`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.
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`MODULE_SKIPPED` Ta właściwość ma wartość „true” (prawda), jeśli moduł testowy został pominięty.
`public static final String`	`MODULE_TEST_COUNT`
`public static final String`	`PREPARATION_TIME`
`public static final String`	`RETRY_FAIL_COUNT`
`public static final String`	`RETRY_SUCCESS_COUNT`
`public static final String`	`RETRY_TIME`
`public static final String`	`SPARSE_MODULE` Ta właściwość ma wartość Prawda, jeśli raportowane są tylko zdarzenia na poziomie modułu.
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

Konstruktory publiczne
`ModuleDefinition()`
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Konstruktor
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Konstruktor

Metody publiczne
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` Zwraca niepowtarzalną nazwę modułu.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` Zwraca wartość `IInvocationContext` powiązaną z modułem.
	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` Zwraca przybliżony czas wykonywania wszystkich testów w module.
`boolean`	`hasModuleFailed()` Zwraca wartość Prawda, jeśli wywołano testRunFailure w module *
`int`	`neededDevices()` Zwraca liczbę urządzeń, na których ma być przeprowadzony test.
`int`	`numTests()` Zwraca bieżącą liczbę `IRemoteTest` oczekujących na wykonanie.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` zgłaszać całkowicie niewykonanych modułów.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners)` Uruchom wszystkie `IRemoteTest` zawarte w module i użyj wszystkich narzędzi do przygotowania przed i po skonfigurowaniu oraz czyszczeniu urządzenia.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit)` Uruchom wszystkie `IRemoteTest` zawarte w module i użyj wszystkich narzędzi do przygotowania przed i po skonfigurowaniu oraz czyszczeniu urządzenia.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` Uruchom wszystkie `IRemoteTest` zawarte w module i użyj wszystkich narzędzi do przygotowania przed i po skonfigurowaniu oraz czyszczeniu urządzenia.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` osoby przygotowujące test, w tym osoby przygotowujące na poziomie zestawu (jeśli są określone);
`void`	`setBuild(IBuildInfo build)` Wstrzyknij `IBuildInfo`, aby użyć go podczas testów.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Włącza lub wyłącza tryb testowy zbierania danych
`void`	`setDevice(ITestDevice device)` Wstrzyknij `ITestDevice`, aby użyć go podczas testów.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Określa, czy pobieranie dynamiczne ma być włączone na poziomie modułu.
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` Przekaż modułowi narzędzie do zapisywania logów wywołania, aby mógł z niego skorzystać w razie potrzeby.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Określa, czy należy scalić wyniki.
`void`	`setMetricCollectors( collectors)` Wstrzyknij listę `IMetricCollector`, której ma używać moduł.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` Zestawy powinny przywrócić wirtualne urządzenie.
`final void`	`setRetryDecision(IRetryDecision decision)` Ustawia wartość `IRetryDecision`, która ma być używana do ponownego próbowania w ramach modułu.
`boolean`	`shouldRecoverVirtualDevice()` Zwraca wartość, jeśli mamy przywrócić urządzenie wirtualne.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Skopiuj kilka ustawień na poziomie pakietu.

Chronione metody
`boolean`	`hasTests()` Zwraca wartość Prawda, jeśli moduł nadal ma `IRemoteTest` do wykonania w swojej puli.

Fieldsem

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

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

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String 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.

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Ta właściwość ma wartość Prawda, jeśli moduł działał na świeżo przygotowanym urządzeniu.

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.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_SKIPPED

public static final String MODULE_SKIPPED

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

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

PREPARATION_TIME

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

SPARSE_MODULE

public static final String SPARSE_MODULE

Ta właściwość ma wartość Prawda, jeśli raportowane są tylko zdarzenia na poziomie modułu.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Konstruktory publiczne

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

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

Konstruktor

Parametry
`name`	`String`: niepowtarzalna nazwa konfiguracji testowej.
`tests`	: lista `IRemoteTest`, które należy uruchomić.
`preparersPerDevice`	: lista `ITargetPreparer`, która ma służyć do konfigurowania urządzenia.
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` konfiguracji modułu.

ModuleDefinition

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

Konstruktor

Parametry
`name`	`String`: niepowtarzalna nazwa konfiguracji testowej.
`tests`	: lista `IRemoteTest`, które należy uruchomić.
`preparersPerDevice`	: lista `ITargetPreparer`, która ma służyć do konfigurowania urządzenia.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: `IConfiguration` konfiguracji modułu.

Metody publiczne

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parametry
`moduleDef`	`ModuleDefinition`

Zwroty
`int`

getId

public String getId ()

Zwraca niepowtarzalną 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 wartość IInvocationContext powiązaną z modułem.

Zwroty
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parametry
`testInfo`	`TestInformation`

Zwroty

getRuntimeHint

public long getRuntimeHint ()

Zwraca przybliżony czas wykonywania wszystkich testów w module.

Zwroty
`long`

hasModuleFailed

public boolean hasModuleFailed ()

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

Zwroty
`boolean`

neededDevices

public int neededDevices ()

Zwraca liczbę urządzeń, na których ma być przeprowadzony 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)

zgłaszać całkowicie niewykonanych modułów.

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

home run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners)

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich narzędzi do przygotowania przed i po skonfigurowaniu oraz czyszczeniu urządzenia.

Parametry
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym należy zgłaszać wyniki.
`moduleLevelListeners`	: lista odbiorców na poziomie modułu.

Rzuty
`DeviceNotAvailableException`	w przypadku przejścia urządzenia w tryb offline.

home run

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

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich narzędzi do przygotowania przed i po skonfigurowaniu oraz czyszczeniu urządzenia.

Parametry
`moduleInfo`	`TestInformation`: `TestInformation` modułu.
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym należy zgłaszać wyniki.
`moduleLevelListeners`	: lista odbiorców na poziomie modułu.
`maxRunLimit`	`int`: maksymalna liczba uruchomień każdego testu.

Rzuty
`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 narzędzi do przygotowania przed i po skonfigurowaniu oraz czyszczeniu urządzenia.

Parametry
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym należy zgłaszać wyniki.

Rzuty
`DeviceNotAvailableException`	w przypadku przejścia urządzenia w tryb offline.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

osoby przygotowujące test, w tym osoby przygotowujące na poziomie zestawu (jeśli są określone);

Parametry
`includeSuitePreparers`	`boolean`: ustaw na `true`, aby uruchomić również przygotowujące na poziomie pakietu.

Zwroty
`Throwable`	`Throwable` wszelkich wyjątków zgłoszonych podczas uruchamiania przygotowań.

setBuild

public void setBuild (IBuildInfo build)

Wstrzyknij IBuildInfo, aby użyć go podczas testów.

Parametry
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Włącza lub wyłącza tryb testowy zbierania danych

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij ITestDevice, aby użyć go podczas testów.

Parametry
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Określa, czy pobieranie dynamiczne ma być włączone 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ż modułowi narzędzie do zapisywania logów wywołania, aby mógł z niego skorzystać w razie potrzeby.

Parametry
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Określa, czy należy scalić wyniki.

Parametry
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

Wstrzyknij listę IMetricCollector, której ma używać moduł.

Parametry
`collectors`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Zestawy powinny przywrócić wirtualne urządzenie.

Parametry
`recoverVirtualDevice`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Ustawia wartość IRetryDecision, która ma być używana do ponownego próbowania w ramach modułu.

Parametry
`decision`	`IRetryDecision`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Zwraca wartość informują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ń na poziomie pakietu.

Parametry
`mSuiteConfiguration`	`IConfiguration`

Chronione metody

hasTests

protected boolean hasTests ()

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

Zwroty
`boolean`