RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

यह Android टेस्ट कमांड को रिमोट से चलाता है और नतीजों की रिपोर्ट करता है.

खास जानकारी

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

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

वैकल्पिक कंस्ट्रक्टर.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

वैकल्पिक कंस्ट्रक्टर.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

यह रिमोट Android टेस्ट रनर बनाता है.

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

void addBooleanArg(String name, boolean value)

यह इंस्ट्रुमेंटेशन कमांड में शामिल करने के लिए, बूलियन आर्ग्युमेंट जोड़ता है.

void addInstrumentationArg(String name, String value)

इंस्ट्रुमेंटेशन कमांड में शामिल करने के लिए, एक आर्ग्युमेंट जोड़ता है.

void cancel()

इस टेस्ट रन को रद्द करने का अनुरोध करता है.

IInstrumentationResultParser createParser(String runName, listeners)

उस InstrumentationResultParser को बनाएं जिसका इस्तेमाल, इंस्ट्रुमेंटेशन के आउटपुट को पार्स करने के लिए किया जाएगा.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

यह फ़ंक्शन, रनर के ज़रिए जनरेट की गई टेस्ट कवरेज का टाइप दिखाता है.

String getPackageName()

ऐप्लिकेशन के पैकेज का नाम दिखाता है.

String getRunOptions()

यह कमांड, 'am instrument' कमांड के लिए विकल्प दिखाती है.

String getRunnerName()

runnerName दिखाता है.

void removeInstrumentationArg(String name)

पहले से जोड़े गए किसी आर्ग्युमेंट को हटाता है.

void run(ITestRunListener... listeners)

इस टेस्ट रन को लागू करें.

void run( listeners)

इस टेस्ट रन को लागू करें.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

यह कुकी, टेस्ट ऐप्लिकेशन को अनइंस्टॉल करने से पहले, होस्ट में कॉपी किए जाने वाले अतिरिक्त टेस्ट आउटपुट की जगह सेट करती है.

void setClassName(String className)

इस क्लास में सिर्फ़ टेस्ट चलाने के लिए सेट करता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

void setClassNames(String[] classNames)

यह विकल्प, दी गई क्लास में सिर्फ़ टेस्ट चलाने के लिए सेट करता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

void setCoverage(boolean coverage)

यह इस टेस्ट रन के लिए, कोड कवरेज मोड सेट करता है.

void setCoverageReportLocation(String reportPath)

यह कुकी, जनरेट की गई कवरेज रिपोर्ट की जगह की जानकारी सेट करती है.

void setDebug(boolean debug)

इस टेस्ट रन के लिए, डीबग मोड सेट करता है.

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

यह विकल्प, इंस्ट्रूमेंटेशन को पूरा करने के लिए ज़्यादा से ज़्यादा समय सेट करता है.

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

यह सिर्फ़ तय किए गए टेस्ट मेथड को चलाने के लिए सेट करता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

void setRunName(String runName)

run() को ITestRunListener पर रिपोर्ट करने के लिए, कस्टम रन का नाम सेट करें

अगर यह जानकारी नहीं दी गई है, तो पैकेज के नाम का इस्तेमाल किया जाएगा

void setRunOptions(String options)

यह कुकी, am इंस्ट्रूमेंट कमांड के लिए विकल्प सेट करती है.

void setTestCollection(boolean collect)

इस टेस्ट रन को टेस्ट कलेक्शन मोड पर सेट करता है.

void setTestPackageName(String packageName)

इस फ़ंक्शन का इस्तेमाल, तय किए गए पैकेज में सभी टेस्ट चलाने के लिए किया जाता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

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

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

String getArgsCommand()

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

String getRunnerPath()

यह इंस्ट्रुमेंटेशन कॉम्पोनेंट का पूरा पाथ दिखाता है.

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

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

वैकल्पिक कंस्ट्रक्टर. डिफ़ॉल्ट इंस्ट्रुमेंटेशन रनर का इस्तेमाल करता है.

पैरामीटर
packageName String: यह Android ऐप्लिकेशन पैकेज है, जिसमें टेस्ट चलाने के लिए ज़रूरी फ़ाइलें होती हैं
remoteDevice IShellEnabledDevice: Android डिवाइस, जिस पर टेस्ट किए जाने हैं

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

वैकल्पिक कंस्ट्रक्टर. डिफ़ॉल्ट statusReporterMode का इस्तेमाल करता है.

पैरामीटर
packageName String: यह Android ऐप्लिकेशन पैकेज है, जिसमें टेस्ट चलाने के लिए ज़रूरी फ़ाइलें होती हैं
runnerName String: इंस्ट्रुमेंटेशन टेस्ट रनर को एक्ज़ीक्यूट करना है. अगर यह शून्य है, तो डिफ़ॉल्ट रनर का इस्तेमाल किया जाएगा
remoteDevice IShellEnabledDevice: Android डिवाइस, जिस पर टेस्ट किए जाने हैं

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

