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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

Detektor dołączony do każdego IRemoteTest w każdym module w celu zebrania listy wyników.

Podsumowanie

Konstruktory publiczne
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Konstruktor.

Metody publiczne
`boolean`	`hasLastAttemptFailed()` Zwraca informację, czy ostatnia sesja ponawiania procesu nasłuchującego zakończyła się niepowodzeniem.
`void`	`logAssociation(String dataName, LogFile logFile)` W niektórych przypadkach dziennik musi być ściśle powiązany z przypadkami testowymi, ale nie można tego zrobić w bezpośrednim wywołaniu zwrotnym `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Określa, czy próba powinna być zgłaszana jako odizolowana.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Określa, czy zbieramy tylko testy.
`void`	`setMarkTestsSkipped(boolean skip)` Określ, czy wszystkie przypadki testowe mają być oznaczone jako pominięte.
`void`	`setTestMappingSources(List<String> testMappingSources)` Określa źródła mapowania testów, które zostaną wstawione do danych.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Zgłasza zakończenie wykonania pojedynczego elementu testowania.
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternatywa dla `testEnded(TestDescription,Map)`, w której możemy bezpośrednio określić czas zakończenia.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Zgłasza niepowodzenie pojedynczego elementu testowania.
`void`	`testFailed(TestDescription test, String trace)` Zgłasza niepowodzenie pojedynczego elementu testowania.
`void`	`testIgnored(TestDescription test)` Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Zgłasza zakończenie sesji testowej.
`void`	`testRunFailed(FailureDescription failure)` Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana.
`void`	`testStarted(TestDescription test, long startTime)` Alternatywa dla `testStarted(TestDescription)`, w której podajemy też datę rozpoczęcia testu, w połączeniu z `testEnded(TestDescription,long,Map)`, aby uzyskać dokładny pomiar.

Konstruktory publiczne

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Konstruktor.

Parametry
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

Metody publiczne

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Zwraca informację, czy ostatnia sesja ponawiania procesu nasłuchującego zakończyła się niepowodzeniem.

Zwraca
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach dziennik musi być ściśle powiązany z przypadkami testowymi, ale nie można tego zrobić w bezpośrednim wywołaniu zwrotnym testLogSaved(String,LogDataType,InputStreamSource,LogFile). Dzięki temu wywołaniu zwrotnemu można wyraźnie określić silne powiązanie.

Parametry
`dataName`	`String`: nazwa danych
`logFile`	`LogFile`: `LogFile`, który został zarejestrowany wcześniej i powinien być powiązany z elementem testowania.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Określa, czy próba powinna być zgłaszana jako odizolowana.

Parametry
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Określa, czy zbieramy tylko testy.

Parametry
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Określa, czy wszystkie przypadki testowe mają być oznaczone jako pominięte.

Parametry
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

Określa źródła mapowania testów, które zostaną wstawione do danych.

Parametry
`testMappingSources`	`List`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parametry
`useModuleResultsForwarder`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

Parametry
`test`	`TestDescription`: identyfikuje test
`trace`	`String`: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

Parametry
`test`	`TestDescription`: identyfikuje test
`failure`	`FailureDescription`: `FailureDescription` opisuje błąd i jego kontekst.

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Zgłasza zakończenie wykonania pojedynczego elementu testowania.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test uznaje się za zaliczony. Zwraca też wszystkie dane klucz/wartość, które mogły zostać wyemitowane podczas wykonywania elementu testowania.

Parametry
`test`	`TestDescription`: identyfikuje test
`testMetrics`	`HashMap`: `Map` danych wygenerowanych

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatywa dla testEnded(TestDescription,Map), w której możemy bezpośrednio określić czas zakończenia. Łącz z testStarted(TestDescription,long), aby uzyskać dokładne pomiary.

Parametry
`test`	`TestDescription`: identyfikuje test
`endTime`	`long`: czas zakończenia testu mierzony za pomocą `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `Map` danych wygenerowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

Parametry
`test`	`TestDescription`: identyfikuje test
`failure`	`FailureDescription`: `FailureDescription` opisuje błąd i jego kontekst.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

Parametry
`test`	`TestDescription`: identyfikuje test
`trace`	`String`: zrzut stosu błędu

testIgnored

public void testIgnored (TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

Parametry
`test`	`TestDescription`: identyfikuje test

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Parametry
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parametry
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Zgłasza zakończenie sesji testowej. FIXME: Nie możemy mieć dwóch interfejsów Map<> z różnymi typami, więc musimy tutaj użyć HashMap.

Parametry
`elapsedTime`	`long`: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)
`runMetrics`	`HashMap`: pary klucz/wartość zgłaszane na zakończenie sesji testowej z parametrem `Metric`.

testRunFailed

public void testRunFailed (FailureDescription failure)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez FailureDescription.

Parametry
`failure`	`FailureDescription`: `FailureDescription` opisuje błąd i jego kontekst.

testRunFailed

public void testRunFailed (String errorMessage)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.

Parametry
`errorMessage`	`String`: `String` opisuje przyczynę niepowodzenia uruchomienia.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`name`	`String`: nazwa sesji testowej
`numTests`	`int`: łączna liczba testów podczas sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Numer próby jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest ponownie uruchamiany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tą samą nazwą uruchomienia, a numer próby powinien wynosić od 0 do 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`name`	`String`: nazwa sesji testowej
`numTests`	`int`: łączna liczba testów podczas sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Wartość attemptNumber jest indeksowana od zera i powinna zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Na przykład jeśli test jest ponownie uruchamiany 3 razy, powinien mieć łącznie 4 uruchomienia pod tą samą nazwą runName, a wartość attemptNumber powinna wynosić od 0 do 3.
`startTime`	`long`: czas rozpoczęcia uruchomienia mierzony za pomocą `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana. Te testy będą ponawiane, aby uzyskać prawidłowe wykonanie.

Parametry
`test`	`TestDescription`: identyfikuje test
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(TestDescription), w której podajemy też datę rozpoczęcia testu, w połączeniu z testEnded(TestDescription,long,Map), aby uzyskać dokładny pomiar.

Parametry
`test`	`TestDescription`: identyfikuje test
`startTime`	`long`: czas rozpoczęcia testu mierzony za pomocą `System.currentTimeMillis()`