IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Android 테스트 명령어를 원격으로 실행하고 리스너에 결과를 보고하는 인터페이스

요약

공개 메서드

abstract void addBooleanArg(String name, boolean value)

계측 명령어에 포함할 불리언 인수를 추가합니다.

abstract void addInstrumentationArg(String name, String value)

계측 명령어에 포함할 인수를 추가합니다.

abstract void cancel()

이 테스트 실행의 취소를 요청합니다.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

러너가 생성하는 테스트 범위의 유형을 반환합니다.

abstract String getPackageName()

애플리케이션 패키지 이름을 반환합니다.

abstract String getRunnerName()

runnerName을 반환합니다.

abstract void removeInstrumentationArg(String name)

이전에 추가된 인수를 삭제합니다.

abstract void run(ITestRunListener... listeners)

이 테스트 실행을 실행합니다.

abstract void run( listeners)

이 테스트 실행을 실행합니다.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

테스트 앱이 제거되기 전에 호스트에 복사할 추가 테스트 출력의 위치를 설정합니다.

abstract void setClassName(String className)

이 클래스의 테스트만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

abstract void setClassNames(String[] classNames)

제공된 클래스의 테스트만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

abstract void setCoverage(boolean coverage)

이 테스트 실행의 코드 커버리지 모드를 설정합니다.

abstract void setCoverageReportLocation(String reportPath)

생성된 범위 보고서의 위치를 설정합니다.

abstract void setDebug(boolean debug)

이 테스트 실행의 디버그 모드를 설정합니다.

abstract void setLogOnly(boolean logOnly)

이 테스트 실행을 로깅 전용 모드로 설정합니다. 테스트 실행을 건너뜁니다.

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

기기에서 테스트를 실행하는 셸 명령어가 출력되는 사이의 최대 허용 시간을 설정합니다.

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

계측이 완료되는 데 허용되는 최대 시간을 설정합니다.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

이 메서드는 지원 중단되었습니다. ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit))를 사용합니다.

abstract void setMethodName(String className, String testName)

지정된 테스트 메서드만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

abstract void setRunName(String runName)

run()에서 ITestRunListener에 보고할 맞춤 실행 이름을 설정합니다.

지정하지 않으면 패키지 이름을 사용합니다.

abstract void setTestCollection(boolean collection)

이 테스트 실행을 테스트 수집 모드로 설정합니다.

abstract void setTestPackageName(String packageName)

지정된 패키지에서 모든 테스트를 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

지정된 크기의 테스트만 실행하도록 설정합니다.

공개 메서드

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

계측 명령어에 포함할 불리언 인수를 추가합니다.

매개변수
name String: 계측 번들 인수의 이름
value boolean: 인수의 값

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

계측 명령어에 포함할 인수를 추가합니다.

'run' 전에 호출해야 합니다. 지정된 이름의 인수가 이미 제공된 경우 해당 값이 재정의됩니다.

매개변수
name String: 계측 번들 인수 이름
value String: 인수의 값

취소

public abstract void cancel ()

이 테스트 실행의 취소를 요청합니다.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

러너가 생성하는 테스트 범위의 유형을 반환합니다. CoverageOutput를 참조하세요.

반환 값
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

애플리케이션 패키지 이름을 반환합니다.

반환 값
String

getRunnerName

public abstract String getRunnerName ()

runnerName을 반환합니다.

반환 값
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

이전에 추가된 인수를 삭제합니다.

매개변수
name String: 삭제할 계측 번들 인수 이름

실행

public abstract void run (ITestRunListener... listeners)

이 테스트 실행을 실행합니다.

