ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

Subclass tidak langsung yang dikenal AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , CommandStatusHandler , and 71 others. AggregatePostProcessor Agregator metrik yang memberikan persentil min, maks, rata-rata, varians, standar deviasi, total, jumlah, dan opsional untuk metrik numerik yang dikumpulkan selama pengujian multi-iterasi, memperlakukannya sebagai ganda. AtraceCollector IMetricCollector yang menjalankan atrace selama pengujian dan mengumpulkan hasilnya dan mencatatnya ke dalam pemanggilan. AtraceRunMetricCollector Mengumpulkan pelacakan dari semua direktori pengujian di bawah direktori yang diberikan dari perangkat pengujian, mencatat log direktori pengujian dan memposting memproses file pelacakan di bawah direktori pengujian dan menggabungkan metrik. Rata-rataPostProcessor 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 ditentukan sebelumnya ke perangkat dan mengumpulkan durasi koneksi Bluetooth untuk setiap profil. BluetoothConnectionStateCollector Kolektor ini akan mengumpulkan metrik BluetoothConnectionStateChanged dan merekam 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]. BugreportCollector ITestInvocationListener pass-through yang mengumpulkan laporan bug saat peristiwa yang dapat dikonfigurasi terjadi dan kemudian memanggil ITestInvocationListener#testLog pada turunannya setelah setiap laporan bug dikumpulkan. BugreportzOnFailureCollector Kumpulkan laporan bug saat kasus uji gagal. BugreportzOnTestCaseFailureCollector Kumpulkan laporan bug ketika kasus uji coba gagal. ClangCodeCoverageCollector BaseDeviceMetricCollector yang akan menarik pengukuran cakupan Clang dari perangkat dan mencatatnya sebagai artefak pengujian. MengumpulkanTestListener ITestInvocationListener yang akan mengumpulkan semua hasil tes. CommandStatusHandler Handler membantu memantau dan memperbarui status doa. ConditionFailureMonitor Pantau setiap kegagalan dari pemanggilan. ConsoleResultReporter Pelapor hasil untuk mencetak hasil tes ke konsol. CountTestCasesCollector Hitung dan laporkan jumlah kasus uji untuk IRemoteTest tertentu. DebugHostLogOnFailureCollector Kolektor yang akan mengumpulkan dan mencatat log sisi host saat terjadi kegagalan kasus uji. DeviceReleaseReporter Reporter rilis perangkat yang menangani komunikasi dengan induk memproses perangkat yang akan dirilis. DeviceTraceCollector Kolektor yang akan memulai pelacakan perfetto saat uji coba dimulai dan mencatat file pelacakan di akhir. DeviceUnavailableMonitor Pemroses ini mencoba menangkap DNAE tingkat kasus uji saja. EventsLoggerListener Pendengar yang mencatat semua peristiwa yang diterimanya ke dalam file FileProtoResultReporter Reporter proto yang membuang TestRecord ke dalam file. FilePullerDeviceMetricCollector BaseDeviceMetricCollector yang mendengarkan kunci metrik yang berasal dari perangkat dan menariknya sebagai file dari perangkat. FilePullerLogCollector Pencatat file yang dilaporkan oleh sisi perangkat. FilteredResultForwarder Varian dari ResultForwarder yang hanya mengizinkan laporan TestDescription yang TestDescription . TerformatGeneratorReporter Reporter yang memungkinkan untuk menghasilkan 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 mematikan perangkat dan akhirnya mencatatnya sebagai artefak pengujian. GranularRetriableTestWrapper.StartEndCollector Pembantu kelas untuk menangkap awal dan akhir lari yang hilang. HostStatsdMetricCollector IMetricCollector yang mengumpulkan metrik statsd dari sisi host menggunakan perintah utilitas statsd. ICommandScheduler.IScheduledInvocationListener Pendengar untuk acara pemanggilan saat pemanggilan selesai. ILogSaverListener Mengizinkan ITestInvocationListener s mendengarkan saat file log disimpan. IMetricCollector Antarmuka ini akan ditambahkan sebagai penghias saat melaporkan hasil pengujian untuk mengumpulkan metrik yang cocok. IPostProcessor Pemroses pos adalah objek Federasi Dagang yang dimaksudkan untuk memungkinkan pemrosesan metrik dan log SETELAH pengujian dan SEBELUM pelaporan hasil. IShardableListener Sebuah ITestInvocationListener yang dapat dipecah. ISupportGranularResults Antarmuka yang menentukan apakah ITestInvocationListener mendukung penerimaan hasil granular atau tidak. ITestSummaryListener Antarmuka yang memungkinkan ITestInvocationListener bertukar beberapa informasi terbatas melalui ringkasan. InvokasiToJUnitResultForwarder Kelas yang mendengarkan acara ITestInvocationListener dan meneruskannya ke TestListener . JarHostTest.HostTestListener Pemroses pembungkus 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 menyandikan hasil dan cabang metrik pengujian, info perangkat ke JSON dan POST ke titik akhir layanan HTTP LastShardDetector Saat menjalankan sharding lokal, terkadang kita hanya ingin mengeksekusi beberapa tindakan saat shard terakhir mencapai invocationEnded(long) . LegacySubprocessResultsReporter Implementasi beku dari pelapor hasil subproses yang harus tetap kompatibel dengan versi sebelumnya dari TF/CTS (mis. 8+), meskipun terjadi perubahan pada superkelasnya. LogSaverResultForwarder ResultForwarder untuk menyimpan log dengan penghemat file global. LogcatCrashResultForwarder Pendengar khusus: pada kegagalan (proses instrumentasi mogok) itu akan mencoba untuk mengekstrak dari logcat crash dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian. LogcatOnFailureCollector Kolektor yang akan menangkap dan mencatat logcat saat kasus uji gagal. LogcatTimingMetricCollector Pengumpul metrik yang mengumpulkan informasi pengaturan waktu (mis. waktu peralihan pengguna) dari logcat selama satu atau beberapa pengujian berulang dengan menggunakan pola regex tertentu untuk mengurai sinyal awal dan akhir peristiwa dari baris logcat. MetricFilePostProcessor Digunakan untuk mengupload file log metrik yang dikumpulkan selama level pengujian dan pengoperasian. MetricsXMLResultReporter MetricsXMLResultReporter menulis metrik pengujian dan menjalankan metrik ke file XML dalam folder yang ditentukan oleh parameter metrics-folder pada fase invocationEnded pengujian. ModuleListener Pendengar dilampirkan ke setiap IRemoteTest dari setiap modul untuk mengumpulkan daftar hasil. ModuleLogcatCollector Versi kolektor logcat tetapi untuk modul. NameMangleListener Pendengar proxy untuk menerjemahkan metode pengujian, kelas, dan nama paket saat hasilnya dilaporkan. Melewati TestFileReporter ITestInvocationListener yang menyimpan daftar kasus uji yang lulus ke file uji PerfettoGenericPostProcessor Prosesor pos yang memproses file proto perfetto metrik biner/teks menjadi pasangan nilai kunci dengan memperluas pesan proto dan bidang dengan nilai string secara rekursif hingga bidang dengan nilai numerik ditemukan. PerfettoPullerMetricCollector Implementasi dasar FilePullerDeviceMetricCollector yang memungkinkan menarik file perfetto dari perangkat dan mengumpulkan metrik darinya. PrettyTestEventLogger Logger mencocokkan peristiwa dan mencatatnya untuk memudahkan debug. ProtoResultReporter Reporter hasil membuat protobuf TestRecord dengan semua hasil di dalamnya. PythonBinaryHostTest.PythonForwarder Penerusan hasil untuk mengganti nama proses dengan nama biner. RebootReasonCollector Kolektor yang mengumpulkan reboot perangkat selama uji coba dan melaporkannya dengan alasan dan hitungan. RemoteTestTimeOutEnforcer Pendengar yang memungkinkan untuk memeriksa waktu eksekusi dari konfigurasi pengujian yang diberikan dan gagal jika melewati waktu tunggu yang diberikan. ReportPassedTests Laporkan dalam file kemungkinan filter untuk mengecualikan tes yang lulus. ResultAggregator Forwarder khusus yang mengumpulkan hasil saat dibutuhkan, berdasarkan strategi coba lagi yang diambil. ResultAndLogForwarder Forwarder untuk hasil dan peristiwa log. Penerusan Hasil ITestInvocationListener yang meneruskan hasil pemanggilan ke daftar pendengar lainnya. Coba lagiLogSaverResultForwarder Forwarder yang juga menangani passing dari percobaan yang sedang kita lakukan. RetryResultForwarder Perpanjangan ResultForwarder yang selalu mendorong ke nomor percobaan yang diberikan. RuntimeRestartCollector Kolektor yang mengumpulkan stempel waktu mulai ulang runtime (server sistem mogok) selama uji coba, jika ada. Tangkapan LayarOnFailureCollector Kolektor yang akan menangkap dan mencatat tangkapan layar saat kasus uji gagal. ShardListener ITestInvocationListener yang mengumpulkan hasil dari pecahan doa (alias pemisahan doa untuk berjalan di beberapa sumber daya secara paralel), dan meneruskannya ke pendengar lain. ShardMainResultForwarder ResultForwarder yang mengombinasikan hasil pemanggilan pengujian yang di-sharding. ShowmapPullerMetricCollector Implementasi dasar FilePullerDeviceMetricCollector yang memungkinkan menarik file peta pertunjukan dari perangkat dan mengumpulkan metrik darinya. StatsdBeforeAfterGaugeMetricPostProcessor Pemroses pos yang memproses metrik pengukur yang dikumpulkan dalam pendekatan "sebelum/sesudah", yaitu StatsdEventMetricPostProcessor Pemroses postingan yang memproses metrik peristiwa dalam laporan statistik menjadi pasangan nilai kunci, menggunakan pemformat yang ditentukan di prosesor. StatsdGenericPostProcessor Pemroses pos yang memproses laporan statistik proto biner menjadi pasangan nilai kunci dengan memperluas laporan sebagai struktur pohon. StreamProtoResultReporter Implementasi ProtoResultReporter SubprosesResultsReporter Mengimplementasikan ITestInvocationListener untuk ditetapkan sebagai result_reporter dan meneruskan dari subproses hasil pengujian, pengujian berjalan, pemanggilan pengujian. SuiteResultReporter Kumpulkan hasil tes untuk seluruh rangkaian doa dan tampilkan hasil akhirnya. TestFailureListener Pendengar biasa mengambil tindakan seperti tangkapan layar, laporan bug, pengumpulan logcat setelah kegagalan pengujian saat diminta. TestTimeoutEnforcer Pendengar yang memungkinkan untuk memeriksa waktu eksekusi dari kasus uji yang diberikan dan gagal jika melewati waktu tunggu yang diberikan. TextResultReporter Reporter hasil tes yang meneruskan hasil ke printer hasil teks JUnit. TraceCmdCollector IMetricCollector yang mengumpulkan jejak selama pengujian menggunakan jejak-cmd, dan mencatatnya ke dalam pemanggilan. TradefedSandboxRunner.StubScheduledInvocationListener Rintisan IScheduledInvocationListener yang tidak melakukan apa pun. XmlFormattedGeneratorReporter Implementasi FormattedGeneratorReporter yang memformat hasil suite dalam format xml. XmlResultReporter Menulis hasil JUnit ke file XML dalam format yang konsisten dengan XMLJUnitResultFormatter milik Ant.

