ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

इस क्लास से सीधे इनहेरिट न करने वाली ज्ञात सबक्लास GoogleTradefedSandbox, TradefedSandbox GoogleTradefedSandbox TradefedSandbox का इंटरनल स्पेशलाइज़ेशन, जिसका इस्तेमाल लैब के इन्फ़्रास्ट्रक्चर में किया जाता है.  TradefedSandbox सैंडबॉक्स कंटेनर, जो ट्रेड फ़ेडरेशन इनवोकेशन को चला सकता है.

---

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

खास जानकारी

पब्लिक मेथड
abstract String	createClasspath(File workingDir) getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) से मिले एनवायरमेंट और वर्किंग डायरेक्ट्री के आधार पर, क्लासपाथ बनाएं.
abstract IConfiguration	createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) स्पेशल मोड, मुख्य रन से डिसकनेक्ट हो गया है: जब किसी कॉन्फ़िगरेशन का पैरंट मौजूद नहीं होता है, तो हम थिन लॉन्चर पर वापस आ जाते हैं. यहां हम मौजूदा जानकारी के साथ सैंडबॉक्स को सेटअप करने की कोशिश करते हैं. साथ ही, वर्किंग डायरेक्ट्री को भरते हैं, ताकि वर्शन वाले डायरेक्ट्री में कॉन्फ़िगरेशन को पूरी तरह से बनाया जा सके.
default Map<String, List<String>>	discoverTests(IInvocationContext context, IConfiguration configuration) यह prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) का एक उप-चरण है. इससे यह पता चलता है कि SandboxOptions.shouldUseTestDiscovery() चालू है या नहीं.
default Map<String, List<String>>	discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo	fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args) prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) का सब-स्टेप, जो सैंडबॉक्स के लिए ज़रूरी अतिरिक्त फ़ाइलें फ़ेच करता है.
default File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args) यह फ़ंक्शन, सैंडबॉक्स एनवायरमेंट के TF को दिखाता है. इसका इस्तेमाल कमांड लाइन के तर्कों के आधार पर किया जाता है.
default File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
abstract Exception	prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener) सैंडबॉक्स को ठीक से चलाने के लिए एनवायरमेंट तैयार करें.
abstract CommandResult	run(TestInformation info, IConfiguration configuration, ITestLogger logger) सेट किए गए एनवायरमेंट के साथ सैंडबॉक्स चलाएं.
abstract void	tearDown() बदले गए किसी भी स्टेट, फ़ाइल या एनवायरमेंट को ठीक करें.

पब्लिक मेथड

createClasspath

public abstract String createClasspath (File workingDir)

getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) से मिले एनवायरमेंट और वर्किंग डायरेक्ट्री के आधार पर, क्लासपाथ बनाएं.

पैरामीटर
workingDir	File: सैंडबॉक्स के लिए मौजूदा वर्किंग डायरेक्ट्री.

रिटर्न
String	इस्तेमाल किया जाने वाला क्लासपाथ.

थ्रो
ConfigurationException

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

स्पेशल मोड, मुख्य रन से डिसकनेक्ट हो गया है: जब किसी कॉन्फ़िगरेशन का पैरंट मौजूद नहीं होता है, तो हम थिन लॉन्चर पर वापस आ जाते हैं. यहां हम मौजूदा जानकारी के साथ सैंडबॉक्स को सेटअप करने की कोशिश करते हैं. साथ ही, वर्किंग डायरेक्ट्री को भरते हैं, ताकि वर्शन वाले डायरेक्ट्री में कॉन्फ़िगरेशन को पूरी तरह से बनाया जा सके.

पैरामीटर
args	String: ओरिजनल कमांड लाइन आर्ग्युमेंट.
keyStoreClient	IKeyStoreClient: कॉन्फ़िगरेशन बनाने के लिए, मौजूदा कीस्टोर क्लाइंट.
runUtil	IRunUtil: होस्ट कमांड चलाने के लिए मौजूदा IRunUtil.
globalConfig	File: TF की सबप्रोसेस चलाने के लिए इस्तेमाल किया जाने वाला ग्लोबल कॉन्फ़िगरेशन.

