ITestSuite

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

java.lang.객체
↳	com.android.tradefed.testtype.suite.ITestSuite

알려진 직접 하위 클래스 BaseTestSuite , TfSuiteRunner BaseTestSuite 새로운 제품군 시스템으로 호환성 테스트 제품군을 실행하기 위한 테스트입니다. TfSuiteRunner 구현 ITestSuite TF 항아리 고해상도 / 설정 / 스위트 / 폴더에서 테스트를로드합니다.

알려진 간접 서브클래스 TestMappingSuiteRunner TestMappingSuiteRunner 구현 BaseTestSuite 옵션에 의해 지정된 실행 테스트에 포함 필터 제품군으로, 또는 빌드에서 TEST_MAPPING 파일을.

---

Test Suite를 실행하는 데 사용되는 추상 클래스입니다. 이 클래스는 도구 모음이 실행되는 방법의 기반을 제공합니다. 각각의 구현을 통해 시험의리스트를 정의 할 수 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	REBOOT_BEFORE_TEST
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)
final void	enableRebootBeforeTest () 테스트 전 재부팅을 true로 설정합니다.
	getAbis (ITestDevice device) 두 호환성 시험, ABI는 세트 가져 AbiUtils.getAbisSupportedByCompatibility() 와 시험 장치.
static	getAbisForBuildTargetArchFromSuite () TestSuiteInfo에서 가능한 abis를 반환합니다.
IBuildInfo	getBuildInfo () 구현 ITestSuite 테스트를로드 할 빌드 정보를 요구할 수있다.
final IConfiguration	getConfiguration () 호출 반환 IConfiguration .
ITestLogger	getCurrentTestLogger ()
ITestDevice	getDevice () 테스트 중인 장치를 가져옵니다.
ModuleDefinition	getDirectModule () 반환 ModuleDefinition 직접 실행, 또는 null합니다 (ITestSuite 아직 분산됩니다되지 않은) 없음 아직 만약합니다.
IInvocationContext	getInvocationContext () 호출 컨텍스트를 반환합니다.
final String	getRequestedAbi () -a 또는 --abi 옵션으로 요청된 abi를 반환합니다.
	getRequiredTokens ()
long	getRuntimeHint () 테스트의 예상 런타임을 밀리초 단위로 반환합니다.
File	getTestsDir ()
boolean	isSplitting () 우리가 현재있는 경우에 true를 돌려줍니다 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	setInvocationContext (IInvocationContext invocationContext)
void	setInvocationInjector (Injector injector) 현재 Guice 가져 Injector 호출에서.
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) 세트의 목록 IMetricCollector 테스트 실행에 대해 정의 s의.
void	setPrimaryAbiRun (boolean primaryAbiRun) mPrimaryAbiRun 값 설정
void	setShouldMakeDynamicModule (boolean dynamicModule) 분산 샤딩을 수행할 때 풀에서 테스트를 공유하는 ModuleDefinition을 가질 수 없습니다. 그렇지 않으면 모듈 내 샤딩이 작동하지 않으므로 비활성화할 수 있습니다.
void	setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) 세트 ISystemStatusChecker 들 시험의 구성에서.
void	setTestLogger (ITestLogger testLogger)
	split (Integer shardCountHint, TestInformation testInfo) 의 대체 버전 split(int) 또한 제공 TestInformation 파편을 만드는 부모로부터 초기 정보가 포함되어 있습니다.

보호된 방법
	createModuleListeners () 반환 목록 ITestInvocationListener 받는 적용 ModuleListener 수준.
boolean	filterByConfigMetadata ( IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude) 구성에 메타데이터 필터를 적용하고 구성이 실행되어야 하는지 확인합니다.
boolean	filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) 러너 화이트리스트 필터링을 적용하여 화이트리스트에 포함되지 않은 러너를 제거합니다.
	getAbisForBuildTargetArch () 호스트 빌드 대상 아키텍처에서 지원하는 abis를 반환합니다.
	getHostAbis () 호스트 머신 abis를 반환합니다.
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

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RANDOM_SEED

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

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

토큰_키

public static final String TOKEN_KEY

공개 생성자

ITestSuite

public ITestSuite ()

공개 메서드

addModuleMetadataExcludeFilters

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

매개변수
filters	MultiMap

addModuleMetadataIncludeFilters

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

매개변수
filters	MultiMap

인에이블RebootBeforeTest

public final void enableRebootBeforeTest ()

테스트 전 재부팅을 true로 설정합니다.

getAbis

public  getAbis (ITestDevice device)

두 호환성 시험, ABI는 세트 가져 AbiUtils.getAbisSupportedByCompatibility() 와 시험 장치.

