BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

इस क्लास से सीधे इनहेरिट करने वाली ज्ञात सबक्लास AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, ModulePerfettoCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenRecordOnFailureCollector, ScreenshotOnFailureCollector AtraceCollector एक IMetricCollector, जो टेस्ट के दौरान atrace चलाता है. साथ ही, नतीजे इकट्ठा करता है और उन्हें इनवोकेशन में लॉग करता है.  BugreportzOnFailureCollector टेस्ट केस फ़ेल होने पर, bugreportz इकट्ठा करता है.  BugreportzOnTestCaseFailureCollector किसी रन में टेस्ट केस के फ़ेल होने पर, bugreportz इकट्ठा करता है.  ClangCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Clang कवरेज मेज़रमेंट को पुल करेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CodeCoverageCollector एक BaseDeviceMetricCollector जो डिवाइस से Java और नेटिव कवरेज मेज़रमेंट को पुल करेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CountTestCasesCollector किसी दिए गए IRemoteTest के लिए, टेस्ट केस की संख्या गिनें और उसकी रिपोर्ट बनाएं.  DebugHostLogOnFailureCollector यह कलेक्टर, टेस्ट केस के फ़ेल होने पर होस्ट-साइड के लॉग इकट्ठा करेगा और उन्हें लॉग करेगा.  DeviceTraceCollector यह कलेक्टर, टेस्ट रन शुरू होने पर perfetto ट्रेस शुरू करेगा और आखिर में ट्रेस फ़ाइल को लॉग करेगा.  FilePullerDeviceMetricCollector एक BaseDeviceMetricCollector जो डिवाइस से आने वाली मेट्रिक की कुंजी को सुनता है और उन्हें डिवाइस से फ़ाइल के तौर पर खींचता है.  GcovCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से gcov कवरेज मेज़रमेंट को खींच लेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग कर देगा.  GcovKernelCodeCoverageCollector एक BaseDeviceMetricCollector जो debugfs से gcov कर्नल कवरेज मेज़रमेंट को डिवाइस से बाहर निकालता है और फिर उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करता है.  HostStatsdMetricCollector यह IMetricCollector, statsd यूटिलिटी कमांड का इस्तेमाल करके होस्ट साइड से statsd मेट्रिक इकट्ठा करता है.  JavaCodeCoverageCollector एक BaseDeviceMetricCollector जो डिवाइस से Java कवरेज मेज़रमेंट को पुल करेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  LogcatOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस या टेस्ट रन के फ़ेल होने पर, logcat को कैप्चर और लॉग करेगा.  LogcatTimingMetricCollector यह एक मेट्रिक कलेक्टर है. यह logcat से समय की जानकारी इकट्ठा करता है. जैसे, उपयोगकर्ता के स्विच करने का समय. यह जानकारी, एक या एक से ज़्यादा बार दोहराए गए टेस्ट के दौरान इकट्ठा की जाती है. इसके लिए, दिए गए regex पैटर्न का इस्तेमाल किया जाता है. इससे logcat लाइनों से किसी इवेंट के शुरू और खत्म होने के सिग्नल को पार्स किया जाता है.  ModulePerfettoCollector यह कलेक्टर, टेस्ट मॉड्यूल के शुरू और खत्म होने पर, परफ़ेक्टो ट्रेस शुरू करेगा. साथ ही, डिवाइस के रीबूट होने पर भी ऐसा करेगा.  RebootReasonCollector यह कलेक्टर, टेस्ट रन के दौरान डिवाइस के रीबूट होने की जानकारी इकट्ठा करता है. साथ ही, इसकी वजह और संख्या के हिसाब से रिपोर्ट करता है.  RuntimeRestartCollector यह कलेक्टर, टेस्ट रन के दौरान सिस्टम सर्वर क्रैश होने पर, रनटाइम रीस्टार्ट के टाइमस्टैंप इकट्ठा करता है.  ScreenRecordOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस के फ़ेल होने पर, स्क्रीन रिकॉर्डिंग को कैप्चर और लॉग करेगा.  ScreenshotOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस के फ़ेल होने पर, स्क्रीनशॉट कैप्चर और लॉग करेगा.

