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

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

StubDevice

public class StubDevice
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.StubDevice

알려진 직접 서브클래스

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	빠른 부팅 모드의 기기 표현입니다.
NullDevice	`IDeviceSelection.nullDeviceRequested()`가 `true`일 때 할당하기 위해 `DeviceManager`에서 사용하는 자리표시자 `IDevice`
RemoteAvdIDevice	`DeviceSelectionOptions.gceDeviceRequested()`가 `true`일 때 할당하기 위해 `DeviceManager`에서 사용하는 자리표시자 `IDevice`
StubLocalAndroidVirtualDevice	`DeviceSelectionOptions.localVirtualDeviceRequested()`가 `true`일 때 할당하기 위해 `DeviceManager`에서 사용하는 자리표시자 `IDevice`
VmRemoteDevice	가상 머신 내부에서 관리할 원격 가상 기기입니다.

IDevice의 스텁 자리표시자 구현입니다.

요약

공개 생성자
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

공개 메서드
`boolean`	`arePropertiesSet()` 속성이 캐시된 경우 `true`를 반환합니다.
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` 로컬 TCP 포트와 원격 Unix 도메인 소켓 간에 포트 포워딩을 만듭니다.
`void`	`createForward(int localPort, int remotePort)` 로컬 포트와 원격 포트 간에 포트 포워딩을 만듭니다.
`void`	`createReverse(int remotePort, int localPort)` 원격 포트와 로컬 포트 간에 포트 반전을 만듭니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` 기기에서 셸 명령어를 실행하고 결과를 `receiver`에 전송합니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` 기기에서 셸 명령어를 실행하고 결과를 `receiver`에 전송합니다. 이는 `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`을 호출하는 것과 유사합니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` 이 메서드는 지원 중단되었습니다. `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`을 사용합니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` 기기에서 셸 명령어를 실행하고 결과를 `receiver`에 전송합니다.
	`getAbis()` 이 기기에서 지원하는 ABI를 반환합니다.
`String`	`getAvdName()` 에뮬레이터가 실행 중인 AVD의 이름을 반환합니다.
`String`	`getAvdPath()` 파일 시스템에서 가상 기기의 절대 경로를 반환합니다.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` 기기의 배터리 잔량을 0~100%로 반환합니다.
	`getBattery()` 기기의 배터리 잔량을 0~100%로 반환합니다.
`Integer`	`getBatteryLevel(long freshnessMs)` 이 메서드는 지원 중단되었습니다. 대신 `getBattery(long, TimeUnit)`를 사용하세요.
`Integer`	`getBatteryLevel()` 이 메서드는 지원 중단되었습니다. 대신 `getBattery()`를 사용하세요.
`Client`	`getClient(String applicationName)` 애플리케이션 이름으로 `Client`을 반환합니다.
`String`	`getClientName(int pid)` pid로 클라이언트 이름을 반환하거나 pid를 알 수 없는 경우 `null`을 반환합니다.
`Client[]`	`getClients()` 클라이언트 배열을 반환합니다.
`int`	`getDensity()` 시스템 속성 `PROP_DEVICE_DENSITY`의 값을 읽어 기기 화면의 밀도 버킷을 반환합니다.
`FileListingService`	`getFileListingService()` 이 기기의 `FileListingService`를 반환합니다.
`String`	`getLanguage()` 사용자의 언어를 반환합니다.
`String`	`getMountPoint(String name)` 마운트 지점을 반환합니다.
`String`	`getName()` 이 기기의 (사람이 읽을 수 있는) 이름을 반환합니다.
	`getProperties()` 이 메서드는 지원 중단되었습니다. 대신 `getSystemProperty(String)`를 사용하세요.
