BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
   ↳ com.android.tradefed.device.metric.BaseDeviceMetricCollector


IMetricCollector को लागू करने का बुनियादी तरीका. इससे onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) और ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) पर डेटा इकट्ठा करने की प्रोसेस शुरू और बंद की जा सकती है.

खास जानकारी

कॉन्स्टेंट

String TEST_CASE_EXCLUDE_GROUP_OPTION

String TEST_CASE_INCLUDE_GROUP_OPTION

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

BaseDeviceMetricCollector()

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

void extraInit(IInvocationContext context, ITestInvocationListener listener)
final getBuildInfos()

यह फ़ंक्शन, इनवोकेशन में उपलब्ध बिल्ड की जानकारी की सूची दिखाता है.

final getDevices()

इस फ़ंक्शन से, इनवॉकेशन में उपलब्ध डिवाइसों की सूची मिलती है.

File getFileFromTestArtifacts(String fileName)

टेस्ट आर्टफ़ैक्ट या मॉड्यूल आर्टफ़ैक्ट से फ़ाइल को वापस पाएं और उसे मैप में कैश मेमोरी में सेव करें, ताकि बाद में कॉल किया जा सके.

final ITestInvocationListener getInvocationListener()

यह कुकी, उस ओरिजनल ITestInvocationListener को वापस भेजती है जहां हम नतीजे फ़ॉरवर्ड कर रहे हैं.

String getModuleName()
final getRealDevices()

यह getDevices() की सूची से, सभी नॉन-स्टब डिवाइसों को दिखाता है.

String getRunName()

यह उस टेस्ट रन mRunName का नाम दिखाता है जो कलेक्टर को ट्रिगर करता है.

String getTestName()

यह उस टेस्ट mTestName का नाम दिखाता है जो कलेक्टर को ट्रिगर करता है.

final ITestInvocationListener init(IInvocationContext context, ITestInvocationListener listener)

मौजूदा कॉन्टेक्स्ट के साथ कलेक्टर को शुरू करना और नतीजों को कहां फ़ॉरवर्ड करना है.

final void invocationEnded(long elapsedTime)

यह बताता है कि इनवॉकेशन खत्म हो गया है. ऐसा किसी गड़बड़ी की वजह से हुआ है या यह प्रोसेस पूरी हो गई है.

final void invocationFailed(FailureDescription failure)

किसी गड़बड़ी की वजह से, यह कुकी इनवोकेशन पूरा न होने की सूचना देती है.

final void invocationFailed(Throwable cause)

किसी गड़बड़ी की वजह से, यह कुकी इनवोकेशन पूरा न होने की सूचना देती है.

void invocationSkipped(SkipReason reason)

यह इवेंट, किसी इनवोकेशन को स्किप किए गए इवेंट के तौर पर रिपोर्ट करता है

final void invocationStarted(IInvocationContext context)

फ़ॉरवर्ड करने के लिए इनवोकेशन लिसनर

final boolean isDisabled()

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

boolean isDisabledReceiver()

IDeviceActionReceiver की सुविधा बंद है या नहीं.

final void logAssociation(String dataName, LogFile logFile)

इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें.

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

जब कोई टेस्ट केस, अनुमान के सही न होने की वजह से पूरा नहीं हो पाता, तब कॉलबैक किया जाता है.

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

टेस्ट केस खत्म होने पर कॉलबैक.

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

टेस्ट केस खत्म होने पर कॉलबैक.

void onTestFail(DeviceMetricData testData, TestDescription test)

टेस्ट केस फ़ेल होने पर कॉलबैक.

void onTestModuleEnded()

इस कुकी का इस्तेमाल, मॉड्यूल के खत्म होने से जुड़े इवेंट को कैप्चर करने के लिए किया जाता है.

void onTestModuleStarted()

इस कुकी की मदद से, मॉड्यूल शुरू होने वाले इवेंट को कैप्चर किया जा सकता है.

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

टेस्ट रन खत्म होने पर कॉलबैक.

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

testRunFailed इवेंट के लिए कॉलबैक

void onTestRunStart(DeviceMetricData runData)

टेस्ट रन शुरू होने पर कॉलबैक.

void onTestStart(DeviceMetricData testData)

टेस्ट केस शुरू होने पर कॉलबैक.

void rebootEnded(ITestDevice device)

डिवाइस में रीबूट की प्रोसेस पूरी होने पर सूचना मिलती है.

void rebootStarted(ITestDevice device)

इस कुकी से सूचना मिलती है कि डिवाइस में रीबूट की प्रोसेस शुरू हो गई है.

final void setDisable(boolean isDisabled)

इससे यह सेट किया जाता है कि ऑब्जेक्ट को बंद किया जाना चाहिए या नहीं.

void setDisableReceiver(boolean isDisabled)

