IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

요약

상수

int CHANGE_BUILD_INFO

기기 변경 비트 마스크: 빌드 정보 변경

int CHANGE_CLIENT_LIST

기기 변경 비트 마스크: Client 목록 변경

int CHANGE_PROFILEABLE_CLIENT_LIST

기기 변경 비트 마스크: ProfileableClient 목록 변경

int CHANGE_STATE

기기 변경 비트 마스크: DeviceState 변경

String FIRST_EMULATOR_SN

처음 연결된 에뮬레이터의 일련번호입니다.

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

이 상수는 지원 중단되었습니다. PROP_BUILD_API_LEVEL를 사용합니다.

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

에뮬레이터 일련번호 정규 표현식입니다.

String UNKNOWN_PACKAGE

공개 메서드

abstract boolean arePropertiesSet()

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

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

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

abstract void createForward(int localPort, int remotePort)

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

default void createReverse(int remotePort, int localPort)

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

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

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

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

default void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

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

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

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

default void forceStop(String applicationName)

애플리케이션 이름으로 애플리케이션을 강제 종료합니다.

abstract getAbis()

이 기기에서 지원하는 ABI를 반환합니다.

default ListenableFuture<AvdData> getAvdData()

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

abstract String getAvdName()

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

abstract String getAvdPath()

파일 시스템에서 가상 기기의 절대 경로를 반환합니다.

abstract getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

이 메서드는 지원 중단되었습니다. getBattery()를 사용합니다.

abstract Client getClient(String applicationName)

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

abstract String getClientName(int pid)

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

abstract Client[] getClients()

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

abstract int getDensity()

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

abstract FileListingService getFileListingService()

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

default getHardwareCharacteristics()

빌드 특성 속성을 읽어 가져온 기능을 반환합니다.

abstract String getLanguage()

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

default InstallMetrics getLastInstallMetrics()

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

abstract String getMountPoint(String name)

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

default ProfileableClient[] getProfileableClients()

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

abstract getProperties()

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

abstract String getProperty(String name)

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

abstract String getPropertyCacheOrSync(String name)

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

abstract int getPropertyCount()

이 메서드는 지원 중단되었습니다. 구현 세부정보

abstract String getPropertySync(String name)

이 메서드는 지원 중단되었습니다. IShellEnabledDevice.getSystemProperty(String)를 사용합니다.

abstract String getRegion()

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

abstract RawImage getScreenshot()

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

abstract RawImage getScreenshot(long timeout, TimeUnit unit)
abstract String getSerialNumber()

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

abstract IDevice.DeviceState getState()

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

abstract SyncService getSyncService()

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

abstract boolean hasClients()

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

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

기기에 Android 애플리케이션을 설치합니다.

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

기기에 Android 애플리케이션을 설치합니다.

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

기기에 Android 애플리케이션을 설치합니다.

default void installPackages( apks, boolean reinstall, installOptions)

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

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

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

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

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

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

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

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

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

default void installRemotePackages( remoteApks, boolean reinstall, installOptions)

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

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

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

abstract boolean isBootLoader()

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

abstract boolean isEmulator()

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

abstract boolean isOffline()

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

abstract boolean isOnline()

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

abstract boolean isRoot()

기기의 현재 루트 상태를 쿼리합니다.

default void kill(String applicationName)

애플리케이션 이름으로 애플리케이션을 종료합니다.

abstract void pullFile(String remote, String local)

단일 파일을 가져옵니다.

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

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

abstract void pushFile(String local, String remote)

단일 파일을 푸시합니다.

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

원격 기기에서 Android 바인더 브리지 서비스를 호출합니다.

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

원격 기기에서 host:exec 서비스를 호출합니다.

abstract void reboot(String into)

기기를 재부팅합니다.

default void removeForward(int localPort)

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

default void removeForward(int localPort, int remotePort)

이 메서드는 지원 중단되었습니다. removeForward(int) 사용

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

이 메서드는 지원 중단되었습니다. removeForward(int) 사용

abstract void removeRemotePackage(String remoteFilePath)

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

default void removeReverse(int remotePort)

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

abstract boolean root()

adb 데몬이 기기에서 루트가 되도록 요청합니다.

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

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

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature(IDevice.Feature feature)

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

abstract String syncPackageToDevice(String localFilePath)

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

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

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

abstract String uninstallPackage(String packageName)

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

상수

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

기기 변경 비트 마스크: 빌드 정보 변경

상수 값: 4 (0x00000004)

CHANGE_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

기기 변경 비트 마스크: Client 목록 변경

상수 값: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

기기 변경 비트 마스크: ProfileableClient 목록 변경

상수 값: 8 (0x00000008)

CHANGE_STATE

public static final int CHANGE_STATE

기기 변경 비트 마스크: DeviceState 변경

상수 값: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

처음 연결된 에뮬레이터의 일련번호입니다.

상수 값: 'emulator-5554'

MNT_DATA

public static final String MNT_DATA

