BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

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

एक पास-थ्रू ITestInvocationListener जो कॉन्फ़िगर करने योग्य ईवेंट होने पर बग रिपोर्ट एकत्र करता है और फिर प्रत्येक बग रिपोर्ट एकत्र होने के बाद अपने बच्चों पर ITestInvocationListener#testLog कॉल करता है।

व्यवहार: (FIXME: इसे समाप्त करें)

  • यदि कोई टेस्टकेस विफल हो जाता है तो प्रत्येक के बाद कैप्चर करें
  • प्रत्येक टेस्टकेस के बाद कैप्चर करें
  • प्रत्येक विफल टेस्टकेस के बाद कैप्चर करें
  • कब्ज़ा करना

सारांश

नेस्टेड कक्षाएं

class BugreportCollector.Predicate

बग्रेपोर्ट कब कैप्चर करना है इसका वर्णन करने वाला एक पूर्ण विधेय।

interface BugreportCollector.SubPredicate

खेत

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

एक पूर्वनिर्धारित विधेय जो प्रत्येक विफल टेस्टकेस के बाद सक्रिय होता है

public static final BugreportCollector.Predicate AT_START

एक पूर्वनिर्धारित विधेय जो पहले आह्वान के शुरू होते ही सक्रिय हो जाता है

सार्वजनिक निर्माणकर्ता

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

सार्वजनिक तरीके

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

ब्लॉक करें जब तक कलेक्टर कोई बग रिपोर्ट एकत्र नहीं कर रहा है।

TestSummary getSummary ()

इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।

void invocationEnded (long elapsedTime)

रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या कुछ त्रुटि स्थिति के कारण।

void invocationFailed (Throwable cause)

कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।

void invocationStarted ( IInvocationContext context)

परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।

void setAsynchronous (boolean asynchronous)

सेट करें कि बगरेपोर्ट संग्रह को बगरेपोर्ट को एक अलग थ्रेड ( asynchronous = true ) में इकट्ठा करना चाहिए, या कॉलर को तब तक ब्लॉक करना चाहिए जब तक कि बगरेपोर्ट कैप्चर नहीं हो जाता ( asynchronous = false )।

void setDescriptiveName (String name)

बग रिपोर्ट रिकॉर्ड करते समय उपयोग करने के लिए वर्णनात्मक नाम सेट करें।

void setDeviceWaitTime (int waitTime)

इससे पहले कि हम किसी बग रिपोर्ट को कैप्चर करने का प्रयास करें, डिवाइस के ऑनलाइन होने की प्रतीक्षा करने के लिए समय (सेकंड में) सेट करें।

void testAssumptionFailure ( TestDescription test, String trace)

कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

एक व्यक्तिगत परीक्षण मामले के निष्पादन अंत की रिपोर्ट करता है।

void testFailed ( TestDescription test, String trace)

व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

void testIgnored ( TestDescription test)

कॉल तब किया जाता है जब कोई परीक्षण नहीं चलाया जाएगा, आम तौर पर क्योंकि एक परीक्षण विधि org.junit.Ignore के साथ एनोटेट की जाती है।

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

परीक्षण मंगलाचरण से संबंधित लॉग या डीबग डेटा प्रदान करता है।

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

टेस्ट रन के अंत की रिपोर्ट।

void testRunFailed (String errorMessage)

घातक त्रुटि के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।

void testRunStarted (String runName, int testCount)

टेस्ट रन की शुरुआत की रिपोर्ट करता है।

void testRunStopped (long elapsedTime)

एक उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले ही रुक गया।

void testStarted ( TestDescription test)

एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है।

खेत

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

एक पूर्वनिर्धारित विधेय जो प्रत्येक विफल टेस्टकेस के बाद सक्रिय होता है

प्रारंभ में

public static final BugreportCollector.Predicate AT_START

एक पूर्वनिर्धारित विधेय जो पहले आह्वान के शुरू होते ही सक्रिय हो जाता है

सार्वजनिक निर्माणकर्ता

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

पैरामीटर
listener ITestInvocationListener

testDevice ITestDevice

सार्वजनिक तरीके

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

पैरामीटर
p BugreportCollector.Predicate

BlockUntilIdle

public void blockUntilIdle ()

ब्लॉक करें जब तक कलेक्टर कोई बग रिपोर्ट एकत्र नहीं कर रहा है। यदि संग्राहक सक्रिय रूप से बग रिपोर्ट एकत्र नहीं कर रहा है, तो तुरंत वापस लौटें

getSummary

public TestSummary getSummary ()

इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।

रिटर्न
TestSummary रन, या शून्य का सारांश देने वाला एक TestSummary

मंगलाचरणसमाप्त

public void invocationEnded (long elapsedTime)

रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या कुछ त्रुटि स्थिति के कारण।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
elapsedTime long : एमएस में मंगलाचरण का बीता हुआ समय

मंगलाचरण विफल

public void invocationFailed (Throwable cause)

कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
cause Throwable : ERROR(/Throwable) विफलता का कारण

मंगलाचरण प्रारंभ

public void invocationStarted (IInvocationContext context)

परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा। एकाधिक डिवाइस रिपोर्टिंग का समर्थन करने के लिए रिपोर्टरों को इस विधि को ओवरराइड करने की आवश्यकता है।

पैरामीटर
context IInvocationContext : मंगलाचरण के बारे में जानकारी

सेटअतुल्यकालिक

public void setAsynchronous (boolean asynchronous)

