Kolektor Laporan Bug

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Objek
↳ com.android.tradefed.result.BugreportCollector

ITestInvocationListener pass-through yang mengumpulkan laporan bug ketika peristiwa yang dapat dikonfigurasi terjadi dan kemudian memanggil ITestInvocationListener#testLog pada turunannya setelah setiap laporan bug dikumpulkan.

Perilaku: (FIXME: selesaikan ini)

  • Tangkap setelah masing-masing kasus uji jika ada yang gagal
  • Tangkap setelah setiap testcase
  • Tangkap setelah setiap testcase gagal
  • Menangkap

Ringkasan

Kelas bersarang

class BugreportCollector.Predicate

Predikat lengkap yang menjelaskan kapan harus menangkap laporan bug.

interface BugreportCollector.SubPredicate

Bidang

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Predikat yang telah ditentukan sebelumnya yang diaktifkan setelah setiap kasus uji gagal

public static final BugreportCollector.Predicate AT_START

Predikat yang telah ditentukan sebelumnya yang diaktifkan saat pemanggilan pertama dimulai

Konstruktor publik

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

Metode publik

void addPredicate ( BugreportCollector.Predicate p)
void blockUntilIdle ()

Blokir hingga kolektor tidak mengumpulkan laporan bug apa pun.

TestSummary getSummary ()

Mengizinkan InvocationListener mengembalikan ringkasan.

void invocationEnded (long elapsedTime)

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

void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

void invocationStarted ( IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

void setAsynchronous (boolean asynchronous)

Tetapkan apakah pengumpulan laporan bug harus mengumpulkan laporan bug di thread yang berbeda ( asynchronous = true ), atau memblokir pemanggil hingga laporan bug ditangkap ( asynchronous = false ).

void setDescriptiveName (String name)

Tetapkan nama deskriptif yang akan digunakan saat merekam laporan bug.

void setDeviceWaitTime (int waitTime)

Atur waktu (dalam detik) untuk menunggu perangkat Online sebelum kami mencoba menangkap laporan bug.

void testAssumptionFailure ( TestDescription test, String trace)

Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Melaporkan akhir eksekusi kasus uji individual.

void testFailed ( TestDescription test, String trace)

Melaporkan kegagalan kasus uji individual.

void testIgnored ( TestDescription test)

Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Melaporkan akhir uji coba.

void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

void testRunStarted (String runName, int testCount)

Melaporkan dimulainya uji coba.

void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

void testStarted ( TestDescription test)

Melaporkan permulaan kasus uji individual.

Bidang

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Predikat yang telah ditentukan sebelumnya yang diaktifkan setelah setiap kasus uji gagal

DI_START

public static final BugreportCollector.Predicate AT_START

Predikat yang telah ditentukan sebelumnya yang diaktifkan saat pemanggilan pertama dimulai

Konstruktor publik

Kolektor Laporan Bug

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parameter
listener ITestInvocationListener

testDevice ITestDevice

Metode publik

tambahkanPredikat

public void addPredicate (BugreportCollector.Predicate p)

Parameter
p BugreportCollector.Predicate

blokSampaiIdle

public void blockUntilIdle ()

Blokir hingga kolektor tidak mengumpulkan laporan bug apa pun. Jika kolektor tidak secara aktif mengumpulkan laporan bug, segera kembalikan

dapatkan Ringkasan

public TestSummary getSummary ()

Mengizinkan InvocationListener mengembalikan ringkasan.

Kembali
TestSummary TestSummary yang merangkum proses, atau null

doaBerakhir

public void invocationEnded (long elapsedTime)

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

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
elapsedTime long : waktu pemanggilan yang telah berlalu dalam ms

doaGagal

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
cause Throwable : penyebab kegagalan Throwable

doaDimulai

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

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

Parameter
context IInvocationContext : informasi tentang pemanggilan

setAsynchronous

public void setAsynchronous (boolean asynchronous)

Tetapkan apakah pengumpulan laporan bug harus mengumpulkan laporan bug di thread yang berbeda ( asynchronous = true ), atau memblokir pemanggil hingga laporan bug ditangkap ( asynchronous = false ).

Parameter
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

Tetapkan nama deskriptif yang akan digunakan saat merekam laporan bug. Jika null , BugreportCollector akan kembali ke perilaku default yaitu membuat serial nama peristiwa yang menyebabkan laporan bug dikumpulkan.

Parameter
name String

setelDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Atur waktu (dalam detik) untuk menunggu perangkat Online sebelum kami mencoba menangkap laporan bug. Jika negatif, pemeriksaan tidak akan dilakukan. Setiap DeviceNotAvailableException yang ditemukan selama pemeriksaan ini akan dicatat dan diabaikan.

Parameter
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

Parameter
test TestDescription : mengidentifikasi tes

trace String : tumpukan jejak kegagalan

tesBerakhir

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi kasus uji individual.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini berhasil. Juga mengembalikan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
test TestDescription : mengidentifikasi tes

testMetrics : ERROR(/Map) dari metrik yang dikeluarkan

tesGagal

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus uji individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test TestDescription : mengidentifikasi tes

trace String : tumpukan jejak kegagalan

tesIgnored

public void testIgnored (TestDescription test)

Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
test TestDescription : mengidentifikasi tes

tesLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(/ITestInvocationListener#invocationFailed(Throwable)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

Kerangka kerja TradeFederation akan secara otomatis memanggil metode ini, menyediakan log host dan jika berlaku, logcat perangkat.

Parameter
dataName String : sebuah String yang merupakan nama deskriptif data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus mampu menangani banyak panggilan dengan nama data yang sama

dataType LogDataType : LogDataType datanya

dataStream InputStreamSource : InputStreamSource data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Penelepon harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe berbeda, jadi kami harus menggunakan HashMap di sini.

Parameter
elapsedTime long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik

runMetrics : pasangan nilai kunci yang dilaporkan pada akhir uji coba dengan Metric .

testRunFailed

public void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

Parameter
errorMessage String : String yang menjelaskan alasan kegagalan proses.

tesRunStarted

public void testRunStarted (String runName, 
                int testCount)

Melaporkan dimulainya uji coba.

Parameter
runName String : nama uji coba

testCount int : jumlah total pengujian dalam pengujian yang dijalankan

testRunStopped

public void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya

Parameter
elapsedTime long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik

tesDimulai

public void testStarted (TestDescription test)

Melaporkan permulaan kasus uji individual. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) bila memungkinkan.

Parameter
test TestDescription : mengidentifikasi tes