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 के उस वर्शन को दिखाती है जिसका इस्तेमाल किया जा रहा है.

List<ITargetPreparer> getLabPreparersToRun(IConfiguration config, String deviceName)

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

List<ITargetPreparer> 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, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> 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: यह टेस्ट के दौरान जनरेट हुआ ओरिजनल अपवाद है.
थ्रो
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
थ्रो
Throwable

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 List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

पैरामीटर
config IConfiguration

deviceName String

रिटर्न
List<ITargetPreparer>

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

पैरामीटर
config IConfiguration

deviceName String

रिटर्न
List<ITargetPreparer>

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, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

पैरामीटर
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun List

trackPreparersMap Map

रिटर्न
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

पैरामीटर
info IBuildInfo

config IConfiguration