सेट करें कि बगरेपोर्ट संग्रह को बगरेपोर्ट को एक अलग थ्रेड ( asynchronous = true ) में इकट्ठा करना चाहिए, या कॉलर को तब तक ब्लॉक करना चाहिए जब तक कि बगरेपोर्ट कैप्चर नहीं हो जाता ( asynchronous = false )।

पैरामीटर
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

बग रिपोर्ट रिकॉर्ड करते समय उपयोग करने के लिए वर्णनात्मक नाम सेट करें। यदि null , तो BugreportCollector उस घटना के नाम को क्रमबद्ध करने के डिफ़ॉल्ट व्यवहार पर वापस आ जाएगा जिसके कारण बगरेपोर्ट एकत्र किया गया था।

पैरामीटर
name String

सेटडिवाइसवेटटाइम

public void setDeviceWaitTime (int waitTime)

इससे पहले कि हम किसी बग रिपोर्ट को कैप्चर करने का प्रयास करें, डिवाइस के ऑनलाइन होने की प्रतीक्षा करने के लिए समय (सेकंड में) सेट करें। निगेटिव होने पर कोई जांच नहीं की जाएगी। इस जांच के दौरान किसी भी DeviceNotAvailableException का सामना करना पड़ा और उसे अनदेखा कर दिया जाएगा।

पैरामीटर
waitTime int

परीक्षण धारणा विफलता

public void testAssumptionFailure (TestDescription test, 
                String trace)

कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है

पैरामीटर
test TestDescription : परीक्षण की पहचान करता है

trace String : विफलता का स्टैक ट्रेस

परीक्षण समाप्त

public void testEnded (TestDescription test, 
                 testMetrics)

एक व्यक्तिगत परीक्षण मामले के निष्पादन अंत की रिपोर्ट करता है।

अगर testFailed(TestDescription, FailureDescription) लागू नहीं किया गया था, तो यह परीक्षा पास हो गई। किसी भी कुंजी/मान मेट्रिक्स को भी लौटाता है जो टेस्ट केस के निष्पादन के दौरान उत्सर्जित हो सकता है।

पैरामीटर
test TestDescription : परीक्षण की पहचान करता है

testMetrics : उत्सर्जित मेट्रिक्स का एक ERROR(/Map)

परीक्षण विफल

public void testFailed (TestDescription test, 
                String trace)

व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्टेड और टेस्टएंडेड के बीच कॉल किया जाएगा।

पैरामीटर
test TestDescription : परीक्षण की पहचान करता है

trace String : विफलता का स्टैक ट्रेस

परीक्षणउपेक्षित

public void testIgnored (TestDescription test)

कॉल तब किया जाता है जब कोई परीक्षण नहीं चलाया जाएगा, आम तौर पर क्योंकि एक परीक्षण विधि org.junit.Ignore के साथ एनोटेट की जाती है।

पैरामीटर
test TestDescription : परीक्षण की पहचान करता है

testLog

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

परीक्षण मंगलाचरण से संबंधित लॉग या डीबग डेटा प्रदान करता है।

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) या ERROR(/ITestInvocationListener#invocationEnded(long)) से पहले कॉल किया जाना चाहिए

ट्रेडफेडरेशन फ्रेमवर्क स्वचालित रूप से इस विधि को कॉल करेगा, होस्ट लॉग प्रदान करेगा और यदि लागू हो, डिवाइस लॉगकैट।

पैरामीटर
dataName String : एक ERROR(/String) डेटा का वर्णनात्मक नाम। उदाहरण के लिए "डिवाइस_लॉगकैट"। नोट dataName प्रति मंगलाचरण अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ताओं को एक ही डेटानाम के साथ कई कॉलों को संभालने में सक्षम होना चाहिए

dataType LogDataType : डेटा का LogDataType

dataStream InputStreamSource : डेटा का InputStreamSource । कार्यान्वयनकर्ताओं को डेटा पढ़ना शुरू करने के लिए createInputStream को कॉल करना चाहिए और पूरा होने पर परिणामी InputStream को बंद करना सुनिश्चित करना चाहिए। कॉल करने वालों को यह सुनिश्चित करना चाहिए कि टेस्टलॉग विधि पूरी होने तक डेटा का स्रोत मौजूद और सुलभ रहे।

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

टेस्ट रन के अंत की रिपोर्ट। FIXME: हमारे पास अलग-अलग प्रकार के दो मैप<> इंटरफेस नहीं हो सकते हैं, इसलिए हमें यहां हैश मैप का उपयोग करना होगा।

पैरामीटर
elapsedTime long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में रिपोर्ट किया

runMetrics : Metric के साथ टेस्ट रन के अंत में रिपोर्ट किए गए की-वैल्यू पेयर।

testrunFailed

public void testRunFailed (String errorMessage)

घातक त्रुटि के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।

पैरामीटर
errorMessage String : ERROR(/String) रन विफलता के कारण का वर्णन करता है।

testrunStarted

public void testRunStarted (String runName, 
                int testCount)

टेस्ट रन की शुरुआत की रिपोर्ट करता है।

पैरामीटर
runName String : टेस्ट रन नाम

testCount int : परीक्षण चलाने में परीक्षणों की कुल संख्या

testRunStopped

public void testRunStopped (long elapsedTime)

एक उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले ही रुक गया।

TODO: वर्तमान में अप्रयुक्त, हटाने पर विचार करें

पैरामीटर
elapsedTime long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में रिपोर्ट किया

परीक्षण शुरू

public void testStarted (TestDescription test)

एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है। पुराना इंटरफ़ेस, जब भी संभव हो testStarted(com.android.tradefed.result.TestDescription) उपयोग करना चाहिए।

पैरामीटर
test TestDescription : परीक्षण की पहचान करता है