इससे यह सेट होता है कि IDeviceActionReceiver को बंद करना है या नहीं.

final void setLogSaver(ILogSaver logSaver)

इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें.

final void testAssumptionFailure(TestDescription test, String trace)

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

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

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

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

final void testEnded(TestDescription test, testMetrics)

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

final void testFailed(TestDescription test, FailureDescription failure)

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

final void testFailed(TestDescription test, String trace)

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

final void testIgnored(TestDescription test)

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

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

यह टेस्ट शुरू करने से जुड़ा लॉग या डीबग डेटा उपलब्ध कराता है.

final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें.

final void testModuleEnded()

यह कुकी, मॉड्यूल के रन के खत्म होने की जानकारी देती है.

final void testModuleStarted(IInvocationContext moduleContext)

इस कुकी से, किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट मिलती है.

final void testRunEnded(long elapsedTime, runMetrics)

यह कुकी, टेस्ट रन के खत्म होने की जानकारी देती है.

final void testRunFailed(FailureDescription failure)

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

final void testRunFailed(String errorMessage)

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

final void testRunStarted(String runName, int testCount, int attemptNumber)

यह कुकी, टेस्ट रन की शुरुआत की रिपोर्ट करती है.

final void testRunStarted(String runName, int testCount)

कॉलबैक की जांच करना

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

यह कुकी, टेस्ट रन की शुरुआत की रिपोर्ट करती है.

final void testRunStopped(long elapsedTime)

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

final void testSkipped(TestDescription test, SkipReason reason)

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

final void testStarted(TestDescription test, long startTime)

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

final void testStarted(TestDescription test)

टेस्ट केस कॉलबैक

कॉन्स्टेंट

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

स्थिर वैल्यू: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

स्थिर वैल्यू: "test-case-include-group"

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

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

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

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

थ्रो
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

यह फ़ंक्शन, इनवोकेशन में उपलब्ध बिल्ड की जानकारी की सूची दिखाता है.

रिटर्न

getDevices

public final  getDevices ()

इस फ़ंक्शन से, इनवॉकेशन में उपलब्ध डिवाइसों की सूची मिलती है.

रिटर्न

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

टेस्ट आर्टफ़ैक्ट या मॉड्यूल आर्टफ़ैक्ट से फ़ाइल को वापस पाएं और उसे मैप में कैश मेमोरी में सेव करें, ताकि बाद में कॉल किया जा सके.

पैरामीटर
fileName String: आर्टफ़ैक्ट में खोजने के लिए फ़ाइल का नाम.

रिटर्न
File टेस्ट आर्टफ़ैक्ट या मॉड्यूल आर्टफ़ैक्ट से फ़ाइल. अगर फ़ाइल नहीं मिलती है, तो शून्य दिखाता है.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

यह कुकी, उस ओरिजनल ITestInvocationListener को वापस भेजती है जहां हम नतीजे फ़ॉरवर्ड कर रहे हैं.

रिटर्न
ITestInvocationListener

getModuleName

public String getModuleName ()

रिटर्न
String

getRealDevices

public final  getRealDevices ()

यह getDevices() की सूची से, सभी नॉन-स्टब डिवाइसों को दिखाता है.

रिटर्न

getRunName

public String getRunName ()

यह उस टेस्ट रन mRunName का नाम दिखाता है जो कलेक्टर को ट्रिगर करता है.

रिटर्न
String mRunName, मौजूदा टेस्ट रन का नाम.

getTestName

public String getTestName ()

यह उस टेस्ट mTestName का नाम दिखाता है जो कलेक्टर को ट्रिगर करता है.

रिटर्न
String mTestName, मौजूदा टेस्ट का नाम.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

मौजूदा कॉन्टेक्स्ट के साथ कलेक्टर को शुरू करना और नतीजों को कहां फ़ॉरवर्ड करना है. इसे हर इंस्टेंस के लिए सिर्फ़ एक बार कॉल किया जाएगा. साथ ही, कलेक्टर को अपने इंटरनल कॉन्टेक्स्ट और लिसनर को अपडेट करना होगा. टेस्ट रन के दौरान, Init को कभी भी कॉल नहीं किया जाएगा.

जब तक आपको यह न पता हो कि क्या करना है, तब तक इस विकल्प को न चुनें.

पैरामीटर
context IInvocationContext: चालू इनवोकेशन के लिए IInvocationContext.

listener ITestInvocationListener: ITestInvocationListener जहां नतीजे दिखाने हैं.

रिटर्न
ITestInvocationListener नए लिसनर को ओरिजनल लिसनर के साथ रैप किया गया है.

थ्रो
DeviceNotAvailableException

invocationEnded

public final void invocationEnded (long elapsedTime)

यह बताता है कि इनवॉकेशन खत्म हो गया है. ऐसा किसी गड़बड़ी की वजह से हुआ है या यह प्रोसेस पूरी हो गई है.

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

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