`String`	`getProperty(String name)` 매우 짧은 대기 시간으로 `IShellEnabledDevice.getSystemProperty(String)`를 통해 속성을 가져오려고 시도하고 예외를 처리하는 편의 메서드입니다.
`String`	`getPropertyCacheOrSync(String name)` 이 메서드는 지원 중단되었습니다. 대신 `getProperty(String)`를 사용하세요.
`int`	`getPropertyCount()` 이 메서드는 지원 중단되었습니다. ddmlib에서 '구현 세부정보'를 이유로 지원 중단되었습니다.
`String`	`getPropertySync(String name)` 이 메서드는 지원 중단되었습니다. 대신 `getProperty(String)`를 사용하세요.
`String`	`getRegion()` 사용자의 지역을 반환합니다.
`RawImage`	`getScreenshot()` 기기의 스크린샷을 찍어 `RawImage`로 반환합니다.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` 기기의 일련번호를 반환합니다.
`IDevice.DeviceState`	`getState()` 기기의 상태를 반환합니다.
`SyncService`	`getSyncService()` 기기에/기기에서 파일을 푸시/풀하는 `SyncService` 객체를 반환합니다.
`ListenableFuture<String>`	`getSystemProperty(String name)` 시스템 속성에 대해 잠재적인 비동기 쿼리를 실행합니다.
`boolean`	`hasClients()` `IDevice`에 `Client`이 있는지 여부를 반환합니다.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` 기기에 Android 애플리케이션을 설치합니다.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` 기기에 Android 애플리케이션을 설치합니다.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` 기기에 Android 애플리케이션을 설치합니다.
`void`	`installPackages( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` 여러 APK 파일 (기본 패키지 1개와 분할 패키지 0~n개)로 구성된 Android 애플리케이션을 설치합니다.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` 기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` 기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` 기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.
`boolean`	`isBootLoader()` 기기가 부트로더 모드에 있는지 여부를 반환합니다.
`boolean`	`isEmulator()` 기기가 에뮬레이터인 경우 `true`을 반환합니다.
`boolean`	`isOffline()` 기기가 오프라인인지 여부를 반환합니다.
`boolean`	`isOnline()` 기기가 준비되었는지 여부를 반환합니다.
`boolean`	`isRoot()` 기기의 현재 루트 상태를 쿼리합니다.
`void`	`pullFile(String remote, String local)` 단일 파일을 가져옵니다.
`void`	`pushFile(String local, String remote)` 단일 파일을 푸시합니다.
`void`	`reboot(String into)` 기기를 재부팅합니다.
`void`	`removeForward(int localPort)` 로컬 포트와 원격 포트 간의 포트 전달을 삭제합니다.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` 기기에서 파일을 삭제합니다.
`void`	`removeReverse(int remotePort)` 원격 포트와 로컬 포트 간의 포트 반전을 삭제합니다.
`boolean`	`root()` adb 데몬이 기기에서 루트가 되도록 요청합니다.
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` 기기가 `IDevice.Feature.SCREEN_RECORD`를 지원하는 경우 기기에서 화면 녹화를 시작합니다.
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` 이 기기가 지정된 하드웨어 기능을 지원하는지 여부를 반환합니다.
`boolean`	`supportsFeature(IDevice.Feature feature)` 이 기기가 지정된 소프트웨어 기능을 지원하는지 여부를 반환합니다.
`String`	`syncPackageToDevice(String localFilePath)` 기기에 파일을 푸시합니다.
`String`	`uninstallApp(String applicationID, String... extraArgs)` 기기에서 앱을 제거합니다.
`String`	`uninstallPackage(String packageName)` 기기에서 패키지를 제거합니다.

공개 생성자

StubDevice

public StubDevice (String serial)

매개변수
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

매개변수
`serial`	`String`
`isEmulator`	`boolean`

공개 메서드

arePropertiesSet

public boolean arePropertiesSet ()

속성이 캐시된 경우 true를 반환합니다.

반환 값
`boolean`

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

로컬 TCP 포트와 원격 Unix 도메인 소켓 간에 포트 포워딩을 만듭니다.

매개변수
`localPort`	`int`: 전달할 로컬 포트
`remoteSocketName`	`String`: 기기에서 생성된 Unix 도메인 소켓의 이름
`namespace`	`IDevice.DeviceUnixSocketNamespace`: 유닉스 도메인 소켓이 생성된 네임스페이스

생성 값
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

로컬 포트와 원격 포트 간에 포트 포워딩을 만듭니다.

매개변수
`localPort`	`int`: 전달할 로컬 포트
`remotePort`	`int`: 원격 포트입니다.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

원격 포트와 로컬 포트 간에 포트 반전을 만듭니다.

매개변수
`remotePort`	`int`: 반전할 원격 포트입니다.
`localPort`	`int`: 로컬 포트