इस क्लास से सीधे इनहेरिट न करने वाली ज्ञात सबक्लास AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector AtraceRunMetricCollector यह कमांड, टेस्ट डिवाइस से दी गई डायरेक्ट्री के तहत सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करती है. साथ ही, टेस्ट डायरेक्ट्री को लॉग करती है और टेस्ट डायरेक्ट्री के तहत ट्रेस फ़ाइलों को प्रोसेस करती है. इसके अलावा, यह मेट्रिक को एग्रीगेट करती है.  BluetoothConnectionLatencyCollector कलेक्टर, पहले से तय की गई statsd अवधि की मेट्रिक कॉन्फ़िगरेशन को डिवाइसों पर पुश करेगा. साथ ही, हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि इकट्ठा करेगा.  BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा. साथ ही, हर प्रोफ़ाइल के लिए कनेक्शन की स्थिति का नंबर रिकॉर्ड करेगा.  BluetoothHciSnoopLogCollector कलेक्टर, DUT पर ब्लूटूथ एचसीआई स्नूप लॉगिंग को चालू करता है और हर टेस्ट के लिए लॉग इकट्ठा करता है.  FilePullerLogCollector यह डिवाइस-साइड से रिपोर्ट की गई फ़ाइल का लॉगर है.  ModuleLogcatCollector यह logcat collector का वर्शन है, लेकिन यह मॉड्यूल के लिए है.  PerfettoFilePullerCollector यह एक कलेक्टर है, जो डिवाइस से Perfect Trace फ़ाइलों को खींचता है. इसके अलावा, यह फ़ाइलों को कंप्रेस भी कर सकता है. साथ ही, उन्हें टेस्ट लॉग में जोड़ता है.  PerfettoPullerMetricCollector इस क्लास का इस्तेमाल बंद कर दिया गया है. इसके बजाय, PerfettoFilePullerCollector और ERROR(/PerfettoTracePostProcessor) का इस्तेमाल करें.  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector का बुनियादी तौर पर लागू किया गया वर्शन. इससे डिवाइस से showmap फ़ाइलें पुल की जा सकती हैं और उनसे मेट्रिक इकट्ठा की जा सकती हैं.  TraceCmdCollector यह एक IMetricCollector है, जो trace-cmd का इस्तेमाल करके टेस्ट के दौरान ट्रेस इकट्ठा करता है. साथ ही, उन्हें इनवॉकेशन में लॉग करता है.

---

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

खास जानकारी

कॉन्स्टेंट
String	TEST_CASE_EXCLUDE_GROUP_OPTION
String	TEST_CASE_INCLUDE_GROUP_OPTION

सार्वजनिक कंस्ट्रक्टर
BaseDeviceMetricCollector()

