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.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

Subclass tidak langsung yang umum

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, dan 81 lainnya.

AggregatePostProcessor	Penggabung metrik yang memberikan nilai minimum, maksimum, rata-rata, varians, deviasi standar, total, jumlah, dan secara opsional persentil untuk metrik numerik yang dikumpulkan selama beberapa kali menjalankan pengujian, dengan memperlakukannya sebagai ganda.
AtraceCollector	`IMetricCollector` yang menjalankan atrace selama pengujian dan mengumpulkan hasil serta mencatatnya ke pemanggilan.
AtraceRunMetricCollector	Mengumpulkan rekaman aktivitas dari semua direktori pengujian di direktori yang ditentukan dari perangkat pengujian, mencatat direktori pengujian, dan memproses file rekaman aktivitas setelahnya di direktori pengujian serta menggabungkan metrik.
AveragePostProcessor	Implementasi post-processor yang menghitung rata-rata daftar metrik.
BaseDeviceMetricCollector	Implementasi dasar `IMetricCollector` yang memungkinkan untuk memulai dan menghentikan pengumpulan data di `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` dan `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	`IPostProcessor` dasar yang harus diperluas oleh setiap penerapan.
BluetoothConnectionLatencyCollector	Pengumpul akan mengirimkan konfigurasi metrik durasi statsd yang telah ditentukan sebelumnya ke perangkat dan mengumpulkan durasi koneksi Bluetooth untuk setiap profil.
BluetoothConnectionStateCollector	Pengumpul ini akan mengumpulkan metrik BluetoothConnectionStateChanged dan mencatat jumlah status koneksi untuk setiap profil.
BluetoothConnectionSuccessRatePostProcessor	Penerapan post-prosesor yang menghitung tingkat keberhasilan untuk profil bluetooth Gunakan "metric-key-match" untuk menentukan metrik yang berisi status koneksi bluetooth dalam array numerik Contoh [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Pengumpul untuk mengaktifkan pencatatan log pengintaian HCI Bluetooth di DUT dan mengumpulkan log untuk setiap pengujian.
BugreportCollector	`ITestInvocationListener` pass-through yang mengumpulkan laporan bug saat peristiwa yang dapat dikonfigurasi terjadi, lalu memanggil `ITestInvocationListener.testLog` pada turunannya setelah setiap laporan bug dikumpulkan.
BugreportzOnFailureCollector	Kumpulkan bugreportz saat kasus pengujian gagal.
BugreportzOnTestCaseFailureCollector	Mengumpulkan bugreportz saat kasus pengujian dalam suatu proses gagal.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Clang dari perangkat dan mencatatnya sebagai artefak pengujian.
CodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Java dan native dari perangkat dan mencatatnya sebagai artefak pengujian.
CollectingTestListener	`ITestInvocationListener` yang akan mengumpulkan semua hasil pengujian.
CommandStatusHandler	Handler yang membantu memantau dan memperbarui status pemanggilan.
ConditionFailureMonitor	Pantau kegagalan dari pemanggilan.
ConsoleResultReporter	Pelapor hasil untuk mencetak hasil pengujian ke konsol.
CountTestCasesCollector	Menghitung dan melaporkan jumlah kasus pengujian untuk `IRemoteTest` tertentu.
DebugHostLogOnFailureCollector	Pengumpul yang akan mengumpulkan dan mencatat log sisi host saat terjadi kegagalan kasus pengujian.
DeviceReleaseReporter	Pelapor pelepasan perangkat yang menangani komunikasi dengan proses induk perangkat yang akan dilepaskan.
DeviceTraceCollector	Pengumpul yang akan memulai rekaman aktivitas perfetto saat uji coba dimulai dan mencatat file rekaman aktivitas di akhir.
DeviceUnavailableMonitor	Listener ini mencoba merekam DNAE tingkat kasus pengujian saja.
EventsLoggerListener	Pemroses yang mencatat semua peristiwa yang diterimanya ke dalam file
FileProtoResultReporter	Pelapor proto yang membuang `TestRecord` ke dalam file.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` yang memantau kunci metrik yang berasal dari perangkat dan menarik nya sebagai file dari perangkat.
FilePullerLogCollector	Logger file yang dilaporkan oleh sisi perangkat.
FilteredResultForwarder	Varian `ResultForwarder` yang hanya mengizinkan daftar yang diizinkan dari `TestDescription` untuk dilaporkan.
FormattedGeneratorReporter	Reporter yang memungkinkan pembuatan laporan dalam format tertentu.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan gcov dari perangkat dan mencatatnya sebagai artefak pengujian.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan kernel gcov dari debugfs dan dari perangkat, lalu mencatatnya sebagai artefak pengujian.
GranularRetriableTestWrapper.StartEndCollector	Class helper untuk menangkap awal dan akhir proses yang tidak ada.
HostStatsdMetricCollector	`IMetricCollector` yang mengumpulkan metrik statsd dari sisi host menggunakan perintah utilitas statsd.
ICommandScheduler.IScheduledInvocationListener	Pemroses untuk peristiwa pemanggilan saat pemanggilan selesai.
ILogSaverListener	Memungkinkan `ITestInvocationListener` memproses saat file log disimpan.
IMetricCollector	Antarmuka ini akan ditambahkan sebagai dekorator saat melaporkan hasil pengujian untuk mengumpulkan metrik yang cocok.
IPostProcessor	Post-processor adalah objek Trade Federation yang dimaksudkan untuk memungkinkan pemrosesan metrik dan log SETELAH pengujian dan SEBELUM pelaporan hasil.
IShardableListener	`ITestInvocationListener` yang dapat di-shard.
ISupportGranularResults	Antarmuka yang menentukan apakah `ITestInvocationListener` mendukung penerimaan hasil terperinci atau tidak.
ITestSummaryListener	Antarmuka yang memungkinkan `ITestInvocationListener` bertukar beberapa informasi terbatas melalui ringkasan.
InvocationProtoResultReporter	Reporter untuk menyimpan informasi caching tingkat pemanggilan dan daftar modulnya
InvocationToJUnitResultForwarder	Class yang memproses peristiwa `ITestInvocationListener` dan meneruskannya ke `TestListener`.
JarHostTest.HostTestListener	Pemroses wrapper yang meneruskan semua peristiwa kecuali testRunStarted() dan testRunEnded() ke pemroses yang disematkan.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Java dari perangkat dan mencatatnya sebagai artefak pengujian.
JsonHttpTestResultReporter	Pelapor hasil yang mengenkode hasil metrik pengujian dan info cabang, perangkat ke dalam JSON dan POST ke endpoint layanan HTTP
LUCIResultReporter	Pelapor hasil yang menyimpan hasil pengujian yang diperlukan oleh ResultDB dan LUCI ke dalam format JSON (go/result-sink) dan mencatat lokasi file di konsol.
LastShardDetector	Saat menjalankan sharding lokal, terkadang kita hanya ingin menjalankan beberapa tindakan saat shard terakhir mencapai `invocationEnded(long)`.
LegacySubprocessResultsReporter	Implementasi yang dibekukan dari pelapor hasil subproses yang harus tetap kompatibel dengan versi TF/CTS sebelumnya (misalnya 8+), meskipun ada perubahan pada superclass-nya.
LogSaverResultForwarder	`ResultForwarder` untuk menyimpan log dengan penyimpan file global.
LogcatCrashResultForwarder	Pemroses khusus: jika terjadi kegagalan (proses instrumentasi error), pemroses ini akan mencoba mengekstrak error dari logcat dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian.
LogcatOnFailureCollector	Pengumpul yang akan merekam dan mencatat logcat saat kasus pengujian gagal.
LogcatTimingMetricCollector	Pengumpul metrik yang mengumpulkan informasi pengaturan waktu (misalnya, waktu peralihan pengguna) dari logcat selama satu atau beberapa pengujian berulang dengan menggunakan pola regex tertentu untuk mengurai sinyal mulai dan akhir peristiwa dari baris logcat.
MetricFilePostProcessor	Digunakan untuk mengupload file log metrik yang dikumpulkan selama pengujian dan tingkat eksekusi.
MetricsXMLResultReporter	MetricsXMLResultReporter menulis metrik pengujian dan metrik run ke file XML dalam folder yang ditentukan oleh parameter metrics-folder pada fase invocationEnded pengujian.
ModuleListener	Listener dilampirkan ke setiap `IRemoteTest` setiap modul untuk mengumpulkan daftar hasil.
ModuleLogcatCollector	Versi pengumpul logcat, tetapi untuk modul.
ModuleProtoResultReporter	Pelapor hasil yang dimaksudkan untuk melaporkan hanya hasil tingkat modul.
ModuleResultsAndMetricsForwarder	Ekstensi `ResultAndLogForwarder` yang menambahkan metrik terkait modul tambahan ke hasil pengujian.
NameMangleListener	Listener proxy untuk menerjemahkan nama metode, class, dan paket pengujian saat hasil dilaporkan.
PassingTestFileReporter	`ITestInvocationListener` yang menyimpan daftar kasus pengujian yang lulus ke file pengujian
PerfettoFilePullerCollector	Pengumpul yang menarik file rekaman aktivitas Perfetto dari perangkat, mengompresinya secara opsional, dan menambahkannya ke log pengujian.
PerfettoGenericPostProcessor	Post-prosesor yang memproses file proto perfetto metrik biner/teks menjadi key-value pair dengan memperluas pesan dan kolom proto secara rekursif dengan nilai string hingga kolom dengan nilai numerik ditemukan.
PerfettoPullerMetricCollector	Class ini tidak digunakan lagi. Sebagai gantinya, gunakan `PerfettoFilePullerCollector` dan `ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	Post-prosesor yang mengambil file rekaman aktivitas Perfetto dari log pengujian dan menjalankan prosesor rekaman aktivitas pada file tersebut untuk menghasilkan proto metrik Perfetto.
PrettyTestEventLogger	Logger yang cocok dengan peristiwa dan mencatatnya agar lebih mudah di-debug.
ProtoResultReporter	Pelapor hasil membuat protobuf `TestRecord` dengan semua hasil di dalamnya.
PythonBinaryHostTest.PythonForwarder	Penerusan hasil untuk mengganti nama operasi dengan nama biner.
RebootReasonCollector	Pengumpul yang mengumpulkan reboot perangkat selama menjalankan pengujian dan melaporkannya berdasarkan alasan dan jumlah.
RemoteTestTimeOutEnforcer	Listener yang memungkinkan untuk memeriksa waktu eksekusi konfigurasi pengujian tertentu dan gagal jika melebihi waktu tunggu tertentu.
ReportPassedTests	Melaporkan kemungkinan filter dalam file untuk mengecualikan pengujian yang lulus.
ResultAggregator	Forwarder khusus yang menggabungkan hasil jika diperlukan, berdasarkan strategi percobaan ulang yang dilakukan.
ResultAndLogForwarder	Forwarder untuk hasil dan peristiwa log.
ResultDBReporter	Pelapor hasil yang mengupload hasil pengujian ke ResultDB.
ResultForwarder	`ITestInvocationListener` yang meneruskan hasil pemanggilan ke daftar pendengar lainnya.
ResultReporter
RetryLogSaverResultForwarder	Forwarder yang juga menangani upaya saat ini yang sedang kita lakukan.
RetryResultForwarder	Ekstensi `ResultForwarder` yang selalu mendorong ke nomor upaya tertentu.
RuntimeRestartCollector	Pengumpul yang mengumpulkan stempel waktu mulai ulang runtime (error server sistem) selama pengujian dijalankan, jika ada.
ScreenshotOnFailureCollector	Pengumpul yang akan mengambil dan mencatat screenshot saat kasus pengujian gagal.
ShardListener	`ITestInvocationListener` yang mengumpulkan hasil dari shard pemanggilan (alias pemanggilan dibagi untuk dijalankan secara paralel di beberapa resource), dan meneruskannya ke pendengar lain.
ShardMainResultForwarder	`ResultForwarder` yang menggabungkan hasil pemanggilan pengujian yang di-sharding.
ShowmapPullerMetricCollector	Implementasi dasar `FilePullerDeviceMetricCollector` yang memungkinkan penarikan file showmap dari perangkat dan pengumpulan metrik darinya.
StatsdBeforeAfterGaugeMetricPostProcessor	Post-prosesor yang memproses metrik pengukur yang dikumpulkan dengan pendekatan "sebelum/sesudah", yaitu
StatsdEventMetricPostProcessor	Post-prosesor yang memproses metrik peristiwa dalam laporan statsd menjadi pasangan nilai kunci, menggunakan pemformat yang ditentukan pada prosesor.
StatsdGenericPostProcessor	Post-prosesor yang memproses laporan statsd proto biner menjadi pasangan nilai kunci dengan memperluas laporan sebagai struktur hierarki.
StreamProtoResultReporter	Implementasi `ProtoResultReporter`
SubprocessResultsReporter	Menerapkan `ITestInvocationListener` untuk ditentukan sebagai result_reporter dan meneruskan dari subproses hasil pengujian, menjalankan pengujian, pemanggilan pengujian.
SuiteResultReporter	Mengumpulkan hasil pengujian untuk seluruh pemanggilan rangkaian pengujian dan menghasilkan hasil akhir.
TestRunResultListener	Listener yang memungkinkan untuk membaca status akhir proses pengujian.
TestTimeoutEnforcer	Listener yang memungkinkan untuk memeriksa waktu eksekusi kasus pengujian tertentu dan gagal jika melebihi waktu tunggu tertentu.
TextResultReporter	Pelapor hasil pengujian yang meneruskan hasil ke pencetak hasil teks JUnit.
TraceCmdCollector	`IMetricCollector` yang mengumpulkan rekaman aktivitas selama pengujian menggunakan trace-cmd, dan mencatatnya ke pemanggilan.
TradefedSandboxRunner.StubScheduledInvocationListener	Stub `IScheduledInvocationListener` yang tidak melakukan apa pun.
XmlFormattedGeneratorReporter	Implementasi `FormattedGeneratorReporter` yang memformat hasil rangkaian pengujian dalam format xml.
XmlResultReporter	Menulis hasil JUnit ke file XML dalam format yang konsisten dengan XMLJUnitResultFormatter Ant.

Listener untuk hasil pengujian dari pemanggilan pengujian.

Pemanggilan pengujian itu sendiri dapat mencakup beberapa proses pengujian, sehingga urutan panggilan akan menjadi

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

Ringkasan

Metode publik
`default TestSummary`	`getSummary()` Memungkinkan InvocationListener menampilkan ringkasan.
`default void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena kondisi error tertentu.
`default void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`default void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`default void`	`invocationInterrupted()` Dipanggil saat scheduler dimatikan, memberikan kesempatan kepada pemanggilan untuk melakukan sesuatu sebelum berakhir.
`default void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`default void`	`invocationStarted(IInvocationContext context)` Melaporkan dimulainya pemanggilan pengujian.
`default void`	`testModuleEnded()` Melaporkan akhir proses modul.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul berjalan.

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

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`: `Throwable` penyebab kegagalan

invocationInterrupted

public void invocationInterrupted ()

Dipanggil saat scheduler dimatikan, memberikan kesempatan kepada pemanggilan untuk melakukan sesuatu sebelum berakhir.

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

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul 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.