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 işlevini çağıran bir geçiş ITestInvocationListener.

Davranışlar: (FIXME: finish this)

  • Test senaryoları başarısız olursa her birinden sonra yakalama
  • Her test senaryosundan sonra yakalama
  • Her başarısız test senaryosundan 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 yüklem. 

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ğırma işlemi başladığında tetiklenen önceden tanımlanmış bir yüklem

Herkese açık oluşturucular

BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

Herkese açık yöntemler

void addPredicate(BugreportCollector.Predicate p)
void blockUntilIdle()

Toplayıcı hata raporu toplamayı bırakana kadar engelle.

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

Çağırmanın başarıyla mı yoksa bir hata durumu nedeniyle mi sonlandırıldığını bildirir.

void invocationFailed(Throwable cause)

Bir hata durumu nedeniyle eksik bir çağırma 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 iş parçacığında toplamasını (asynchronous = true) veya hata raporu alınana kadar arayan kişiyi engellemesini (asynchronous = false) ayarlayın.

void setDescriptiveName(String name)

Hata raporları kaydedilirken kullanılacak açıklayıcı adı ayarlayın.

void setDeviceWaitTime(int waitTime)

Hata raporu almaya çalışmadan önce cihazın çevrimiçi olmasını bekleyeceğimiz süreyi (saniye cinsinden) ayarlayın.

void testAssumptionFailure(TestDescription test, String trace)

Birim testi, yanlış olduğu varsayılan bir koşulu işaretlediğinde çağrılır.

void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

Tek bir test senaryosunun yürütülmesinin 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çıklama eklenmiş olduğundan bir test çalıştırılmayacağı zaman ç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, HashMap<String, MetricMeasurement.Metric> runMetrics)

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

void testRunFailed(String errorMessage)

Raporlar test çalıştırması, ölümcül 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, kullanıcı isteği nedeniyle tamamlanmadan önce test çalıştırması durduruldu.

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

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

AT_START

public static final BugreportCollector.Predicate AT_START

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

Herkese açık oluşturucular

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 toplamayı bırakana kadar engelle. Toplayıcı etkin olarak hata raporu toplamıyorsa hemen geri dönün.

getSummary

public TestSummary getSummary ()

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

İadeler
TestSummary Koşuyu özetleyen bir TestSummary veya null

invocationEnded

public void invocationEnded (long elapsedTime)

Çağırmanın başarıyla mı yoksa bir hata durumu nedeniyle mi sonlandırıldığını bildirir.

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

Parametreler
elapsedTime long: çağrının geçen süresi (ms)

invocationFailed

public void invocationFailed (Throwable cause)

Bir hata durumu nedeniyle eksik bir çağırma 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. Raporcuların, birden fazla cihazın raporlamasını desteklemek için bu yöntemi geçersiz kılması gerekir.

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

setAsynchronous

public void setAsynchronous (boolean asynchronous)

Hata raporu toplama işleminin hata raporunu farklı bir iş parçacığında toplamasını (asynchronous = true) veya hata raporu alınana kadar arayan kişiyi engellemesini (asynchronous = false) ayarlayın.

Parametreler
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

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

Parametreler
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Hata raporu almaya çalışmadan önce cihazın çevrimiçi olmasını bekleyeceğimiz süreyi (saniye cinsinden) ayarlayın. Negatifse kontrol yapılmaz. Bu kontrol sırasında karşılaşılan DeviceNotAvailableException karakterleri kaydedilir ve yoksayılır.

Parametreler
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Birim testi, yanlış olduğu varsayılan bir koşulu işaretlediğinde çağrılır.

Parametreler
test TestDescription: Testi tanımlar.
trace String: Hatayla sonuçlanan yığın izleme

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Tek bir test senaryosunun yürütülmesinin sonunu bildirir.

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

Parametreler
test TestDescription: Testi tanımlar.
testMetrics HashMap: yayınlanan metriklerin Map

testFailed

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: Hatayla sonuçlanan yığın izleme

testIgnored

public void testIgnored (TestDescription test)

Genellikle bir test yöntemi org.junit.Ignore ile açıklama eklenmiş olduğundan bir test çalıştırılmayacağı zaman ç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)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) veya ERROR(/ITestInvocationListener#invocationEnded(long)) tarihinden önce aranmalıdır.

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

Parametreler
dataName String: Verilerin String açıklayıcı adı. Örneğin, "device_logcat". Not dataName, her çağırmada 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 sonuçtaki 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Test çalıştırmasının sonunu bildirir. DÜZELTİLMESİ GEREKEN YER: Farklı türde iki Map<> arayüzümüz olamaz. Bu nedenle burada HashMap kullanmamız gerekiyor.

Parametreler
elapsedTime long: Cihazın bildirdiği geçen süre (milisaniye cinsinden)
runMetrics HashMap: Metric ile yapılan bir test çalıştırmasının sonunda bildirilen anahtar/değer çiftleri.

testRunFailed

public void testRunFailed (String errorMessage)

Raporlar test çalıştırması, ölümcül bir hata nedeniyle tamamlanamadı.

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

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ının adı
testCount int: test çalıştırmasındaki toplam test sayısı

testRunStopped

public void testRunStopped (long elapsedTime)

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

YAPILACAKLAR: Şu anda kullanılmıyor, kaldırılabilir.

Parametreler
elapsedTime long: Cihazın bildirdiği geçen süre (milisaniye cinsinden)

testStarted

public void testStarted (TestDescription test)

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

Parametreler
test TestDescription: Testi tanımlar.