2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.server.DeviceImpl

기기입니다. 실제 기기 또는 에뮬레이터일 수 있습니다.

요약

공개 생성자
`DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)`

공개 메서드
`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`	`executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` 기기에서 바인더 명령어를 실행하고 결과를 `receiver`에 전송합니다. 이는 기기 OS와 호스트 ADB 서버가 모두 Android 바인더 브리지 실행 기능을 지원하는 경우 exec:cmd 호출 또는 더 빠른 abb_exec:를 사용합니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` 기기에서 셸 명령어를 실행하고 결과를 `receiver`에 전송합니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` stdin을 통해 전송할 입력 스트림을 사용할 수 있는 executeShell 명령어 버전입니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` 기기에서 셸 명령어를 실행하고 결과를 `receiver`에 전송합니다. 이는 `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`을 호출하는 것과 유사합니다.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` 기기에서 셸 명령어를 실행하고 결과를 `receiver`에 전송합니다.
`void`	`forceStop(String applicationName)` 애플리케이션 이름으로 애플리케이션을 강제 종료합니다.
	`getAbis()` 이 기기에서 지원하는 ABI를 반환합니다.
`ListenableFuture<AvdData>`	`getAvdData()` 에뮬레이터가 실행 중인 AVD에 관한 정보를 반환합니다.
`String`	`getAvdName()` 에뮬레이터가 실행 중인 AVD의 이름을 반환합니다.
`String`	`getAvdPath()` 파일 시스템에서 가상 기기의 절대 경로를 반환합니다.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` 기기의 배터리 잔량을 0~100%로 반환합니다.
	`getBattery()` 기기의 배터리 잔량을 0~100%로 반환합니다.
`Integer`	`getBatteryLevel(long freshnessMs)` 기기의 배터리 잔량을 0~100%로 반환합니다.
`Integer`	`getBatteryLevel()` 기기의 배터리 잔량을 0~100%로 반환합니다.
`ClientImpl`	`getClient(String applicationName)` 애플리케이션 이름으로 `Client`을 반환합니다.
`String`	`getClientName(int pid)` pid로 클라이언트 이름을 반환하거나 pid를 알 수 없는 경우 `null`을 반환합니다.
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`getClients()` 클라이언트 배열을 반환합니다.
`int`	`getDensity()` 시스템 속성 `PROP_DEVICE_DENSITY`의 값을 읽어 기기 화면의 밀도 버킷을 반환합니다.
`FileListingService`	`getFileListingService()` 이 기기의 `FileListingService`를 반환합니다.
`String`	`getLanguage()` 사용자의 언어를 반환합니다.
`InstallMetrics`	`getLastInstallMetrics()` 이 기기의 가장 최근 설치에 관한 정보를 가져옵니다.
`String`	`getMountPoint(String name)` 마운트 지점을 반환합니다.
`String`	`getName()` 이 기기의 (사람이 읽을 수 있는) 이름을 반환합니다.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` 프로파일링 가능한 클라이언트의 배열을 반환합니다.
	`getProperties()` 캐시된 기기 속성을 반환합니다.