invocationFailed

public final void invocationFailed (FailureDescription failure)

किसी गड़बड़ी की वजह से, यह कुकी इनवोकेशन पूरा न होने की सूचना देती है.

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

पैरामीटर
failure FailureDescription: FailureDescription में, अनुरोध पूरा न होने की वजह बताई जाती है

invocationFailed

public final void invocationFailed (Throwable cause)

किसी गड़बड़ी की वजह से, यह कुकी इनवोकेशन पूरा न होने की सूचना देती है.

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

पैरामीटर
cause Throwable: Throwable की वजह से टेस्ट पूरा नहीं हो सका

invocationSkipped

public void invocationSkipped (SkipReason reason)

इस कुकी का इस्तेमाल, किसी इनवॉकेशन को 'अभी नहीं' के तौर पर रिपोर्ट करने के लिए किया जाता है

पैरामीटर
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

फ़ॉरवर्ड करने के लिए इनवोकेशन लिसनर

पैरामीटर
context IInvocationContext: शुरू करने के बारे में जानकारी

isDisabled

public final boolean isDisabled ()

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

रिटर्न
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver की सुविधा बंद है या नहीं.

रिटर्न
boolean अगर सुविधा बंद है, तो true दिखाता है. अगर सुविधा चालू है, तो false दिखाता है.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें. यह सिर्फ़ फ़ॉरवर्ड करने की सुविधा है.

पैरामीटर
dataName String: डेटा का नाम

logFile LogFile: वह LogFile जिसे पहले लॉग किया गया था और जिसे टेस्ट केस से जोड़ा जाना चाहिए.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

जब कोई टेस्ट केस, अनुमान के सही न होने की वजह से पूरा नहीं हो पाता, तब कॉलबैक किया जाता है.

पैरामीटर
testData DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है.

test TestDescription: इससे, टेस्ट केस की TestDescription का पता चलता है.

थ्रो
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

टेस्ट केस खत्म होने पर कॉलबैक. यह समय, डेटा को साफ़ करने का होना चाहिए.

पैरामीटर
testData DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है. यह onTestStart(com.android.tradefed.device.metric.DeviceMetricData) के दौरान इस्तेमाल किए गए ऑब्जेक्ट जैसा ही होगा.

currentTestCaseMetrics : ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) को पास की गई मेट्रिक का मौजूदा मैप.

test TestDescription: इससे, टेस्ट केस की TestDescription का पता चलता है.

थ्रो
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

टेस्ट केस खत्म होने पर कॉलबैक. यह समय, डेटा को साफ़ करने का होना चाहिए.

पैरामीटर
testData DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है. यह onTestStart(com.android.tradefed.device.metric.DeviceMetricData) के दौरान इस्तेमाल किए गए ऑब्जेक्ट जैसा ही होगा.

currentTestCaseMetrics : ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) को पास की गई मेट्रिक का मौजूदा मैप.

थ्रो
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

टेस्ट केस फ़ेल होने पर कॉलबैक.

पैरामीटर
testData DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है.

test TestDescription: इससे, टेस्ट केस की TestDescription का पता चलता है.

थ्रो
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

इस कुकी का इस्तेमाल, मॉड्यूल के खत्म होने से जुड़े इवेंट को कैप्चर करने के लिए किया जाता है.

थ्रो
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

इस कुकी की मदद से, मॉड्यूल शुरू होने वाले इवेंट को कैप्चर किया जा सकता है.

थ्रो
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

टेस्ट रन खत्म होने पर कॉलबैक. यह समय, डेटा को साफ़ करने का होना चाहिए.

पैरामीटर
runData DeviceMetricData: वह DeviceMetricData जिसमें रन का डेटा मौजूद है. यह onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) के दौरान इस्तेमाल किए गए ऑब्जेक्ट जैसा ही होगा.

