ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

खास जानकारी

सार्वजनिक तरीके

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

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