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.

EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.EventsLoggerListener

Odbiornik, który rejestruje wszystkie otrzymane zdarzenia w pliku

Podsumowanie

Konstruktory publiczne
`EventsLoggerListener(String name)`

Metody publiczne
`File`	`getLoggedEvents()`
`void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.
`void`	`invocationFailed(FailureDescription failure)` Zgłasza niekompletne wywołanie z powodu błędu.
`void`	`invocationSkipped(SkipReason reason)` Zgłasza wywołanie jako pominięte
`void`	`invocationStarted(IInvocationContext context)` Zgłasza rozpoczęcie wywołania testu.
`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`	`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, 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`	`testModuleEnded()` Zgłasza zakończenie działania modułu.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Zgłasza rozpoczęcie działania modułu.
`void`	`testRunEnded(long elapsedTimeMillis, 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 runName, int testCount, int attemptNumber)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStarted(String runName, int testCount)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStarted(String runName, int testCount, 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

EventsLoggerListener

public EventsLoggerListener (String name)

Parametry
`name`	`String`

Metody publiczne

getLoggedEvents

public File getLoggedEvents ()

Zwraca
`File`

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`elapsedTime`	`long`: czas trwania wywołania w milisekundach.

invocationFailed

public void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`failure`	`FailureDescription`: `FailureDescription` opisująca przyczynę niepowodzenia.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Zgłasza rozpoczęcie wywołania testu.

Zostanie automatycznie wywołana przez platformę TradeFederation. Aby obsługiwać raportowanie z wielu urządzeń, reporterzy muszą zastąpić tę metodę.

Parametry
`context`	`IInvocationContext`: informacje o wywołaniu,

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.

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

testModuleEnded

public void testModuleEnded ()

Zgłasza zakończenie działania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Zgłasza rozpoczęcie działania modułu. Ten wywołanie zwrotne jest powiązane z elementem testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas uruchamiania modułów: narzędzi uruchamiających opartych na pakietach.

Parametry
`moduleContext`	`IInvocationContext`: `IInvocationContext` modułu.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                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
`elapsedTimeMillis`	`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 runName, 
                int testCount, 
                int attemptNumber)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`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 runName, 
                int testCount)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`int`: łączna liczba testów podczas sesji testowej

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`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()`