BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

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

ITestInvocationListener pass-through yang mengumpulkan bugreport saat peristiwa yang dapat dikonfigurasi terjadi, lalu memanggil ITestInvocationListener.testLog pada turunannya setelah setiap bugreport dikumpulkan.

Perilaku: (FIXME: selesaikan ini)

  • Ambil gambar setelah setiap kasus pengujian gagal
  • Merekam setelah setiap pengujian kasus
  • Merekam setelah setiap kasus pengujian gagal
  • Rekam

Ringkasan

Class bertingkat

class BugreportCollector.Predicate

Predikat lengkap yang menjelaskan kapan harus mengambil laporan bug. 

interface BugreportCollector.SubPredicate

 

Kolom

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Predikat standar yang diaktifkan setelah setiap kasus pengujian gagal

public static final BugreportCollector.Predicate AT_START

Predikat standar 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()

Memungkinkan InvocationListener menampilkan ringkasan.

void invocationEnded(long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.

void invocationFailed(Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

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 diambil (asynchronous = false).

void setDescriptiveName(String name)

Tetapkan nama deskriptif yang akan digunakan saat merekam bugreport.

void setDeviceWaitTime(int waitTime)

Tetapkan waktu (dalam detik) untuk menunggu perangkat Online sebelum kita mencoba mengambil bugreport.

void testAssumptionFailure(TestDescription test, String trace)

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

void testEnded(TestDescription test, testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

void testFailed(TestDescription test, String trace)

Melaporkan kegagalan kasus pengujian individual.

void testIgnored(TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

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

Memberikan data log atau debug terkait dari pemanggilan pengujian.

void testRunEnded(long elapsedTime, runMetrics)

Melaporkan akhir pengujian yang dijalankan.

void testRunFailed(String errorMessage)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

void testRunStarted(String runName, int testCount)

Melaporkan awal pengujian yang dijalankan.

void testRunStopped(long elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

void testStarted(TestDescription test)

Melaporkan awal setiap kasus pengujian.

Kolom

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Predikat standar yang diaktifkan setelah setiap kasus pengujian gagal

AT_START

public static final BugreportCollector.Predicate AT_START

Predikat standar yang diaktifkan saat pemanggilan pertama dimulai

Konstruktor publik

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parameter
listener ITestInvocationListener

testDevice ITestDevice

Metode publik

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

Parameter
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

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

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 (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
cause Throwable: Throwable penyebab kegagalan

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

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 diambil (asynchronous = false).

Parameter
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

Tetapkan nama deskriptif yang akan digunakan saat merekam bugreport. Jika null, BugreportCollector akan kembali ke perilaku default serialisasi nama peristiwa yang menyebabkan bugreport dikumpulkan.

Parameter
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Tetapkan waktu (dalam detik) untuk menunggu perangkat Online sebelum kita mencoba mengambil bugreport. Jika negatif, tidak akan ada pemeriksaan yang dilakukan. Setiap DeviceNotAvailableException yang ditemukan selama pemeriksaan ini akan dicatat ke dalam log dan diabaikan.

Parameter
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Parameter
test TestDescription: mengidentifikasi pengujian
trace String: stack trace kegagalan

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini akan lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
test TestDescription: mengidentifikasi pengujian
testMetrics : ERROR(/Map) dari metrik yang dikeluarkan

testFailed

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test TestDescription: mengidentifikasi pengujian
trace String: stack trace kegagalan

testIgnored

public void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
test TestDescription: mengidentifikasi pengujian

testLog

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

Memberikan data log atau debug terkait dari pemanggilan pengujian.

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

Framework TradeFederation akan otomatis memanggil metode ini, yang menyediakan log host dan jika berlaku, logcat perangkat.

Parameter
dataName String: nama deskriptif String data. misalnya, "device_logcat". Perhatikan bahwa dataName mungkin tidak unik per pemanggilan. Artinya, pengimplementasi harus dapat menangani beberapa panggilan dengan dataName yang sama
dataType LogDataType: LogDataType data
dataStream InputStreamSource: InputStreamSource data. Implementator harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

Parameter
elapsedTime long: waktu berlalu yang dilaporkan perangkat, dalam milidetik
runMetrics : pasangan nilai kunci yang dilaporkan di akhir pengujian

testRunFailed

public void testRunFailed (String errorMessage)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

Parameter
errorMessage String: String yang menjelaskan alasan kegagalan operasi.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Melaporkan awal pengujian yang dijalankan.

Parameter
runName String: nama operasi pengujian
testCount int: jumlah total pengujian dalam operasi pengujian

testRunStopped

public void testRunStopped (long elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

Parameter
elapsedTime long: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testStarted

public void testStarted (TestDescription test)

Melaporkan awal setiap kasus pengujian. Antarmuka lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) jika memungkinkan.

Parameter
test TestDescription: mengidentifikasi pengujian