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 używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Słuchacz proxy do tłumaczenia nazw metod testowych, klas i pakietów w miarę raportowania wyników.

Podsumowanie

Konstruktory publiczne
`NameMangleListener(ITestInvocationListener listener)`

Metody publiczne
`TestSummary`	`getSummary()` Umożliwia interfejsowi InvocationListener zwracanie podsumowania.
`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(Throwable cause)` Zgłasza niekompletne wywołanie z powodu błędu.
`void`	`invocationStarted(IInvocationContext context)` Zgłasza rozpoczęcie wywołania testu.
`void`	`testAssumptionFailure(TestDescription test, String trace)` 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`	`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)` Zawiera powiązane dane dziennika lub dane debugowania z wywołania testu.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Zgłasza zakończenie sesji testowej.
`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)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStopped(long elapsedTime)` Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.
`void`	`testStarted(TestDescription test)` Zgłasza rozpoczęcie pojedynczego elementu testowania.

Metody chronione
`TestDescription`	`mangleTestId(TestDescription test)` Ta metoda jest uruchamiana na wszystkich obiektach `TestDescription` przekazywanych do wywołań zwrotnych `testStarted(TestDescription)`, `testFailed(TestDescription,String)` i `testEnded(TestDescription,HashMap)`.
`String`	`mangleTestRunName(String name)` Ta metoda jest uruchamiana w przypadku wszystkich nazw przebiegów testów przekazywanych do wywołania zwrotnego `testRunStarted(String,int)`.

Konstruktory publiczne

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parametry
`listener`	`ITestInvocationListener`

Metody publiczne

getSummary

public TestSummary getSummary ()

Umożliwia interfejsowi InvocationListener zwracanie podsumowania.

Zwraca
`TestSummary`	`TestSummary` podsumowująca bieg lub wartość null.

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 (Throwable cause)

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

Zostanie automatycznie wywołana przez platformę TradeFederation.

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

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,

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

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

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)

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

Musi być wywołana przed ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

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

Parametry
`dataName`	`String`: opisowa nazwa danych, np. „device_logcat”.`String` Uwaga: parametr dataName może nie być unikalny w przypadku każdego wywołania. Oznacza to, że osoby wdrażające muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą dataName.
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: `InputStreamSource` danych. Osoby wdrażające powinny wywołać funkcję createInputStream, aby rozpocząć odczytywanie danych, i po zakończeniu zamknąć wynikowy strumień InputStream. Wywołujący powinni zadbać o to, aby źródło danych było dostępne do momentu zakończenia działania metody testLog.

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

Zgłasza rozpoczęcie sesji testowej.

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

testRunStopped

public void testRunStopped (long elapsedTime)

Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.

TODO: obecnie nieużywane, rozważ usunięcie

Parametry
`elapsedTime`	`long`: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)

testStarted

public void testStarted (TestDescription test)

Zgłasza rozpoczęcie pojedynczego elementu testowania. Jest to starszy interfejs; o ile to możliwe, używaj testStarted(TestDescription).

Parametry
`test`	`TestDescription`: identyfikuje test

Metody chronione

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Ta metoda jest uruchamiana na wszystkich obiektach TestDescription przekazywanych do wywołań zwrotnych testStarted(TestDescription), testFailed(TestDescription,String) i testEnded(TestDescription,HashMap). Metoda powinna zwracać potencjalnie inny obiekt TestDescription, który zostanie przekazany do obiektu ITestInvocationListener niższego poziomu określonego podczas tworzenia.

Implementacja powinna uważać, aby nie modyfikować oryginalnego TestDescription.

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

Parametry
`test`	`TestDescription`

Zwraca
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Ta metoda jest uruchamiana w przypadku wszystkich nazw przebiegów testów przekazywanych do wywołania zwrotnego testRunStarted(String,int). Metoda powinna zwracać potencjalnie inną nazwę testu, która zostanie przekazana do dalszego ITestInvocationListener określonego podczas tworzenia.

Implementacja nie powinna modyfikować oryginalnej nazwy uruchomienia.

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

Parametry
`name`	`String`

Zwraca
`String`