ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

खास जानकारी

पब्लिक मेथड

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 ()

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