생성 값
`AdbCommandRejectedException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

기기에서 셸 명령어를 실행하고 결과를 receiver에 전송합니다.

maxTimeToOutputResponse는 기기에서 명령어 출력을 예상할 때 최대 대기 시간으로 사용됩니다.
언제든지 셸 명령어가 maxTimeToOutputResponse보다 긴 기간 동안 아무것도 출력하지 않으면 메서드는 ShellCommandUnresponsiveException를 발생시킵니다.

로그 출력과 같은 명령어의 경우 메서드가 예외를 발생시키지 않고 수신자의 IShellOutputReceiver.isCancelled()가 true를 반환할 때까지 차단됨을 의미하는 maxTimeToOutputResponse 값 0을 사용해야 합니다.

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

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

기기에서 셸 명령어를 실행하고 결과를 receiver에 전송합니다.

이는 executeShellCommand(command, receiver, DdmPreferences.getTimeOut())을 호출하는 것과 유사합니다.

매개변수
`command`	`String`: 실행할 셸 명령어
`receiver`	`IShellOutputReceiver`: 셸 명령어의 출력을 수신할 `IShellOutputReceiver`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

이 메서드는 지원 중단되었습니다.
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)를 사용합니다.

매개변수
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

기기에서 셸 명령어를 실행하고 결과를 receiver에 전송합니다.

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

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getAbis

public  getAbis ()

이 기기에서 지원하는 ABI를 반환합니다. ABI는 선호하는 순서로 정렬되며 첫 번째 ABI가 가장 선호됩니다.

반환 값
	ABI 목록입니다.

getAvdName

public String getAvdName ()

에뮬레이터가 실행 중인 AVD의 이름을 반환합니다.

isEmulator()이 true를 반환하는 경우에만 유효합니다.

에뮬레이터가 AVD를 실행하고 있지 않으면 (예: Android 소스 트리 빌드에서 실행 중인 경우) 이 메서드는 '<build>'를 반환합니다.

참고: 제한 시간을 제어하려면 getAvdData()을 사용하는 것이 좋습니다.

반환 값
`String`	AVD의 이름 또는 AVD가 없는 경우 `null`

getAvdPath

public String getAvdPath ()

파일 시스템에서 가상 기기의 절대 경로를 반환합니다. 경로는 운영체제에 따라 다릅니다. Linux에서는 / 이름 구분자가 있고 Windows에서는 \ 구분자가 있습니다.

참고: 제한 시간을 제어하려면 getAvdData()을 사용하는 것이 좋습니다.

반환 값
`String`	AVD 경로입니다. 실제 기기이거나 에뮬레이터 콘솔 하위 명령이 실패했거나 에뮬레이터 버전이 30.0.18보다 오래된 경우 null입니다.

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

기기의 배터리 잔량을 0~100%로 반환합니다.

배터리 잔량이 캐시될 수 있습니다. 마지막으로 성공한 쿼리 이후 freshnessTime가 만료된 경우에만 기기에 배터리 잔량을 쿼리합니다.

매개변수
`freshnessTime`	`long`: 원하는 배터리 잔량의 최신성
`timeUnit`	`TimeUnit`: freshnessTime의 `ERROR(/TimeUnit)`

반환 값
	배터리 잔량을 쿼리하는 데 사용할 수 있는 `ERROR(/Future)` 배터리 수준을 가져올 수 없는 경우 Future는 `ERROR(/ExecutionException)`을 반환합니다.

getBattery

public  getBattery ()

기기의 배터리 잔량을 0~100%로 반환합니다.

배터리 잔량이 캐시될 수 있습니다. 마지막으로 성공한 쿼리 이후 5분이 지난 경우에만 기기의 배터리 잔량을 쿼리합니다.

반환 값
	배터리 잔량을 쿼리하는 데 사용할 수 있는 `ERROR(/Future)` 배터리 수준을 가져올 수 없는 경우 Future는 `ERROR(/ExecutionException)`을 반환합니다.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

이 메서드는 지원 중단되었습니다.
대신 getBattery(long, TimeUnit)를 사용하세요.

기기의 배터리 잔량을 0~100%로 반환합니다.

배터리 잔량이 캐시될 수 있습니다. 마지막으로 성공한 쿼리 이후 freshnessMsms가 경과한 경우에만 기기에 배터리 잔량을 쿼리합니다.

반환 값
`Integer`	배터리 잔량 또는 검색할 수 없는 경우 `null`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

이 메서드는 지원 중단되었습니다.
대신 getBattery()를 사용하세요.

기기의 배터리 잔량을 0~100%로 반환합니다.

배터리 잔량이 캐시될 수 있습니다. 마지막으로 성공한 쿼리 이후 5분이 지난 경우에만 기기의 배터리 잔량을 쿼리합니다.

반환 값
`Integer`	배터리 잔량 또는 검색할 수 없는 경우 `null`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public Client getClient (String applicationName)

애플리케이션 이름으로 Client을 반환합니다.

매개변수
`applicationName`	`String`: 애플리케이션의 이름

반환 값
`Client`	`Client` 객체 또는 일치하는 항목이 없는 경우 `null`

getClientName

public String getClientName (int pid)

pid로 클라이언트 이름을 반환하거나 pid를 알 수 없는 경우 null을 반환합니다.

매개변수
`pid`	`int`: 클라이언트의 pid입니다.

반환 값
`String`

getClients

public Client[] getClients ()

클라이언트 배열을 반환합니다.

반환 값
`Client[]`

getDensity

public int getDensity ()

시스템 속성 PROP_DEVICE_DENSITY의 값을 읽어 기기 화면의 밀도 버킷을 반환합니다.

반환 값
`int`	밀도입니다. 확인할 수 없는 경우 -1입니다.

getFileListingService

public FileListingService getFileListingService ()

이 기기의 FileListingService를 반환합니다.

반환 값
`FileListingService`

getLanguage

public String getLanguage ()

사용자의 언어를 반환합니다.

반환 값
`String`	사용자의 언어입니다. 알 수 없는 경우 null입니다.

getMountPoint

public String getMountPoint (String name)

마운트 지점을 반환합니다.

매개변수
`name`	`String`: 반환할 마운트 지점의 이름

반환 값
`String`

getName

public String getName ()

이 기기의 (사람이 읽을 수 있는) 이름을 반환합니다. 일반적으로 AVD의 경우 AVD 이름이고 기기의 경우 제조업체 이름, 모델 이름, 일련번호의 조합입니다.

반환 값
`String`

getProperties

public  getProperties ()

이 메서드는 지원 중단되었습니다.
대신 getSystemProperty(String)를 사용하세요.

캐시된 기기 속성을 반환합니다. 'getprop'의 전체 출력을 포함합니다.

반환 값

getProperty

public String getProperty (String name)

매우 짧은 대기 시간으로 IShellEnabledDevice.getSystemProperty(String)를 통해 속성을 가져오려고 시도하고 예외를 처리하는 편의 메서드입니다.

참고: 제한 시간을 제어하려면 IShellEnabledDevice.getSystemProperty(String)을 사용하는 것이 좋습니다.

매개변수
`name`	`String`: 반환할 값의 이름입니다.

반환 값
`String`	속성 값을 즉시 사용할 수 없는 경우 값 또는 `null`

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

이 메서드는 지원 중단되었습니다.
대신 getProperty(String)를 사용하세요.

캐시에서 속성을 가져오려고 시도하는 getProperty(String) 및 getPropertySync(String)의 조합입니다. 찾을 수 없는 경우 동기식으로 기기를 직접 쿼리하고 성공하면 캐시를 다시 채우려고 시도합니다.

매개변수
`name`	`String`: 반환할 값의 이름입니다.

반환 값
`String`	속성이 없는 경우 값 또는 `null`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

이 메서드는 지원 중단되었습니다.
이유가 '구현 세부정보'인 ddmlib에서 지원 중단됨

이 기기의 속성 수를 반환합니다.

반환 값
`int`

getPropertySync

public String getPropertySync (String name)

이 메서드는 지원 중단되었습니다.
대신 getProperty(String)를 사용하세요.

캐시를 사용하지 않고 기기에서 직접 지정된 속성을 가져오려고 시도하는 getProperty(String)의 변형입니다. 이 메서드는 휘발성 속성에만 사용해야 합니다.

매개변수
`name`	`String`: 반환할 값의 이름입니다.

반환 값
`String`	속성이 없는 경우 값 또는 `null`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getRegion

public String getRegion ()

사용자의 지역을 반환합니다.

반환 값
`String`	사용자의 지역입니다. 알 수 없는 경우 null입니다.

getScreenshot

public RawImage getScreenshot ()

기기의 스크린샷을 찍어 RawImage로 반환합니다.

반환 값
`RawImage`	문제가 발생한 경우 스크린샷을 `RawImage` 또는 `null`로 반환합니다.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

매개변수
`timeout`	`long`
`unit`	`TimeUnit`

반환 값
`RawImage`

생성 값
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

기기의 일련번호를 반환합니다.

반환 값
`String`

getState

public IDevice.DeviceState getState ()

기기의 상태를 반환합니다.

반환 값
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

기기에/기기에서 파일을 푸시/풀하는 SyncService 객체를 반환합니다.

반환 값
`SyncService`	SyncService를 만들 수 없는 경우 `null` `IDevice`이 유효하지 않거나 연결이 끊어져서 adb가 연결을 열지 않는 경우에 발생할 수 있습니다.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

시스템 속성에 대해 잠재적인 비동기 쿼리를 실행합니다.

매개변수
`name`	`String`: 반환할 값의 이름입니다.

반환 값
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)`이 null을 반환할 수 있습니다.

