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

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