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.

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 każdego modułu w celu zebrania listy wyników.

Podsumowanie

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

Metody publiczne
`boolean`	`hasLastAttemptFailed()` Zwraca informację, czy ostatnia sesja próby nasłuchiwania się zakończyła niepowodzeniem.
`void`	`logAssociation(String dataName, LogFile logFile)` W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Określa, czy próba powinna być zaraportowana jako próba pojedyncza.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Określa, czy zbieramy tylko testy.
`void`	`setMarkTestsSkipped(boolean skip)` Określ, czy wszystkie przypadki testowe mają być pominięte.
`void`	`setTestMappingSources( testMappingSources)` Ustawia źródła mapowania testowego, które zostaną wstawione do danych.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternatywa dla `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, w której możemy bezpośrednio określić czas zakończenia.
`void`	`testEnded(TestDescription test, testMetrics)` Raportuje zakończenie wykonywania pojedynczego przypadku testowego.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Raportuje niepowodzenie pojedynczego przypadku testowego.
`void`	`testFailed(TestDescription test, String trace)` Raportuje niepowodzenie pojedynczego przypadku testowego.
`void`	`testIgnored(TestDescription test)` Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu 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, runMetrics)` Raportuje zakończenie testu.
`void`	`testRunFailed(FailureDescription failure)` Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` Raportuje rozpoczęcie testu.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Raportuje rozpoczęcie testu.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu.
`void`	`testStarted(TestDescription test, long startTime)` Alternatywa dla `testStarted(com.android.tradefed.result.TestDescription)`, w której określamy też, kiedy test się rozpoczął, w połączeniu z `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))`, aby uzyskać dokładne wyniki.

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 próby nasłuchiwania się zakończyła niepowodzeniem.

Zwroty
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Dzięki temu wywołaniu zwrotnemu można wyraźnie powiązać dane.

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

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Określa, czy próba powinna być zaraportowana jako próba pojedyncza.

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śl, czy wszystkie przypadki testowe mają być pominięte.

Parametry
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Ustawia źródła mapowania testowego, które zostaną wstawione do danych.

Parametry
`testMappingSources`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), w której możemy bezpośrednio określić czas zakończenia. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long).

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiedzie. Zwraca też wszystkie dane klucz-wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
`test`	`TestDescription`: identyfikuje test
`testMetrics`	: `ERROR(/Map)` danych wyemitowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu 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, 
                 runMetrics)

Raportuje zakończenie testu.

Parametry
`elapsedTime`	`long`: czas upłynął, milisekundy zgłoszone przez urządzenie
`runMetrics`	: pary klucz-wartość zgłoszone na końcu wykonania testu

testRunFailed

public void testRunFailed (FailureDescription failure)

Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.

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

testRunFailed

public void testRunFailed (String errorMessage)

Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.

Parametry
`errorMessage`	`String`: `String` opisujący przyczynę niepowodzenia wykonania.

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
`name`	`String`: nazwa testu;
`numTests`	`int`: łączna liczba testów w sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania pod tym samym runName, a attemptNumber będzie miał wartość od 0 do 3.

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
`name`	`String`: nazwa testu;
`numTests`	`int`: łączna liczba testów w sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym nazwą runName, a wartość attemptNumber powinna się zmieniać od 0 do 3.
`startTime`	`long`: czas rozpoczęcia wykonywania zadania, mierzony za pomocą `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Te testy zostaną powtórzone, aby sprawdzić, czy tym razem wszystko się uda.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

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