Hata RaporuToplayıcı

public class BugreportCollector
extends Object implements ITestInvocationListener

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

---

Yapılandırılabilir olaylar meydana geldiğinde hata raporlarını toplayan ve ardından her hata raporu toplandıktan sonra ITestInvocationListener#testLog çağıran bir geçişli ITestInvocationListener .

Davranışlar: (DÜZELTME: bunu bitir)

• Herhangi bir test senaryosu başarısız olursa, her birinden sonra yakalayın
• Her test senaryosundan sonra yakalayın
• Her başarısız test senaryosundan sonra yakala
• Ele geçirmek

Özet

iç içe sınıflar
enum	BugreportCollector.Filter
enum	BugreportCollector.Freq
enum	BugreportCollector.Noun
class	BugreportCollector.Predicate Hata raporunun ne zaman yakalanacağını açıklayan tam bir yüklem.
enum	BugreportCollector.Relation
interface	BugreportCollector.SubPredicate

Alanlar
public static final BugreportCollector.Predicate	AFTER_FAILED_TESTCASES Her başarısız test senaryosundan sonra tetiklenen önceden tanımlanmış bir yüklem
public static final BugreportCollector.Predicate	AT_START İlk çağrı başladığında tetiklenen önceden tanımlanmış bir yüklem

Kamu inşaatçıları
BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

Genel yöntemler
void	addPredicate ( BugreportCollector.Predicate p)
void	blockUntilIdle () Toplayıcı herhangi bir hata raporu toplamayana kadar engelleyin.
TestSummary	getSummary () InvocationListener'ın bir özet döndürmesine izin verir.
void	invocationEnded (long elapsedTime) Çağrının başarılı bir şekilde 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ğırmanın başladığını bildirir.
void	setAsynchronous (boolean asynchronous) Hata raporu koleksiyonunun hata raporunu farklı bir iş parçacığında mı toplaması gerektiğini ( asynchronous = true ) veya hata raporu yakalanana kadar arayanı engellemesini mi ( asynchronous = false ) ayarlayın.
void	setDescriptiveName (String name) Hata raporlarını kaydederken kullanılacak açıklayıcı adı ayarlayın.
void	setDeviceWaitTime (int waitTime) Bir hata raporu yakalamaya çalışmadan önce cihazın Çevrimiçi olmasını beklemek için süreyi (saniye olarak) ayarlayın.
void	testAssumptionFailure ( TestDescription test, String trace) Bir atomik test, yanlış olan bir koşulu üstlendiğini işaretlediğinde çağrılır.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Tek bir test senaryosunun yürütme sonunu bildirir.
void	testFailed ( TestDescription test, String trace) Tek bir test senaryosunun başarısızlığını bildirir.
void	testIgnored ( TestDescription test) Genellikle bir test yöntemine org.junit.Ignore ile açıklama eklendiğinden, bir test çalıştırılmayacaksa ç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) testRunEnded (long elapsedTime, runMetrics) Test çalıştırmasının sonunu bildirir.
void	testRunFailed (String errorMessage) Önemli bir hata nedeniyle rapor testi çalıştırması tamamlanamadı.
void	testRunStarted (String runName, int testCount) Bir test çalıştırmasının başladığını bildirir.
void	testRunStopped (long elapsedTime) Bir kullanıcı isteği nedeniyle test çalıştırmasının tamamlanmadan önce durdurulduğunu bildirir.
void	testStarted ( TestDescription test) Bireysel bir test vakasının başlangıcını bildirir.

Alanlar

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Her başarısız test senaryosundan sonra tetiklenen önceden tanımlanmış bir yüklem

BAŞLANGIÇTA

public static final BugreportCollector.Predicate AT_START

İlk çağrı başladığında tetiklenen önceden tanımlanmış bir yüklem

Kamu inşaatçıları

Hata RaporuToplayıcı

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

parametreler
listener	ITestInvocationListener
testDevice	ITestDevice

Genel yöntemler

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

parametreler
p	BugreportCollector.Predicate

blokIdle kadar

public void blockUntilIdle ()

Toplayıcı herhangi bir hata raporu toplamayana kadar engelleyin. Toplayıcı aktif olarak bir hata raporu toplamıyorsa, hemen geri dönün

özet

public TestSummary getSummary ()

InvocationListener'ın bir özet döndürmesine izin verir.

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

çağrı Bitirildi

public void invocationEnded (long elapsedTime)

Çağrının başarılı bir şekilde 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 ms cinsinden geçen süresi

çağırmaBaşarısız

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 : Throwable nedeni

