InstrumentationTest

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

java.lang.Object
↳	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
protected boolean	mInstrumentSdkInSandbox
protected boolean	mInstrumentSdkSandbox

공개 생성자
InstrumentationTest()

공개 메서드
void	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 계측 실행기를 가져옵니다.
boolean	isOrchestrator() ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)의 값을 반환합니다.
void	run(TestInformation testInfo, ITestInvocationListener listener) 테스트를 실행하고 리스너에 결과를 보고합니다.
void	setAbi(IAbi abi)
void	setClassName(String testClassName) 원하는 경우 실행할 테스트 클래스 이름을 설정합니다.
void	setCollectTestsOnly(boolean shouldCollectTest) 테스트 수집 모드를 사용 또는 사용 중지합니다.
void	setCollectsTestsShellTimeout(int timeout) 이 메서드는 지원 중단되었습니다. 이 메서드는 무작위 작업입니다.
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) 테스트 실행에 정의된 IMetricCollector 목록을 설정합니다.
void	setOrchestrator(boolean useOrchestrator) --orchestrator 옵션을 설정합니다.
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) 이 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

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

공개 생성자

InstrumentationTest

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

isOrchestrator

public boolean isOrchestrator ()

ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)의 값을 반환합니다.

반환 값
boolean

실행

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)

이 메서드는 지원 중단되었습니다.
이 메서드는 무작위 작업입니다.

테스트를 수집할 때 '셸 출력 응답 최대 시간'을 허용하도록 최대 시간을 밀리초 단위로 설정합니다.

매개변수
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

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

--orchestrator 옵션을 설정합니다.

매개변수
useOrchestrator	boolean

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 패키지 내의 테스트만 실행됩니다.

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

매개변수
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	: 실행할 테스트

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

매개변수
windowAnimation	boolean

보호된 메서드

excludeNonExecuted

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