2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

java.lang.Object
↳	com.android.tradefed.testtype.junit4.DeviceTestRunOptions

BaseHostJUnit4Test를 통한 기기 테스트 실행과 관련된 옵션을 위한 빌더 클래스입니다.

요약

공개 생성자
`DeviceTestRunOptions(String packageName)`

공개 메서드
`DeviceTestRunOptions`	`addExtraListener(ITestLifeCycleReceiver listener)` 실행 중인 계측에 리스너를 추가합니다.
`DeviceTestRunOptions`	`addInstrumentationArg(String key, String value)` 계측에 전달할 인수를 추가합니다.
`void`	`clearExtraListeners()`
`void`	`clearInstrumentationArgs()` 이전에 `addInstrumentationArg(String, String)`로 설정된 모든 계측 인수를 삭제합니다.
`String`	`getApkFileName()` APK 설치의 APK 파일 이름을 반환합니다.
`ITestDevice`	`getDevice()`
	`getExtraListeners()`
`String[]`	`getInstallArgs()` 설치 명령어의 추가 옵션을 반환합니다.
	`getInstrumentationArgs()`
`Long`	`getMaxInstrumentationTimeoutMs()`
`Long`	`getMaxTimeToOutputMs()`
`String`	`getPackageName()`
`String`	`getRunner()`
`String`	`getTestClassName()`
`String`	`getTestMethodName()`
`Long`	`getTestTimeoutMs()`
`Integer`	`getUserId()`
`boolean`	`isForceQueryable()` 설치할 APK를 쿼리할 수 있는지 여부입니다.
`boolean`	`isGrantPermission()` APK 설치 권한을 부여할지 여부입니다.
`boolean`	`isHiddenApiCheckDisabled()`
`boolean`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` APK 설치의 APK 파일 이름을 설정합니다.
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` 계측 실행 결과를 확인하고 실패가 발생하지 않았는지 확인해야 하는지 여부를 설정합니다.
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` 호스트 측에서 사용되는 'am 계측기'에 --no-hidden-api-checks를 추가할지 여부를 설정합니다.
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` 호스트 측에서 사용되는 'am 계측기'에 --no-isolated-storage를 추가할지 여부를 설정합니다.
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` 호스트 측에서 사용되는 'am 계측기'에 --no-restart를 추가할지 여부를 설정합니다.
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` 호스트 측에서 사용되는 'am 계측기'에 --no-test-api-access를 추가할지 여부를 설정합니다.
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` 호스트 측에서 사용되는 'am 계측기'에 --no-window-animation을 추가할지 여부를 설정합니다.
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` 설치할 APK를 쿼리할 수 없는 경우 `false`를 설정합니다.
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` APK 설치 권한을 부여합니다.
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` 설치 명령어의 추가 옵션을 설정합니다.
`DeviceTestRunOptions`	`setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)` 전체 계측을 실행하고 완료해야 하는 최대 시간 (밀리초)을 설정합니다.
`DeviceTestRunOptions`	`setMaxTimeToOutputMs(Long maxTimeToOutputMs)` 계측이 중지되기 전에 출력을 중지할 수 있는 최대 시간 (밀리초)을 설정합니다.
`DeviceTestRunOptions`	`setRunner(String runner)` 계측을 실행하는 데 사용해야 하는 계측 실행기를 설정합니다.
`DeviceTestRunOptions`	`setTestClassName(String testClassName)` 계측을 실행해야 하는 클래스 이름을 설정합니다.
`DeviceTestRunOptions`	`setTestMethodName(String testMethodName)` 계측이 실행해야 하는 메서드 이름을 설정합니다.
`DeviceTestRunOptions`	`setTestTimeoutMs(Long testTimeoutMs)` 테스트가 중단되기 전에 실행할 수 있는 최대 시간 (밀리초)을 설정합니다.
`DeviceTestRunOptions`	`setUserId(Integer userId)` 계측을 실행할 사용자 ID를 설정합니다.
`boolean`	`shouldCheckResults()`

공개 생성자

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

매개변수
`packageName`	`String`

공개 메서드

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

실행 중인 계측에 리스너를 추가합니다.

매개변수
`listener`	`ITestLifeCycleReceiver`

반환 값
`DeviceTestRunOptions`

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

계측에 전달할 인수를 추가합니다.

매개변수
`key`	`String`
`value`	`String`

반환 값
`DeviceTestRunOptions`

clearExtraListeners

public void clearExtraListeners ()

clearInstrumentationArgs

public void clearInstrumentationArgs ()

이전에 addInstrumentationArg(String, String)로 설정된 모든 계측 인수를 삭제합니다.

getApkFileName

public String getApkFileName ()

APK 설치의 APK 파일 이름을 반환합니다.

반환 값
`String`

getDevice

public ITestDevice getDevice ()

반환 값
`ITestDevice`

getExtraListeners

public  getExtraListeners ()

반환 값

getInstallArgs

public String[] getInstallArgs ()

설치 명령어의 추가 옵션을 반환합니다.

반환 값
`String[]`

getInstrumentationArgs

public  getInstrumentationArgs ()

반환 값

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

반환 값
`Long`

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

반환 값
`Long`

getPackageName

public String getPackageName ()

반환 값
`String`

getRunner