hasClients

public boolean hasClients ()

IDevice에 Client이 있는지 여부를 반환합니다.

반환 값
`boolean`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

기기에 Android 애플리케이션을 설치합니다. 이는 syncPackageToDevice, installRemotePackage, removePackage 단계를 결합하는 도우미 메서드입니다.

매개변수
`packageFilePath`	`String`: 설치할 로컬 호스트의 파일에 대한 절대 파일 시스템 경로
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`receiver`	`InstallReceiver`: 설치를 모니터링하고 최종 상태를 가져오는 데 사용할 `InstallReceiver`입니다.
`maxTimeout`	`long`: 명령어가 반환되는 최대 제한 시간입니다. 값이 0이면 최대 제한 시간이 적용되지 않습니다.
`maxTimeToOutputResponse`	`long`: 명령어가 응답을 출력하지 않아도 되는 최대 시간입니다. 값이 0이면 메서드가 명령 출력을 무한정 기다리며 (`receiver`가 실행을 취소할 때까지) 예외를 발생시키지 않습니다.
`maxTimeUnits`	`TimeUnit`: 0이 아닌 `maxTimeout` 및 `maxTimeToOutputResponse` 값의 단위입니다.
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

생성 값
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

기기에 Android 애플리케이션을 설치합니다. 이는 syncPackageToDevice, installRemotePackage, removePackage 단계를 결합하는 도우미 메서드입니다.

