ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

Subclass tidak langsung yang umum AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, dan 87 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 nilai ganda.  AndroidBuildResultReporter Melaporkan hasil pengujian ke Android Build API.  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 di onTestRunStart(DeviceMetricData) dan onTestRunEnd(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 snoop 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.  CoverageMetadataCollector ILogSaverListener yang mengumpulkan pengukuran cakupan yang dicatat dan membuat CoverageMetadataProto untuk diproses oleh layanan Cakupan Kode Android.  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 Collector yang akan memulai rekaman aktivitas perfetto saat uji coba dimulai dan mencatat file rekaman aktivitas di akhir.  DeviceUnavailableMonitor Pendengar 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 TestDescription dalam daftar yang diizinkan 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.  GeminiDebuggingPostProcessor Post-processor membuat kueri perintah untuk men-debug error.  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 ITestInvocationListeners memantau 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 Pelapor 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 TF/CTS versi sebelumnya (misalnya 8+), meskipun ada perubahan pada superclass-nya.  LogSaverResultForwarder ResultForwarder untuk menyimpan log dengan penyimpan file global.  LogcatCrashResultForwarder Pendengar khusus: saat terjadi kegagalan (proses instrumentasi error), pendengar 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 atau proses 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 dari setiap modul untuk mengumpulkan daftar hasil.  ModuleLogcatCollector Versi pengumpul logcat, tetapi untuk modul.  ModulePerfettoCollector Pengumpul yang akan memulai rekaman aktivitas perfetto saat modul pengujian dimulai dan berakhir serta perangkat dimulai ulang.  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 berhasil 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 metrik text/binary perfetto 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 pemroses rekaman aktivitas di file tersebut untuk menghasilkan proto metrik Perfetto.  PrettyTestEventLogger Logger mencocokkan peristiwa dan mencatatnya agar lebih mudah di-debug.  ProtoResultReporter Pelapor hasil membuat protobuf TestRecord dengan semua hasil di dalamnya.  PythonBinaryHostTest.PythonForwarder Penerus hasil untuk mengganti nama operasi dengan nama program biner.  RebootReasonCollector Pengumpul yang mengumpulkan reboot perangkat selama uji coba 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 pemroses lainnya.  ResultReporter   RetryLogSaverResultForwarder Forwarder yang juga menangani upaya saat ini yang sedang kita lakukan.  RetryResultForwarder Ekstensi ResultForwarder yang selalu mendorong ke nomor percobaan tertentu.  RuntimeRestartCollector Pengumpul yang mengumpulkan stempel waktu mulai ulang runtime (error server sistem) selama uji coba, jika ada.  ScreenRecordOnFailureCollector Pengumpul yang akan merekam dan mencatat log rekaman layar saat kasus pengujian gagal.  ScreenshotOnFailureCollector Pengumpul yang akan mengambil dan mencatat screenshot saat kasus pengujian gagal.  ShardListener ITestInvocationListener yang mengumpulkan hasil dari shard pemanggilan (alias pembagian pemanggilan untuk dijalankan secara paralel di beberapa resource), dan meneruskannya ke pemroses 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.  SimpleperfProfilePostProcessor Post-prosesor yang menemukan data pemrofilan simpleperf dan menghasilkan profil pprof.  StatsdBeforeAfterGaugeMetricPostProcessor Post-prosesor yang memproses metrik pengukur yang dikumpulkan dengan pendekatan "sebelum/sesudah", yaitu  StatsdEventMetricPostProcessor Post-processor yang memproses metrik peristiwa dalam laporan statsd menjadi pasangan nilai kunci, menggunakan pemformat yang ditentukan di pemroses.  StatsdGenericPostProcessor Post-processor 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, berjalannya 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 Penerapan FormattedGeneratorReporter yang memformat hasil rangkaian 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 penonaktifan penjadwal, 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 yang 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: penyebab kegagalan Throwable

invocationInterrupted

public void invocationInterrupted ()

Dipanggil saat penonaktifan penjadwal, 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 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.