रिटर्न
IConfiguration	NON_VERSIONED ऑब्जेक्ट के लिए, TF के कॉन्फ़िगरेशन एक्सएमएल की ओर ले जाने वाली फ़ाइल. अगर थिन लॉन्चर का कोई कॉन्फ़िगरेशन नहीं बनाया जा सका, तो शून्य दिखाता है.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

यह prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) का एक उप-चरण है. इससे यह पता चलता है कि SandboxOptions.shouldUseTestDiscovery() चालू है या नहीं.

पैरामीटर
context	IInvocationContext: मौजूदा इनवोकेशन IInvocationContext.
configuration	IConfiguration: कमांड चलाने के लिए IConfiguration.

रिटर्न
Map<String, List<String>>	जांची गई सुविधाओं का मैप या अगर सुविधा काम नहीं करती है या जांच नहीं हो पाती है, तो शून्य.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

पैरामीटर
context	IInvocationContext
configuration	IConfiguration
logger	ITestLogger

रिटर्न
Map<String, List<String>>

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) का सब-स्टेप, जो सैंडबॉक्स के लिए ज़रूरी अतिरिक्त फ़ाइलें फ़ेच करता है.

पैरामीटर
context	IInvocationContext: मौजूदा इनवोकेशन IInvocationContext.
configuration	IConfiguration: कमांड चलाने के लिए IConfiguration.
args	String: कमांड लाइन आर्ग्युमेंट.

रिटर्न
IFolderBuildInfo	सैंडबॉक्स की गई अतिरिक्त फ़ाइलों के लिए फ़ेच किया गया बिल्ड.

थ्रो
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
BuildRetrievalError
ConfigurationException
IOException

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

यह फ़ंक्शन, सैंडबॉक्स एनवायरमेंट के TF को दिखाता है. इसका इस्तेमाल कमांड लाइन के तर्कों के आधार पर किया जाता है.

पैरामीटर
context	IInvocationContext: पैरंट का IInvocationContext.
nonVersionedConfig	IConfiguration: IConfiguration, वर्शन से जुड़े ऑब्जेक्ट नहीं दिखाता है.
args	String: कमांड लाइन आर्ग्युमेंट.

रिटर्न
File	File डायरेक्ट्री, जिसमें TF सैंडबॉक्स एनवायरमेंट जार शामिल हों.

थ्रो
Exception

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

पैरामीटर
context	IInvocationContext
nonVersionedConfig	IConfiguration
logger	ITestLogger
args	String

रिटर्न
File

थ्रो
Exception

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

सैंडबॉक्स को ठीक से चलाने के लिए एनवायरमेंट तैयार करें.

पैरामीटर
context	IInvocationContext: मौजूदा इनवोकेशन IInvocationContext.
configuration	IConfiguration: कमांड चलाने के लिए IConfiguration.
listener	ITestInvocationListener: मौजूदा इनवोकेशन ITestInvocationListener, जहां फ़ाइनल नतीजे पाइप किए जाने चाहिए.

रिटर्न
Exception	अगर कार्रवाई पूरी नहीं होती है, तो Exception. अगर कार्रवाई पूरी हो जाती है, तो Null.

रन

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

सेट किए गए एनवायरमेंट के साथ सैंडबॉक्स चलाएं.

पैरामीटर
info	TestInformation: इनवोकेशन के बारे में बताने वाला TestInformation
configuration	IConfiguration: कमांड चलाने के लिए IConfiguration.
logger	ITestLogger: एक ITestLogger, जहां हम फ़ाइलों को लॉग कर सकते हैं.

रिटर्न
CommandResult	सैंडबॉक्स रन और लॉग के स्टेटस के साथ CommandResult.

थ्रो
Throwable

tearDown

public abstract void tearDown ()

बदले गए किसी भी स्टेट, फ़ाइल या एनवायरमेंट को ठीक करें.