currentRunMetrics : ERROR(/#testRunEnded(long,Map)) को पास की गई मेट्रिक का मौजूदा मैप.

थ्रो
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

testRunFailed इवेंट के लिए कॉलबैक

थ्रो
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

टेस्ट रन शुरू होने पर कॉलबैक.

पैरामीटर
runData DeviceMetricData: वह DeviceMetricData जिसमें रन का डेटा मौजूद है.

थ्रो
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

टेस्ट केस शुरू होने पर कॉलबैक.

पैरामीटर
testData DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है.

थ्रो
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

डिवाइस में रीबूट की प्रोसेस पूरी होने पर सूचना मिलती है.

ध्यान दें: इस कॉलबैक के दौरान, रिसीवर को रीबूट नहीं करना चाहिए. रीबूट करने की किसी भी कोशिश को अनदेखा कर दिया जाएगा.

पैरामीटर
device ITestDevice: ITestDevice जहां रीबूट खत्म हुआ.

थ्रो
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

इस कुकी से सूचना मिलती है कि डिवाइस में रीबूट की प्रोसेस शुरू हो गई है.

ध्यान दें: इस कॉलबैक के दौरान, रिसीवर को रीबूट नहीं करना चाहिए. रीबूट करने की किसी भी कोशिश को अनदेखा कर दिया जाएगा.

पैरामीटर
device ITestDevice: ITestDevice जहां से रीबूट शुरू हुआ.

थ्रो
DeviceNotAvailableException

setDisable

public final void setDisable (boolean isDisabled)

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

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

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

इससे यह सेट होता है कि IDeviceActionReceiver को बंद करना है या नहीं. इस सुविधा को बंद करने का मतलब है कि डिवाइस पर की गई कार्रवाई से जुड़े इवेंट पाने के लिए, डिवाइस रजिस्टर नहीं किया जाएगा.

पैरामीटर
isDisabled boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें. यह सिर्फ़ फ़ॉरवर्ड करने की सुविधा है.

पैरामीटर
logSaver ILogSaver: ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

trace String: गड़बड़ी का स्टैक ट्रेस

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

failure FailureDescription: FailureDescription में गड़बड़ी और उसके कॉन्टेक्स्ट के बारे में बताया गया हो.

testEnded

public final 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 final void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testMetrics : भेजी गई मेट्रिक का ERROR(/Map)

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

failure FailureDescription: FailureDescription में गड़बड़ी और उसके कॉन्टेक्स्ट के बारे में बताया गया हो.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String: गड़बड़ी का स्टैक ट्रेस

testIgnored

public final void testIgnored (TestDescription test)

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

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

testLog

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

यह टेस्ट शुरू करने से जुड़ा लॉग या डीबग डेटा उपलब्ध कराता है.

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

TradeFederation फ़्रेमवर्क इस तरीके को अपने-आप कॉल करेगा. इससे होस्ट लॉग और अगर लागू हो, तो डिवाइस लॉगकैट उपलब्ध होगा.

पैरामीटर
dataName String: डेटा का String जानकारी देने वाला नाम. उदाहरण के लिए, "device_logcat". ध्यान दें ऐसा हो सकता है कि हर इनवोकेशन के लिए dataName यूनीक न हो. इसका मतलब है कि लागू करने वालों को एक ही dataName के साथ कई कॉल मैनेज करने में सक्षम होना चाहिए

dataType LogDataType: डेटा का LogDataType

dataStream InputStreamSource: डेटा का InputStreamSource. डेटा को पढ़ना शुरू करने के लिए, लागू करने वालों को createInputStream को कॉल करना चाहिए. साथ ही, यह पक्का करना चाहिए कि पूरा होने पर, InputStream को बंद कर दिया गया हो. कॉल करने वालों को यह पक्का करना चाहिए कि डेटा का सोर्स, testLog तरीके के पूरा होने तक मौजूद रहे और उसे ऐक्सेस किया जा सके.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें. यह सिर्फ़ फ़ॉरवर्ड करने की सुविधा है.

पैरामीटर
dataName String: डेटा का String जानकारी देने वाला नाम. उदाहरण के लिए, "device_logcat". ध्यान दें ऐसा हो सकता है कि हर इनवोकेशन के लिए dataName यूनीक न हो. इसका मतलब है कि लागू करने वालों को एक ही dataName के साथ कई कॉल मैनेज करने होंगे

dataType LogDataType: डेटा का LogDataType

dataStream InputStreamSource: डेटा का InputStreamSource. डेटा को पढ़ना शुरू करने के लिए, लागू करने वालों को createInputStream को कॉल करना चाहिए. साथ ही, यह पक्का करना चाहिए कि पूरा होने पर, InputStream को बंद कर दिया गया हो.

logFile LogFile: LogFile में सेव की गई फ़ाइल का मेटा डेटा होता है.

testModuleEnded

public final void testModuleEnded ()

यह कुकी, मॉड्यूल के रन के खत्म होने की जानकारी देती है.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

यह कुकी, टेस्ट रन के खत्म होने की जानकारी देती है.

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

runMetrics : टेस्ट रन के आखिर में रिपोर्ट किए गए की-वैल्यू पेयर

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

यह कुकी, टेस्ट रन की शुरुआत की रिपोर्ट करती है.

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

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

कॉलबैक की जांच करना

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

यह कुकी, टेस्ट रन की शुरुआत की रिपोर्ट करती है.

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

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

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

startTime long: यह रन शुरू होने का समय है. इसे System.currentTimeMillis() के ज़रिए मेज़र किया जाता है

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason: SkipReason

testStarted

public final 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 final void testStarted (TestDescription test)

टेस्ट केस कॉलबैक

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