매개변수
device	ITestDevice

보고
	테스트를 실행할 ABI 세트

던지다
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

TestSuiteInfo에서 가능한 abis를 반환합니다.

보고

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 직접 실행, 또는 null합니다 (ITestSuite 아직 분산됩니다되지 않은) 없음 아직 만약합니다.

보고
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

호출 컨텍스트를 반환합니다.

보고
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

-a 또는 --abi 옵션으로 요청된 abi를 반환합니다.

보고
String

getRequiredTokens

public  getRequiredTokens ()

보고

getRuntime힌트

public long getRuntimeHint ()

테스트의 예상 런타임을 밀리초 단위로 반환합니다. 시간은 샤딩된 실행을 로드 밸런싱하는 데 사용됩니다.

보고
long

getTestsDir

public File getTestsDir ()

보고
File

isSplitting

public boolean isSplitting ()

우리가 현재있는 경우에 true를 돌려줍니다 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
listener	ITestInvocationListener

던지다
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

mAbiName 값 설정

매개변수
abiName	String

세트아비스

public final void setAbis ( abis)

매개변수
abis

세트빌드

public void setBuild (IBuildInfo buildInfo)

매개변수
buildInfo	IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

수집기 전용 모드에서 테스트 스위트를 실행합니다. 이 인터페이스도 구현하려면 모든 하위 테스트가 필요합니다.

설정 구성

public void setConfiguration (IConfiguration configuration)

주입 IConfiguration 사용한다.

매개변수
configuration	IConfiguration

세트장치

public void setDevice (ITestDevice device)

테스트 중인 장치를 주입합니다.

매개변수
device	ITestDevice 다음 ITestDevice 사용에

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

매개변수
invocationContext	IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

현재 Guice 가져 Injector 호출에서. 모듈의 개체 주입을 계속할 수 있어야 합니다.

매개변수
injector	Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

세트의 목록 IMetricCollector 테스트 실행에 대해 정의 s의.

매개변수
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

mPrimaryAbiRun 값 설정

매개변수
primaryAbiRun	boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

분산 샤딩을 수행할 때 풀에서 테스트를 공유하는 ModuleDefinition을 가질 수 없습니다. 그렇지 않으면 모듈 내 샤딩이 작동하지 않으므로 비활성화할 수 있습니다.

매개변수
dynamicModule	boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

세트 ISystemStatusChecker 들 시험의 구성에서.

매개변수
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

매개변수
testLogger	ITestLogger

나뉘다

public  split (Integer shardCountHint, 
                TestInformation testInfo)

의 대체 버전 split(int) 또한 제공 TestInformation 파편을 만드는 부모로부터 초기 정보가 포함되어 있습니다. 샤딩 중에 장치 또는 빌드 정보에 액세스해야 하는 경우에 유용합니다.

매개변수
shardCountHint	Integer : 시도 된 샤드 수입니다.
testInfo	TestInformation : 부모 TestInformation

보고
	하위 검사의 컬렉션 개별적으로 또는 실행되는 null 테스트가 현재 shardable없는 경우

보호된 방법

createModuleListeners

protected  createModuleListeners ()

반환 목록 ITestInvocationListener 받는 적용 ModuleListener 수준. 이러한 리스너는 각 모듈에 대해 재사용되며 다시 인스턴스화되지 않으므로 내부 상태를 가정하지 않아야 합니다.

보고

filterByConfigMetadata

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

구성에 메타데이터 필터를 적용하고 구성이 실행되어야 하는지 확인합니다.

매개변수
config	IConfiguration 다음 IConfiguration 평가된다.
include	MultiMap : 메타 데이터는 필터를 포함
exclude	MultiMap 다음 제외 메타 데이터 필터

보고
boolean	모듈을 실행해야 하는 경우 true, 그렇지 않으면 false입니다.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

러너 화이트리스트 필터링을 적용하여 화이트리스트에 포함되지 않은 러너를 제거합니다. 구성에 여러 러너가 있는 경우 일부는 제거될 수 있으며 구성은 계속 실행됩니다.

매개변수
config	IConfiguration 다음 IConfiguration 평가된다.
allowedRunners	: 현재 주자 화이트리스트.

보고
boolean	구성 모듈이 실행되도록 허용되면 True, 그렇지 않으면 False입니다.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

호스트 빌드 대상 아키텍처에서 지원하는 abis를 반환합니다. 테스트를 위해 노출되었습니다.

보고

getHostAbis

protected  getHostAbis ()

호스트 머신 abis를 반환합니다.

보고

해야 모듈 실행

protected boolean shouldModuleRun (ModuleDefinition module)

매개변수
module	ModuleDefinition

보고
boolean