ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

ऐसे सबक्लास जिनके बारे में पहले से पता है TradefedSandbox TradefedSandbox सैंडबॉक्स कंटेनर, जो Trade Federation का अनुरोध चला सकता है.

---

इंटरफ़ेस, जिसमें सैंडबॉक्स की जानकारी दी गई है. इसका इस्तेमाल, किसी अनुरोध को चलाने के लिए किया जा सकता है.

खास जानकारी

सार्वजनिक तरीके
abstract String	createClasspath(File workingDir) getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) से मिली एनवायरमेंट और वर्किंग डायरेक्ट्री के आधार पर क्लासपाथ बनाएं.
abstract IConfiguration	createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) मुख्य रन से डिसकनेक्ट किया गया स्पेशल मोड: जब पैरंट में कोई कॉन्फ़िगरेशन मौजूद नहीं होता है, तो हम थिन लॉन्चर पर फ़ॉलबैक करते हैं. यहां हम मौजूदा जानकारी के साथ सैंडबॉक्स को सेटअप करने की कोशिश करते हैं. साथ ही, वर्शन वाली डायरेक्ट्री में कॉन्फ़िगरेशन बनाने के लिए, वर्किंग डायरेक्ट्री को भरते हैं.
default	discoverTests(IInvocationContext context, IConfiguration configuration) prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) का एक उप-चरण, जो SandboxOptions.shouldUseTestDiscovery() के चालू होने पर टेस्ट का पता लगाता है.
default	discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo	fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args) prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.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(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.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  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) का एक उप-चरण, जो SandboxOptions.shouldUseTestDiscovery() के चालू होने पर टेस्ट का पता लगाता है.

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

रिटर्न
	ढूंढे गए टेस्ट का मैप. अगर यह सुविधा काम नहीं करती है या काम नहीं करती है, तो यह वैल्यू शून्य होगी.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

रिटर्न

fetchSandboxExtraArtifacts

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

prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) का एक उप-चरण, जो सैंडबॉक्स के लिए ज़रूरी अन्य फ़ाइलें फ़ेच करता है.

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

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

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

getTradefedSandboxEnvironment

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

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

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

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

getTradefedSandboxEnvironment

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

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

रिटर्न
File

prepareEnvironment

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

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

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

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

रन

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

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

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

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

tearDown

public abstract void tearDown ()

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