यह रिमोट Android टेस्ट रनर बनाता है.

पैरामीटर
packageName String: यह Android ऐप्लिकेशन पैकेज है, जिसमें टेस्ट चलाने के लिए ज़रूरी फ़ाइलें होती हैं
runnerName String: इंस्ट्रुमेंटेशन टेस्ट रनर को एक्ज़ीक्यूट करना है. अगर यह शून्य है, तो डिफ़ॉल्ट रनर का इस्तेमाल किया जाएगा
remoteDevice IShellEnabledDevice: Android डिवाइस, जिस पर टेस्ट किए जाने हैं
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: किसी इंस्ट्रुमेंट कमांड के लिए, स्टेटस रिपोर्टर मोड का इस्तेमाल किया जाना चाहिए

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

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

यह इंस्ट्रुमेंटेशन कमांड में शामिल करने के लिए, बूलियन आर्ग्युमेंट जोड़ता है.

पैरामीटर
name String: इंस्ट्रुमेंटेशन बंडल आर्ग्युमेंट का नाम
value boolean: तर्क की वैल्यू

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

इंस्ट्रुमेंटेशन कमांड में शामिल करने के लिए, एक आर्ग्युमेंट जोड़ता है.

इसे 'run' से पहले कॉल किया जाना चाहिए. अगर दिए गए नाम का कोई आर्ग्युमेंट पहले से मौजूद है, तो उसकी वैल्यू बदल दी जाएगी.

पैरामीटर
name String: इंस्ट्रुमेंटेशन बंडल आर्ग्युमेंट का नाम
value String: तर्क की वैल्यू

अभी नहीं

public void cancel ()

इस टेस्ट रन को रद्द करने का अनुरोध करता है.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

उस InstrumentationResultParser को बनाएं जिसका इस्तेमाल, इंस्ट्रुमेंटेशन के आउटपुट को पार्स करने के लिए किया जाएगा.

पैरामीटर
runName String: इस्तेमाल किए जाने वाले रन का नाम.
listeners : लिसनर को नतीजे कहां रिपोर्ट करने हैं.
रिटर्न
IInstrumentationResultParser InstrumentationResultParser का इंस्टेंस.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

रिटर्न
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

यह फ़ंक्शन, रनर के ज़रिए जनरेट की गई टेस्ट कवरेज का टाइप दिखाता है. CoverageOutput देखें.

रिटर्न
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

ऐप्लिकेशन के पैकेज का नाम दिखाता है.

रिटर्न
String

getRunOptions

public String getRunOptions ()

यह कमांड, ऐम इंस्ट्रूमेंट के लिए विकल्प दिखाती है.

रिटर्न
String

getRunnerName

public String getRunnerName ()

runnerName दिखाता है.

रिटर्न
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

पहले से जोड़े गए किसी आर्ग्युमेंट को हटाता है.

पैरामीटर
name String: हटाने के लिए इंस्ट्रुमेंटेशन बंडल के तर्क का नाम

रन

public void run (ITestRunListener... listeners)

इस टेस्ट रन को लागू करें.

