InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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

पहचाने गए डायरेक्ट सबक्लास DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution DelegatedInvocationExecution InvocationExecution, जो किसी अन्य Tradefed बाइनरी को एक्सीक्यूशन का काम सौंपते हैं.  ParentSandboxInvocationExecution सैंडबॉक्स चलाते समय, पैरंट को कॉल करने की खास कार्रवाइयों के लिए InvocationExecution का वर्शन.  RemoteInvocationExecution InvocationExecution को लागू करना, जो रिमोट से प्रोसेस को चलाता है.  SandboxedInvocationExecution सैंडबॉक्स में निर्देश चलाने का खास तरीका: यह InvocationExection तब होता है, जब हम सैंडबॉक्स में कमांड चला रहे हों.

---

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

खास जानकारी

फ़ील्ड्स की फ़िल्में
public static final String	ADB_VERSION_KEY
public static final String	JAVA_CLASSPATH_KEY
public static final 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 के क्लीनअप चरण को लागू करें.
void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener) target_preparer और multi_target_preparer सेटअप चरण को लागू करें.
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 वर्शन की जानकारी दिखाता है जिसका इस्तेमाल, ADB को शुरू करने के लिए किया जा रहा है.
	getLabPreparersToRun(IConfiguration config, String deviceName) इस डिवाइस पर चलाने के लिए, Labs में तैयार किए गए ऐप्लिकेशन की सूची पाएं.
	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

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

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

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 के क्लीनअप चरण को लागू करें. क्या डिवाइसों का स्टोरेज खाली हो गया है.

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

doSetup

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

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

पैरामीटर
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	अगर बिल्ड डाउनलोड हो जाता है, तो यह वैल्यू 'सही' दिखती है. अगर बिल्ड डाउनलोड नहीं हो पाता है, तो यह वैल्यू 'गलत' दिखती है.

थ्रो
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)

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

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

पैरामीटर
config	IConfiguration: मौजूदा IConfiguration.
testInfo	TestInformation: TestInformation, जिसमें जांच की जानकारी हो.
rescheduler	IRescheduler: IRescheduler.
logger	ITestLogger: ITestLogger का इस्तेमाल, sharding के दौरान फ़ाइल को लॉग करने के लिए किया जाता है.

रिटर्न
boolean	अगर टेस्ट को अलग-अलग हिस्सों में बांटा गया था, तो यह वैल्यू 'सही' होगी. अगर ऐसा नहीं है, तो 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 वर्शन की जानकारी दिखाता है जिसका इस्तेमाल, ADB को शुरू करने के लिए किया जा रहा है.

रिटर्न
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

इस डिवाइस पर चलाने के लिए, Labs में तैयार किए गए ऐप्लिकेशन की सूची पाएं.

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

पैरामीटर
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