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
.
- 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ı ( |
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 | 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 |
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2023-03-30 UTC.