Hata Raporu Toplayıcı

public class BugreportCollector
extends Object implements ITestInvocationListener

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


Yapılandırılabilir olaylar gerçekleştiğinde hata raporlarını toplayan ve ardından her hata raporu toplandıktan sonra alt öğelerinde ITestInvocationListener#testLog çağıran doğrudan geçişli bir ITestInvocationListener .

Davranışlar: (FIXME: bunu bitir)

  • Herhangi bir test durumu başarısız olursa her birinden sonra yakalayın
  • Her test durumundan sonra yakalayın
  • Başarısız olan her test durumundan sonra yakalayın
  • Esir almak

Özet

İç içe sınıflar

class BugreportCollector.Predicate

Bir hata raporunun ne zaman yakalanacağını açıklayan tam bir yüklem.

interface BugreportCollector.SubPredicate

alanlar

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Başarısız olan her test senaryosundan sonra tetiklenen önceden tanımlanmış bir koşul

public static final BugreportCollector.Predicate AT_START

İlk çağırma başladığında harekete geçen ö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)

Başarıyla veya bazı hata durumlarından dolayı çağrının 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 koleksiyonunun hata raporunu farklı bir ileti dizisinde toplaması ( asynchronous = true ) veya hata raporu yakalanana kadar ( asynchronous = false ) arayanı engellemesi gerekip gerekmediğini 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 varsaydığını 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öntemi org.junit.Ignore ile açıklamalı olduğundan, bir 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) testRunEnded (long elapsedTime, runMetrics)

Test çalışmasının sonunu bildirir.

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount)

Bir test çalışması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)

Tek bir test senaryosunun başlangıcını bildirir.

alanlar

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Başarısız olan her test senaryosundan sonra tetiklenen önceden tanımlanmış bir koşul

BAŞLANGIÇTA

public static final BugreportCollector.Predicate AT_START

İlk çağırma başladığında harekete geçen önceden tanımlanmış bir yüklem

kamu inşaatçılar

Hata Raporu Toplayıcı

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

parametreler
listener ITestInvocationListener

testDevice ITestDevice

Genel yöntemler

ek yüklem

public void addPredicate (BugreportCollector.Predicate p)

parametreler
p BugreportCollector.Predicate

blokUntilidle

public void blockUntilIdle ()

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

Özeti al

public TestSummary getSummary ()

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

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

Çağrı Sona Erdi

public void invocationEnded (long elapsedTime)

Başarıyla veya bazı hata durumlarından dolayı çağrının sonlandırıldığını bildirir.

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

parametreler
elapsedTime long : çağrının ms cinsinden geçen süresi

çağrı başarısız oldu

public void invocationFailed (Throwable cause)

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

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

parametreler
cause Throwable : hatanın ERROR(/Throwable) nedeni

çağrı başlatıldı

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ılacaktır. Raporlayıcıların, birden fazla cihaz raporlamasını desteklemek için bu yöntemi geçersiz kılmaları gerekir.

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

setAsenkronize

public void setAsynchronous (boolean asynchronous)

Hata raporu koleksiyonunun hata raporunu farklı bir ileti dizisinde toplaması ( asynchronous = true ) veya hata raporu yakalanana kadar ( asynchronous = false ) arayanı engellemesi gerekip gerekmediğini ayarlayın.

parametreler
asynchronous boolean

setTanımlayıcıAd

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 şeklindeki varsayılan davranışa geri dönecektir.

parametreler
name String

CihazBekleme Süresini ayarla

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 kontrol yapılmaz. Bu kontrol sırasında karşılaşılan herhangi bir DeviceNotAvailableException günlüğe kaydedilecek ve yoksayılacaktır.

parametreler
waitTime int

test Varsayım Başarısızlığı

public void testAssumptionFailure (TestDescription test, 
                String trace)

Bir atomik test, yanlış olan 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

test Bitti

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

parametreler
test TestDescription : testi tanımlar

testMetrics : yayılan metriklerde 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ılacak.

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 açıklamalı olduğundan, bir test çalıştırılmadığında ç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)) öncesinde çağrılmalıdır.

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

parametreler
dataName String : verilerin ERROR(/String) tanımlayıcı adı. örneğin "device_logcat". Not dataName her çağrı için benzersiz olmayabilir. yani uygulayıcılar, aynı dataName ile birden fazla çağrıyı yönetebilmelidir.

dataType LogDataType : verilerin LogDataType

dataStream InputStreamSource : verilerin InputStreamSource . Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında ortaya çıkan InputStream'i kapattığı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.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Test çalışmasının sonunu bildirir. FIXME: Farklı türde iki Map<> arayüzümüz olamaz, bu yüzden burada HashMap kullanmalıyız.

parametreler
elapsedTime long : cihazın milisaniye cinsinden geçen süreyi bildirdiği

runMetrics : Metric ile yapılan bir test çalışmasının sonunda bildirilen anahtar/değer çiftleri.

testRunFailed

public void testRunFailed (String errorMessage)

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

parametreler
errorMessage String : ERROR(/String) çalışma hatasının nedenini açıklıyor.

testÇalıştırBaşlatıldı

public void testRunStarted (String runName, 
                int testCount)

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

parametreler
runName String : test çalıştırması adı

testCount int : test çalışmasında 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ın milisaniye cinsinden geçen süreyi bildirdiği

test başladı

public void testStarted (TestDescription test)

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

parametreler
test TestDescription : testi tanımlar