आईटेस्टसुइट

public abstract class ITestSuite
extends Object implements IRemoteTest, IDeviceTest, IBuildReceiver, ISystemStatusCheckerReceiver, IShardableTest, ITestCollector, IInvocationContextReceiver, IRuntimeHintProvider, IMetricCollectorReceiver, IConfigurationReceiver, IReportNotExecuted, ITokenRequest, ITestLoggerReceiver

java.lang.Object
↳ com.android.tradefed.testtype.suite.ITestSuite

टेस्ट सुइट चलाने के लिए इस्तेमाल की जाने वाली ऐब्स्ट्रैक्ट क्लास. इस क्लास से पता चलता है कि सुइट को कैसे चलाया जाएगा. हर लागू करने पर, loadTests() तरीके से टेस्ट की सूची तय की जा सकती है.

खास जानकारी

फ़ील्ड्स की फ़िल्में

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_END_TIME

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_START_TIME

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RANDOM_SEED

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_STAGING_ARTIFACTS

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String STAGE_MODULE_ARTIFACTS

public static final String TEST_TYPE_KEY

public static final String TEST_TYPE_VALUE_PERFORMANCE

public static final String TOKEN_KEY

protected boolean mEnableResolveSymlinks

protected boolean mRecoverDeviceByCvd

सार्वजनिक कंस्ट्रक्टर

ITestSuite()

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

void addModuleMetadataExcludeFilters(MultiMap<String, String> filters)
void addModuleMetadataIncludeFilters(MultiMap<String, String> filters)
void cleanUpSuiteSetup()

उन सभी चीज़ों को खाली किया जा सकता है जो सुइट को सेटअप करने के दौरान ज़रूरी थीं, लेकिन टेस्ट करने के लिए ज़रूरी नहीं हैं.

boolean filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)

कॉन्फ़िगरेशन पर मेटाडेटा फ़िल्टर लागू करें और देखें कि कॉन्फ़िगरेशन चलना चाहिए या नहीं.

getAbis(ITestDevice device)

यह टेस्ट किए जा रहे डिवाइस और कम्पैटिबिलिटी टेस्टिंग AbiUtils.getAbisSupportedByCompatibility() के साथ काम करने वाले एबीआई के सेट को इकट्ठा करता है.

static getAbisForBuildTargetArchFromSuite()

TestSuiteInfo से संभावित abis दिखाता है.

IBuildInfo getBuildInfo()

ITestSuite को लागू करने के लिए टेस्ट लोड करने के लिए बिल्ड की जानकारी की ज़रूरत हो सकती है.

final IConfiguration getConfiguration()

शुरू करने के लिए, IConfiguration मैसेज दिखाता है.

ITestLogger getCurrentTestLogger()
ITestDevice getDevice()

डिवाइस की जांच करें.

ModuleDefinition getDirectModule()

सीधे तौर पर चलाने के लिए, ModuleDefinition दिखाता है. अगर अभी तक ITestSuite शार्ड नहीं बनाया गया है, तो यह शून्य हो जाता है.

boolean getIntraModuleSharding()
IInvocationContext getInvocationContext()

शुरू करने का कॉन्टेक्स्ट दिखाता है.

MultiMap<String, String> getModuleMetadataIncludeFilters()
ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy()
final String getRequestedAbi()

विकल्प -a या --abi के साथ अनुरोध किया गया abi देता है.

getRequiredTokens(TestInformation testInfo)

यह फ़ंक्शन टेस्ट के हिसाब से ज़रूरी टोकन की सूची दिखाता है.

long getRuntimeHint()

जांच का अनुमानित रनटाइम, मिलीसेकंड में दिखाएं.

File getTestsDir()
boolean isSplitting()

अगर हम फ़िलहाल IShardableTest.split(int) में हैं, तो 'सही' दिखाता है.

abstract loadTests()

चलाए जाने वाले टेस्ट कॉन्फ़िगरेशन को लोड करने का ऐब्स्ट्रैक्ट तरीका.

void reportNotExecuted(ITestInvocationListener listener, String message)

दिए गए मुख्य लिसनर को एक्ज़ीक्यूट नहीं किए गए टेस्ट की रिपोर्ट करें.

void reportNotExecuted(ITestInvocationListener listener)

दिए गए मुख्य लिसनर को एक्ज़ीक्यूट नहीं किए गए टेस्ट की रिपोर्ट करें.

final void run(TestInformation testInfo, ITestInvocationListener listener)

loadTests() से लोड किए गए सभी टेस्ट के लिए, रन करने का सामान्य तरीका.

void setAbiName(String abiName)

mAbiName का मान सेट करें

final void setAbis( abis)
void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

