ITestSuite

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

ज्ञात प्रत्यक्ष उपवर्ग बेसटेस्टसुइट , टीएफसुइटरनर बेसटेस्टसुइट नए सुइट सिस्टम के साथ संगतता परीक्षण सूट चलाने के लिए एक परीक्षण। TfSuiteRunner ITestSuite का कार्यान्वयन जो TF जार res/config/suite/फ़ोल्डर से परीक्षण लोड करेगा।

ज्ञात अप्रत्यक्ष उपवर्ग एटेस्ट रनर , टेस्ट मैपिंग सूइट रनर AtestRunner ITestSuite का कार्यान्वयन टेस्ट मैपिंग सुइट रनर विकल्प शामिल-फ़िल्टर, या बिल्ड से TEST_MAPPING फ़ाइलों द्वारा निर्दिष्ट परीक्षणों को चलाने के लिए BaseTestSuite का कार्यान्वयन, एक सूट के रूप में।

---

सार वर्ग टेस्ट सूट चलाने के लिए प्रयोग किया जाता है। यह वर्ग इस बात का आधार प्रदान करता है कि सुइट कैसे चलाया जाएगा। प्रत्येक कार्यान्वयन 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_METADATA_EXCLUDE_FILTER
public static final String	MODULE_METADATA_INCLUDE_FILTER
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_SYSTEM_STATUS_CHECKER
public static final String	TOKEN_KEY

सार्वजनिक निर्माणकर्ता
ITestSuite ()

सार्वजनिक तरीके
void	addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)
void	addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)
	getAbis ( ITestDevice device) संगतता परीक्षण AbiUtils.getAbisSupportedByCompatibility() और परीक्षणाधीन डिवाइस दोनों द्वारा समर्थित ABI का सेट प्राप्त करता है।
static	getAbisForBuildTargetArchFromSuite () TestSuiteInfo से संभावित सार लौटाता है।
IBuildInfo	getBuildInfo () ITestSuite के कार्यान्वयन के लिए परीक्षणों को लोड करने के लिए बिल्ड जानकारी की आवश्यकता हो सकती है।
final IConfiguration	getConfiguration () मंगलाचरण IConfiguration लौटाता है।
ITestLogger	getCurrentTestLogger ()
ITestDevice	getDevice () डिवाइस को परीक्षण के तहत प्राप्त करें।
ModuleDefinition	getDirectModule () ModuleDefinition सीधे निष्पादित करने के लिए लौटाता है, या शून्य अगर अभी तक कोई नहीं है (जब ITestSuite अभी तक शार्ड नहीं किया गया है)।
IInvocationContext	getInvocationContext () मंगलाचरण प्रसंग लौटाता है।
MultiMap <String, String>	getModuleMetadataIncludeFilters ()
final String	getRequestedAbi () विकल्प -a या --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) setAbis ( abis)
void	setBuild ( IBuildInfo buildInfo)
void	setCollectTestsOnly (boolean shouldCollectTest) टेस्ट सूट को केवल कलेक्टर मोड में चलाएं, इसके लिए इस इंटरफ़ेस को भी लागू करने के लिए सभी उप-परीक्षणों की आवश्यकता होती है।
void	setConfiguration ( IConfiguration configuration) उपयोग में IConfiguration इंजेक्ट करता है।
void	setDevice ( ITestDevice device) परीक्षण के तहत डिवाइस को इंजेक्ट करें।
void	setDirectModule ( ModuleDefinition module)
void	setInvocationContext ( IInvocationContext invocationContext)
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) टेस्ट रन के लिए परिभाषित IMetricCollector की सूची सेट करता है।
void	setPrimaryAbiRun (boolean primaryAbiRun) mPrimaryAbiRun का मान सेट करें
void	setShouldMakeDynamicModule (boolean dynamicModule) वितरित शार्डिंग करते समय, हमारे पास मॉड्यूलडिफिनिशन नहीं हो सकता है जो एक पूल में परीक्षण साझा करता है अन्यथा इंट्रा-मॉड्यूल शार्डिंग काम नहीं करेगा, इसलिए हम इसे अक्षम करने की अनुमति देते हैं।
void	setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) परीक्षण के लिए कॉन्फ़िगरेशन से ISystemStatusChecker s सेट करता है।
void	setTestLogger ( ITestLogger testLogger) ITestLogger उदाहरण को इंजेक्ट करता है
	split (Integer shardCountHint, TestInformation testInfo) split(int) का वैकल्पिक संस्करण जो एक TestInformation भी प्रदान करता है जिसमें माता-पिता से शार्ड बनाने की प्रारंभिक जानकारी होती है।

संरक्षित तरीके
	createModuleListeners () ModuleListener स्तर पर लागू ITestInvocationListener की सूची लौटाता है।
boolean	filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) कॉन्फ़िगरेशन में मेटाडेटा फ़िल्टर लागू करें और देखें कि कॉन्फ़िगरेशन चलाना चाहिए या नहीं।
boolean	filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) रनर श्वेतसूची फ़िल्टरिंग लागू करें, ऐसे किसी भी रनर को हटा दें जो श्वेतसूची में नहीं था।
	getAbisForBuildTargetArch () होस्ट बिल्ड लक्ष्य आर्किटेक्चर द्वारा समर्थित एबिस वापस करें।
	getHostAbis () होस्ट मशीन एबिस लौटाता है।