---

Pendengar untuk hasil pengujian dari pemanggilan pengujian.

Doa pengujian itu sendiri dapat mencakup beberapa uji coba, sehingga urutan panggilan akan menjadi

• pemanggilan Dimulai(BuildInfo)
• testRunStarted
• testStarted
• [testFailed]
• testEnded
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [panggilan gagal]
• [testLog+]
• doaBerakhir
• getSummary

Ringkasan

Metode publik
default TestSummary	getSummary () Mengizinkan InvocationListener mengembalikan ringkasan.
default void	invocationEnded (long elapsedTime) Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.
default void	invocationFailed ( FailureDescription failure) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
default void	invocationFailed (Throwable cause) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
default void	invocationInterrupted () Dipanggil saat shutdown penjadwal, memberikan kesempatan untuk melakukan sesuatu sebelum mengakhiri.
default void	invocationStarted ( IInvocationContext context) Melaporkan awal pemanggilan pengujian.
default void	testModuleEnded () Melaporkan akhir dari sebuah modul yang dijalankan.
default void	testModuleStarted ( IInvocationContext moduleContext) Melaporkan awal dari modul yang sedang berjalan.

Metode publik

getSummary

public TestSummary getSummary ()

Mengizinkan InvocationListener mengembalikan ringkasan.

Pengembalian
TestSummary	TestSummary meringkas proses, atau null

doaBerakhir

public void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
elapsedTime	long : waktu berlalu dari doa dalam ms

doa Gagal

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
failure	FailureDescription : FailureDescription menjelaskan penyebab kegagalan

doa Gagal

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
cause	Throwable : Penyebab kegagalan yang Throwable

doa Terganggu

public void invocationInterrupted ()

Dipanggil saat shutdown penjadwal, memberikan kesempatan untuk melakukan sesuatu sebelum mengakhiri.

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

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

Parameter
context	IInvocationContext : informasi tentang doa

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir dari sebuah modul yang dijalankan.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal dari modul yang sedang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan opsional dalam urutannya. Ini hanya digunakan selama menjalankan yang menggunakan modul: pelari berbasis suite.

Parameter
moduleContext	IInvocationContext : IInvocationContext dari modul.