CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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

पहचाने गए डायरेक्ट सबक्लास JsonHttpTestResultReporter, LUCIResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter JsonHttpTestResultReporter नतीजों की जानकारी देने वाला टूल, जो जांच की मेट्रिक के नतीजों और शाखा, डिवाइस की जानकारी को JSON में बदलता है और HTTP सेवा के एंडपॉइंट में पोस्ट करता है  LUCIResultReporter नतीजों की जानकारी देने वाला टूल, जो ResultDB और LUCI के लिए ज़रूरी टेस्ट के नतीजों को JSON फ़ॉर्मैट (go/result-sink) में सेव करता है. साथ ही, फ़ाइल की जगह की जानकारी को कंसोल में लॉग करता है.  MetricsXMLResultReporter MetricsXMLResultReporter, टेस्ट की मेट्रिक को लिखता है और मेट्रिक को एक्सएमएल फ़ाइल में चलाता है. यह फ़ाइल, टेस्ट के invocationEnded फ़ेज़ में, metrics-folder पैरामीटर से तय किए गए फ़ोल्डर में होती है.  ModuleListener नतीजों की सूची इकट्ठा करने के लिए, हर मॉड्यूल के हर IRemoteTest से जुड़ा Listener.  ReportPassedTests पास हो चुके टेस्ट को बाहर रखने के लिए, फ़ाइल में संभावित फ़िल्टर की रिपोर्ट करें.  ResultAggregator यह एक खास फ़ॉरवर्डर है, जो ज़रूरत पड़ने पर, फिर से कोशिश करने की रणनीति के आधार पर नतीजों को इकट्ठा करता है.  ShardListener एक ITestInvocationListener जो किसी invocaton shard (जिसे एक साथ कई संसाधनों पर चलाने के लिए invocaton split भी कहा जाता है) से नतीजे इकट्ठा करता है और उन्हें किसी दूसरे listener को भेजता है.  SuiteResultReporter पूरे सुइट के इस्तेमाल के लिए टेस्ट के नतीजे इकट्ठा करें और आखिरी नतीजे दिखाएं.  XmlResultReporter JUnit के नतीजों को एक्सएमएल फ़ाइलों में लिखता है. यह फ़ॉर्मैट, Ant के XMLJUnitResultFormatter के फ़ॉर्मैट से मेल खाता है.

ऐसे सबक्लास जिनके बारे में पहले से पता है FormattedGeneratorReporter, XmlFormattedGeneratorReporter FormattedGeneratorReporter रिपोर्टर, जो किसी खास फ़ॉर्मैट में रिपोर्ट जनरेट करने की सुविधा देता है.  XmlFormattedGeneratorReporter FormattedGeneratorReporter को लागू करना, जो सुइट के नतीजों को एक्सएमएल फ़ॉर्मैट में फ़ॉर्मैट करता है.

---

एक ITestInvocationListener, जो टेस्ट के सभी नतीजे इकट्ठा करेगा.

इस ऑब्जेक्ट में इस्तेमाल किए गए डेटा स्ट्रक्चर, थ्रेड-सेफ़ होते हैं. हालांकि, ITestInvocationListener कॉलबैक को सही क्रम में कॉल किया जाना चाहिए.

खास जानकारी

पब्लिक कंस्ट्रक्टर
CollectingTestListener()

सार्वजनिक तरीके
IBuildInfo	getBuildInfo() इस तरीके का इस्तेमाल नहीं किया जा सकता. getInvocationContext() से मिले IBuildInfo पर भरोसा करें.
TestRunResult	getCurrentRunResults() मौजूदा टेस्ट रन के नतीजे दिखाता है.
int	getExpectedTests() अनुमानित टेस्ट की संख्या दिखाता है.
IInvocationContext	getInvocationContext() invocationStarted(com.android.tradefed.invoker.IInvocationContext) के ज़रिए रिपोर्ट किया गया, ट्रिगर करने का कॉन्टेक्स्ट दिखाता है
	getMergedTestRunResults() अलग-अलग कोशिशों के सभी रन के नतीजों का मर्ज किया गया कलेक्शन दिखाता है.
