계측 테스트

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

java.lang.객체
↳	com.android.tradefed.testtype.InstrumentationTest

알려진 직접 하위 클래스 AndroidJUnitTest , CodeCoverageTest AndroidJUnitTest android.support.test.runner.AndroidJUnitRunner를 사용하여 지정된 기기에서 계측 테스트 패키지를 실행하는 테스트입니다. CodeCoverageTest 지정된 장치에서 계측 테스트 패키지를 실행하고 코드 검사 보고서를 생성하는 테스트입니다.

---

지정된 장치에서 계측 테스트 패키지를 실행하는 테스트입니다.

요약

필드
public static final String	RUN_TESTS_AS_USER_KEY
public static final String	RUN_TESTS_ON_SDK_SANDBOX
protected boolean	mDebug

공개 생성자
InstrumentationTest ()

공개 방법
void	addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) 러너에 더 많은 사용자 정의 리스너를 추가할 수 있습니다.
void	addInstrumentationArg (String key, String value) 계측 테스트를 실행할 때 제공할 인수를 추가합니다.
IAbi	getAbi ()
IConfiguration	getConfiguration () 이 테스트에 대한 IConfiguration 가져옵니다.
String	getCoverageTarget () 이전에 setCoverageTarget(String) 통해 설정한 coverageTarget을 가져옵니다.
boolean	getDebug () 계측 디버그 설정을 가져옵니다.
ITestDevice	getDevice () 테스트 중인 장치를 가져옵니다.
String	getForceAbi ()
long	getMaxTimeout () 계측에 설정된 최대 제한 시간을 반환합니다.
String	getPackageName () 실행할 Android 매니페스트 패키지를 가져옵니다.
String	getRunName () 수신기에 제공될 사용자 지정 테스트 실행 이름을 가져옵니다.
String	getRunnerName () 사용할 Android 계측 실행기를 가져옵니다.
void	run ( TestInformation testInfo, ITestInvocationListener listener) 테스트를 실행하고 결과를 수신기에 보고합니다.
void	setAbi ( IAbi abi)
void	setClassName (String testClassName) 선택적으로 실행할 테스트 클래스 이름을 설정합니다.
void	setCollectTestsOnly (boolean shouldCollectTest) 테스트 수집 모드를 활성화 또는 비활성화합니다.
void	setCollectsTestsShellTimeout (int timeout) 이 방법은 더 이상 사용되지 않습니다. 이 방법은 no-op입니다.
void	setConfiguration ( IConfiguration config) 사용 중인 IConfiguration 주입합니다.
void	setCoverageTarget (String coverageTarget) 이 테스트의 적용 대상을 설정합니다.
void	setDebug (boolean debug) 계측 디버그 설정을 지정합니다.
void	setDevice ( ITestDevice device) 테스트 중인 장치를 주입합니다.
void	setEnforceFormat (boolean enforce) 계측의 AJUR 출력 형식을 적용하는 경우 True로 설정합니다.
void	setForceAbi (String abi) force-abi 옵션을 설정합니다.
void	setInstallFile (File installFile) 테스트가 포함된 선택적 파일을 설치하도록 설정합니다.
void	setIsolatedStorage (boolean isolatedStorage) 격리된 저장소를 사용할지 여부를 설정합니다.
void	setMethodName (String testMethodName) 선택적으로 실행할 테스트 방법을 설정합니다.
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) 테스트 실행에 대해 정의된 IMetricCollector 목록을 설정합니다.
void	setPackageName (String packageName) 실행할 Android 매니페스트 패키지를 설정합니다.
void	setReRunUsingTestFile (boolean reRunUsingTestFile) --rerun-from-file 옵션을 설정합니다.
void	setRerunMode (boolean rerun) 선택적으로 재실행 모드를 설정합니다.
void	setRunName (String runName) 리스너에게 제공할 사용자 지정 테스트 실행 이름을 설정합니다.
void	setRunnerName (String runnerName) 선택적으로 사용할 Android 계측 실행기를 설정합니다.
void	setShellTimeout (long timeout) 선택적으로 장치에서 셸 출력을 예상하는 최대 시간(밀리초)을 설정합니다.
void	setTestFilePathOnDevice (String testFilePathOnDevice) 선택적으로 실행할 줄로 구분된 테스트 클래스 및 메서드 목록(형식: com.foo.Class#method)을 포함해야 하는 장치에 있는 파일의 경로를 설정합니다.
void	setTestPackageName (String testPackageName) 테스트 패키지 필터를 설정합니다.
void	setTestSize (String size) 선택적으로 실행할 테스트 크기를 설정합니다.
void	setTestTimeout (long timeout) 선택적으로 각 개별 테스트 실행에 대한 최대 시간(밀리초)을 설정합니다.
void	setTestsToRun ( tests) setTestsToRun ( tests) 이 InstrumentationTest에서 실행해야 하는 테스트 컬렉션을 설정합니다.
void	setWindowAnimation (boolean windowAnimation)

보호된 메서드
static	excludeNonExecuted ( TestRunResult results) 다시 실행해야 하는 항목을 추적하기 위해 "NOT_EXECUTED"를 필터링합니다.
String	getClassName () 실행할 클래스 이름을 가져옵니다.
ListInstrumentationParser	getListInstrumentationParser () 'pm list instrumentation' 쿼리를 구문 분석하는 데 사용되는 ListInstrumentationParser 가져옵니다.
String	getMethodName () 실행할 테스트 메서드를 가져옵니다.
String	getTestPackageName () 실행할 테스트 Java 패키지를 가져오십시오.
String	queryRunnerName () 테스트 러너가 사용할 디바이스를 쿼리합니다.
void	setRunnerArgs (IRemoteAndroidTestRunner runner)

필드

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

m디버그

protected boolean mDebug

공개 생성자

계측 테스트

public InstrumentationTest ()

공개 방법

addDeviceListeners

public void addDeviceListeners ( extraListeners)

러너에 더 많은 사용자 정의 리스너를 추가할 수 있습니다.

매개변수
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

계측 테스트를 실행할 때 제공할 인수를 추가합니다.

매개변수
key	String : 인수 이름
value	String : 인수 값

getAbi

public IAbi getAbi ()

보고
IAbi

getConfiguration

public IConfiguration getConfiguration ()

이 테스트에 대한 IConfiguration 가져옵니다.

보고
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

이전에 setCoverageTarget(String) 통해 설정한 coverageTarget을 가져옵니다.

보고
String

getDebug

public boolean getDebug ()

계측 디버그 설정을 가져옵니다.

보고
boolean	부울 디버그 설정입니다.

getDevice

public ITestDevice getDevice ()

테스트 중인 장치를 가져옵니다.

보고
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

보고
String

getMaxTimeout

public long getMaxTimeout ()

계측에 설정된 최대 제한 시간을 반환합니다.

보고
long

getPackageName

public String getPackageName ()

실행할 Android 매니페스트 패키지를 가져옵니다.

보고
String

getRunName

public String getRunName ()

수신기에 제공될 사용자 지정 테스트 실행 이름을 가져옵니다.

보고
String

getRunnerName

public String getRunnerName ()

사용할 Android 계측 실행기를 가져옵니다.

보고
String

달리다

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

테스트를 실행하고 결과를 수신기에 보고합니다.

매개변수
testInfo	TestInformation : 테스트를 실행하는 데 유용한 정보가 포함된 TestInformation 개체입니다.
listener	ITestInvocationListener : 테스트 결과의 ITestInvocationListener

던지기
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

매개변수
abi	IAbi

setClassName

public void setClassName (String testClassName)

선택적으로 실행할 테스트 클래스 이름을 설정합니다.

매개변수
testClassName	String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

테스트 수집 모드를 활성화 또는 비활성화합니다.

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

이 방법은 더 이상 사용되지 않습니다.
이 방법은 no-op입니다.

테스트를 수집할 때 '쉘 출력 응답까지의 최대 시간'을 허용하도록 최대 시간을 ms 단위로 설정합니다.

매개변수
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

사용 중인 IConfiguration 주입합니다.

매개변수
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

이 테스트의 적용 대상을 설정합니다.

현재 미사용. 이 메서드는 제공되므로 coverageTarget은 나중에 getCoverageTarget() 통해 검색할 수 있습니다.

매개변수
coverageTarget	String

setDebug

public void setDebug (boolean debug)

계측 디버그 설정을 지정합니다.

매개변수
debug	boolean : 계측 디버그 설정을 설정할 부울 값입니다.

setDevice

public void setDevice (ITestDevice device)

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

매개변수
device	ITestDevice : 사용할 ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

계측의 AJUR 출력 형식을 적용하는 경우 True로 설정합니다.

매개변수
enforce	boolean

setForceAbi

public void setForceAbi (String abi)

force-abi 옵션을 설정합니다.

setInstallFile

public void setInstallFile (File installFile)

테스트가 포함된 선택적 파일을 설치하도록 설정합니다.

매개변수
installFile	File : 설치 가능한 ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

격리된 저장소를 사용할지 여부를 설정합니다.

매개변수
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

선택적으로 실행할 테스트 방법을 설정합니다.

매개변수
testMethodName	String

setMetricCollectors

public void setMetricCollectors ( collectors)

테스트 실행에 대해 정의된 IMetricCollector 목록을 설정합니다.

매개변수
collectors

setPackageName

public void setPackageName (String packageName)

실행할 Android 매니페스트 패키지를 설정합니다.

매개변수
packageName	String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

--rerun-from-file 옵션을 설정합니다.

매개변수
reRunUsingTestFile	boolean

setRerunMode

public void setRerunMode (boolean rerun)

선택적으로 재실행 모드를 설정합니다.

매개변수
rerun	boolean

setRunName

public void setRunName (String runName)

리스너에게 제공할 사용자 지정 테스트 실행 이름을 설정합니다.

매개변수
runName	String

setRunnerName

public void setRunnerName (String runnerName)

선택적으로 사용할 Android 계측 실행기를 설정합니다.

매개변수
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

선택적으로 장치에서 셸 출력을 예상하는 최대 시간(밀리초)을 설정합니다.

매개변수
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

선택적으로 실행할 줄로 구분된 테스트 클래스 및 메서드 목록(형식: com.foo.Class#method)을 포함해야 하는 장치에 있는 파일의 경로를 설정합니다. 설정된 경우 재실행을 통해 나머지 각 테스트에 대해 별도의 adb 명령을 실행하는 대신 InstrumentationFileTest를 통해 이 테스트 파일을 사용하여 테스트 재실행을 자동으로 시도합니다.

매개변수
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

테스트 패키지 필터를 설정합니다.

null이 아닌 경우 지정된 Java 패키지 내의 테스트만 실행됩니다.

null이 아닌 값이 setClassName(String) 에 제공된 경우 무시됩니다.

매개변수
testPackageName	String

setTestSize

public void setTestSize (String size)

선택적으로 실행할 테스트 크기를 설정합니다.

매개변수
size	String

setTestTimeout

public void setTestTimeout (long timeout)

선택적으로 각 개별 테스트 실행에 대한 최대 시간(밀리초)을 설정합니다.

매개변수
timeout	long

setTestsToRun

public void setTestsToRun ( tests)

이 InstrumentationTest에서 실행해야 하는 테스트 컬렉션을 설정합니다.

매개변수
tests	: 실행할 테스트

setWindow애니메이션

public void setWindowAnimation (boolean windowAnimation)

매개변수
windowAnimation	boolean

보호된 메서드

제외비실행됨

protected static  excludeNonExecuted (TestRunResult results)

다시 실행해야 하는 항목을 추적하기 위해 "NOT_EXECUTED"를 필터링합니다.

매개변수
results	TestRunResult

보고

getClassName

protected String getClassName ()

실행할 클래스 이름을 가져옵니다.

보고
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

'pm list instrumentation' 쿼리를 구문 분석하는 데 사용되는 ListInstrumentationParser 가져옵니다.

보고
ListInstrumentationParser

getMethodName

protected String getMethodName ()

실행할 테스트 메서드를 가져옵니다.

보고
String

getTestPackageName

protected String getTestPackageName ()

실행할 테스트 Java 패키지를 가져오십시오.

보고
String

queryRunnerName

protected String queryRunnerName ()

테스트 러너가 사용할 디바이스를 쿼리합니다.

보고
String	패키지와 일치하는 첫 번째 테스트 실행기 이름 또는 아무것도 찾지 못한 경우 null입니다.

던지기
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

매개변수
runner	IRemoteAndroidTestRunner