BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

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

---

Yapılandırılabilir etkinlikler gerçekleştiğinde hata raporlarını toplayan ve her hata raporu toplandıktan sonra alt öğelerinde ITestInvocationListener.testLog'ı çağıran bir geçiş ITestInvocationListener.

Davranışlar: (FIXME: bunu tamamlayın)

• Her testin ardından, testlerden herhangi biri başarısız olursa yakalama
• Her test sonucundan sonra yakalama
• Her başarısız test durumundan sonra yakalama
• Çekim Yapın

Özet

İç içe yerleştirilmiş sınıflar
class	BugreportCollector.Predicate Hata raporunun ne zaman yakalanacağını açıklayan tam bir önerme.
interface	BugreportCollector.SubPredicate

Fields'ın oynadığı filmler
public static final BugreportCollector.Predicate	AFTER_FAILED_TESTCASES Her başarısız test örneğinden sonra tetiklenen önceden tanımlanmış bir önerme
public static final BugreportCollector.Predicate	AT_START İlk çağrı başlarken tetiklenen önceden tanımlanmış bir önerme

Herkese açık kurucular
BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

Herkese açık yöntemler
void	addPredicate(BugreportCollector.Predicate p)
void	blockUntilIdle() Toplayıcı hata raporu toplayana kadar engelleyin.
TestSummary	getSummary() InvocationListener'ın özet döndürmesine olanak tanır.
void	invocationEnded(long elapsedTime) Çağrının başarıyla veya bir hata durumu nedeniyle sonlandırıldığını bildirir.
void	invocationFailed(Throwable cause) Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir.
void	invocationStarted(IInvocationContext context) Test çağrısının başlangıcını bildirir.
void	setAsynchronous(boolean asynchronous) Hata raporu toplama işleminin, hata raporunu farklı bir ileti dizisinde toplayıp toplamayacağı (asynchronous = true) veya hata raporu yakalanana kadar arayanı engelleyip engellemeyeceğini ayarlayın (asynchronous = false).
void	setDescriptiveName(String name) Hata raporları kaydederken kullanılacak açıklayıcı adı ayarlayın.
void	setDeviceWaitTime(int waitTime) Hata raporu oluşturmayı denemeden önce cihazın çevrimiçi olmasını beklemek için süreyi (saniye cinsinden) ayarlayın.
void	testAssumptionFailure(TestDescription test, String trace) Bir atomik test, yanlış bir koşulu varsaydığını işaretlediğinde çağrılır
void	testEnded(TestDescription test, testMetrics) Tek bir testin yürütülmesinin sonunu bildirir.
void	testFailed(TestDescription test, String trace) Tek bir test durumunun başarısız olduğunu bildirir.
void	testIgnored(TestDescription test) Genellikle bir test yöntemi org.junit.Ignore ile eklendiği için test çalıştırılmadığında çağrılır.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Test çağrısından ilişkili günlük veya hata ayıklama verilerini sağlar.
void	testRunEnded(long elapsedTime, runMetrics) Test çalıştırmasının sonunu bildirir.
void	testRunFailed(String errorMessage) Raporlar test çalışması, önemli bir hata nedeniyle tamamlanamadı.
void	testRunStarted(String runName, int testCount) Test çalıştırmasının başlangıcını bildirir.
void	testRunStopped(long elapsedTime) Raporlar test çalışması, kullanıcı isteği nedeniyle tamamlanmadan önce durduruldu.
void	testStarted(TestDescription test) Tek bir testin başlangıcını bildirir.

Fields'ın oynadığı filmler

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Her başarısız test örneğinden sonra tetiklenen önceden tanımlanmış bir önerme

AT_START

public static final BugreportCollector.Predicate AT_START

İlk çağrı başlarken tetiklenen önceden tanımlanmış bir önerme

Herkese açık kurucular

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parametreler
listener	ITestInvocationListener
testDevice	ITestDevice

Herkese açık yöntemler

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

Parametreler
p	BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

Toplayıcı hata raporu toplayana kadar engelleyin. Toplayıcı etkin bir şekilde hata raporu toplamıyorsa hemen döndürülür

getSummary

public TestSummary getSummary ()

InvocationListener'ın özet döndürmesine olanak tanır.

İlerlemeler
TestSummary	Çalıştırmayı özetleyen bir TestSummary veya null

invocationEnded

public void invocationEnded (long elapsedTime)

Çağrının başarıyla veya bir hata durumu nedeniyle sonlandırıldığını bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır.

Parametreler
elapsedTime	long: Çağrının geçtiği süre (ms.)

invocationFailed

public void invocationFailed (Throwable cause)

Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır.

Parametreler
cause	Throwable: Hatanın Throwable nedeni

invocationStarted