IInvocationContext	getModuleContextForRunResult(String testRunName) नतीजों से जुड़े मॉड्यूल का IInvocationContext दिखाता है.
MultiMap<String, LogFile>	getModuleLogFiles() इस फ़ंक्शन से, उस मैप की कॉपी मिलती है जिसमें मॉड्यूल से जुड़ी सभी लॉग की गई फ़ाइलें होती हैं
MultiMap<String, LogFile>	getNonAssociatedLogFiles() मैप की एक कॉपी दिखाता है. इसमें, टेस्ट रन या किसी मॉड्यूल से जुड़ी सभी लॉग की गई फ़ाइलें शामिल नहीं होती हैं.
int	getNumAllFailedTestRuns() गड़बड़ी की स्थिति में टेस्ट रन की कुल संख्या दिखाता है
int	getNumAllFailedTests() गड़बड़ी की स्थिति में मौजूद टेस्ट की कुल संख्या दिखाता है. इसमें सिर्फ़ गड़बड़ी वाली टेस्ट की गिनती की जाती है, न कि गलत अनुमान की गिनती की जाती है.
int	getNumTestsInState(TestStatus status) इस रन के लिए, दी गई स्थिति में मौजूद टेस्ट की संख्या दिखाता है.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) पुराने स्टेटस टाइप के साथ काम करने के लिए
int	getNumTotalTests() सभी रन के लिए, पूरे किए गए टेस्ट की कुल संख्या दिखाता है.
IBuildInfo	getPrimaryBuildInfo() invocationStarted(com.android.tradefed.invoker.IInvocationContext) के ज़रिए रिपोर्ट की गई, प्राइमरी बिल्ड की जानकारी दिखाता है.
	getRunResults() इस तरीके का इस्तेमाल नहीं किया जा सकता. getMergedTestRunResults() का इस्तेमाल करें
TestRunResult	getTestRunAtAttempt(String testRunName, int attempt) एक बार कोशिश करने के लिए TestRunResult दिखाएं.
int	getTestRunAttemptCount(String testRunName) किसी टेस्ट रन के नाम के लिए, कोशिशों की संख्या दिखाता है.
	getTestRunAttempts(String testRunName) किसी टेस्ट रन के TestRunResult के लिए किए गए सभी प्रयासों की जानकारी मिलती है.
	getTestRunForAttempts(int attempt) किसी दिए गए प्रयास के लिए सभी नतीजे पाता है.
	getTestRunNames() सभी टेस्ट रन के लिए सभी नाम दिखाता है.
boolean	hasFailedTests() यह बताता है कि क्या अनुरोध में कोई ऐसी जांच शामिल थी जो पूरी नहीं हुई या जिसकी पुष्टि नहीं हुई.
boolean	hasTestRunResultsForName(String testRunName) यह बताता है कि किसी टेस्ट रन के नाम से कोई नतीजा मिलता है या नहीं.
void	invocationEnded(long elapsedTime) यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.
void	invocationFailed(Throwable cause) किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.
void	invocationSkipped(SkipReason reason) किसी अनुरोध को 'अभी नहीं' के तौर पर रिपोर्ट करता है
void	invocationStarted(IInvocationContext context) टेस्ट को शुरू करने के बारे में रिपोर्ट करता है.
boolean	isDisabled() अगर पूरा ऑब्जेक्ट बंद है, तो True दिखाता है. इस स्थिति में, सेटअप और टियरडाउन, दोनों को छोड़ दिया जाता है.
void	logAssociation(String dataName, LogFile logFile) कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है.
void	setBuildInfo(IBuildInfo buildInfo) इस तरीके का इस्तेमाल नहीं किया जा सकता. अब टेस्टिंग के लिए ज़रूरी नहीं है.
void	setDisable(boolean isDisabled) इससे यह तय होता है कि ऑब्जेक्ट को बंद करना है या नहीं.
void	setMergeStrategy(MergeStrategy strategy) नतीजों को मर्ज करते समय इस्तेमाल करने के लिए MergeStrategy सेट करता है.
void	testAssumptionFailure(TestDescription test, String trace) जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है
void	testAssumptionFailure(TestDescription test, FailureDescription failure) जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है
void	testEnded(TestDescription test, long endTime, testMetrics) ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) का विकल्प, जहां हम सीधे तौर पर खत्म होने का समय बता सकते हैं.
void	testEnded(TestDescription test, testMetrics) किसी टेस्ट केस के पूरा होने की जानकारी देता है.
void	testFailed(TestDescription test, FailureDescription failure) किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.
void	testFailed(TestDescription test, String trace) किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.
void	testIgnored(TestDescription test) जब कोई टेस्ट नहीं चलेगा, तब इसे कॉल किया जाएगा. आम तौर पर, ऐसा इसलिए होता है, क्योंकि टेस्ट के तरीके को org.junit.Ignore के साथ एनोटेट किया गया है.
void	testModuleEnded() मॉड्यूल के चलने के खत्म होने की रिपोर्ट दिखाता है.
void	testModuleStarted(IInvocationContext moduleContext) किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है.
void	testRunEnded(long elapsedTime, runMetrics) टेस्ट रन खत्म होने की रिपोर्ट दिखाता है.
void	testRunFailed(FailureDescription failure) FailureDescription की बताई गई गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.
void	testRunFailed(String errorMessage) किसी गंभीर गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.
void	testRunStarted(String name, int numTests, int attemptNumber) टेस्ट रन शुरू होने की जानकारी देता है.
void	testRunStarted(String name, int numTests) टेस्ट रन शुरू होने की जानकारी देता है.
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) टेस्ट रन शुरू होने की जानकारी देता है.
void	testRunStopped(long elapsedTime) उपयोगकर्ता के अनुरोध की वजह से, रिपोर्ट की जांच पूरी होने से पहले ही रोक दी गई.
void	testSkipped(TestDescription test, SkipReason reason) जब किसी टेस्ट को स्किप किया जाता है और वह किसी ऐसी वजह से नहीं चलता है जिसकी आम तौर पर उम्मीद नहीं की जाती, तब यह ट्रिगर होता है.
void	testStarted(TestDescription test, long startTime) testStarted(com.android.tradefed.result.TestDescription) का विकल्प, जिसमें हम यह भी बताते हैं कि जांच कब शुरू की गई थी. सटीक मेज़रमेंट के लिए, इसे ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) के साथ जोड़ा जाता है.
void	testStarted(TestDescription test) किसी टेस्ट केस के शुरू होने की जानकारी देता है.