पब्लिक मेथड
boolean	doesModuleContainFailure() अगर मौजूदा मॉड्यूल में कोई टेस्ट केस या टेस्ट रन फ़ेल हुआ है, तो यह फ़ंक्शन 'सही' दिखाता है.
void	enableDefaultMetricCollection() इस कुकी की मदद से, डेटा इकट्ठा करने वाले लोग डिफ़ॉल्ट मेट्रिक कलेक्शन की सुविधा चालू कर सकते हैं.
void	extraInit(IInvocationContext context, ITestInvocationListener listener)
IMetricCollector.MetricCollectionLevel	getAlwaysOnCollectionLevel()
final List<IBuildInfo>	getBuildInfos() यह फ़ंक्शन, इनवोकेशन में उपलब्ध बिल्ड की जानकारी की सूची दिखाता है.
final List<ITestDevice>	getDevices() इस तरीके से, कॉल करने के लिए उपलब्ध डिवाइसों की सूची मिलती है.
File	getFileFromTestArtifacts(String fileName) टेस्ट आर्टफ़ैक्ट या मॉड्यूल आर्टफ़ैक्ट से फ़ाइल को वापस पाएं और उसे मैप में कैश मेमोरी में सेव करें, ताकि बाद में कॉल किया जा सके.
final ITestInvocationListener	getInvocationListener() यह कुकी, उस ओरिजनल ITestInvocationListener को वापस लाती है जहां हम नतीजे फ़ॉरवर्ड कर रहे हैं.
String	getModuleName()
IMetricCollector.MetricCollectionLevel	getOnFailureCollectionLevel()
final List<ITestDevice>	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) फ़ॉरवर्ड करने के लिए इनवोकेशन लिसनर
boolean	isDefaultMetricCollectionEnabled() क्या कलेक्टर, डिफ़ॉल्ट मेट्रिक कलेक्शन के हिस्से के तौर पर मेट्रिक इकट्ठा कर रहा है.
final boolean	isDisabled() अगर पूरा ऑब्जेक्ट बंद है, तो True दिखाता है. इससे सेटअप और टियरडाउन, दोनों को स्किप किया जा सकता है.
boolean	isDisabledReceiver() इससे पता चलता है कि IDeviceActionReceiver बंद है या नहीं.
final void	logAssociation(String dataName, LogFile logFile) इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें.
void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) जब कोई टेस्ट केस, अनुमान के सही न होने की वजह से पूरा नहीं होता है, तब कॉलबैक होता है.
void	onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics) टेस्ट केस खत्म होने पर कॉलबैक.
void	onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test) टेस्ट केस खत्म होने पर कॉलबैक.
void	onTestFail(DeviceMetricData testData, TestDescription test) टेस्ट केस फ़ेल होने पर कॉलबैक.
void	onTestModuleEnded() इस कुकी का इस्तेमाल, मॉड्यूल के खत्म होने से जुड़े इवेंट को कैप्चर करने के लिए किया जाता है.
void	onTestModuleStarted() इस कुकी की मदद से, मॉड्यूल शुरू होने वाले इवेंट को कैप्चर किया जा सकता है.
void	onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics) टेस्ट रन खत्म होने पर कॉलबैक.
void	onTestRunFailed(DeviceMetricData testData, FailureDescription failure) testRunFailed इवेंट के लिए कॉलबैक
void	onTestRunStart(DeviceMetricData runData) टेस्ट रन शुरू होने पर कॉलबैक.
void	onTestStart(DeviceMetricData testData) टेस्ट केस शुरू होने पर कॉलबैक.
void	rebootEnded(ITestDevice device) डिवाइस में रीबूट की प्रोसेस पूरी होने पर सूचना मिलती है.
void	rebootStarted(ITestDevice device) डिवाइस में रीबूट शुरू होने पर सूचना मिलती है.
void	setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level) यह उस लेवल को सेट करता है जिस पर कलेक्टर को लॉग इकट्ठा करने चाहिए. भले ही, लॉग इकट्ठा करने में कोई समस्या आ रही हो.
final void	setDisable(boolean isDisabled) इससे यह सेट किया जाता है कि ऑब्जेक्ट को बंद करना है या नहीं.
void	setDisableReceiver(boolean isDisabled) इस सेटिंग से यह तय होता है कि IDeviceActionReceiver को बंद करना है या नहीं.
final void	setLogSaver(ILogSaver logSaver) इसका इस्तेमाल मेट्रिक कलेक्टर को लागू करने के दौरान न करें.
void	setModuleContainsFailure() यह कुकी सेट करती है कि मॉड्यूल में कोई गड़बड़ी (टेस्ट केस, टेस्ट रन) हुई है या नहीं.
void	setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level) यह उस लेवल को सेट करता है जिस पर कलेक्टर को गड़बड़ियों के दौरान लॉग इकट्ठा करने चाहिए.
final void	testAssumptionFailure(TestDescription test, String trace) इस फ़ंक्शन को तब कॉल किया जाता है, जब कोई ऐटॉमिक टेस्ट यह फ़्लैग करता है कि वह ऐसी शर्त मान रहा है जो गलत है
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) इस फ़ंक्शन को तब कॉल किया जाता है, जब कोई ऐटॉमिक टेस्ट यह फ़्लैग करता है कि वह ऐसी शर्त मान रहा है जो गलत है
final void	testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) testEnded(TestDescription,Map) के बजाय, सीधे तौर पर इवेंट खत्म होने का समय बताने का विकल्प.
final void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> 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, HashMap<String, MetricMeasurement.Metric> 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(TestDescription) के बजाय, यहां हम यह भी बताते हैं कि टेस्ट कब शुरू हुआ था. साथ ही, सटीक मेज़रमेंट के लिए testEnded(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 ()

पब्लिक मेथड

doesModuleContainFailure

public boolean doesModuleContainFailure ()

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

रिटर्न
boolean

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

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

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

रिटर्न
IMetricCollector.MetricCollectionLevel

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

रिटर्न
List<IBuildInfo>

getDevices

public final List<ITestDevice> getDevices ()

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

रिटर्न
List<ITestDevice>

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

रिटर्न
ITestInvocationListener

getModuleName

public String getModuleName ()

रिटर्न
String

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

रिटर्न
IMetricCollector.MetricCollectionLevel

getRealDevices

public final List<ITestDevice> getRealDevices ()

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

रिटर्न
List<ITestDevice>

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: शुरू करने के बारे में जानकारी

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

क्या कलेक्टर, डिफ़ॉल्ट मेट्रिक कलेक्शन के हिस्से के तौर पर मेट्रिक इकट्ठा कर रहा है.

रिटर्न
boolean

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, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

पैरामीटर
testData	DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है. यह onTestStart(DeviceMetricData) के दौरान इस्तेमाल किए गए ऑब्जेक्ट जैसा ही होगा.
currentTestCaseMetrics	Map: testEnded(TestDescription,Map) को पास की गई मेट्रिक का मौजूदा मैप.

थ्रो
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

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

पैरामीटर
testData	DeviceMetricData: DeviceMetricData, जिसमें टेस्ट केस का डेटा मौजूद है. यह onTestStart(DeviceMetricData) के दौरान इस्तेमाल किए गए ऑब्जेक्ट जैसा ही होगा.
currentTestCaseMetrics	Map: testEnded(TestDescription,Map) को पास की गई मेट्रिक का मौजूदा मैप.
test	TestDescription: यह टेस्ट केस की TestDescription है.

थ्रो
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, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

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

पैरामीटर
runData	DeviceMetricData: यह DeviceMetricData है, जिसमें रन के लिए डेटा होता है. यह onTestRunStart(DeviceMetricData) के दौरान इस्तेमाल किए गए ऑब्जेक्ट जैसा ही होगा.
currentRunMetrics	Map: 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

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

यह उस लेवल को सेट करता है जिस पर कलेक्टर को लॉग इकट्ठा करने चाहिए. भले ही, लॉग इकट्ठा करने में कोई समस्या आ रही हो.

NULL लेवल पर कोई कलेक्शन नहीं होगा.

पैरामीटर
level	IMetricCollector.MetricCollectionLevel: वह MetricCollectionLevel जिस पर लॉग इकट्ठा किए जाएंगे.

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

setModuleContainsFailure

public void setModuleContainsFailure ()

यह कुकी सेट करती है कि मॉड्यूल में कोई गड़बड़ी (टेस्ट केस, टेस्ट रन) हुई है या नहीं.

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

यह उस लेवल को सेट करता है जिस पर कलेक्टर को गड़बड़ियों के दौरान लॉग इकट्ठा करने चाहिए.

NULL लेवल पर कोई कलेक्शन नहीं होगा.

पैरामीटर
level	IMetricCollector.MetricCollectionLevel: वह MetricCollectionLevel जिस पर लॉग इकट्ठा किए जाएंगे.

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है
endTime	long: टेस्ट के खत्म होने का समय, जिसे System.currentTimeMillis() के ज़रिए मेज़र किया जाता है
testMetrics	HashMap: भेजी गई मेट्रिक का Map

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

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

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है
testMetrics	HashMap: भेजी गई मेट्रिक का 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)/ITestInvocationListener#invocationFailed(java.lang.Throwable) 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

यह कुकी, टेस्ट रन के खत्म होने की जानकारी देती है. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

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

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(TestDescription) के बजाय, यहां हम यह भी बताते हैं कि टेस्ट कब शुरू हुआ था. साथ ही, सटीक मेज़रमेंट के लिए testEnded(TestDescription,long,Map) का इस्तेमाल किया जाता है.

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

testStarted

public final void testStarted (TestDescription test)

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

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