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.

EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

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

Pemroses yang mencatat semua peristiwa yang diterimanya ke dalam file

Ringkasan

Konstruktor publik
`EventsLoggerListener(String name)`

Metode publik
`File`	`getLoggedEvents()`
`void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena kondisi error tertentu.
`void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`void`	`invocationStarted(IInvocationContext context)` Melaporkan dimulainya pemanggilan pengujian.
`void`	`logAssociation(String dataName, LogFile logFile)` Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` langsung tidak memungkinkan.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternatif untuk `testEnded(TestDescription,Map)` tempat kita dapat menentukan waktu berakhir secara langsung.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Melaporkan kegagalan 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`	`testModuleEnded()` Melaporkan akhir proses modul.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.
`void`	`testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)` Melaporkan akhir eksekusi pengujian.
`void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` Uji coba laporan gagal diselesaikan karena terjadi error fatal.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStarted(String runName, int testCount)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Melaporkan dimulainya proses pengujian.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan.
`void`	`testStarted(TestDescription test, long startTime)` Alternatif untuk `testStarted(TestDescription)` yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan `testEnded(TestDescription,long,Map)` untuk pengukuran yang akurat.

Konstruktor publik

EventsLoggerListener

public EventsLoggerListener (String name)

Parameter
`name`	`String`

Metode publik

getLoggedEvents

public File getLoggedEvents ()

Hasil
`File`

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

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan penyebab kegagalan

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
`reason`	`SkipReason`

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback testLogSaved(String,LogDataType,InputStreamSource,LogFile) langsung tidak memungkinkan. Dengan demikian, callback ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.

Parameter
`dataName`	`String`: Nama data
`logFile`	`LogFile`: `LogFile` yang dicatat sebelumnya dan harus dikaitkan dengan kasus pengujian.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

testEnded

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

Alternatif untuk testEnded(TestDescription,Map) tempat kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(TestDescription,long) untuk pengukuran yang akurat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`endTime`	`long`: waktu berakhirnya pengujian, diukur melalui `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `Map` metrik yang dikeluarkan

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

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

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini terkait dengan testModuleEnded() dan bersifat opsional dalam urutan. Hanya digunakan selama menjalankan modul yang menggunakan runner berbasis rangkaian pengujian.

Parameter
`moduleContext`	`IInvocationContext`: `IInvocationContext` modul.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                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
`elapsedTimeMillis`	`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 (FailureDescription failure)

Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

Parameter
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

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

Melaporkan dimulainya proses pengujian.

Parameter
`runName`	`String`: nama uji coba
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada proses baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka akan ada total 4 proses dalam runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Melaporkan dimulainya proses pengujian.

Parameter
`runName`	`String`: nama uji coba
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada run baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka akan ada total 4 run dengan runName yang sama dan attemptNumber dari 0 hingga 3.
`startTime`	`long`: waktu mulai eksekusi, diukur melalui `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba lagi untuk mendapatkan eksekusi yang tepat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(TestDescription) yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan testEnded(TestDescription,long,Map) untuk pengukuran yang akurat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`startTime`	`long`: waktu dimulainya pengujian, diukur melalui `System.currentTimeMillis()`