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.
- 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 ( |
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 sebelumERROR(/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 | 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 |
Konten dan contoh kode di halaman ini tunduk pada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2023-12-01 UTC.