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.

ResultAggregator

public class ResultAggregator
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.retry.ResultAggregator

Specjalny przekierowujący, który w razie potrzeby agreguje wyniki na podstawie wybranej strategii ponownego próby.

Podsumowanie

Konstruktory publiczne
`ResultAggregator( listeners, RetryStrategy strategy)`

Metody publiczne
`void`	`cleanEventsFiles()`
`final void`	`forwardAggregatedInvocationLogs()` Przesyłaj do raportów wyników wszystkie dzienniki na poziomie wywołania, które nie obsługują szczegółowych wyników.
`void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)` zgłasza niepełne wywołanie z powodu błędu.
`void`	`invocationSkipped(SkipReason reason)` zgłasza wywołanie jako pominięte;
`void`	`invocationStarted(IInvocationContext context)` Raportuje rozpoczęcie wywołania testu.
`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`	`setLogSaver(ILogSaver logSaver)`
`void`	`setUpdatedReporting(boolean updatedReporting)` Ustawia nowe raportowanie.
`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`	`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`	`testModuleEnded()` Raportuje koniec wykonania modułu.
`void`	`testModuleStarted(IInvocationContext moduleContext)` zgłasza rozpoczęcie działania modułu.
`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 testCount, 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.

Chronione metody
`File[]`	`getEventsLogs()`

Konstruktory publiczne

ResultAggregator

public ResultAggregator ( listeners, 
                RetryStrategy strategy)

Parametry
`listeners`
`strategy`	`RetryStrategy`

Metody publiczne

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

Przesyłaj do raportów wyników wszystkie dzienniki na poziomie wywołania, które nie obsługują szczegółowych wyników.

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
`elapsedTime`	`long`: upłynął czas wywołania w ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Parametry
`failure`	`FailureDescription`

invocationFailed

public void invocationFailed (Throwable cause)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
`cause`	`Throwable`: przyczyna niepowodzenia `Throwable`

invocationSkipped

public void invocationSkipped (SkipReason reason)

zgłasza wywołanie jako pominięte;

Parametry
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

Będzie wywoływany automatycznie przez platformę TradeFederation. Aby umożliwić raportowanie z kilku urządzeń, autorzy raportów muszą zastąpić tę metodę.

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

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.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Parametry
`logSaver`	`ILogSaver`

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

Ustawia nowe raportowanie.

Parametry
`updatedReporting`	`boolean`

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

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`

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas wykonywania testu, który korzysta z modułów: modułów opartych na zestawach.

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

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 testCount, 
                int attemptNumber, 
                long startTime)

Raportuje rozpoczęcie testu.

Parametry
`name`	`String`: nazwa testu;
`testCount`	`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()`

Chronione metody

getEventsLogs

protected File[] getEventsLogs ()

Zwroty
`File[]`