आईटेस्टसुइट
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)
यह टेस्ट किए जा रहे डिवाइस और कम्पैटिबिलिटी टेस्टिंग |
static
|
getAbisForBuildTargetArchFromSuite()
TestSuiteInfo से संभावित abis दिखाता है. |
IBuildInfo
|
getBuildInfo()
|
final
IConfiguration
|
getConfiguration()
शुरू करने के लिए, |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
डिवाइस की जांच करें. |
ModuleDefinition
|
getDirectModule()
सीधे तौर पर चलाने के लिए, |
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()
अगर हम फ़िलहाल |
abstract
|
loadTests()
चलाए जाने वाले टेस्ट कॉन्फ़िगरेशन को लोड करने का ऐब्स्ट्रैक्ट तरीका. |
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
दिए गए मुख्य लिसनर को एक्ज़ीक्यूट नहीं किए गए टेस्ट की रिपोर्ट करें. |
void
|
reportNotExecuted(ITestInvocationListener listener)
दिए गए मुख्य लिसनर को एक्ज़ीक्यूट नहीं किए गए टेस्ट की रिपोर्ट करें. |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
|
void
|
setAbiName(String abiName)
mAbiName का मान सेट करें |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
टेस्ट सुइट को 'सिर्फ़ कलेक्टर' मोड में चलाएं. ऐसा करने के लिए, सभी सब-टेस्टों की ज़रूरत होती है, ताकि यह इंटरफ़ेस भी लागू किया जा सके. |
void
|
setConfiguration(IConfiguration configuration)
|
void
|
setDevice(ITestDevice device)
जांच में डिवाइस इंजेक्ट करें. |
void
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
टेस्ट रन के लिए तय की गई |
void
|
setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
|
void
|
setPrimaryAbiRun(boolean primaryAbiRun)
mPrimaryAbiRun का मान सेट करें |
void
|
setShouldMakeDynamicModule(boolean dynamicModule)
डिस्ट्रिब्यूटेड शार्डिंग करते समय, हम ऐसा मॉड्यूल डेफ़िनिशन नहीं बना सकते जो पूल में जांच शेयर करता हो. ऐसा न करने पर इंट्रा-मॉड्यूल शार्डिंग काम नहीं करेगी. इसलिए, हम इसे बंद करने की अनुमति देते हैं. |
void
|
setSystemStatusChecker(
यह टेस्ट के लिए, कॉन्फ़िगरेशन से |
void
|
setTestLogger(ITestLogger testLogger)
|
|
split(Integer shardCountHint, TestInformation testInfo)
|
सुरक्षित तरीके | |
---|---|
|
createModuleListeners()
यह फ़ंक्शन |
boolean
|
filterByRunnerType(IConfiguration config,
'रनर' की व्हाइटलिस्ट फ़िल्टर करने की सुविधा लागू करें. इससे उन रनर को हटा दिया जाता है जिन्हें अनुमति नहीं मिली थी. |
|
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
mचालू रिज़ॉल्व सिमलिंक
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 |
अगर मॉड्यूल को चलाना है, तो सही है. अगर ऐसा नहीं है, तो गलत है. |
जैबिस
publicgetAbis (ITestDevice device)
यह टेस्ट किए जा रहे डिवाइस और कम्पैटिबिलिटी टेस्टिंग AbiUtils.getAbisSupportedByCompatibility()
के साथ काम करने वाले एबीआई के सेट को इकट्ठा करता है.
पैरामीटर | |
---|---|
device |
ITestDevice |
रिटर्न | |
---|---|
|
परीक्षण चलाने के लिए एबीआई का सेट |
थ्रो | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailable विशेषता |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
TestSuiteInfo से संभावित abis दिखाता है.
रिटर्न | |
---|---|
|
GetBuildInfo
public IBuildInfo getBuildInfo ()
ITestSuite
को लागू करने के लिए टेस्ट लोड करने के लिए बिल्ड की जानकारी की ज़रूरत हो सकती है.
रिटर्न | |
---|---|
IBuildInfo |
getकॉन्फ़िगरेशन
public final IConfiguration getConfiguration ()
शुरू करने के लिए, IConfiguration
मैसेज दिखाता है.
रिटर्न | |
---|---|
IConfiguration |
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
publicgetRequiredTokens (TestInformation testInfo)
यह फ़ंक्शन टेस्ट के हिसाब से ज़रूरी टोकन की सूची दिखाता है. अगर कोई टोकन काम नहीं करता है, तो यह वैल्यू शून्य हो जाती है.
पैरामीटर | |
---|---|
testInfo |
TestInformation |
रिटर्न | |
---|---|
|
'रनटाइम हिंट'
public long getRuntimeHint ()
जांच का अनुमानित रनटाइम, मिलीसेकंड में दिखाएं. शार्ड एक्ज़ीक्यूशन का बैलेंस लोड करने में लगने वाले समय का इस्तेमाल किया जाता है
रिटर्न | |
---|---|
long |
गेटटेस्ट्सडीर
public File getTestsDir ()
रिटर्न | |
---|---|
File |
बांटा जा रहा है
public boolean isSplitting ()
अगर हम फ़िलहाल IShardableTest.split(int)
में हैं, तो 'सही' दिखाता है.
रिटर्न | |
---|---|
boolean |
लोड की जांच
public abstractloadTests ()
चलाए जाने वाले टेस्ट कॉन्फ़िगरेशन को लोड करने का ऐब्स्ट्रैक्ट तरीका. हर जांच को एक
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 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)
यह टेस्ट के लिए, कॉन्फ़िगरेशन से ISystemStatusChecker
s को सेट करता है.
पैरामीटर | |
---|---|
systemCheckers |
|
टेस्टलॉगर सेट करें
public void setTestLogger (ITestLogger testLogger)
ITestLogger
इंस्टेंस इंजेक्ट करता है
पैरामीटर | |
---|---|
testLogger |
ITestLogger |
बाँटना
publicsplit (Integer shardCountHint, TestInformation testInfo)
split(int)
का दूसरा वर्शन, जो TestInformation
भी उपलब्ध कराता है.
इसमें शार्ड बनाने वाले माता-पिता की शुरुआती जानकारी होती है. शार्डिंग के दौरान, डिवाइस या बिल्ड की जानकारी को ऐक्सेस करने की ज़रूरत पड़ने पर, यह तरीका मददगार होता है.
पैरामीटर | |
---|---|
shardCountHint |
Integer : प्रयास किए गए शार्ड की संख्या. |
testInfo |
TestInformation : माता-पिता TestInformation |
रिटर्न | |
---|---|
|
अलग-अलग किए जाने वाले सबटेस्ट का कलेक्शन या अगर टेस्ट को अभी शार्ड नहीं किया जा सकता है, तो null |
सुरक्षित तरीके
createModuleListeners
protectedcreateModuleListeners ()
यह फ़ंक्शन ITestInvocationListener
की सूची दिखाता है, जो ModuleListener
लेवल पर लागू होता है. इन लिसनर को हर मॉड्यूल के लिए फिर से इस्तेमाल किया जाएगा. उन्हें फिर से चालू नहीं किया जाएगा.
इसलिए, उन्हें कोई अंदरूनी स्थिति नहीं माननी चाहिए.
रिटर्न | |
---|---|
|
फ़िल्टर बायरनर टाइप
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
'रनर' की व्हाइटलिस्ट फ़िल्टर करने की सुविधा लागू करें. इससे उन रनर को हटा दिया जाता है जिन्हें अनुमति नहीं मिली थी. अगर किसी कॉन्फ़िगरेशन में कई रनर हैं, तो हो सकता है कि कुछ रनर को हटा दिया जाए और कॉन्फ़िगरेशन अब भी चलता रहे.
पैरामीटर | |
---|---|
config |
IConfiguration : IConfiguration का आकलन किया जा रहा है. |
allowedRunners |
: रनर की मौजूदा अनुमति वाली सूची. |
रिटर्न | |
---|---|
boolean |
अगर कॉन्फ़िगरेशन मॉड्यूल को चलने की अनुमति है, तो सही है. अगर ऐसा नहीं है, तो गलत है. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
होस्ट बिल्ड टारगेट आर्किटेक्चर के साथ काम करने वाला abis दिखाएं. टेस्टिंग के लिए एक्सपोज़्ड.
रिटर्न | |
---|---|
|
गेटहोस्टएबिस
protectedgetHostAbis ()
होस्ट मशीन abis को लौटाता है.
रिटर्न | |
---|---|
|
चाहिएमॉड्यूलरन
protected boolean shouldModuleRun (ModuleDefinition module)
पैरामीटर | |
---|---|
module |
ModuleDefinition |
रिटर्न | |
---|---|
boolean |