매개변수
`packageFilePath`	`String`: 설치할 로컬 호스트의 파일에 대한 절대 파일 시스템 경로
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`receiver`	`InstallReceiver`: 설치를 모니터링하고 최종 상태를 가져오는 데 사용할 `InstallReceiver`입니다.
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

생성 값
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

기기에 Android 애플리케이션을 설치합니다. 이는 syncPackageToDevice, installRemotePackage, removePackage 단계를 결합하는 도우미 메서드입니다.

매개변수
`packageFilePath`	`String`: 설치할 로컬 호스트의 파일에 대한 절대 파일 시스템 경로
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

생성 값
`InstallException`

installPackages

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

여러 APK 파일 (기본 패키지 1개와 분할 패키지 0~n개)로 구성된 Android 애플리케이션을 설치합니다.

매개변수
`apkFilePaths`	: 설치할 APK 목록 (기본 APK 1개 + 분할 APK 0~n개)
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`extraArgs`	: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.
`timeOutInMs`	`long`: 설치 시간 제한
`timeunit`	`TimeUnit`: 제한 시간 매개변수에 해당하는 `ERROR(/TimeUnit)`

생성 값
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.

매개변수
`remoteFilePath`	`String`: 기기의 패키지 파일 절대 파일 경로
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`receiver`	`InstallReceiver`: 설치를 모니터링하고 최종 상태를 가져오는 데 사용할 `InstallReceiver`입니다.
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

생성 값
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.

매개변수
`remoteFilePath`	`String`: 기기의 패키지 파일 절대 파일 경로
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

생성 값
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.

