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. Implementer 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