상수 값: 'ANDROID_DATA'

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

상수 값: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

상수 값: 'ANDROID_ROOT'

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

상수 값: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

상수 값: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

상수 값: "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

상수 값: 'ro.build.tags'

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

상수 값: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

상수 값: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

이 상수는 지원 중단되었습니다.
PROP_BUILD_API_LEVEL을 사용하세요.

상수 값: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

상수 값: 'ro.debuggable'

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

상수 값: 'ro.product.cpu.abi'

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

상수 값: 'ro.product.cpu.abi2'

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

상수 값: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

상수 값: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

상수 값: 'qemu.sf.lcd_density'

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

상수 값: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

상수 값: 'ro.product.manufacturer'

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

상수 값: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

상수 값: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

에뮬레이터 일련번호 정규 표현식입니다.

상수 값: "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

상수 값: ''

공개 메서드

arePropertiesSet

public abstract boolean arePropertiesSet ()

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

반환 값
boolean

createForward

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

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

매개변수
localPort int: 전달할 로컬 포트
remoteSocketName String: 기기에서 생성된 Unix 도메인 소켓의 이름
namespace IDevice.DeviceUnixSocketNamespace: 유닉스 도메인 소켓이 생성된 네임스페이스
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

매개변수
localPort int: 전달할 로컬 포트
remotePort int: 원격 포트입니다.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

매개변수
remotePort int: 반전할 원격 포트입니다.
localPort int: 로컬 포트
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우

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을 통해 전송할 선택적 입력 스트림
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
ShellCommandUnresponsiveException 바인더 명령어가 지정된 시간 동안 출력을 전송하지 않는 경우
연결에 I/O 오류가 있는 경우

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 abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

매개변수
command String: 실행할 셸 명령어
receiver IShellOutputReceiver: 셸 명령어의 출력을 수신할 IShellOutputReceiver
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
ShellCommandUnresponsiveException 셸 명령어가 지정된 시간 동안 출력을 전송하지 않는 경우
연결에 I/O 오류가 있는 경우

executeShellCommand

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

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

매개변수
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

생성 값
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract  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 abstract String getAvdName ()

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

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

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

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

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

getAvdPath

public abstract String getAvdPath ()

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

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

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

getBattery

public abstract  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

매개변수
freshnessTime long: 원하는 배터리 잔량의 최신성
timeUnit TimeUnit: freshnessTime의 ERROR(/TimeUnit)
반환 값
배터리 잔량을 쿼리하는 데 사용할 수 있는 ERROR(/Future) 배터리 수준을 가져올 수 없는 경우 Future는 ERROR(/ExecutionException)을 반환합니다.

getBattery

public abstract  getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

이 메서드는 지원 중단되었습니다.
use getBattery(long, TimeUnit)

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

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

반환 값
Integer 배터리 잔량 또는 검색할 수 없는 경우 null
생성 값
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

이 메서드는 지원 중단되었습니다.
use getBattery()

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

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

반환 값
Integer 배터리 잔량 또는 검색할 수 없는 경우 null
생성 값
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getClient

public abstract Client getClient (String applicationName)

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

매개변수
applicationName String: 애플리케이션의 이름
반환 값
Client Client 객체 또는 일치하는 항목이 없는 경우 null

getClientName

public abstract String getClientName (int pid)

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

매개변수
pid int: 클라이언트의 pid입니다.
반환 값
String

getClients

public abstract Client[] getClients ()

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

반환 값
Client[]

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

반환 값
FileListingService

getHardwareCharacteristics

public  getHardwareCharacteristics ()

빌드 특성 속성을 읽어 가져온 기능을 반환합니다.

반환 값

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public abstract String getMountPoint (String name)

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

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

getProfileableClients

public ProfileableClient[] getProfileableClients ()

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

반환 값
ProfileableClient[]

getProperties

public abstract  getProperties ()

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

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

반환 값

getProperty

public abstract String getProperty (String name)

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

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

매개변수
name String: 반환할 값의 이름입니다.
반환 값
String 속성 값을 즉시 사용할 수 없는 경우 값 또는 null

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

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

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

매개변수
name String: 반환할 값의 이름입니다.
반환 값
String 속성이 없는 경우 값 또는 null
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
ShellCommandUnresponsiveException 셸 명령어가 지정된 시간 동안 출력을 전송하지 않는 경우
연결에 I/O 오류가 있는 경우

getPropertyCount

public abstract int getPropertyCount ()

이 메서드는 지원 중단되었습니다.
구현 세부정보

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

반환 값
int

getPropertySync

public abstract String getPropertySync (String name)

이 메서드는 지원 중단되었습니다.
use IShellEnabledDevice.getSystemProperty(String)

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

매개변수
name String: 반환할 값의 이름입니다.
반환 값
String 속성이 없는 경우 값 또는 null
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
ShellCommandUnresponsiveException 셸 명령어가 지정된 시간 동안 출력을 전송하지 않는 경우
연결에 I/O 오류가 있는 경우

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

