बुग्रेपोर्टकलेक्टर

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.ऑब्जेक्ट
मैं com.android.tradefed.result. BugreportCollector


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

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

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

सारांश

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

enum BugreportCollector.Filter

enum BugreportCollector.Freq

enum BugreportCollector.Noun

class BugreportCollector.Predicate

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

enum BugreportCollector.Relation

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

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

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

बुग्रेपोर्टकलेक्टर

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

मापदंडों
listener ITestInvocationListener

testDevice ITestDevice

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

जोड़ें प्रेडिकेट

public void addPredicate (BugreportCollector.Predicate p)

मापदंडों
p BugreportCollector.Predicate

ब्लॉक तक निष्क्रिय

public void blockUntilIdle ()

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

सारांश प्राप्त करें

public TestSummary getSummary ()

आमंत्रण सूची को सारांश वापस करने की अनुमति देता है।

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

आह्वान समाप्त

public void invocationEnded (long elapsedTime)

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

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

मापदंडों
elapsedTime long : ms . में आह्वान का बीता हुआ समय

आह्वानविफल

public void invocationFailed (Throwable cause)

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

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

मापदंडों
cause Throwable : विफलता का Throwable कारण

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

public void invocationStarted (IInvocationContext context)

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

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

मापदंडों
context IInvocationContext : आमंत्रण के बारे में जानकारी

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

public void setAsynchronous (boolean asynchronous)

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

मापदंडों
asynchronous boolean

सेट वर्णनात्मक नाम

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 : टेस्ट की पहचान करता है

टेस्टलॉग

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

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

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

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

मापदंडों
dataName String : डेटा का एक String वर्णनात्मक नाम। उदाहरण के लिए "device_logcat"। नोट डेटानाम प्रति आमंत्रण अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ता एक ही डेटानाम के साथ कई कॉलों को संभालने में सक्षम होना चाहिए

dataType LogDataType : डेटा का LogDataType

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

टेस्टरनसमाप्त

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

मापदंडों
elapsedTime long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में सूचित किया

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

टेस्टरनविफल

public void testRunFailed (String errorMessage)

एक घातक त्रुटि के कारण रिपोर्ट टेस्ट रन पूरा नहीं हो सका।

मापदंडों
errorMessage String : रन विफलता के कारण का वर्णन करने वाला String

टेस्टरनस्टार्ट किया गया

public void testRunStarted (String runName, 
                int testCount)

एक परीक्षण चलाने की शुरुआत की रिपोर्ट करता है।

मापदंडों
runName String : टेस्ट रन नाम

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

टेस्टरनस्टॉप्ड

public void testRunStopped (long elapsedTime)

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

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

मापदंडों
elapsedTime long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में सूचित किया

परीक्षण शुरू हुआ

public void testStarted (TestDescription test)

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

मापदंडों
test TestDescription : टेस्ट की पहचान करता है