Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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.

Perilaku: (FIXME: selesaikan ini)

  • 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 ( asynchronous = true ), atau blokir pemanggil hingga laporan bug ditangkap ( asynchronous = false ).

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 sebelum ERROR(/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 : key-value pair dilaporkan di akhir uji coba dengan 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