टेस्ट सुइट को 'सिर्फ़ कलेक्टर' मोड में चलाएं. ऐसा करने के लिए, सभी सब-टेस्टों की ज़रूरत होती है, ताकि यह इंटरफ़ेस भी लागू किया जा सके.

void setConfiguration(IConfiguration configuration)

IConfiguration को इंजेक्ट करता है.

void setDevice(ITestDevice device)

जांच में डिवाइस इंजेक्ट करें.

void setDirectModule(ModuleDefinition module)
void setIntraModuleSharding(boolean intraModuleSharding)
void setInvocationContext(IInvocationContext invocationContext)

void setMetricCollectors( collectors)

टेस्ट रन के लिए तय की गई IMetricCollector की सूची सेट करता है.

void setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
void setPrimaryAbiRun(boolean primaryAbiRun)

mPrimaryAbiRun का मान सेट करें

void setShouldMakeDynamicModule(boolean dynamicModule)

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

void setSystemStatusChecker( systemCheckers)

यह टेस्ट के लिए, कॉन्फ़िगरेशन से ISystemStatusCheckers को सेट करता है.

void setTestLogger(ITestLogger testLogger)

ITestLogger इंस्टेंस इंजेक्ट करता है

split(Integer shardCountHint, TestInformation testInfo)

split(int) का दूसरा वर्शन, जो TestInformation भी उपलब्ध कराता है. इसमें शार्ड बनाने वाले माता-पिता की शुरुआती जानकारी होती है.

सुरक्षित तरीके

createModuleListeners()

यह फ़ंक्शन ITestInvocationListener की सूची दिखाता है, जो ModuleListener लेवल पर लागू होता है.

boolean filterByRunnerType(IConfiguration config, allowedRunners)

'रनर' की व्हाइटलिस्ट फ़िल्टर करने की सुविधा लागू करें. इससे उन रनर को हटा दिया जाता है जिन्हें अनुमति नहीं मिली थी.

getAbisForBuildTargetArch()

होस्ट बिल्ड टारगेट आर्किटेक्चर के साथ काम करने वाला abis दिखाएं.

getHostAbis()

होस्ट मशीन abis को लौटाता है.

boolean shouldModuleRun(ModuleDefinition module)

फ़ील्ड्स की फ़िल्में

एबीआई_विकल्प

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_END_TIME

public static final String MODULE_END_TIME

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

MODULE_START_TIME

public static final String MODULE_START_TIME

पैरामीटर की पैरामीटर कुंजी

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

प्राथमिक_ABI_RUN

public static final String PRIMARY_ABI_RUN

रैंडम एसईईडी

public static final String RANDOM_SEED

रनर_व्हाइटलिस्ट

public static final String RUNNER_WHITELIST

SKIP_Host_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

SKIP_System_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

टेस्ट_TYPE_KEY

public static final String TEST_TYPE_KEY

टेस्ट_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

TOKEN_KEY

public static final String TOKEN_KEY

protected boolean mEnableResolveSymlinks

एम रिकवर DeviceByCvd

protected boolean mRecoverDeviceByCvd

सार्वजनिक कंस्ट्रक्टर

आईटेस्टसुइट

public ITestSuite ()

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

ऐडमॉड्यूलइन्टैटामटा एक्सक्लूज़नफ़िल्टर

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

पैरामीटर
filters MultiMap

ऐड मॉड्यूल मेटाडेटा शामिल फ़िल्टर

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

पैरामीटर
filters MultiMap

क्लीनअप सेटअप

public void cleanUpSuiteSetup ()

उन सभी चीज़ों को खाली किया जा सकता है जो सुइट को सेटअप करने के दौरान ज़रूरी थीं, लेकिन टेस्ट करने के लिए ज़रूरी नहीं हैं.

फ़िल्टरByConfigमेटाडेटा

public boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

कॉन्फ़िगरेशन पर मेटाडेटा फ़िल्टर लागू करें और देखें कि कॉन्फ़िगरेशन चलना चाहिए या नहीं.

पैरामीटर
config IConfiguration: IConfiguration का आकलन किया जा रहा है.
include MultiMap: मेटाडेटा में फ़िल्टर शामिल है
exclude MultiMap: मेटाडेटा में बाहर रखने वाला फ़िल्टर
रिटर्न
boolean अगर मॉड्यूल को चलाना है, तो सही है. अगर ऐसा नहीं है, तो गलत है.

जैबिस

public  getAbis (ITestDevice device)

यह टेस्ट किए जा रहे डिवाइस और कम्पैटिबिलिटी टेस्टिंग AbiUtils.getAbisSupportedByCompatibility() के साथ काम करने वाले एबीआई के सेट को इकट्ठा करता है.

पैरामीटर
device ITestDevice

रिटर्न
परीक्षण चलाने के लिए एबीआई का सेट
थ्रो
com.android.tradefed.device.DeviceNotAvailable विशेषता
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