सुरक्षित तरीके
final void	clearModuleLogFiles() मॉड्यूल फ़ाइल को साफ़ करने की अनुमति देता है, ताकि हम उन्हें बहुत लंबे समय तक न रखें.
final void	clearResultsForName(String testRunName) इससे किसी रन के नाम के लिए नतीजे मिटाए जा सकते हैं.
void	setIsAggregrateMetrics(boolean aggregate) 'एग्रीगेट मेट्रिक' विकल्प को टॉगल करना

पब्लिक कंस्ट्रक्टर

CollectingTestListener

public CollectingTestListener ()

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

getBuildInfo

public IBuildInfo getBuildInfo ()

इस तरीके का इस्तेमाल नहीं किया जा सकता.
getInvocationContext() से IBuildInfo पर भरोसा करें.

बिल्ड की जानकारी दिखाता है.

रिटर्न
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

मौजूदा टेस्ट रन के नतीजे दिखाता है.

ध्यान दें कि हो सकता है कि नतीजे पूरे न हों. हमारा सुझाव है कि नतीजों को प्रोसेस करने से पहले, TestRunResult.isRunComplete() और/या (@link TestRunResult#isRunFailure()} की वैल्यू की जांच करें.

रिटर्न
TestRunResult	TestRunResult, पिछले टेस्ट रन के दौरान इकट्ठा किए गए डेटा को दिखाता है

getExpectedTests

public int getExpectedTests ()

अनुमानित टेस्ट की संख्या दिखाता है. अगर कुछ टेस्ट नहीं चले, तो यह getNumTotalTests() से अलग हो सकता है.

रिटर्न
int

getInvocationContext

public IInvocationContext getInvocationContext ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext) के ज़रिए रिपोर्ट किया गया, ट्रिगर करने का कॉन्टेक्स्ट दिखाता है

रिटर्न
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

अलग-अलग कोशिशों के सभी रन के नतीजों का मर्ज किया गया कलेक्शन दिखाता है.

अगर एक से ज़्यादा नतीजे हैं, तो हर टेस्ट रन को मर्ज कर दिया जाता है. साथ ही, नया टेस्ट नतीजा, पिछले टेस्ट के नतीजों को ओवरराइट कर देता है. टेस्ट रन को कोशिश की संख्या के हिसाब से क्रम में लगाया जाता है.

एक ही कोशिश की मेट्रिक, aggregate-metrics की सेट की गई प्राथमिकता के आधार पर मर्ज हो जाएंगी. आखिरी मेट्रिक, आखिरी कोशिश की मेट्रिक होंगी.

रिटर्न

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

नतीजों से जुड़े मॉड्यूल का IInvocationContext दिखाता है.

