ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener
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.