TestSuiteInfo से संभावित abis दिखाता है.

रिटर्न

GetBuildInfo

public IBuildInfo getBuildInfo ()

ITestSuite को लागू करने के लिए टेस्ट लोड करने के लिए बिल्ड की जानकारी की ज़रूरत हो सकती है.

रिटर्न
IBuildInfo

getकॉन्फ़िगरेशन

public final IConfiguration getConfiguration ()

शुरू करने के लिए, IConfiguration मैसेज दिखाता है.

रिटर्न
IConfiguration

'CurrentTLogger' पाएं

public ITestLogger getCurrentTestLogger ()

रिटर्न
ITestLogger

'डिवाइस पाएं'

public ITestDevice getDevice ()

डिवाइस की जांच करें.

रिटर्न
ITestDevice ITestDevice

getDirectमॉड्यूल

public ModuleDefinition getDirectModule ()

सीधे तौर पर चलाने के लिए, ModuleDefinition दिखाता है. अगर अभी तक ITestSuite शार्ड नहीं बनाया गया है, तो यह शून्य हो जाता है.

रिटर्न
ModuleDefinition

गेटइंट्रामॉड्यूलशार्डिंग

public boolean getIntraModuleSharding ()

रिटर्न
boolean

गेट इनवोकेशन कॉन्टेक्स्ट

public IInvocationContext getInvocationContext ()

शुरू करने का कॉन्टेक्स्ट दिखाता है.

रिटर्न
IInvocationContext

getमॉड्यूलमेटाडेटाइन्क्लूड फ़िल्टर

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

रिटर्न
MultiMap<String, String>

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

रिटर्न
ITestSuite.MultiDeviceModuleStrategy

गेट रिक्वेस्ट ऐबी

public final String getRequestedAbi ()

विकल्प -a या --abi के साथ अनुरोध किया गया abi देता है.

रिटर्न
String

get EssentialsTokens

public  getRequiredTokens (TestInformation testInfo)

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

पैरामीटर
testInfo TestInformation

रिटर्न

'रनटाइम हिंट'

public long getRuntimeHint ()

जांच का अनुमानित रनटाइम, मिलीसेकंड में दिखाएं. शार्ड एक्ज़ीक्यूशन का बैलेंस लोड करने में लगने वाले समय का इस्तेमाल किया जाता है

रिटर्न
long

गेटटेस्ट्सडीर

public File getTestsDir ()

रिटर्न
File

बांटा जा रहा है

public boolean isSplitting ()

अगर हम फ़िलहाल IShardableTest.split(int) में हैं, तो 'सही' दिखाता है.

रिटर्न
boolean

लोड की जांच

public abstract  loadTests ()

चलाए जाने वाले टेस्ट कॉन्फ़िगरेशन को लोड करने का ऐब्स्ट्रैक्ट तरीका. हर जांच को एक IConfiguration और एक यूनीक नाम से तय किया जाता है, जिसके आधार पर यह जांच के नतीजे रिपोर्ट करती है.

रिटर्न

रिपोर्ट नहीं की गई

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

दिए गए मुख्य लिसनर को एक्ज़ीक्यूट नहीं किए गए टेस्ट की रिपोर्ट करें. उनकी शिकायत NOT_EXECUTED_FAILURE मैसेज के साथ 'नहीं किया जा सका' के तौर पर की जानी चाहिए.

पैरामीटर
listener ITestInvocationListener: मुख्य लिसनर जहां उन नतीजों की शिकायत की जाती है जो लागू नहीं हुए हैं.
message String: गैर-निष्पादित विफलता से संबद्ध किया जाने वाला संदेश.

रिपोर्ट नहीं की गई

public void reportNotExecuted (ITestInvocationListener listener)

दिए गए मुख्य लिसनर को एक्ज़ीक्यूट नहीं किए गए टेस्ट की रिपोर्ट करें. उनकी शिकायत NOT_EXECUTED_FAILURE मैसेज के साथ 'नहीं किया जा सका' के तौर पर की जानी चाहिए.

पैरामीटर
listener ITestInvocationListener: मुख्य लिसनर जहां उन नतीजों की शिकायत की जाती है जो लागू नहीं हुए हैं.

रन

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

loadTests() से लोड किए गए सभी टेस्ट के लिए, रन करने का सामान्य तरीका.

पैरामीटर
testInfo TestInformation: TestInformation ऑब्जेक्ट में, जांच करने के लिए काम की जानकारी है.
listener ITestInvocationListener: ITestInvocationListener जांच के नतीजे
थ्रो
DeviceNotAvailableException

सेटएबीनाम

public void setAbiName (String abiName)

mAbiName का मान सेट करें

पैरामीटर
abiName String

सेऐबिस

