Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Q2 dan Q4. Untuk membuat dan berkontribusi ke AOSP, gunakan android-latest-release. Cabang manifes android-latest-release akan selalu merujuk ke rilis terbaru yang dikirim ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Listener 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 kondisi error tertentu.
`void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`void`	`invocationStarted(IInvocationContext context)` Melaporkan dimulainya pemanggilan pengujian.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Melaporkan akhir eksekusi kasus pengujian individu.
`void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individu.
`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)` Menyediakan data log atau debug terkait dari pemanggilan pengujian.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Melaporkan akhir eksekusi pengujian.
`void`	`testRunFailed(String errorMessage)` Uji coba laporan gagal diselesaikan karena terjadi error fatal.
`void`	`testRunStarted(String runName, int testCount)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStopped(long elapsedTime)` Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.
`void`	`testStarted(TestDescription test)` Melaporkan dimulainya kasus pengujian individu.

Metode yang dilindungi
`TestDescription`	`mangleTestId(TestDescription test)` Metode ini dijalankan pada semua `TestDescription` yang diteruskan ke callback `testStarted(TestDescription)`, `testFailed(TestDescription,String)`, dan `testEnded(TestDescription,HashMap)`.
`String`	`mangleTestRunName(String name)` Metode ini dijalankan pada semua nama proses pengujian 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 proses, atau null

invocationEnded

public void invocationEnded (long elapsedTime)

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

Akan dipanggil secara otomatis 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 kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan dimulainya pemanggilan pengujian.

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

Parameter
`context`	`IInvocationContext`: informasi tentang pemanggilan

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

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

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Melaporkan akhir eksekusi kasus pengujian individu.

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

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`testMetrics`	`HashMap`: `Map` metrik yang dikeluarkan

testFailed

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individu.

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)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) 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". Catatan dataName mungkin tidak unik per pemanggilan. Artinya, pelaksana harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Pelaksana 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Melaporkan akhir eksekusi pengujian. FIXME: Kita tidak dapat memiliki dua antarmuka Map<> dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.

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

testRunFailed

public void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Melaporkan dimulainya proses pengujian.

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

testRunStopped

public void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya

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

testStarted

public void testStarted (TestDescription test)

Melaporkan dimulainya kasus pengujian individu. Antarmuka lama, sebaiknya gunakan testStarted(TestDescription) jika memungkinkan.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

Metode yang dilindungi

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Metode ini dijalankan pada semua TestDescription yang diteruskan ke callback testStarted(TestDescription), testFailed(TestDescription,String), dan testEnded(TestDescription,HashMap). Metode ini akan menampilkan TestDescription yang mungkin berbeda yang akan diteruskan ke ITestInvocationListener hilir yang ditentukan selama konstruksi.

Penerapannya harus dilakukan dengan hati-hati agar tidak mengubah TestDescription asli.

Implementasi default meneruskan ID masuk tanpa diubah.

Parameter
`test`	`TestDescription`

Hasil
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

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

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

Implementasi default meneruskan nama proses pengujian masuk tanpa diubah.

Parameter
`name`	`String`

Hasil
`String`