반환 값
RawImage 문제가 발생한 경우 스크린샷을 RawImage 또는 null로 반환합니다.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

매개변수
timeout long

unit TimeUnit

반환 값
RawImage

생성 값
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

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

반환 값
String

getState

public abstract IDevice.DeviceState getState ()

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

반환 값
IDevice.DeviceState

getSyncService

public abstract SyncService getSyncService ()

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

반환 값
SyncService SyncService를 만들 수 없는 경우 null IDevice이 유효하지 않거나 연결이 끊어져서 adb가 연결을 열지 않는 경우에 발생할 수 있습니다.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
adb와의 연결이 실패한 경우

hasClients

public abstract boolean hasClients ()

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

반환 값
boolean

installPackage

public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 abstract void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

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

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

installRemotePackage

public abstract 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 abstract boolean isBootLoader ()

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

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

isEmulator

public abstract boolean isEmulator ()

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

반환 값
boolean

isOffline

public abstract boolean isOffline ()

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

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

isOnline

public abstract boolean isOnline ()

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

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

isRoot

public abstract boolean isRoot ()

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

반환 값
boolean adb 데몬이 루트로 실행 중이면 true, 그렇지 않으면 false입니다.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb가 명령어를 거부하는 경우
ShellCommandUnresponsiveException

kill

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

단일 파일을 가져옵니다.

매개변수
remote String: 원격 파일의 전체 경로
local String: 로컬 대상입니다.
생성 값
IO 예외가 발생한 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
TimeoutException 기기에서 응답을 읽는 동안 시간 초과가 발생한 경우
SyncException 동기화 예외가 발생한 경우

push

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

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

매개변수
local String: 푸시할 로컬 파일
remote String: 디렉터리를 나타내는 원격 경로
생성 값
연결에 I/O 오류가 있는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
TimeoutException 기기에서 응답을 읽는 동안 시간 초과가 발생한 경우
SyncException 일부 파일을 푸시할 수 없는 경우

pushFile

public abstract void pushFile (String local, 
                String remote)

단일 파일을 푸시합니다.

매개변수
local String: 로컬 파일 경로입니다.
remote String: 원격 파일 경로
생성 값
연결에 I/O 오류가 있는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
TimeoutException 기기에서 응답을 읽는 동안 시간 초과가 발생한 경우
SyncException 파일을 푸시할 수 없는 경우

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 abstract void reboot (String into)

기기를 재부팅합니다.

매개변수
into String: 재부팅할 부트로더 이름입니다. 기기를 재부팅하려면 null을 사용하세요.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
IOException

removeForward

public void removeForward (int localPort)

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

매개변수
localPort int: 전달할 로컬 포트
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우

removeForward

public void removeForward (int localPort, 
                int remotePort)

이 메서드는 지원 중단되었습니다.
removeForward(int) 사용

매개변수
localPort int

remotePort int

생성 값
AdbCommandRejectedException
TimeoutException

removeForward

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

이 메서드는 지원 중단되었습니다.
removeForward(int) 사용

매개변수
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

생성 값
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

매개변수
remoteFilePath String: 삭제할 파일의 기기 내 경로
생성 값
InstallException 설치가 실패하는 경우

removeReverse

public void removeReverse (int remotePort)

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

매개변수
remotePort int: 원격 포트입니다.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우

루트

public abstract boolean root ()

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

반환 값
boolean adb 데몬이 루트로 실행 중이면 true, 그렇지 않으면 false입니다.
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb가 명령어를 거부하는 경우
ShellCommandUnresponsiveException 루트 상태를 쿼리할 수 없는 경우
IOException

startScreenRecorder

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

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

매개변수
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

생성 값
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

supportsFeature

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

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

매개변수
feature IDevice.HardwareFeature

반환 값
boolean

supportsFeature

public abstract boolean supportsFeature (IDevice.Feature feature)

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

매개변수
feature IDevice.Feature

반환 값
boolean

syncPackageToDevice

public abstract String syncPackageToDevice (String localFilePath)

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

매개변수
localFilePath String: 로컬 호스트의 파일 절대 경로
반환 값
String 파일의 기기 내 String 대상 경로
생성 값
TimeoutException 연결 시간이 초과되는 경우
AdbCommandRejectedException adb에서 명령어를 거부하는 경우
연결에 I/O 오류가 있는 경우
SyncException 기기에 패키지를 푸시하는 중에 오류가 발생한 경우

uninstallApp

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

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

매개변수
applicationID String: 제거할 Android 애플리케이션 ID
extraArgs String: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm install --help'를 참고하세요.
반환 값
String 오류 코드가 있는 String 또는 성공 시 null
생성 값
InstallException 제거가 실패하는 경우

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

매개변수
packageName String: 제거할 Android 애플리케이션 ID
반환 값
String 오류 코드가 있는 String 또는 성공 시 null
생성 값
InstallException 제거가 실패하는 경우