InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
   ↳ com.android.tradefed.invoker.InvocationExecution

यह क्लास, इनवॉकेशन के सभी चरणों के बारे में बताती है: बिल्ड डाउनलोड, target_prep, रन टेस्ट, क्लीन अप. इसका इस्तेमाल, कुछ चरणों के डिफ़ॉल्ट व्यवहार को बदलने के लिए किया जा सकता है. चरणों का क्रम TestInvocation के हिसाब से तय होता है.

खास जानकारी

कॉन्स्टेंट

String ADB_VERSION_KEY

String JAVA_CLASSPATH_KEY

String JAVA_VERSION_KEY

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

InvocationExecution()

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

void cleanUpBuilds(IInvocationContext context, IConfiguration config)

build_provider क्लीन अप चरण को पूरा करें.

void doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)

target_preparer और multi_target_preparer के cleanUp चरण को लागू करें.

void doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)

target_preparer और multi_target_preparer के setUp चरण को लागू करें.

void doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

target_preparer और multi_target_preparer को हटाने का चरण पूरा करें.

boolean fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

इनवॉकेशन के build_provider चरण को पूरा करें.

void reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)

डिवाइस के कुछ लॉग को अलग-अलग स्टेज पर रिपोर्ट करें.

void runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)

इनवॉकेशन में शामिल हर डिवाइस के लिए, ITestDevice.postInvocationTearDown(Throwable) को कॉल करें.

void runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)

इनवॉकेशन में शामिल हर डिवाइस के लिए, ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) को कॉल करें.

void runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)

इस कुकी का इस्तेमाल टेस्ट चलाने के लिए किया जाता है.

boolean shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

कॉन्फ़िगरेशन को सब-कॉन्फ़िगरेशन में बांटने की कोशिश करें, ताकि उन्हें एक साथ कई संसाधनों पर चलाने के लिए फिर से शेड्यूल किया जा सके.

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

void collectAutoInfo(IConfiguration config, TestInformation info)

टेस्ट किए जा रहे मुख्य डिवाइस पर कुछ जानकारी अपने-आप इकट्ठा करता है.

IShardHelper createShardHelper()

इस्तेमाल किए जाने वाले IShardHelper को बनाएं और उसे दिखाएं.

void customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)

preInvocationSetup से पहले, डिवाइस के कुछ हिस्सों को पसंद के मुताबिक बनाने का विकल्प दें.

String getAdbVersion()

यह कमांड, adb के उस वर्शन को दिखाती है जिसका इस्तेमाल किया जा रहा है.

getLabPreparersToRun(IConfiguration config, String deviceName)

इस डिवाइस पर चलाने के लिए, लैब तैयार करने वालों की सूची पाएं.

getTargetPreparersToRun(IConfiguration config, String deviceName)

इस डिवाइस पर चलाने के लिए, टारगेट प्रिपेयरर की सूची वापस पाएं.

void linkExternalDirs(IBuildInfo info, TestInformation testInfo)
void logHostAdb(IConfiguration config, ITestLogger logger)

$TMPDIR/adb.$UID.log से लॉग इकट्ठा करें.

Throwable runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)
void setTestTag(IBuildInfo info, IConfiguration config)

यह कुकी, बिल्ड की जानकारी पर टेस्ट टैग सेट करने की प्रोसेस को मैनेज करती है.

कॉन्स्टेंट

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

स्थिर वैल्यू: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

स्थिर वैल्यू: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

स्थिर वैल्यू: "java_version"

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

InvocationExecution

public InvocationExecution ()

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

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

build_provider के क्लीन अप चरण को पूरा करें. यह कुकी, बिल्ड फ़ेच करने से जुड़ी है.

पैरामीटर
context IInvocationContext: शुरू करने का IInvocationContext.
config IConfiguration: इस टेस्ट रन का IConfiguration.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

target_preparer और multi_target_preparer के cleanUp चरण को लागू करें. क्या डिवाइसों का स्टोरेज खाली हो जाता है.

पैरामीटर
context IInvocationContext: शुरू करने का IInvocationContext.
config IConfiguration: इस टेस्ट रन का IConfiguration.
exception Throwable: यह टेस्ट रन करने के दौरान जनरेट हुआ ओरिजनल अपवाद है.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

target_preparer और multi_target_preparer के setUp चरण को लागू करें. क्या सभी डिवाइसों को टेस्ट चलाने के लिए सेट अप किया गया है.

पैरामीटर
testInfo TestInformation: शुरू करने का TestInformation.
config IConfiguration: इस टेस्ट रन का IConfiguration.
listener ITestLogger: सेटअप से जुड़ी गड़बड़ियों के लॉग की रिपोर्ट करने के लिए ITestLogger.
थ्रो
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

target_preparer और multi_target_preparer को हटाने का चरण पूरा करें. क्या डिवाइस सेटअप से जुड़े सभी कॉम्पोनेंट को अलग कर दिया गया है.

पैरामीटर
testInfo TestInformation: शुरू करने का TestInformation.
config IConfiguration: इस टेस्ट रन का IConfiguration.
logger ITestLogger: लॉग की जानकारी देने के लिए ITestLogger.
exception Throwable: यह टेस्ट रन करने के दौरान जनरेट हुआ ओरिजनल अपवाद है.

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

