BugreportCollector
public class BugreportCollector
extends Object
implements ITestInvocationListener
java.lang.Objek | |
↳ | com.android.tradefed.result.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.
- Tangkap setelah masing-masing jika ada testcase yang gagal
- Tangkap setelah setiap testcase
- Tangkap setelah setiap testcase yang gagal
- Menangkap
Ringkasan
Kelas bersarang | |
---|---|
class | BugreportCollector.Predicate Predikat lengkap yang menjelaskan kapan harus merekam laporan bug. |
interface | BugreportCollector.SubPredicate
|
Bidang | |
---|---|
public static final BugreportCollector.Predicate | AFTER_FAILED_TESTCASES Predikat yang telah ditentukan sebelumnya yang menyala setelah setiap testcase yang gagal |
public static final BugreportCollector.Predicate | AT_START Predikat yang telah ditentukan sebelumnya yang menyala saat doa pertama dimulai |
Konstruktor publik | |
---|---|
BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice) |
Metode publik | |
---|---|
void | addPredicate ( BugreportCollector.Predicate p) |
void | blockUntilIdle () Blokir sampai 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) Setel apakah pengumpulan laporan bug harus mengumpulkan laporan bug di utas yang berbeda ( |
void | setDescriptiveName (String name) Tetapkan nama deskriptif untuk digunakan saat merekam laporan bug. |
void | setDeviceWaitTime (int waitTime) Tetapkan waktu (dalam detik) untuk menunggu perangkat menjadi Online sebelum kami mencoba merekam laporan bug. |
void | testAssumptionFailure ( TestDescription test, String trace) Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi dari kasus uji individu. |
void | testFailed ( TestDescription test, String trace) Melaporkan kegagalan kasus uji individu. |
void | testIgnored ( TestDescription test) Dipanggil saat 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 awal uji coba. |
void | testRunStopped (long elapsedTime) Uji coba laporan berhenti sebelum selesai karena permintaan pengguna. |
void | testStarted ( TestDescription test) Melaporkan awal kasus uji individu. |
Bidang
SETELAH_FAILED_TESTCASES
public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES
Predikat yang telah ditentukan sebelumnya yang menyala setelah setiap testcase yang gagal
AT_START
public static final BugreportCollector.Predicate AT_START
Predikat yang telah ditentukan sebelumnya yang menyala saat doa pertama dimulai
Konstruktor publik
BugreportCollector
public BugreportCollector (ITestInvocationListener listener, ITestDevice testDevice)
Parameter | |
---|---|
listener | ITestInvocationListener |
testDevice | ITestDevice |
Metode publik
addPredikat
public void addPredicate (BugreportCollector.Predicate p)
Parameter | |
---|---|
p | BugreportCollector.Predicate |
blockUntilIdle
public void blockUntilIdle ()
Blokir sampai kolektor tidak mengumpulkan laporan bug apa pun. Jika kolektor tidak secara aktif mengumpulkan laporan bug, segera kembali
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 (Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.Parameter | |
---|---|
cause | Throwable : ERROR(/Throwable) penyebab kegagalan |
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 |
setAsynchronous
public void setAsynchronous (boolean asynchronous)
Setel apakah pengumpulan laporan bug harus mengumpulkan laporan bug di utas yang berbeda ( asynchronous = true
), atau blokir pemanggil hingga laporan bug ditangkap ( asynchronous = false
).
Parameter | |
---|---|
asynchronous | boolean |
setDescriptiveName
public void setDescriptiveName (String name)
Tetapkan nama deskriptif untuk digunakan saat merekam laporan bug. Jika null
, BugreportCollector
akan kembali ke perilaku default serialisasi nama peristiwa yang menyebabkan laporan bug dikumpulkan.
Parameter | |
---|---|
name | String |
setDeviceWaitTime
public void setDeviceWaitTime (int waitTime)
Tetapkan waktu (dalam detik) untuk menunggu perangkat menjadi Online sebelum kami mencoba merekam laporan bug. Jika negatif, tidak ada pemeriksaan yang akan dilakukan. Setiap DeviceNotAvailableException
yang ditemui selama pemeriksaan ini akan dicatat dan diabaikan.
Parameter | |
---|---|
waitTime | int |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testEnded
public void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi dari kasus uji individu.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, tes ini lulus. Juga menampilkan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testMetrics | ERROR(/Map) dari metrik yang dipancarkan |
testFailed
public void testFailed (TestDescription test, String trace)
Melaporkan kegagalan kasus uji individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testIgnored
public void testIgnored (TestDescription test)
Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testLog
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 TradeFederation akan secara otomatis memanggil metode ini, memberikan log host dan jika berlaku, logcat perangkat.Parameter | |
---|---|
dataName | String : nama deskriptif ERROR(/String) dari data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus dapat menangani banyak panggilan dengan dataName yang sama |
dataType | LogDataType : LogDataType dari data |
dataStream | InputStreamSource : InputStreamSource dari 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 yang berbeda, jadi kami harus menggunakan HashMap di sini.
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu berlalu, dalam milidetik |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
Uji coba laporan gagal diselesaikan karena kesalahan fatal.
Parameter | |
---|---|
errorMessage | String : ERROR(/String) menjelaskan alasan untuk menjalankan kegagalan. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Melaporkan awal uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam uji coba |
testRunStopped
public void testRunStopped (long elapsedTime)
Uji coba laporan berhenti sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapus
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu berlalu, dalam milidetik |
testStarted
public void testStarted (TestDescription test)
Melaporkan awal kasus uji individu. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
jika 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-03-30 UTC.