ERROR(/#run(Collection)) के लिए सुविधा वाला तरीका.

पैरामीटर
listeners ITestRunListener: जांच के नतीजों के बारे में सुनता है
थ्रो
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

रन

public void run ( listeners)

इस टेस्ट रन को लागू करें.

पैरामीटर
listeners : जांच के नतीजों के लिए, लिसनर का कलेक्शन
थ्रो
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

यह कुकी, टेस्ट ऐप्लिकेशन को अनइंस्टॉल करने से पहले, होस्ट में कॉपी किए जाने वाले अतिरिक्त टेस्ट आउटपुट की जगह सेट करती है. उदाहरण के लिए, जनरेट की गई बेंचमार्क रिपोर्ट.

पैरामीटर
additionalTestDataPath String

setClassName

public void setClassName (String className)

इस क्लास में सिर्फ़ टेस्ट चलाने के लिए सेट करता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

पैरामीटर
className String: पूरी तरह क्वालिफ़ाइड क्लास का नाम (जैसे, x.y.z)

setClassNames

public void setClassNames (String[] classNames)

यह विकल्प, दी गई क्लास में सिर्फ़ टेस्ट चलाने के लिए सेट करता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

एक से ज़्यादा क्लास देने पर, InstrumentationTestRunner की ज़रूरत होती है. यह कई क्लास वाले आर्ग्युमेंट के सिंटैक्स के साथ काम करता है.

पैरामीटर
classNames String: पूरी तरह क्वालिफ़ाइड क्लास के नामों की ऐरे (जैसे, x.y.z)

setCoverage

public void setCoverage (boolean coverage)

यह इस टेस्ट रन के लिए, कोड कवरेज मोड सेट करता है.

पैरामीटर
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

यह कुकी, जनरेट की गई कवरेज रिपोर्ट की जगह की जानकारी सेट करती है.

पैरामीटर
reportPath String

setDebug

public void setDebug (boolean debug)

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

पैरामीटर
debug boolean

setLogOnly

public void setLogOnly (boolean logOnly)

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

पैरामीटर
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

इससे, टेस्ट के रुक जाने और कभी पूरा न होने की स्थिति में टाइम आउट सेट किया जा सकता है. यह कनेक्शन के सामान्य टाइम आउट से अलग होता है.

डिफ़ॉल्ट रूप से, कोई टाइमआउट तय नहीं किया जाएगा.

पैरामीटर
maxTimeToOutputResponse long: यह वह ज़्यादा से ज़्यादा समय है जब कमांड को कोई जवाब नहीं देना होता. 0 वैल्यू का मतलब है कि यह तरीका, कमांड के आउटपुट के लिए हमेशा इंतज़ार करेगा. यह तब तक इंतज़ार करेगा, जब तक receiver एक्ज़ीक्यूशन रद्द नहीं कर देता. साथ ही, यह कभी भी थ्रो नहीं करेगा.
maxTimeUnits TimeUnit: शून्य से ज़्यादा maxTimeToOutputResponse और maxTimeout की वैल्यू के लिए इकाइयां.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

यह विकल्प, इंस्ट्रूमेंटेशन को पूरा करने के लिए ज़्यादा से ज़्यादा समय सेट करता है.

इससे, टेस्ट के रुक जाने और कभी पूरा न होने की स्थिति में टाइम आउट सेट किया जा सकता है. यह कनेक्शन के सामान्य टाइम आउट से अलग होता है.

डिफ़ॉल्ट रूप से, कोई टाइमआउट तय नहीं किया जाएगा.

पैरामीटर
maxTimeout long: यह वह ज़्यादा से ज़्यादा समय है जब कमांड को कोई जवाब नहीं देने की अनुमति होती है. 0 वैल्यू का मतलब है कि यह तरीका, कमांड के आउटपुट के लिए हमेशा इंतज़ार करेगा. यह तब तक इंतज़ार करेगा, जब तक receiver एक्ज़ीक्यूशन रद्द नहीं कर देता. साथ ही, यह कभी भी थ्रो नहीं करेगा.
maxTimeUnits TimeUnit: शून्य से ज़्यादा maxTimeToOutputResponse और maxTimeout की वैल्यू के लिए इकाइयां.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

पैरामीटर
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

यह सिर्फ़ तय किए गए टेस्ट मेथड को चलाने के लिए सेट करता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

पैरामीटर
className String: पूरी तरह क्वालिफ़ाइड क्लास का नाम (जैसे, x.y.z)
testName String: तरीके का नाम

setRunName

public void setRunName (String runName)

run() को ITestRunListener पर रिपोर्ट करने के लिए, कस्टम रन का नाम सेट करें

अगर यह जानकारी नहीं दी गई है, तो पैकेज के नाम का इस्तेमाल किया जाएगा

setRunOptions

public void setRunOptions (String options)

यह कुकी, am इंस्ट्रूमेंट कमांड के लिए विकल्प सेट करती है. विकल्पों की पूरी सूची के लिए, com/android/commands/am/Am.java देखें.

पैरामीटर
options String

setTestCollection

public void setTestCollection (boolean collect)

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

पैरामीटर
collect boolean

setTestPackageName

public void setTestPackageName (String packageName)

इस फ़ंक्शन का इस्तेमाल, तय किए गए पैकेज में सभी टेस्ट चलाने के लिए किया जाता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

पैरामीटर
packageName String: पूरी तरह से क्वालिफ़ाइड पैकेज का नाम (जैसे, x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

इस कुकी का इस्तेमाल, दिए गए साइज़ के सिर्फ़ टेस्ट चलाने के लिए किया जाता है. इसे 'run' से पहले कॉल किया जाना चाहिए.

पैरामीटर
size IRemoteAndroidTestRunner.TestSize: TestSize को चलाने के लिए.

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

getArgsCommand

protected String getArgsCommand ()

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

रिटर्न
String

getRunnerPath

protected String getRunnerPath ()

यह इंस्ट्रुमेंटेशन कॉम्पोनेंट का पूरा पाथ दिखाता है.

रिटर्न
String