इनवॉकेशन के build_provider चरण को पूरा करें.

पैरामीटर
testInfo TestInformation: शुरू करने का TestInformation.
config IConfiguration: इस टेस्ट रन का IConfiguration.
rescheduler IRescheduler: IRescheduler, ताकि किसी अन्य संसाधन पर लागू करने के लिए, अनुरोध के कुछ हिस्सों को फिर से शेड्यूल किया जा सके
listener ITestInvocationListener: ITestInvocation का इस्तेमाल करके, बिल्ड डाउनलोड न हो पाने की समस्या की शिकायत करें.
रिटर्न
boolean अगर हमने बिल्ड को डाउनलोड कर लिया है, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी.
थ्रो
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

डिवाइस के कुछ लॉग को अलग-अलग स्टेज पर रिपोर्ट करें. उदाहरण के लिए: logcat.

पैरामीटर
device ITestDevice: वह डिवाइस जिससे लॉग की रिपोर्ट करनी है.
listener ITestLogger: लॉग के लिए लॉगर.
stage TestInvocation.Stage: हम जिस स्टेज पर हैं उस स्टेज का इनवोकेशन.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

इनवॉकेशन में शामिल हर डिवाइस के लिए, ITestDevice.postInvocationTearDown(Throwable) को कॉल करें.

पैरामीटर
context IInvocationContext: शुरू करने का IInvocationContext.
config IConfiguration: इस टेस्ट रन का IConfiguration.
exception Throwable: अगर कोई टेस्ट चल रहा है, तो उससे जनरेट हुआ ओरिजनल अपवाद.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

इनवॉकेशन में शामिल हर डिवाइस के लिए, ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) को कॉल करें.

पैरामीटर
context IInvocationContext: शुरू करने का IInvocationContext.
config IConfiguration: इस टेस्ट रन का IConfiguration.
logger ITestLogger: लॉग की जानकारी देने के लिए ITestLogger.
थ्रो
DeviceNotAvailableException
TargetSetupError

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

इस कुकी का इस्तेमाल टेस्ट चलाने के लिए किया जाता है.

पैरामीटर
info TestInformation: TestInformation का इस्तेमाल करके टेस्ट चलाएं.
config IConfiguration: IConfiguration को चलाने के लिए
listener ITestInvocationListener: जांच के नतीजों का ITestInvocationListener

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

कॉन्फ़िगरेशन को सब-कॉन्फ़िगरेशन में बांटने की कोशिश करें, ताकि उन्हें एक साथ कई संसाधनों पर चलाने के लिए फिर से शेड्यूल किया जा सके.

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

पैरामीटर
config IConfiguration: मौजूदा IConfiguration.
testInfo TestInformation: TestInformation में टेस्ट की जानकारी होती है.
rescheduler IRescheduler: the IRescheduler.
logger ITestLogger: शार्डिंग के दौरान, लॉग फ़ाइल के लिए इस्तेमाल किया गया ITestLogger.
रिटर्न
boolean अगर टेस्ट को शार्ड किया गया था, तो यह वैल्यू true होती है. अन्यथा, false दिखाता है

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

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

टेस्ट किए जा रहे मुख्य डिवाइस पर कुछ जानकारी अपने-आप इकट्ठा करता है.

पैरामीटर
config IConfiguration

info TestInformation

थ्रो
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

इस्तेमाल किए जाने वाले IShardHelper को बनाएं और उसे दिखाएं.

रिटर्न
IShardHelper

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

preInvocationSetup से पहले, डिवाइस के कुछ हिस्सों को पसंद के मुताबिक बनाने का विकल्प दें.

पैरामीटर
config IConfiguration: इनवोकेशन का कॉन्फ़िगरेशन.
context IInvocationContext: मौजूदा इनवोकेशन कॉन्टेक्स्ट.

getAdbVersion

protected String getAdbVersion ()

यह कमांड, adb के उस वर्शन को दिखाती है जिसका इस्तेमाल किया जा रहा है.

रिटर्न
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

इस डिवाइस पर चलाने के लिए, लैब तैयार करने वालों की सूची पाएं.

सैंडबॉक्स क्लास में इस फ़ंक्शन को बदला जाता है, ताकि लैब तैयार करने वालों को सैंडबॉक्स चाइल्ड में चलाने से रोका जा सके

पैरामीटर
config IConfiguration

deviceName String

रिटर्न

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

इस डिवाइस पर चलाने के लिए, टारगेट प्रिपेयरर की सूची वापस पाएं.

सैंडबॉक्स क्लास में इस फ़ंक्शन को बदला जाता है, ताकि लैब तैयार करने वालों को सैंडबॉक्स चाइल्ड में चलाने से रोका जा सके

पैरामीटर
config IConfiguration

deviceName String

रिटर्न

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

पैरामीटर
info IBuildInfo

testInfo TestInformation

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

$TMPDIR/adb.$UID.log से लॉग इकट्ठा करें.

पैरामीटर
config IConfiguration

logger ITestLogger

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

पैरामीटर
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

trackPreparersMap

रिटर्न
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

यह कुकी, बिल्ड की जानकारी पर टेस्ट टैग सेट करने की प्रोसेस को मैनेज करती है.

पैरामीटर
info IBuildInfo

config IConfiguration