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

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.ऑब्जेक्ट
↳ com.android.tradefed.result.BugreportCollector

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

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

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

सारांश

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

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

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

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

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

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

पैरामीटर
listener ITestInvocationListener

testDevice ITestDevice

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

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

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

ब्लॉकअनटिलआइडल

public void blockUntilIdle ()

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

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

public TestSummary getSummary ()

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

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

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

public void invocationEnded (long elapsedTime)

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

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

पैरामीटर
elapsedTime long : एमएस में आह्वान का बीता हुआ समय

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

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

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

परीक्षणलॉग

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

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

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

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

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

dataType LogDataType : डेटा का LogDataType

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : Metric के साथ परीक्षण चलाने के अंत में कुंजी-मूल्य जोड़े की सूचना दी गई।

परीक्षण चलाने में विफल

public void testRunFailed (String errorMessage)

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

पैरामीटर
errorMessage String : रन विफलता का कारण बताने वाली String ।

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

पैरामीटर
runName String : परीक्षण चलाने का नाम

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

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

public void testRunStopped (long elapsedTime)

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

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

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

परीक्षण प्रारंभ

public void testStarted (TestDescription test)

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

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