public final void setAbis ( abis)

पैरामीटर
abis

सेटबिल्ड

public void setBuild (IBuildInfo buildInfo)

पैरामीटर
buildInfo IBuildInfo

सेट कलेक्टटेस्ट ओनली

public void setCollectTestsOnly (boolean shouldCollectTest)

टेस्ट सुइट को 'सिर्फ़ कलेक्टर' मोड में चलाएं. ऐसा करने के लिए, सभी सब-टेस्टों की ज़रूरत होती है, ताकि यह इंटरफ़ेस भी लागू किया जा सके.

सेट कॉन्फ़िगरेशन

public void setConfiguration (IConfiguration configuration)

IConfiguration को इंजेक्ट करता है.

पैरामीटर
configuration IConfiguration

डिवाइस सेट करें

public void setDevice (ITestDevice device)

जांच में डिवाइस इंजेक्ट करें.

पैरामीटर
device ITestDevice: इस्तेमाल करने के लिए ITestDevice

सेटडायरेक्ट मॉड्यूल

public void setDirectModule (ModuleDefinition module)

पैरामीटर
module ModuleDefinition

सेटइंट्रामॉड्यूलशार्डिंग

public void setIntraModuleSharding (boolean intraModuleSharding)

पैरामीटर
intraModuleSharding boolean

सेट इनवोकेशनकॉन्टेक्स्ट

public void setInvocationContext (IInvocationContext invocationContext)

पैरामीटर
invocationContext IInvocationContext

सेटमेट्रिक कलेक्टर

public void setMetricCollectors ( collectors)

टेस्ट रन के लिए तय की गई IMetricCollector की सूची सेट करता है.

पैरामीटर
collectors

मल्टीडिवाइस स्ट्रेटजी सेट करें

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

पैरामीटर
strategy ITestSuite.MultiDeviceModuleStrategy

सेटप्राइमरीएबिरन

public void setPrimaryAbiRun (boolean primaryAbiRun)

mPrimaryAbiRun का मान सेट करें

पैरामीटर
primaryAbiRun boolean

setShouldMakeडाइनैमिक मॉड्यूल

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

पैरामीटर
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

यह टेस्ट के लिए, कॉन्फ़िगरेशन से ISystemStatusCheckers को सेट करता है.

पैरामीटर
systemCheckers

टेस्टलॉगर सेट करें

public void setTestLogger (ITestLogger testLogger)

ITestLogger इंस्टेंस इंजेक्ट करता है

पैरामीटर
testLogger ITestLogger

बाँटना

public  split (Integer shardCountHint, 
                TestInformation testInfo)

split(int) का दूसरा वर्शन, जो TestInformation भी उपलब्ध कराता है. इसमें शार्ड बनाने वाले माता-पिता की शुरुआती जानकारी होती है. शार्डिंग के दौरान, डिवाइस या बिल्ड की जानकारी को ऐक्सेस करने की ज़रूरत पड़ने पर, यह तरीका मददगार होता है.

पैरामीटर
shardCountHint Integer: प्रयास किए गए शार्ड की संख्या.
testInfo TestInformation: माता-पिता TestInformation
रिटर्न
अलग-अलग किए जाने वाले सबटेस्ट का कलेक्शन या अगर टेस्ट को अभी शार्ड नहीं किया जा सकता है, तो null

सुरक्षित तरीके

createModuleListeners

protected  createModuleListeners ()

यह फ़ंक्शन ITestInvocationListener की सूची दिखाता है, जो ModuleListener लेवल पर लागू होता है. इन लिसनर को हर मॉड्यूल के लिए फिर से इस्तेमाल किया जाएगा. उन्हें फिर से चालू नहीं किया जाएगा. इसलिए, उन्हें कोई अंदरूनी स्थिति नहीं माननी चाहिए.

रिटर्न

फ़िल्टर बायरनर टाइप

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

'रनर' की व्हाइटलिस्ट फ़िल्टर करने की सुविधा लागू करें. इससे उन रनर को हटा दिया जाता है जिन्हें अनुमति नहीं मिली थी. अगर किसी कॉन्फ़िगरेशन में कई रनर हैं, तो हो सकता है कि कुछ रनर को हटा दिया जाए और कॉन्फ़िगरेशन अब भी चलता रहे.

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

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

होस्ट बिल्ड टारगेट आर्किटेक्चर के साथ काम करने वाला abis दिखाएं. टेस्टिंग के लिए एक्सपोज़्ड.

रिटर्न

गेटहोस्टएबिस

protected  getHostAbis ()

होस्ट मशीन abis को लौटाता है.

रिटर्न

चाहिएमॉड्यूलरन

protected boolean shouldModuleRun (ModuleDefinition module)

पैरामीटर
module ModuleDefinition

रिटर्न
boolean