पैरामीटर
testRunName	String: {testRunStarted(String, int) ने जो नाम दिया है.

रिटर्न
IInvocationContext	किसी टेस्ट रन के नाम के लिए मॉड्यूल का IInvocationContext null अगर उस नाम के लिए कोई नतीजा नहीं मिलता है.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

इस फ़ंक्शन से, उस मैप की कॉपी मिलती है जिसमें मॉड्यूल से जुड़ी सभी लॉग की गई फ़ाइलें होती हैं

रिटर्न
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

मैप की एक कॉपी दिखाता है. इसमें, टेस्ट रन या किसी मॉड्यूल से जुड़ी सभी लॉग की गई फ़ाइलें शामिल नहीं होती हैं.

रिटर्न
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

गड़बड़ी की स्थिति में टेस्ट रन की कुल संख्या दिखाता है

रिटर्न
int

getNumAllFailedTests

public int getNumAllFailedTests ()

गड़बड़ी की स्थिति में मौजूद टेस्ट की कुल संख्या दिखाता है. इसमें सिर्फ़ गड़बड़ी वाली टेस्ट की गिनती की जाती है, न कि गलत अनुमान की गिनती की जाती है.

रिटर्न
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

इस रन के लिए, दी गई स्थिति में मौजूद टेस्ट की संख्या दिखाता है.

पैरामीटर
status	TestStatus

रिटर्न
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

पुराने स्टेटस टाइप के साथ काम करने के लिए

पैरामीटर
ddmlibStatus	TestResult.TestStatus

रिटर्न
int

getNumTotalTests

public int getNumTotalTests ()

सभी रन के लिए, पूरे किए गए टेस्ट की कुल संख्या दिखाता है.

रिटर्न
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext) के ज़रिए रिपोर्ट की गई, प्राइमरी बिल्ड की जानकारी दिखाता है. प्राइमरी बिल्ड, चल रहे कॉन्फ़िगरेशन के पहले बिल्ड प्रोवाइडर से मिलने वाला बिल्ड होता है. अगर कोई संदर्भ नहीं है, तो यह फ़ंक्शन शून्य दिखाता है. इसका मतलब है कि जांच के लिए कोई बिल्ड नहीं है.

रिटर्न
IBuildInfo

getRunResults

public  getRunResults ()

इस तरीके का इस्तेमाल नहीं किया जा सकता.
getMergedTestRunResults() का इस्तेमाल करना

टेस्ट के सभी रन के नतीजे दिखाता है.

रिटर्न

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

एक बार कोशिश करने के लिए TestRunResult दिखाएं.