çağrıBaşlatıldı

public void invocationStarted (IInvocationContext context)

Test çağırmanın başladığını bildirir.

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

parametreler
context	IInvocationContext : çağırma hakkında bilgi

setEşzamansız

public void setAsynchronous (boolean asynchronous)

Hata raporu koleksiyonunun hata raporunu farklı bir iş parçacığında mı toplaması gerektiğini ( asynchronous = true ) veya hata raporu yakalanana kadar arayanı engellemesini mi ( asynchronous = false ) ayarlayın.

parametreler
asynchronous	boolean

setDescriptiveName

public void setDescriptiveName (String name)

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

parametreler
name	String

setCihazBeklemeZamanı

public void setDeviceWaitTime (int waitTime)

Bir hata raporu yakalamaya çalışmadan önce cihazın Çevrimiçi olmasını beklemek için süreyi (saniye olarak) ayarlayın. Negatif ise herhangi bir kontrol yapılmayacaktır. Bu kontrol sırasında karşılaşılan herhangi bir DeviceNotAvailableException günlüğe kaydedilir ve yoksayılır.

parametreler
waitTime	int

testVarsayımBaşarısızlık

public void testAssumptionFailure (TestDescription test, 
                String trace)

Bir atomik test, yanlış olan bir koşulu üstlendiğini işaretlediğinde çağrılır.

parametreler
test	TestDescription : testi tanımlar
trace	String : yığın hatası izi

testBitti

public void testEnded (TestDescription test, 
                 testMetrics)

Tek bir test senaryosunun yürütme sonunu bildirir.

testFailed(TestDescription, FailureDescription) çağrılmamışsa, bu test başarılı olmuştur. Ayrıca, test senaryosunun yürütülmesi sırasında yayılmış olabilecek tüm anahtar/değer ölçümlerini döndürür.

parametreler
test	TestDescription : testi tanımlar
testMetrics	: yayılan metriklerin bir ERROR(/Map)

test başarısız

public void testFailed (TestDescription test, 
                String trace)

Tek bir test senaryosunun başarısızlığını bildirir.

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

parametreler
test	TestDescription : testi tanımlar
trace	String : başarısızlık yığın izi

testYoksayıldı

public void testIgnored (TestDescription test)

Genellikle bir test yöntemine org.junit.Ignore ile açıklama eklendiğinden, bir test çalıştırılmayacaksa çağrılır.

parametreler
test	TestDescription : testi tanımlar

test günlüğü

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))

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

parametreler
dataName	String : Verilerin bir String açıklayıcı adı. örneğin "device_logcat". Not dataName, çağrı başına benzersiz olmayabilir. yani uygulayıcılar aynı dataName ile birden fazla çağrıyı işleyebilmelidir
dataType	LogDataType : verilerin LogDataType
dataStream	InputStreamSource : verilerin InputStreamSource . Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında InputStream'in kapatıldığından emin olmalıdır. Arayanlar, testLog yöntemi tamamlanana kadar veri kaynağının mevcut ve erişilebilir kalmasını sağlamalıdır.

testRunBitti

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Test çalıştırmasının sonunu bildirir. DÜZELTME: Farklı tipte iki Map<> arayüzümüz olamaz, bu yüzden burada HashMap kullanmamız gerekiyor.

parametreler
elapsedTime	long : cihaz geçen süreyi milisaniye cinsinden bildirdi
runMetrics	: Metric ile yapılan bir test çalıştırmasının sonunda rapor edilen anahtar/değer çiftleri.

testRunFailed

public void testRunFailed (String errorMessage)

Önemli bir hata nedeniyle rapor testi çalıştırması tamamlanamadı.

parametreler
errorMessage	String : Çalıştırma hatasının nedenini açıklayan String .

testÇalıştırıldı

public void testRunStarted (String runName, 
                int testCount)

Bir test çalıştırmasının başladığını bildirir.

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

testRunStopped

public void testRunStopped (long elapsedTime)

Bir kullanıcı isteği nedeniyle test çalıştırmasının tamamlanmadan önce durdurulduğunu bildirir.

YAPILACAKLAR: şu anda kullanılmıyor, kaldırmayı düşünün

parametreler
elapsedTime	long : cihaz geçen süreyi milisaniye cinsinden bildirdi

testBaşladı

public void testStarted (TestDescription test)

Bireysel bir test vakasının başlangıcını bildirir. Eski arayüz, mümkün olduğunda testStarted(com.android.tradefed.result.TestDescription) kullanmalıdır.

parametreler
test	TestDescription : testi tanımlar