RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Android 테스트 명령어를 원격으로 실행하고 결과를 보고합니다.

요약

공개 생성자

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

대체 생성자입니다.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

대체 생성자입니다.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

원격 Android 테스트 실행기를 만듭니다.

공개 메서드

void addBooleanArg(String name, boolean value)

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

void addInstrumentationArg(String name, String value)

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

void cancel()

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

IInstrumentationResultParser createParser(String runName, listeners)

계측 출력을 파싱하는 데 사용될 InstrumentationResultParser를 만듭니다.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

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

String getRunOptions()

am instrument 명령어의 옵션을 반환합니다.

String getRunnerName()

runnerName을 반환합니다.

void removeInstrumentationArg(String name)

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

void run(ITestRunListener... listeners)

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

void run( listeners)

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

void setAdditionalTestOutputLocation(String additionalTestDataPath)

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

void setClassName(String className)

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

void setClassNames(String[] classNames)

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

void setCoverage(boolean coverage)

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

void setCoverageReportLocation(String reportPath)

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

void setDebug(boolean debug)

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

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

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

void setRunName(String runName)

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

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

void setRunOptions(String options)

am instrument 명령어의 옵션을 설정합니다.

void setTestCollection(boolean collect)

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

void setTestPackageName(String packageName)

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

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

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

보호된 메서드

String getArgsCommand()

제공된 계측 인수 전체의 계측 명령어 줄 문법을 반환합니다.

String getRunnerPath()

완전한 계측 구성요소 경로를 반환합니다.

공개 생성자

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

대체 생성자입니다. 기본 계측 실행기를 사용합니다.

매개변수
packageName String: 실행할 테스트가 포함된 Android 애플리케이션 패키지
remoteDevice IShellEnabledDevice: 테스트를 실행할 Android 기기

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

대체 생성자입니다. 기본 statusReporterMode를 사용합니다.

매개변수
packageName String: 실행할 테스트가 포함된 Android 애플리케이션 패키지
runnerName String: 실행할 계측 테스트 러너입니다. null인 경우 기본 러너를 사용합니다.
remoteDevice IShellEnabledDevice: 테스트를 실행할 Android 기기

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

원격 Android 테스트 실행기를 만듭니다.

매개변수
packageName String: 실행할 테스트가 포함된 Android 애플리케이션 패키지
runnerName String: 실행할 계측 테스트 러너입니다. null인 경우 기본 러너를 사용합니다.
remoteDevice IShellEnabledDevice: 테스트를 실행할 Android 기기
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: am instrument 명령어에 사용할 상태 리포터 모드

공개 메서드

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

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

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

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

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

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

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

취소

public void cancel ()

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

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

계측 출력을 파싱하는 데 사용될 InstrumentationResultParser을 만듭니다.

매개변수
runName String: 사용할 실행의 이름입니다.
listeners : 결과를 보고할 리스너입니다.
반환 값
IInstrumentationResultParser InstrumentationResultParser의 인스턴스입니다.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

반환 값
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

반환 값
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

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

반환 값
String

getRunOptions

public String getRunOptions ()

am instrument 명령어의 옵션을 반환합니다.

반환 값
String

getRunnerName

public String getRunnerName ()

runnerName을 반환합니다.

반환 값
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

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

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

실행

public void run (ITestRunListener... listeners)

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

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

매개변수
listeners ITestRunListener: 테스트 결과를 수신 대기합니다.
생성 값
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

실행

public void run ( listeners)

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

매개변수
listeners : 테스트 결과 리스너 모음
생성 값
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

매개변수
additionalTestDataPath String

setClassName

public void setClassName (String className)

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

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

setClassNames

public void setClassNames (String[] classNames)

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

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

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

setCoverage

public void setCoverage (boolean coverage)

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

매개변수
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

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

매개변수
reportPath String

setDebug

public void setDebug (boolean debug)

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

매개변수
debug boolean

setLogOnly

public void setLogOnly (boolean logOnly)

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

매개변수
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

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

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

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

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

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

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

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

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

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

매개변수
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

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

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

setRunName

public void setRunName (String runName)

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

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

setRunOptions

public void setRunOptions (String options)

am instrument 명령어의 옵션을 설정합니다. 옵션의 전체 목록은 com/android/commands/am/Am.java를 참고하세요.

매개변수
options String

setTestCollection

public void setTestCollection (boolean collect)

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

매개변수
collect boolean

setTestPackageName

public void setTestPackageName (String packageName)

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

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

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

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

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

보호된 메서드

getArgsCommand

protected String getArgsCommand ()

제공된 계측 인수 전체의 계측 명령어 줄 문법을 반환합니다. 인수가 지정되지 않은 경우 빈 문자열을 반환합니다.

반환 값
String

getRunnerPath

protected String getRunnerPath ()

완전한 계측 구성요소 경로를 반환합니다.

반환 값
String