पैरामीटर
testRunName	String: {testRunStarted(String, int) ने जो नाम दिया है.
attempt	int: कोशिश का आईडी.

रिटर्न
TestRunResult	दिए गए नाम और कोशिश के आईडी के लिए TestRunResult या अगर यह मौजूद नहीं है, तो null.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

किसी टेस्ट रन के नाम के लिए, कोशिशों की संख्या दिखाता है.

पैरामीटर
testRunName	String: {testRunStarted(String, int) ने जो नाम दिया है.

रिटर्न
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

किसी टेस्ट रन के TestRunResult के लिए किए गए सभी प्रयासों की जानकारी मिलती है.

पैरामीटर
testRunName	String: {testRunStarted(String, int) ने जो नाम दिया है.

रिटर्न
	किसी टेस्ट रन के लिए सभी TestRunResult, कोशिशों के हिसाब से क्रम में लगाए गए.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

किसी दिए गए प्रयास के लिए सभी नतीजे पाता है.

पैरामीटर
attempt	int: वह कोशिश जिसके लिए हमें नतीजे चाहिए.

रिटर्न
	किसी एक कोशिश के लिए सभी TestRunResult.

getTestRunNames

public  getTestRunNames ()

सभी टेस्ट रन के लिए सभी नाम दिखाता है.

हो सकता है कि ये टेस्ट अलग-अलग कोशिशों के साथ कई बार चलाए गए हों.

रिटर्न

hasFailedTests

public boolean hasFailedTests ()

यह बताता है कि क्या अनुरोध में कोई ऐसी जांच शामिल थी जो पूरी नहीं हुई या जिसकी पुष्टि नहीं हुई.

रिटर्न
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

यह बताता है कि किसी टेस्ट रन के नाम से कोई नतीजा मिलता है या नहीं.

पैरामीटर
testRunName	String: {testRunStarted(String, int) ने जो नाम दिया है.

रिटर्न
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा.

पैरामीटर
elapsedTime	long: कॉल को शुरू करने में लगा समय, मिलीसेकंड में

invocationFailed

public void invocationFailed (Throwable cause)

किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा.

पैरामीटर
cause	Throwable: Throwable गड़बड़ी की वजह

invocationSkipped

public void invocationSkipped (SkipReason reason)

किसी अनुरोध को 'अभी नहीं' के तौर पर रिपोर्ट करता है

पैरामीटर
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

टेस्ट को शुरू करने के बारे में रिपोर्ट करता है.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा. एक से ज़्यादा डिवाइसों की रिपोर्टिंग के लिए, रिपोर्टर को इस तरीके को बदलना होगा.

पैरामीटर
context	IInvocationContext: बोलकर निर्देश देने की सुविधा के बारे में जानकारी

isDisabled

public boolean isDisabled ()

अगर पूरा ऑब्जेक्ट बंद है, तो True दिखाता है. इस स्थिति में, सेटअप और टियरडाउन, दोनों को छोड़ दिया जाता है. अगर ऐसा नहीं है, तो गलत.

रिटर्न
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है. इसलिए, इस कॉलबैक की मदद से, साफ़ तौर पर एक बेहतर असोसिएशन दिया जा सकता है.

पैरामीटर
dataName	String: डेटा का नाम
logFile	LogFile: वह LogFile जो पहले लॉग किया गया था और जो जांच के उदाहरण से जुड़ा होना चाहिए.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

इस तरीके का इस्तेमाल नहीं किया जा सकता.
अब टेस्टिंग के लिए ज़रूरी नहीं है.

बिल्ड की जानकारी सेट करें. इसका इस्तेमाल सिर्फ़ टेस्टिंग के लिए किया जाना चाहिए.

पैरामीटर
buildInfo	IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

इससे यह तय होता है कि ऑब्जेक्ट को बंद करना है या नहीं. बंद होने का मतलब है कि सेटअप और टियरडाउन, दोनों चरणों को छोड़ दिया जाना चाहिए. इसका इस्तेमाल, डिफ़ॉल्ट कंस्ट्रक्टर में किसी ऑब्जेक्ट को डिफ़ॉल्ट रूप से बंद करने के लिए किया जा सकता है.

पैरामीटर
isDisabled	boolean: वह स्थिति जिसमें ऑब्जेक्ट को रखा जाना चाहिए.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

नतीजों को मर्ज करते समय इस्तेमाल करने के लिए MergeStrategy सेट करता है.

पैरामीटर
strategy	MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
trace	String: गड़बड़ी का स्टैक ट्रेस

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
failure	FailureDescription: FailureDescription गड़बड़ी और उसके संदर्भ के बारे में बताना.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) का विकल्प, जहां हम सीधे तौर पर खत्म होने का समय बता सकते हैं. सटीक मेज़रमेंट के लिए, testStarted(com.android.tradefed.result.TestDescription, long) के साथ जोड़ें.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
endTime	long: टेस्ट खत्म होने का समय, जिसे System.currentTimeMillis() से मेज़र किया जाता है
testMetrics	: उत्सर्जित मेट्रिक का ERROR(/Map)

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

किसी टेस्ट केस के पूरा होने की जानकारी देता है.

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

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
testMetrics	: उत्सर्जित मेट्रिक का ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.

इसे testStarted और testEnded के बीच कॉल किया जाएगा.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
failure	FailureDescription: FailureDescription गड़बड़ी और उसके संदर्भ के बारे में बताना.

testFailed

public void testFailed (TestDescription test, 
                String trace)

किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.

इसे testStarted और testEnded के बीच कॉल किया जाएगा.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
trace	String: गड़बड़ी का स्टैक ट्रेस

testIgnored

public void testIgnored (TestDescription test)

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

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

testModuleEnded

public void testModuleEnded ()

मॉड्यूल के चलने के खत्म होने की रिपोर्ट दिखाता है.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है. यह कॉलबैक testModuleEnded() से जुड़ा है और क्रम में शामिल करना ज़रूरी नहीं है. इसका इस्तेमाल सिर्फ़ उस रन के दौरान किया जाता है जिसमें मॉड्यूल का इस्तेमाल किया जाता है: suite based runners.

पैरामीटर
moduleContext	IInvocationContext: मॉड्यूल का IInvocationContext.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

टेस्ट रन खत्म होने की रिपोर्ट दिखाता है.

पैरामीटर
elapsedTime	long: डिवाइस से मिलीसेकंड में, बीत चुका समय
runMetrics	: टेस्ट रन के आखिर में रिपोर्ट किए गए की-वैल्यू पेयर

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescription की बताई गई गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.

पैरामीटर
failure	FailureDescription: FailureDescription गड़बड़ी और उसके संदर्भ के बारे में बताना.

testRunFailed

public void testRunFailed (String errorMessage)

किसी गंभीर गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.

पैरामीटर
errorMessage	String: String, जिसमें रन न होने की वजह बताई गई है.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

टेस्ट रन शुरू होने की जानकारी देता है.

पैरामीटर
name	String: टेस्ट रन का नाम
numTests	int: टेस्ट रन में टेस्ट की कुल संख्या
attemptNumber	int: ऑर्डर नंबर, एक ही runName के अलग-अलग प्रयासों की पहचान करता है, जो कई बार चलाए जाते हैं. attemptNumber का इंडेक्स 0 से शुरू होता है और हर बार नया रन होने पर, इसकी वैल्यू बढ़नी चाहिए. उदाहरण के लिए, किसी टेस्ट को तीन बार फिर से चलाया जाता है, तो एक ही runName के तहत कुल चार रन होने चाहिए और attemptNumber की वैल्यू 0 से 3 के बीच होनी चाहिए.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

टेस्ट रन शुरू होने की जानकारी देता है.

पैरामीटर
name	String: टेस्ट रन का नाम
numTests	int: टेस्ट रन में टेस्ट की कुल संख्या

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

टेस्ट रन शुरू होने की जानकारी देता है.

पैरामीटर
name	String: टेस्ट रन का नाम
numTests	int: टेस्ट रन में टेस्ट की कुल संख्या
attemptNumber	int: ऑर्डर नंबर, एक ही runName के अलग-अलग प्रयासों की पहचान करता है, जो कई बार चलाए जाते हैं. attemptNumber का इंडेक्स 0 से शुरू होता है और हर बार नया रन होने पर, इसकी वैल्यू बढ़नी चाहिए. उदाहरण के लिए, किसी टेस्ट को तीन बार फिर से चलाया जाता है, तो उसी runName के तहत कुल चार रन होने चाहिए और attemptNumber की वैल्यू 0 से 3 के बीच होनी चाहिए.
startTime	long: रन शुरू होने का समय, जिसे System.currentTimeMillis() से मेज़र किया जाता है

testRunStopped

public void testRunStopped (long elapsedTime)

उपयोगकर्ता के अनुरोध की वजह से, रिपोर्ट की जांच पूरी होने से पहले ही रोक दी गई.

TODO: फ़िलहाल इस्तेमाल नहीं किया जा रहा है, इसे हटाने पर विचार करें

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

जब किसी टेस्ट को स्किप किया जाता है और वह किसी ऐसी वजह से नहीं चलता है जिसकी आम तौर पर उम्मीद नहीं की जाती, तब यह ट्रिगर होता है. इन टेस्ट को फिर से चलाकर, सही तरीके से लागू करने की कोशिश की जाएगी.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription) का विकल्प, जिसमें हम यह भी बताते हैं कि जांच कब शुरू की गई थी. सटीक मेज़रमेंट के लिए, इसे ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) के साथ जोड़ा जाता है.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
startTime	long: जांच शुरू होने का समय, जिसे System.currentTimeMillis() से मेज़र किया जाता है

testStarted

public void testStarted (TestDescription test)

किसी टेस्ट केस के शुरू होने की जानकारी देता है. पुराने इंटरफ़ेस में, जब भी हो सके testStarted(com.android.tradefed.result.TestDescription) का इस्तेमाल करना चाहिए.

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

सुरक्षित तरीके

clearModuleLogFiles

protected final void clearModuleLogFiles ()

मॉड्यूल फ़ाइल को साफ़ करने की अनुमति देता है, ताकि हम उन्हें बहुत लंबे समय तक न रखें.

clearResultsForName

protected final void clearResultsForName (String testRunName)

इससे किसी रन के नाम के लिए नतीजे मिटाए जा सकते हैं. इसका इस्तेमाल सिर्फ़ कुछ मामलों में किया जाना चाहिए, जैसे कि नतीजों को इकट्ठा करने के लिए.

पैरामीटर
testRunName	String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

'एग्रीगेट मेट्रिक' विकल्प को टॉगल करना

पैरामीटर
aggregate	boolean