`String`	`getProperty(String name)` 매우 짧은 대기 시간으로 `IShellEnabledDevice.getSystemProperty(String)`를 통해 속성을 가져오려고 시도하고 예외를 처리하는 편의 메서드입니다.
`String`	`getPropertyCacheOrSync(String name)` 캐시에서 속성을 가져오려고 시도하는 `getProperty(String)` 및 `getPropertySync(String)`의 조합입니다.
`int`	`getPropertyCount()` 이 기기의 속성 수를 반환합니다.
`String`	`getPropertySync(String name)` 캐시를 사용하지 않고 기기에서 직접 지정된 속성을 가져오려고 시도하는 `getProperty(String)`의 변형입니다.
`String`	`getRegion()` 사용자의 지역을 반환합니다.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`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( apks, boolean reinstall, installOptions)` 기본 제한 시간으로 여러 APK 파일 (기본 패키지 1개와 분할 패키지 0~n개)로 구성된 Android 애플리케이션을 설치합니다.
`void`	`installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` 여러 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)` 기기의 임시 위치로 푸시된 애플리케이션 패키지를 설치합니다.
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions)` 기기에 로컬로 있는 여러 APK 파일로 구성된 Android 애플리케이션을 기본 제한 시간으로 설치합니다.
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` 기기에 로컬로 있는 여러 APK 파일로 구성된 Android 애플리케이션을 설치합니다.
`boolean`	`isBootLoader()` 기기가 부트로더 모드에 있는지 여부를 반환합니다.
`boolean`	`isEmulator()` 기기가 에뮬레이터인 경우 `true`을 반환합니다.
`boolean`	`isOffline()` 기기가 오프라인인지 여부를 반환합니다.
`boolean`	`isOnline()` 기기가 준비되었는지 여부를 반환합니다.
`boolean`	`isRoot()` 기기의 현재 루트 상태를 쿼리합니다.
`void`	`kill(String applicationName)` 애플리케이션 이름으로 애플리케이션을 종료합니다.
`void`	`pullFile(String remote, String local)` 단일 파일을 가져옵니다.
`void`	`push(String[] local, String remote)` 여러 파일 또는 디렉터리를 푸시합니다.
`void`	`pushFile(String local, String remote)` 단일 파일을 푸시합니다.
`SocketChannel`	`rawBinder(String service, String[] parameters)` 원격 기기에서 Android 바인더 브리지 서비스를 호출합니다.
`SocketChannel`	`rawExec(String executable, String[] parameters)` 원격 기기에서 host:exec 서비스를 호출합니다.
`void`	`reboot(String into)` 기기를 재부팅합니다.
`void`	`removeForward(int localPort)` 로컬 포트와 원격 포트 간의 포트 전달을 삭제합니다.
`void`	`removeRemotePackage(String remoteFilePath)` 기기에서 파일을 삭제합니다.
`void`	`removeReverse(int remotePort)` 원격 포트와 로컬 포트 간의 포트 반전을 삭제합니다.
`boolean`	`root()` adb 데몬이 기기에서 루트가 되도록 요청합니다.
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` 기기가 `IDevice.Feature.SCREEN_RECORD`를 지원하는 경우 기기에서 화면 녹화를 시작합니다.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` 이 기기가 지정된 하드웨어 기능을 지원하는지 여부를 반환합니다.
`boolean`	`supportsFeature(IDevice.Feature feature)` 이 기기가 지정된 소프트웨어 기능을 지원하는지 여부를 반환합니다.
`String`	`syncPackageToDevice(String localFilePath)` 기기에 파일을 푸시합니다.
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` 기기에서 앱을 제거합니다.
`String`	`uninstallPackage(String packageName)` 기기에서 패키지를 제거합니다.

공개 생성자

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

매개변수
`clientTracer`	`ClientTracker`
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

공개 메서드

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`

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

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

이는 기기 OS와 호스트 ADB 서버가 모두 Android 바인더 브리지 실행 기능을 지원하는 경우 exec:cmd 호출 또는 더 빠른 abb_exec:를 사용합니다.

매개변수
`parameters`	`String`: 실행할 바인더 명령어
`receiver`	`IShellOutputReceiver`: 바인더 명령어의 출력을 수신할 `IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`: stdin을 통해 전송할 선택적 입력 스트림

생성 값
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`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, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

stdin을 통해 전송할 입력 스트림을 사용할 수 있는 executeShell 명령어 버전입니다.

매개변수
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`

생성 값
`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)

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

forceStop

public void forceStop (String applicationName)

애플리케이션 이름으로 애플리케이션을 강제 종료합니다. 이렇게 하면 대기 중인 알람과 대기열에 추가된 계산이 모두 삭제됩니다.

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

getAbis

public  getAbis ()

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

반환 값
	ABI 목록입니다.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

에뮬레이터가 실행 중인 AVD에 관한 정보를 반환합니다.

AvdData.getName는 AVD의 이름이거나 AVD가 없는 경우 null입니다.

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

반환 값
`ListenableFuture<AvdData>`	기기의 `AvdData`입니다.

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)

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

getClient

public ClientImpl getClient (String applicationName)

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

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

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

getClientName

public String getClientName (int pid)

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

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

반환 값
`String`

getClientTracker

public ClientTracker getClientTracker ()

반환 값
`ClientTracker`

getClients

public ClientImpl[] getClients ()

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

반환 값
`ClientImpl[]`

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

반환 값
`FileListingService`

getLanguage

public String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