public void invocationStarted (IInvocationContext context)

Test çağrısının başlangıcını bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır. Raporlamacıların, birden fazla cihaz raporlamasını desteklemek için bu yöntemi geçersiz kılması gerekir.

Parametreler
context	IInvocationContext: çağrı hakkında bilgi

setAsynchronous

public void setAsynchronous (boolean asynchronous)

Hata raporu toplama işleminin, hata raporunu farklı bir ileti dizisinde toplayıp toplamayacağı (asynchronous = true) veya hata raporu yakalanana kadar arayanı engelleyip engellemeyeceğini ayarlayın (asynchronous = false).

Parametreler
asynchronous	boolean

setDescriptiveName

public void setDescriptiveName (String name)

Hata raporları kaydederken kullanılacak açıklayıcı adı ayarlayın. null ise BugreportCollector, hata raporunun toplanmasına neden olan etkinliğin adını serileştirmek için varsayılan davranışa geri döner.

Parametreler
name	String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Hata raporu oluşturmayı denemeden önce cihazın çevrimiçi olmasını beklemek için süreyi (saniye cinsinden) ayarlayın. Değer negatifse herhangi bir kontrol yapılmaz. Bu kontrol sırasında karşılaşılan tüm DeviceNotAvailableException , günlüğe kaydedilir ve yoksayılır.

Parametreler
waitTime	int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Bir atomik test, yanlış bir koşulu varsaydığını işaretlediğinde çağrılır

Parametreler
test	TestDescription: Testi tanımlar
trace	String: Hatanın yığın izlemesi

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Tek bir testin yürütülmesinin sonunu bildirir.

testFailed(TestDescription, FailureDescription) çağrılmadıysa bu test başarılıdır. Ayrıca, test senaryosunun yürütülmesi sırasında yayınlanmış olabilecek tüm anahtar/değer metriklerini döndürür.

Parametreler
test	TestDescription: Testi tanımlar
testMetrics	: Yayınlanan metriklerin ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                String trace)

Tek bir test durumunun başarısız olduğunu bildirir.

testStarted ve testEnded arasında çağrılır.

Parametreler
test	TestDescription: Testi tanımlar
trace	String: Hatanın yığın izlemesi

testIgnored

public void testIgnored (TestDescription test)

Genellikle bir test yöntemi org.junit.Ignore ile eklendiği için test çalıştırılmadığında çağrılır.

Parametreler
test	TestDescription: Testi tanımlar

testLog

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

Test çağrısından ilişkili günlük veya hata ayıklama verilerini sağlar.

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) veya ERROR(/ITestInvocationListener#invocationEnded(long)) tarihinden önce çağrılmış olmalıdır.

TradeFederation çerçevesi, ana makine günlüğünü ve varsa cihaz logcat'ini sağlayarak bu yöntemi otomatik olarak çağırır.

Parametreler
dataName	String: Verilerin String açıklayıcı adı. Ör. "device_logcat". Not: dataName, her çağrı için benzersiz olmayabilir. Yani uygulayıcılar aynı dataName ile birden fazla çağrıyı işleyebilmelidir.
dataType	LogDataType: Verilerin LogDataType
dataStream	InputStreamSource: Verilerin InputStreamSource. Uygulamacılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve işlem tamamlandığında ortaya çıkan InputStream'i kapatmalıdır. Arayanlar, testLog yöntemi tamamlanana kadar verilerin kaynağının mevcut ve erişilebilir olduğundan emin olmalıdır.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Test çalıştırmasının sonunu bildirir.

Parametreler
elapsedTime	long: Cihaz tarafından bildirilen geçen süre (milisaniye cinsinden)
runMetrics	: Test çalışmasının sonunda raporlanan anahtar/değer çiftleri

testRunFailed

public void testRunFailed (String errorMessage)

Raporlar test çalışması, önemli bir hata nedeniyle tamamlanamadı.

Parametreler
errorMessage	String: String, çalıştırma hatasının nedenini açıklıyor.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Test çalıştırmasının başlangıcını bildirir.

Parametreler
runName	String: test çalıştırması adı
testCount	int: test çalıştırmasında toplam test sayısı

testRunStopped

public void testRunStopped (long elapsedTime)

Raporlar test çalışması, kullanıcı isteği nedeniyle tamamlanmadan önce durduruldu.

TODO: currently unused, consider removing

Parametreler
elapsedTime	long: Cihaz tarafından bildirilen geçen süre (milisaniye cinsinden)

testStarted

public void testStarted (TestDescription test)

Tek bir testin başlangıcını bildirir. Eski arayüz, mümkün olduğunda testStarted(com.android.tradefed.result.TestDescription) kullanılmalıdır.

Parametreler
test	TestDescription: Testi tanımlar