ERROR(/#run(Collection))의 편의 메서드입니다.

매개변수
listeners ITestRunListener: 테스트 결과를 수신 대기합니다.
생성 값
TimeoutException 연결 시간 초과 시
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
ShellCommandUnresponsiveException 기기가 출력하는 최대 시간보다 긴 기간 동안 테스트 결과를 출력하지 않은 경우
기기와의 연결이 끊어진 경우

실행

public abstract void run ( listeners)

이 테스트 실행을 실행합니다.

매개변수
listeners : 테스트 결과 리스너 모음
생성 값
TimeoutException 연결 시간 초과 시
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
ShellCommandUnresponsiveException 기기가 출력하는 최대 시간보다 긴 기간 동안 테스트 결과를 출력하지 않은 경우
기기와의 연결이 끊어진 경우

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

테스트 앱이 제거되기 전에 호스트에 복사할 추가 테스트 출력의 위치를 설정합니다. 예: 생성된 벤치마크 보고서

매개변수
additionalTestDataPath String

setClassName

public abstract void setClassName (String className)

이 클래스의 테스트만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

매개변수
className String: 정규화된 클래스 이름 (예: x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

제공된 클래스의 테스트만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

클래스를 두 개 이상 제공하는 경우 다중 클래스 인수 구문을 지원하는 InstrumentationTestRunner가 필요합니다.

매개변수
classNames String: 정규화된 클래스 이름 배열 (예: x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

이 테스트 실행의 코드 커버리지 모드를 설정합니다.

매개변수
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

생성된 범위 보고서의 위치를 설정합니다.

매개변수
reportPath String

setDebug

public abstract void setDebug (boolean debug)

이 테스트 실행의 디버그 모드를 설정합니다. true인 경우 Android 테스트 실행기는 디버거가 연결될 때까지 기다린 후 테스트 실행을 진행합니다.

매개변수
debug boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

이 테스트 실행을 로깅 전용 모드로 설정합니다. 테스트 실행을 건너뜁니다.

매개변수
logOnly boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

기기에서 테스트를 실행하는 셸 명령어가 출력되는 사이의 최대 허용 시간을 설정합니다.

이를 통해 테스트가 멈춰서 완료되지 않는 경우를 대비해 타임아웃을 설정할 수 있습니다. 이는 연결의 일반적인 시간 제한과는 다릅니다.

기본적으로 시간 제한은 지정되지 않습니다.

매개변수
maxTimeToOutputResponse long: 명령어가 응답을 출력하지 않아도 되는 최대 시간입니다. 값이 0이면 메서드가 명령 출력을 무한정 기다리며 (receiver가 실행을 취소할 때까지) 예외를 발생시키지 않습니다.
maxTimeUnits TimeUnit: 0이 아닌 maxTimeToOutputResponse 및 maxTimeout 값의 단위입니다.

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

계측이 완료되는 데 허용되는 최대 시간을 설정합니다.

이를 통해 테스트가 멈춰서 완료되지 않는 경우를 대비해 타임아웃을 설정할 수 있습니다. 이는 연결의 일반적인 시간 제한과는 다릅니다.

기본적으로 시간 제한은 지정되지 않습니다.

매개변수
maxTimeout long: 명령어가 응답을 출력하지 않아도 되는 최대 시간입니다. 값이 0이면 메서드가 명령 출력을 무한정 기다리며 (receiver가 실행을 취소할 때까지) 예외를 발생시키지 않습니다.
maxTimeUnits TimeUnit: 0이 아닌 maxTimeToOutputResponse 및 maxTimeout 값의 단위입니다.

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

이 메서드는 지원 중단되었습니다.
ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit))을 사용하세요.

매개변수
maxTimeToOutputResponse int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

지정된 테스트 메서드만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

매개변수
className String: 정규화된 클래스 이름 (예: x.y.z)
testName String: 메서드 이름

setRunName

public abstract void setRunName (String runName)

run()에서 ITestRunListener에 보고할 맞춤 실행 이름을 설정합니다.

지정하지 않으면 패키지 이름을 사용합니다.

setTestCollection

public abstract void setTestCollection (boolean collection)

이 테스트 실행을 테스트 수집 모드로 설정합니다. true인 경우 테스트 실행을 건너뛰고 테스트 수집에 필요한 모든 적절한 러너 인수를 설정합니다.

매개변수
collection boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

지정된 패키지에서 모든 테스트를 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

매개변수
packageName String: 정규화된 패키지 이름 (예: x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

지정된 크기의 테스트만 실행하도록 설정합니다. 'run' 전에 호출해야 합니다.

매개변수
size IRemoteAndroidTestRunner.TestSize: 실행할 TestSize입니다.