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 77 lainnya.

AggregatePostProcessor	Agregator metrik yang memberikan nilai minimum, maksimum, rata-rata, varians, simpangan baku, total, jumlah, dan persentil opsional untuk metrik numerik yang dikumpulkan selama pengujian beberapa iterasi berjalan, memperlakukannya sebagai bilangan ganda.
AtraceCollector	`IMetricCollector` yang menjalankan atrace selama pengujian dan mengumpulkan hasilnya serta mencatatnya ke dalam log untuk pemanggilan.
AtraceRunMetricCollector	Mengumpulkan rekaman aktivitas dari semua direktori pengujian di direktori tertentu dari perangkat pengujian, mencatat direktori pengujian dan memproses ulang file rekaman aktivitas 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 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 implementasi.
BluetoothConnectionLatencyCollector	Pengumpul akan mendorong 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 nomor status koneksi untuk setiap profil.
BluetoothConnectionSuccessRatePostProcessor	Implementasi postprocessor 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 logging snoop HCI Bluetooth di DUT dan mengumpulkan log untuk setiap pengujian.
BugreportCollector	`ITestInvocationListener` pass-through yang mengumpulkan bugreport saat peristiwa yang dapat dikonfigurasi terjadi, lalu memanggil `ITestInvocationListener.testLog` pada turunannya setelah setiap bugreport dikumpulkan.
BugreportzOnFailureCollector	Mengumpulkan bugreportz saat kasus pengujian gagal.
BugreportzOnTestCaseFailureCollector	Mengumpulkan bugreportz saat kasus pengujian dalam proses gagal.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Clang dari perangkat dan mencatatnya sebagai artefak pengujian.
CodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan native dan Java dari perangkat dan mencatatnya sebagai artefak pengujian.
CollectingTestListener	`ITestInvocationListener` yang akan mengumpulkan semua hasil pengujian.
CommandStatusHandler	Pengendali 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 kegagalan kasus pengujian terjadi.
DeviceReleaseReporter	Pelapor rilis perangkat yang menangani komunikasi dengan proses induk perangkat yang akan dirilis.
DeviceTraceCollector	Kolektor yang akan memulai rekaman aktivitas perfetto saat pengujian dimulai dan mencatat file rekaman aktivitas di bagian akhir.
DeviceUnavailableMonitor	Pemroses ini hanya mencoba mengambil DNAE tingkat kasus pengujian.
EventsLoggerListener	Pemroses yang mencatat semua peristiwa yang diterimanya ke dalam file
FileProtoResultReporter	Pelapor proto yang membuang `TestRecord` ke dalam file.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` yang memproses kunci metrik yang berasal dari perangkat dan menariknya sebagai file dari perangkat.
FilePullerLogCollector	Logger file yang dilaporkan oleh sisi perangkat.
FilteredResultForwarder	Varian `ResultForwarder` yang hanya mengizinkan daftar yang diizinkan `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 akhirnya mencatatnya sebagai artefak pengujian.
GranularRetriableTestWrapper.StartEndCollector	Helper class untuk menangkap awal dan akhir run 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 kapan 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-sharding.
ISupportGranularResults	Antarmuka yang menentukan apakah `ITestInvocationListener` mendukung penerimaan hasil terperinci atau tidak.
ITestSummaryListener	Antarmuka yang memungkinkan `ITestInvocationListener` bertukar beberapa informasi terbatas melalui ringkasan.
InvocationProtoResultReporter	Pelapor untuk menyimpan informasi penyimpanan dalam cache 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 tersemat.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Java dari perangkat dan mencatatnya sebagai artefak pengujian.
JsonHttpTestResultReporter	Pelapor hasil yang mengenkode hasil metrik pengujian dan cabang, info 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 beku dari pelapor hasil subproses yang harus tetap kompatibel dengan TF/CTS versi sebelumnya (misalnya 8+), meskipun ada perubahan pada superclass-nya.
LogSaverResultForwarder	`ResultForwarder` untuk menyimpan log dengan file saver global.
LogcatCrashResultForwarder	Pemroses khusus: jika terjadi kegagalan (proses instrumentasi mengalami error), pemroses akan mencoba mengekstrak error dari logcat dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian.
LogcatOnFailureCollector	Pengumpul yang akan mengambil dan mencatat logcat saat kasus pengujian gagal.
LogcatTimingMetricCollector	Pengumpul metrik yang mengumpulkan informasi pengaturan waktu (misalnya, waktu pengalihan pengguna) dari logcat selama satu atau beberapa pengujian berulang dengan menggunakan pola ekspresi reguler tertentu untuk mengurai sinyal awal dan akhir peristiwa dari baris logcat.
MetricFilePostProcessor	Digunakan untuk mengupload file log metrik yang dikumpulkan selama pengujian dan tingkat operasi.
MetricsXMLResultReporter	MetricsXMLResultReporter menulis metrik pengujian dan menjalankan metrik ke file XML dalam folder yang ditentukan oleh parameter folder metrik pada fase invocationEnded pengujian.
ModuleListener	Pemroses yang dilampirkan ke setiap `IRemoteTest` dari setiap modul untuk mengumpulkan daftar hasil.
ModuleLogcatCollector	Versi kolektor logcat, tetapi untuk modul.
ModuleProtoResultReporter	Pelapor hasil yang dimaksudkan untuk hanya melaporkan hasil tingkat modul.
NameMangleListener	Pemroses proxy untuk menerjemahkan nama metode, class, dan paket pengujian saat hasil dilaporkan.
PassingTestFileReporter	`ITestInvocationListener` yang menyimpan daftar kasus pengujian yang lulus ke file pengujian
PerfettoGenericPostProcessor	Post-processor yang memproses file proto metrik teks/biner menjadi key-value pair dengan memperluas pesan dan kolom proto secara rekursif dengan nilai string hingga kolom dengan nilai numerik ditemukan.
PerfettoPullerMetricCollector	Implementasi dasar `FilePullerDeviceMetricCollector` yang memungkinkan pengambilan file perfetto dari perangkat dan mengumpulkan metrik darinya.
PrettyTestEventLogger	Logger yang mencocokkan peristiwa dan mencatatnya untuk memudahkan proses debug.
ProtoResultReporter	Pelapor hasil membuat protobuf `TestRecord` dengan semua hasil di dalamnya.
PythonBinaryHostTest.PythonForwarder	Pengirim hasil untuk mengganti nama operasi dengan nama biner.
RebootReasonCollector	Pengumpul yang mengumpulkan mulai ulang perangkat selama pengujian berjalan dan melaporkannya berdasarkan alasan dan jumlah.
RemoteTestTimeOutEnforcer	Pemroses yang memungkinkan untuk memeriksa waktu eksekusi konfigurasi pengujian tertentu dan membuatnya gagal jika melebihi waktu tunggu yang ditentukan.
ReportPassedTests	Melaporkan dalam file kemungkinan filter untuk mengecualikan pengujian yang lulus.
ResultAggregator	Pengirim khusus yang menggabungkan hasil jika diperlukan, berdasarkan strategi percobaan ulang yang dilakukan.
ResultAndLogForwarder	Pengirim untuk peristiwa log dan hasil.
ResultDBReporter	Pelapor hasil yang mengupload hasil pengujian ke ResultDB.
ResultForwarder	`ITestInvocationListener` yang meneruskan hasil pemanggilan ke daftar pemroses lain.
RetryLogSaverResultForwarder	Pengirim yang juga menangani penerusan upaya saat ini.
RetryResultForwarder	Ekstensi `ResultForwarder` yang selalu mendorong ke jumlah 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 pemisahan pemanggilan untuk dijalankan di beberapa resource secara paralel), dan meneruskannya ke pemroses lain.
ShardMainResultForwarder	`ResultForwarder` yang menggabungkan hasil pemanggilan pengujian yang di-sharding.
ShowmapPullerMetricCollector	Implementasi dasar `FilePullerDeviceMetricCollector` yang memungkinkan pengambilan file showmap dari perangkat dan mengumpulkan metrik darinya.
StatsdBeforeAfterGaugeMetricPostProcessor	Post-processor yang memproses metrik pengukur yang dikumpulkan dalam pendekatan "sebelum/setelah", yaitu.
StatsdEventMetricPostProcessor	Post-processor yang memproses metrik peristiwa dalam laporan statsd menjadi pasangan nilai kunci, menggunakan formater yang ditentukan pada pemroses.
StatsdGenericPostProcessor	Post-processor yang memproses laporan statsd proto biner menjadi key-value pair dengan memperluas laporan sebagai struktur hierarki.
StreamProtoResultReporter	Implementasi `ProtoResultReporter`
SubprocessResultsReporter	Mengimplementasikan `ITestInvocationListener` untuk ditentukan sebagai result_reporter dan meneruskan dari subproses hasil pengujian, pengujian berjalan, pemanggilan pengujian.
SuiteResultReporter	Kumpulkan hasil pengujian untuk seluruh pemanggilan suite dan hasilkan hasil akhir.
TestRunResultListener	Pemroses yang memungkinkan untuk membaca status pengujian akhir.
TestTimeoutEnforcer	Pemroses yang memungkinkan untuk memeriksa waktu eksekusi kasus pengujian tertentu dan membuatnya gagal jika melebihi waktu tunggu tertentu.
TextResultReporter	Pelapor hasil pengujian yang meneruskan hasil ke printer hasil teks JUnit.
TraceCmdCollector	`IMetricCollector` yang mengumpulkan rekaman aktivitas selama pengujian menggunakan trace-cmd, dan mencatatnya ke pemanggilan.
TradefedSandboxRunner.StubScheduledInvocationListener	`IScheduledInvocationListener` stub yang tidak melakukan apa pun.
XmlFormattedGeneratorReporter	Implementasi `FormattedGeneratorReporter` yang memformat suite menghasilkan format xml.
XmlResultReporter	Menulis hasil JUnit ke file XML dalam format yang konsisten dengan XMLJUnitResultFormatter Ant.

Pemroses untuk hasil pengujian dari pemanggilan pengujian.

Pemanggilan pengujian itu sendiri dapat menyertakan beberapa pengujian yang dijalankan, sehingga urutan panggilan akan

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 beberapa kondisi error.
`default void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`default void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`default void`	`invocationInterrupted()` Dipanggil saat penjadwal dinonaktifkan, memberikan kesempatan kepada pemanggilan untuk melakukan sesuatu sebelum dihentikan.
`default void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`default void`	`invocationStarted(IInvocationContext context)` Melaporkan awal pemanggilan pengujian.
`default void`	`testModuleEnded()` Melaporkan akhir proses modul.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.

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

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

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

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

invocationInterrupted

public void invocationInterrupted ()

Dipanggil saat penjadwal dinonaktifkan, memberikan kesempatan kepada pemanggilan untuk melakukan sesuatu sebelum dihentikan.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
`reason`	`SkipReason`

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

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan bersifat opsional dalam urutan. Ini hanya digunakan selama operasi yang menggunakan modul: runner berbasis suite.

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