Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

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`	`MODULE_ABI`
`public static final String`	`MODULE_CONTROLLER`
`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_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`	`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`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

Konstruktory publiczne
`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.
`IInvocationContext`	`getModuleInvocationContext()` Zwraca wartość `IInvocationContext` powiązaną z modułem.
	`getRequiredTokens()`
`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`	`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, TestFailureListener failureListener)` 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.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` 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`	`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ł.
`final void`	`setRetryDecision(IRetryDecision decision)` Ustawia wartość `IRetryDecision`, która ma być używana do ponownego próbowania w ramach modułu.
`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

MODULE_ABI

public static final String MODULE_ABI

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

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_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

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

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Konstruktory publiczne

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`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Zwraca wartość IInvocationContext powiązaną z modułem.

Zwroty
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens ()

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`

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, 
                TestFailureListener failureListener)

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.
`failureListener`	`TestFailureListener`: konkretny odbiorca, który ma zbierać logi w przypadku testFail. Może być puste.

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.

home run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener, 
                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.
`failureListener`	`TestFailureListener`: konkretny odbiorca, który ma zbierać logi w przypadku testFail. Może być puste.
`maxRunLimit`	`int`: maksymalna liczba uruchomień każdego testu.

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`

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`

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`

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`