이 기기의 가장 최근 설치에 관한 정보를 가져옵니다.

반환 값
`InstallMetrics`	`InstallMetrics` 설치를 설명하는 측정항목

getMountPoint

public String getMountPoint (String name)

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

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

반환 값
`String`

getName

public String getName ()

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

반환 값
`String`

getNativeClients

public ClientImpl[] getNativeClients ()

반환 값
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

매개변수
`applicationName`	`String`

반환 값
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

프로파일링 가능한 클라이언트의 배열을 반환합니다.

반환 값
`ProfileableClientImpl[]`

getProperties

public  getProperties ()

캐시된 기기 속성을 반환합니다. '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) 및 getPropertySync(String)의 조합입니다. 찾을 수 없는 경우 동기식으로 기기를 직접 쿼리하고 성공하면 캐시를 다시 채우려고 시도합니다.

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

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

getPropertyCount

public int getPropertyCount ()

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

반환 값
`int`

getPropertySync

public String getPropertySync (String name)

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

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

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

getRegion

public String getRegion ()

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

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

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

반환 값
`String`

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 ( apks, 
                boolean reinstall, 
                 installOptions)

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

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

생성 값
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

매개변수
`apks`	: 설치할 APK 목록 (기본 APK 1개 + 분할 APK 0~n개)
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`installOptions`	: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.
`timeout`	`long`: 설치 시간 제한
`timeoutUnit`	`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`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

기기에 로컬로 있는 여러 APK 파일로 구성된 Android 애플리케이션을 기본 제한 시간으로 설치합니다.

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

생성 값
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

기기에 로컬로 있는 여러 APK 파일로 구성된 Android 애플리케이션을 설치합니다.

매개변수
`remoteApks`	: 설치할 기기에 있는 APK 파일 경로 목록
`reinstall`	`boolean`: 앱 재설치를 실행해야 하는 경우 `true`로 설정
`installOptions`	: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.
`timeout`	`long`: 설치 시간 제한
`timeoutUnit`	`TimeUnit`: 제한 시간 매개변수에 해당하는 `ERROR(/TimeUnit)`

생성 값
`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`

kill

public void kill (String applicationName)

애플리케이션 이름으로 애플리케이션을 종료합니다. 이렇게 하면 활동만 소멸되고 상태는 Android 시스템에만 남습니다.

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

pullFile

public void pullFile (String remote, 
                String local)

단일 파일을 가져옵니다.

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

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

push

public void push (String[] local, 
                String remote)

여러 파일 또는 디렉터리를 푸시합니다.

매개변수
`local`	`String`: 푸시할 로컬 파일
`remote`	`String`: 디렉터리를 나타내는 원격 경로

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

pushFile

public void pushFile (String local, 
                String remote)

단일 파일을 푸시합니다.

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

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

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

원격 기기에서 Android 바인더 브리지 서비스를 호출합니다. 기기 바인더 명령에 연결된 소켓 채널을 반환합니다.

SocketChannel의 소유권은 호출자에게 양도되므로 사용 후 명시적으로 닫아야 합니다.

매개변수
`service`	`String`: 연결할 Android 서비스의 이름
`parameters`	`String`: 바인더 명령어의 매개변수

반환 값
`SocketChannel`	기기에서 실행 중인 프로세스에 연결된 SocketChannel입니다. 사용 후 닫아야 합니다.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

원격 기기에서 host:exec 서비스를 호출합니다. 실행 중인 프로세스에 연결된 소켓 채널을 반환합니다. 실행 서비스는 stdout과 stderr을 구분하지 않으므로 소켓에서 읽은 내용은 두 출력에서 모두 가져올 수 있으며 인터리브될 수 있습니다.

SocketChannel의 소유권은 호출자에게 양도되므로 사용 후 명시적으로 닫아야 합니다.

매개변수
`executable`	`String`
`parameters`	`String`

반환 값
`SocketChannel`	기기에서 실행 중인 프로세스에 연결된 SocketChannel입니다. 사용 후 닫아야 합니다.

생성 값
`AdbCommandRejectedException`
`TimeoutException`

재부팅

public void reboot (String into)

기기를 재부팅합니다.

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

생성 값
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

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

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

생성 값
`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`

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 feature)

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

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

toString

public String toString ()

반환 값
`String`

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`