매개변수
`remoteFilePath`	`String`: 기기의 패키지 파일 절대 파일 경로
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`receiver`	`InstallReceiver`: 설치를 모니터링하고 최종 상태를 가져오는 데 사용할 `InstallReceiver`입니다.
`maxTimeout`	`long`: 명령어가 반환되는 최대 제한 시간입니다. 값이 0이면 최대 제한 시간이 적용되지 않습니다.
`maxTimeToOutputResponse`	`long`: 명령어가 응답을 출력하지 않아도 되는 최대 시간입니다. 값이 0이면 메서드가 명령 출력을 무한정 기다리며 (`receiver`가 실행을 취소할 때까지) 예외를 발생시키지 않습니다.
`maxTimeUnits`	`TimeUnit`: 0이 아닌 `maxTimeout` 및 `maxTimeToOutputResponse` 값의 단위입니다.
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

생성 값
`InstallException`

isBootLoader

public boolean isBootLoader ()

기기가 부트로더 모드에 있는지 여부를 반환합니다.

반환 값
`boolean`	`getState()`이 `DeviceState.BOOTLOADER`를 반환하는 경우`true`

isEmulator

public boolean isEmulator ()

기기가 에뮬레이터인 경우 true을 반환합니다.

반환 값
`boolean`

isOffline

public boolean isOffline ()

기기가 오프라인인지 여부를 반환합니다.

반환 값
`boolean`	`getState()`이 `DeviceState.OFFLINE`를 반환하는 경우`true`

isOnline

public boolean isOnline ()

기기가 준비되었는지 여부를 반환합니다.

반환 값
`boolean`	`getState()`이 `DeviceState.ONLINE`를 반환하는 경우`true`

isRoot

public boolean isRoot ()

기기의 현재 루트 상태를 쿼리합니다. 자세한 내용은 'adb root'를 참고하세요.

반환 값
`boolean`	adb 데몬이 루트로 실행 중이면 true, 그렇지 않으면 false입니다.

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

pullFile

public void pullFile (String remote, 
                String local)

단일 파일을 가져옵니다.

매개변수
`remote`	`String`: 원격 파일의 전체 경로
`local`	`String`: 로컬 대상입니다.

생성 값
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

단일 파일을 푸시합니다.

매개변수
`local`	`String`: 로컬 파일 경로입니다.
`remote`	`String`: 원격 파일 경로

생성 값
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

재부팅

public void reboot (String into)

기기를 재부팅합니다.

매개변수
`into`	`String`: 재부팅할 부트로더 이름입니다. 기기를 재부팅하려면 null을 사용하세요.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

로컬 포트와 원격 포트 간의 포트 전달을 삭제합니다.

매개변수
`localPort`	`int`: 전달할 로컬 포트

생성 값
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                int remotePort)

매개변수
`localPort`	`int`
`remotePort`	`int`

생성 값
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

매개변수
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

생성 값
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

기기에서 파일을 삭제합니다.

매개변수
`remoteFilePath`	`String`: 삭제할 파일의 기기 내 경로

생성 값
`InstallException`

removeReverse

public void removeReverse (int remotePort)

원격 포트와 로컬 포트 간의 포트 반전을 삭제합니다.

매개변수
`remotePort`	`int`: 원격 포트입니다.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

루트

public boolean root ()

adb 데몬이 기기에서 루트가 되도록 요청합니다. 이 작업은 자동으로 실패할 수 있으며 개발자 빌드에서만 성공할 수 있습니다. 자세한 내용은 'adb root'를 참고하세요.

반환 값
`boolean`	adb 데몬이 루트로 실행 중이면 true, 그렇지 않으면 false입니다.

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

setSerial

public void setSerial (String serial)

매개변수
`serial`	`String`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

기기가 IDevice.Feature.SCREEN_RECORD를 지원하는 경우 기기에서 화면 녹화를 시작합니다.

매개변수
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature arg0)

이 기기가 지정된 하드웨어 기능을 지원하는지 여부를 반환합니다.

매개변수
`arg0`	`IDevice.HardwareFeature`

반환 값
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

이 기기가 지정된 소프트웨어 기능을 지원하는지 여부를 반환합니다.

매개변수
`feature`	`IDevice.Feature`

반환 값
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

기기에 파일을 푸시합니다.

매개변수
`localFilePath`	`String`: 로컬 호스트의 파일 절대 경로

반환 값
`String`	파일의 기기 내 `String` 대상 경로

생성 값
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

기기에서 앱을 제거합니다.

매개변수
`applicationID`	`String`: 제거할 Android 애플리케이션 ID
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.

반환 값
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

기기에서 패키지를 제거합니다.

매개변수
`packageName`	`String`: 제거할 Android 애플리케이션 ID

반환 값
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`InstallException`