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, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector AtraceCollector एक IMetricCollector जो किसी टेस्ट के दौरान atrace चलाता है और नतीजे इकट्ठा करता है और उन्हें कॉल करने के लिए लॉग करता है.  BugreportzOnFailureCollector टेस्ट केस पूरा न होने पर, बग रिपोर्ट इकट्ठा करें.  BugreportzOnTestCaseFailureCollector जब किसी टेस्ट केस को चलाने में गड़बड़ी होती है, तो बग रिपोर्ट इकट्ठा करें.  ClangCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Clang के कवरेज मेज़रमेंट को खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Java और नेटिव कवरेज मेज़रमेंट खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CountTestCasesCollector किसी दिए गए IRemoteTest के लिए, टेस्ट केस की संख्या की गिनती करें और उसकी रिपोर्ट बनाएं.  DebugHostLogOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर होस्ट-साइड लॉग इकट्ठा और लॉग करेगा.  DeviceTraceCollector यह एक कलेक्टर है, जो टेस्ट रन शुरू होने पर, perfetto ट्रेस शुरू करेगा और आखिर में ट्रेस फ़ाइल को लॉग करेगा.  FilePullerDeviceMetricCollector एक BaseDeviceMetricCollector जो डिवाइस से आने वाली मेट्रिक कुंजी को सुनता है और उन्हें डिवाइस से फ़ाइल के तौर पर खींचता है.  GcovCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से कवरेज मेज़रमेंट को खींचकर, उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  GcovKernelCodeCoverageCollector एक BaseDeviceMetricCollector, जो gcov kernel coverage के मेज़रमेंट को debugfs और डिवाइस से बाहर खींचेगा और फिर उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  HostStatsdMetricCollector एक IMetricCollector, जो statsd की सुविधा वाले कमांड का इस्तेमाल करके, होस्ट साइड से statsd मेट्रिक इकट्ठा करता है.  JavaCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Java कवरेज मेज़रमेंट खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  LogcatOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर logcat को कैप्चर और लॉग करेगा.  LogcatTimingMetricCollector यह एक मेट्रिक कलेक्टर है, जो एक या एक से ज़्यादा बार किए गए टेस्ट के दौरान, logcat से समय की जानकारी इकट्ठा करता है.उदाहरण के लिए, उपयोगकर्ता के स्विच करने में लगने वाला समय. इसके लिए, यह logcat लाइनों से किसी इवेंट के शुरू और खत्म होने के सिग्नल को पार्स करने के लिए, दिए गए रेगुलर एक्सप्रेशन पैटर्न का इस्तेमाल करता है.  RebootReasonCollector यह एक कलेक्टर है, जो टेस्ट रन के दौरान डिवाइस के रीबूट होने की जानकारी इकट्ठा करता है. साथ ही, इसकी वजह और संख्या के हिसाब से रिपोर्ट करता है.  RuntimeRestartCollector यह एक कलेक्टर है, जो टेस्ट के दौरान रनटाइम रीस्टार्ट (सिस्टम सर्वर क्रैश) के टाइमस्टैंप इकट्ठा करता है.  ScreenshotOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर स्क्रीनशॉट कैप्चर करके उसे लॉग करेगा.

ऐसे सबक्लास जिनके बारे में पहले से पता है AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector AtraceRunMetricCollector यह टूल, टेस्ट डिवाइस पर दी गई डायरेक्ट्री में मौजूद सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करता है. साथ ही, टेस्ट डायरेक्ट्री को लॉग करता है और टेस्ट डायरेक्ट्री में मौजूद ट्रेस फ़ाइलों को पोस्ट प्रोसेस करता है. इसके बाद, मेट्रिक इकट्ठा करता है.  BluetoothConnectionLatencyCollector कलेक्टर, डिवाइसों पर पहले से तय की गई statsd अवधि मेट्रिक कॉन्फ़िगरेशन को पुश करेगा और हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि इकट्ठा करेगा.  BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा और हर प्रोफ़ाइल के लिए कनेक्शन की स्थिति का नंबर रिकॉर्ड करेगा.  BluetoothHciSnoopLogCollector डीयूटी पर ब्लूटूथ HCI स्नूप लॉगिंग की सुविधा चालू करने और हर टेस्ट के लिए लॉग इकट्ठा करने वाला कलेक्टर.  FilePullerLogCollector डिवाइस की ओर से रिपोर्ट की गई फ़ाइल का लॉगर.  ModuleLogcatCollector मॉड्यूल के लिए, logcat कलेक्टर का वर्शन.  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से Perfetto फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से शोमैप फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  TraceCmdCollector ऐसा IMetricCollector जो trace-cmd का इस्तेमाल करके, टेस्ट के दौरान ट्रेस इकट्ठा करता है और उन्हें कॉल करने के लिए लॉग करता है.

---

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

खास जानकारी

फ़ील्ड्स की फ़िल्में
public static final String	TEST_CASE_EXCLUDE_GROUP_OPTION
public static final 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 का नाम दिखाता है.
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_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

सार्वजनिक कंस्ट्रक्टर

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, मौजूदा टेस्ट रन का नाम.

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	बंद होने पर 'सही' दिखाता है और बंद न होने पर 'गलत' दिखाता है.

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)

मेट्रिक कलेक्टर को लागू करने के लिए, inside का इस्तेमाल न करें. यह सिर्फ़ फ़ॉरवर्ड करना है.

पैरामीटर
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() से जुड़ा है और क्रम में शामिल करना ज़रूरी नहीं है. इसका इस्तेमाल सिर्फ़ उस रन के दौरान किया जाता है जिसमें मॉड्यूल का इस्तेमाल किया जाता है: suite based runners.

पैरामीटर
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: फ़िलहाल इस्तेमाल नहीं किया जा रहा है, इसे हटाने पर विचार करें

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