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.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Słuchający pośrednik służący do tłumaczenia nazw metody testu, klasy i pakietu podczas raportowania wyników.

Podsumowanie

Konstruktory publiczne
`NameMangleListener(ITestInvocationListener listener)`

Metody publiczne
`TestSummary`	`getSummary()` Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.
`void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).
`void`	`invocationFailed(Throwable cause)` zgłasza niepełne wywołanie z powodu błędu.
`void`	`invocationStarted(IInvocationContext context)` Raportuje rozpoczęcie wywołania testu.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
`void`	`testEnded(TestDescription test, testMetrics)` Raportuje zakończenie wykonywania 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)` Zawiera powiązane dane dziennika lub debugowania z wywołania testu.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Raportuje zakończenie testu.
`void`	`testRunFailed(String errorMessage)` Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
`void`	`testRunStarted(String runName, int testCount)` Raportuje rozpoczęcie testu.
`void`	`testRunStopped(long elapsedTime)` Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.
`void`	`testStarted(TestDescription test)` Raportuje rozpoczęcie pojedynczego testu.

Chronione metody
`TestDescription`	`mangleTestId(TestDescription test)` Ta metoda jest wykonywana dla wszystkich wartości `TestDescription` przekazywanych do funkcji zwracających wartości `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)` i `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Ta metoda jest wywoływana w przypadku wszystkich nazw testów, które są przekazywane do funkcji wywołania zwrotnego `testRunStarted(String, int)`.

Konstruktory publiczne

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parametry
`listener`	`ITestInvocationListener`

Metody publiczne

getSummary

public TestSummary getSummary ()

Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.

Zwroty
`TestSummary`	`TestSummary` podsumowujący wykonanie, lub wartość null.

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 (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`

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;

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

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

Zawiera powiązane dane dziennika lub debugowania z wywołania testu.

Musi być wywołany przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Framework TradeFederation automatycznie wywoła tę metodę, podając log hosta i w razie potrzeby logcat urządzenia.

Parametry
`dataName`	`String`: `String`nazwa opisowa danych, np. „device_logcat”. Uwaga: nazwa danych może nie być unikalna dla każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tą samą nazwą danych.
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: `InputStreamSource` danych. Implementatorzy powinni wywołać createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że zamkną powstały strumień wejściowy po zakończeniu. Osoby wywołujące tę metodę powinny zadbać o to, aby źródło danych było dostępne do momentu zakończenia metody testLog.

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 (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 runName, 
                int testCount)

Raportuje rozpoczęcie testu.

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

testRunStopped

public void testRunStopped (long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

TODO: currently unused, consider removing

Parametry
`elapsedTime`	`long`: czas upłynął, milisekundy zgłoszone przez urządzenie

testStarted

public void testStarted (TestDescription test)

Raportuje rozpoczęcie pojedynczego testu. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription).

Parametry
`test`	`TestDescription`: identyfikuje test

Chronione metody

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Ta metoda jest wykonywana dla wszystkich wartości TestDescription przekazywanych do funkcji zwracających wartości testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). Metoda powinna zwrócić TestDescription, który może być inny niż ITestInvocationListener przekazywany do następnego ITestInvocationListener, który został określony podczas tworzenia.

Implementacja powinna być ostrożna, aby nie zmodyfikować oryginalnego TestDescription.

Domyślna implementacja przekazuje przychodzący identyfikator bez zmian.

Parametry
`test`	`TestDescription`

Zwroty
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Ta metoda jest wywoływana w przypadku wszystkich nazw testów, które są przekazywane do funkcji wywołania zwrotnego testRunStarted(String, int). Metoda powinna zwracać nazwę testu, która może być inna niż nazwa przekazywana do ITestInvocationListener, która została określona podczas tworzenia.

Implementacja powinna być ostrożna, aby nie zmodyfikować pierwotnej nazwy uruchomienia.

Domyślna implementacja przekazuje przychodzącą nazwę testu bez zmian.

Parametry
`name`	`String`

Zwroty
`String`