void	setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
boolean	shouldModuleRun ( ModuleDefinition module)

खेत

ABI_OPTION

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_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

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

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

सार्वजनिक निर्माणकर्ता

ITestSuite

public ITestSuite ()

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

AddModuleMetadataExcludeFilters

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

पैरामीटर
filters	MultiMap

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

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

पैरामीटर
filters	MultiMap

getAbis

public  getAbis (ITestDevice device)

संगतता परीक्षण AbiUtils.getAbisSupportedByCompatibility() और परीक्षणाधीन डिवाइस दोनों द्वारा समर्थित ABI का सेट प्राप्त करता है।

पैरामीटर
device	ITestDevice

रिटर्न
	परीक्षण चलाने के लिए ABI का सेट

फेंकता
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

TestSuiteInfo से संभावित सार लौटाता है।

रिटर्न

getBuildInfo

public IBuildInfo getBuildInfo ()

ITestSuite के कार्यान्वयन के लिए परीक्षणों को लोड करने के लिए बिल्ड जानकारी की आवश्यकता हो सकती है।

रिटर्न
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

मंगलाचरण IConfiguration लौटाता है।

रिटर्न
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

रिटर्न
ITestLogger

getDevice

public ITestDevice getDevice ()

डिवाइस को परीक्षण के तहत प्राप्त करें।

रिटर्न
ITestDevice	ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

ModuleDefinition सीधे निष्पादित करने के लिए लौटाता है, या शून्य अगर अभी तक कोई नहीं है (जब ITestSuite अभी तक शार्ड नहीं किया गया है)।

रिटर्न
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

मंगलाचरण प्रसंग लौटाता है।

रिटर्न
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

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

getRequestedAbi

public final String getRequestedAbi ()

विकल्प -a या --abi के साथ अनुरोधित अबी लौटाता है।

रिटर्न
String

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

परीक्षण द्वारा आवश्यक टोकन की सूची लौटाता है। कोई टोकन समर्थन नहीं होने पर शून्य लौटाता है।

पैरामीटर
testInfo	TestInformation

रिटर्न

getRuntimeHint

public long getRuntimeHint ()

मिलीसेकंड में परीक्षण का अपेक्षित रनटाइम लौटाएं। समय का उपयोग बैलेंस शार्डेड निष्पादन को लोड करने के लिए किया जाता है

रिटर्न
long

getTestsDir

public File getTestsDir ()

रिटर्न
File

बंट रहा है

public boolean isSplitting ()

अगर हम वर्तमान में IShardableTest.split(int) में हैं, तो सही रिटर्न देता है।

रिटर्न
boolean

loadTest

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

setAbiName

public void setAbiName (String abiName)

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

पैरामीटर
abiName	String

setAbis

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 setInvocationContext (IInvocationContext invocationContext)

पैरामीटर
invocationContext	IInvocationContext

setMetricCollectors

public void setMetricCollectors ( collectors)

टेस्ट रन के लिए परिभाषित IMetricCollector की सूची सेट करता है।

पैरामीटर
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

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

पैरामीटर
primaryAbiRun	boolean

सेटशोल्डमेक डायनामिक मॉड्यूल

public void setShouldMakeDynamicModule (boolean dynamicModule)

वितरित शार्डिंग करते समय, हमारे पास मॉड्यूलडिफिनिशन नहीं हो सकता है जो एक पूल में परीक्षण साझा करता है अन्यथा इंट्रा-मॉड्यूल शार्डिंग काम नहीं करेगा, इसलिए हम इसे अक्षम करने की अनुमति देते हैं।

पैरामीटर
dynamicModule	boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

परीक्षण के लिए कॉन्फ़िगरेशन से ISystemStatusChecker s सेट करता है।

पैरामीटर
systemCheckers

setTestLogger

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

ModuleListener स्तर पर लागू ITestInvocationListener की सूची लौटाता है। प्रत्येक मॉड्यूल के लिए इन श्रोताओं का पुन: उपयोग किया जाएगा, उन्हें फिर से तत्काल नहीं किया जाएगा, इसलिए उन्हें आंतरिक स्थिति नहीं माननी चाहिए।

रिटर्न

filterByConfigMetadata

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

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

पैरामीटर
config	IConfiguration : IConfiguration मूल्यांकन किया जा रहा है।
include	MultiMap : मेटाडेटा में फ़िल्टर शामिल है
exclude	MultiMap : मेटाडेटा फ़िल्टर को बाहर करता है

रिटर्न
boolean	सही है अगर मॉड्यूल चलाना चाहिए, अन्यथा झूठा।

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

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

पैरामीटर
config	IConfiguration : IConfiguration मूल्यांकन किया जा रहा है।
allowedRunners	: वर्तमान धावक श्वेतसूची।

रिटर्न
boolean	सही है अगर कॉन्फ़िगरेशन मॉड्यूल को चलाने की अनुमति है, अन्यथा गलत।

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

होस्ट बिल्ड लक्ष्य आर्किटेक्चर द्वारा समर्थित एबिस वापस करें। परीक्षण के लिए उजागर।

रिटर्न

getHostAbis

protected  getHostAbis ()

होस्ट मशीन एबिस लौटाता है।

रिटर्न

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

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

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

पैरामीटर
module	ModuleDefinition

रिटर्न
boolean