Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Pemroses proxy untuk menerjemahkan nama metode, class, dan paket pengujian saat hasil dilaporkan.

Ringkasan

Konstruktor publik
`NameMangleListener(ITestInvocationListener listener)`

Metode publik
`TestSummary`	`getSummary()` Memungkinkan InvocationListener menampilkan ringkasan.
`void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.
`void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`void`	`invocationStarted(IInvocationContext context)` Melaporkan awal pemanggilan pengujian.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`void`	`testEnded(TestDescription test, testMetrics)` Melaporkan akhir eksekusi setiap kasus pengujian.
`void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individual.
`void`	`testIgnored(TestDescription test)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Memberikan data log atau debug terkait dari pemanggilan pengujian.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Melaporkan akhir pengujian yang dijalankan.
`void`	`testRunFailed(String errorMessage)` Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
`void`	`testRunStarted(String runName, int testCount)` Melaporkan awal pengujian yang dijalankan.
`void`	`testRunStopped(long elapsedTime)` Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.
`void`	`testStarted(TestDescription test)` Melaporkan awal setiap kasus pengujian.

Metode yang dilindungi
`TestDescription`	`mangleTestId(TestDescription test)` Metode ini dijalankan di semua `TestDescription` yang diteruskan ke callback `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)`, dan `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Metode ini dijalankan pada semua nama pengujian yang dijalankan yang diteruskan ke callback `testRunStarted(String, int)`.

Konstruktor publik

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parameter
`listener`	`ITestInvocationListener`

Metode publik

getSummary

public TestSummary getSummary ()

Memungkinkan InvocationListener menampilkan ringkasan.

Hasil
`TestSummary`	`TestSummary` yang meringkas operasi, atau null

invocationEnded

public void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
`elapsedTime`	`long`: waktu yang berlalu dari pemanggilan dalam md

invocationFailed

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
`cause`	`Throwable`: `Throwable` penyebab kegagalan

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

Akan otomatis dipanggil oleh framework TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.

Parameter
`context`	`IInvocationContext`: informasi tentang pemanggilan

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`trace`	`String`: stack trace kegagalan

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini akan lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`testMetrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testFailed

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`trace`	`String`: stack trace kegagalan

testIgnored

public void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Memberikan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(/ITestInvocationListener#invocationFailed(Throwable)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

Framework TradeFederation akan otomatis memanggil metode ini, yang menyediakan log host dan jika berlaku, logcat perangkat.

Parameter
`dataName`	`String`: nama deskriptif `String` data. misalnya, "device_logcat". Perhatikan bahwa dataName mungkin tidak unik per pemanggilan. Artinya, pengimplementasi harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Implementator harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

Parameter
`elapsedTime`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik
`runMetrics`	: pasangan nilai kunci yang dilaporkan di akhir pengujian

testRunFailed

public void testRunFailed (String errorMessage)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

Parameter
`errorMessage`	`String`: `String` yang menjelaskan alasan kegagalan operasi.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Melaporkan awal pengujian yang dijalankan.

Parameter
`runName`	`String`: nama operasi pengujian
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian

testRunStopped

public void testRunStopped (long elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testStarted

public void testStarted (TestDescription test)

Melaporkan awal setiap kasus pengujian. Antarmuka lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) jika memungkinkan.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

Metode yang dilindungi

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Metode ini dijalankan di semua TestDescription yang diteruskan ke callback testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String), dan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). Metode ini akan menampilkan TestDescription yang mungkin berbeda yang akan diteruskan ke ITestInvocationListener downstream yang ditentukan selama konstruksi.

Implementasi harus berhati-hati agar tidak mengubah TestDescription asli.

Implementasi default meneruskan ID yang masuk tanpa diubah.

Parameter
`test`	`TestDescription`

Hasil
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Metode ini dijalankan pada semua nama pengujian yang dijalankan yang diteruskan ke callback testRunStarted(String, int). Metode ini akan menampilkan nama pengujian yang mungkin berbeda yang akan diteruskan ke ITestInvocationListener downstream yang ditentukan selama konstruksi.

Implementasi harus berhati-hati agar tidak mengubah nama operasi asli.

Implementasi default meneruskan nama pengujian yang masuk tanpa diubah.

Parameter
`name`	`String`

Hasil
`String`