public String getRunner ()

반환 값
`String`

getTestClassName

public String getTestClassName ()

반환 값
`String`

getTestMethodName

public String getTestMethodName ()

반환 값
`String`

getTestTimeoutMs

public Long getTestTimeoutMs ()

반환 값
`Long`

getUserId

public Integer getUserId ()

반환 값
`Integer`

isForceQueryable

public boolean isForceQueryable ()

설치할 APK를 쿼리할 수 있는지 여부입니다. 기본값은 true입니다.

반환 값
`boolean`

isGrantPermission

public boolean isGrantPermission ()

APK 설치 권한을 부여할지 여부입니다.

반환 값
`boolean`

isHiddenApiCheckDisabled

public boolean isHiddenApiCheckDisabled ()

반환 값
`boolean`

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

반환 값
`boolean`

isRestartDisabled

public boolean isRestartDisabled ()

반환 값
`boolean`

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

반환 값
`boolean`

isWindowAnimationDisabled

public boolean isWindowAnimationDisabled ()

반환 값
`boolean`

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

APK 설치의 APK 파일 이름을 설정합니다.

매개변수
`apkFileName`	`String`

반환 값
`DeviceTestRunOptions`

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

계측 실행 결과를 확인하고 실패가 발생하지 않았는지 확인해야 하는지 여부를 설정합니다.

매개변수
`checkResults`	`boolean`

반환 값
`DeviceTestRunOptions`

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

매개변수
`device`	`ITestDevice`

반환 값
`DeviceTestRunOptions`

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

호스트 측에서 사용되는 'am 계측기'에 --no-hidden-api-checks를 추가할지 여부를 설정합니다.

매개변수
`disableHiddenApiCheck`	`boolean`

반환 값
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

호스트 측에서 사용되는 'am 계측기'에 --no-isolated-storage를 추가할지 여부를 설정합니다.

매개변수
`disableIsolatedStorage`	`boolean`

반환 값
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

호스트 측에서 사용되는 'am 계측기'에 --no-restart를 추가할지 여부를 설정합니다.

매개변수
`disableRestart`	`boolean`

반환 값
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

호스트 측에서 사용되는 'am 계측기'에 --no-test-api-access를 추가할지 여부를 설정합니다.

매개변수
`disableTestApiCheck`	`boolean`

반환 값
`DeviceTestRunOptions`

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

호스트 측에서 사용되는 'am 계측기'에 --no-window-animation을 추가할지 여부를 설정합니다.

매개변수
`disableWindowAnimation`	`boolean`

반환 값
`DeviceTestRunOptions`

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

설치할 APK를 쿼리할 수 없는 경우 false를 설정합니다.

매개변수
`forceQueryable`	`boolean`

반환 값
`DeviceTestRunOptions`

setGrantPermission

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

APK 설치 권한을 부여합니다.

매개변수
`grantPermission`	`boolean`

반환 값
`DeviceTestRunOptions`

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

설치 명령어의 추가 옵션을 설정합니다.

매개변수
`installArgs`	`String`

반환 값
`DeviceTestRunOptions`

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

전체 계측을 실행하고 완료해야 하는 최대 시간 (밀리초)을 설정합니다. 제한 시간이 없으면 0으로 설정하세요. 선택사항입니다.

매개변수
`maxInstrumentationTimeoutMs`	`Long`

반환 값
`DeviceTestRunOptions`

setMaxTimeToOutputMs

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

계측이 중지되기 전에 출력을 중지할 수 있는 최대 시간 (밀리초)을 설정합니다. 제한 시간이 없으면 0으로 설정하세요. 선택사항입니다.

매개변수
`maxTimeToOutputMs`	`Long`

반환 값
`DeviceTestRunOptions`

setRunner

public DeviceTestRunOptions setRunner (String runner)

계측을 실행하는 데 사용해야 하는 계측 실행기를 설정합니다. 기본 실행기는 'android.support.test.runner.AndroidJUnitRunner'입니다. 선택사항입니다.

매개변수
`runner`	`String`

반환 값
`DeviceTestRunOptions`

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

계측을 실행해야 하는 클래스 이름을 설정합니다. 계측은 클래스만 실행하도록 필터링됩니다. setTestMethodName(String)와 함께 사용할 수 있습니다. 선택사항입니다.

매개변수
`testClassName`	`String`

반환 값
`DeviceTestRunOptions`

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

계측이 실행해야 하는 메서드 이름을 설정합니다. 제대로 작동하려면 setTestClassName(String)를 설정해야 합니다. 선택사항입니다.

매개변수
`testMethodName`	`String`

반환 값
`DeviceTestRunOptions`

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

테스트가 중단되기 전에 실행할 수 있는 최대 시간 (밀리초)을 설정합니다. 제한 시간이 없으면 0으로 설정하세요. 선택사항입니다.

매개변수
`testTimeoutMs`	`Long`

반환 값
`DeviceTestRunOptions`

setUserId

public DeviceTestRunOptions setUserId (Integer userId)

계측을 실행할 사용자 ID를 설정합니다. 선택사항입니다.

매개변수
`userId`	`Integer`

반환 값
`DeviceTestRunOptions`

shouldCheckResults

public boolean shouldCheckResults ()

반환 값
`boolean`