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

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

DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

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

요약

중첩된 클래스
`class`	`DeviceManager.FastbootDevice` 빠른 부팅 모드(Fastboot mode)의 기기 표현

필드
`public static final String`	`UNKNOWN_DISPLAY_STRING` 알 수 없는 속성의 표시 문자열
`protected DeviceMonitorMultiplexer`	`mDvcMon`
`protected boolean`	`mFastbootEnabled`

공개 생성자
`DeviceManager()` DeviceManager는 `GlobalConfiguration`에서 가져와야 합니다.

공개 메서드
`void`	`addAvailableDevice(IDevice stubDevice)`
`void`	`addAvailableNativeDevice(IDevice stubDevice)`
`void`	`addDeviceMonitor(IDeviceMonitor mon)` `IDeviceMonitor` 추가
`void`	`addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)`
`void`	`addFastbootListener(IDeviceManager.IFastbootListener listener)` 리스너가 빠른 부팅 상태 변경에 관심이 있음을 관리자에게 알립니다.
`void`	`addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)` 빠른 부팅 모니터에 기기를 추가합니다.
`ITestDevice`	`allocateDevice(IDeviceSelection options, boolean isTemporary)` 특정 기준을 충족하는 테스트 기기를 요청합니다.
`ITestDevice`	`allocateDevice(IDeviceSelection options)` 특정 기준을 충족하는 테스트 기기를 요청합니다.
`ITestDevice`	`allocateDevice()` 테스트용 실제 기기 요청
`ITestDevice`	`connectToTcpDevice(String ipAndPort)` adb-over-tcp로 기기에 연결 이 메서드는 새 기기를 할당하며, 이는 결국 `disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)`를 통해 해제되어야 합니다. 반환된 `ITestDevice`는 온라인 상태이지만 응답하지 않을 수 있습니다.
`boolean`	`disconnectFromTcpDevice(ITestDevice tcpDevice)` adb-over-tcp 연결된 기기에서 연결 해제합니다.
`void`	`displayDevicesInfo(PrintWriter stream, boolean includeStub)` 알려진 기기 목록, 기기 상태, 일반적으로 사용되는 `IDeviceSelection` 옵션의 값이 포함된 사용자 친화적인 설명을 출력합니다.
`CommandResult`	`executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)` 사용 가능한 기기에서 셸 명령어를 실행하는 도우미 메서드입니다.
`String`	`executeGlobalAdbCommand(String... cmdArgs)` 특정 기기를 타겟팅하지 않는 adb 명령어를 실행합니다(예:
`ITestDevice`	`forceAllocateDevice(String serial)` 현재 사용할 수 없는 기기라도 무례하게 할당합니다.
`void`	`freeDevice(ITestDevice device, FreeDeviceState deviceState)` 풀에 기기 반품하기 이전에 할당되지 않은 기기를 반품하려고 하면 무시됩니다.
`String`	`getAdbPath()` 사용할 adb 바이너리의 경로를 반환합니다.
`String`	`getAdbVersion()` 기기 관리자가 현재 사용 중인 adb 버전을 가져옵니다.
`DeviceDescriptor`	`getDeviceDescriptor(String serial)` 지정된 일련번호가 있는 DeviceDescriptor를 반환합니다.
`String`	`getFastbootPath()` 사용할 빠른 부팅 바이너리의 경로를 반환합니다.
`void`	`init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)` 기기 관리자를 초기화합니다.
`void`	`init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)` 기기 관리자를 초기화합니다.
`void`	`init()` 기기 관리자를 초기화합니다.
`boolean`	`isEmulator(String serial)` 주어진 일련번호가 에뮬레이터를 나타내는지 확인
`boolean`	`isFileSystemMountCheckEnabled()` 파일 시스템이 올바르게 마운트되었는지 `NativeDeviceStateMonitor`에서 확인해야 하는지 여부를 반환합니다.
`boolean`	`isNullDevice(String serial)` 지정된 일련번호가 null 기기를 나타내는지 확인
`void`	`killEmulator(ITestDevice device)` 지정된 에뮬레이터를 종료합니다.
`void`	`launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)` 에뮬레이터를 실행하는 도우미 메서드입니다.
	`listAllDevices(boolean shortDescriptor)` 알려진 모든 기기의 DeviceDescriptor 목록을 반환합니다.
	`listAllDevices()` 알려진 모든 기기의 DeviceDescriptor 목록을 반환합니다.
`ITestDevice`	`reconnectDeviceToTcp(ITestDevice usbDevice)` 지정된 USB 기기를 adb-over-tcp 모드로 전환한 다음 `connectToTcpDevice(String)`를 통해 기기에 연결하는 도우미 메서드입니다.
`void`	`removeDeviceMonitor(IDeviceMonitor mon)` 이전에 추가된 `IDeviceMonitor`를 삭제합니다.
`void`	`removeFastbootListener(IDeviceManager.IFastbootListener listener)` 리스너가 더 이상 빠른 부팅 상태 변경에 관심이 없음을 관리자에게 알립니다.
`void`	`restartAdbBridge()` adb 브리지를 다시 시작합니다 (`stopAdbBridge()`가 호출된 경우). 서비스는 adb 연결에 종속됩니다.
`void`	`stopAdbBridge()` adb 브리지를 중지하고 adb 연결에 종속된 서비스를 중지합니다.
`void`	`terminate()` 기기 모니터링 서비스를 중지하고 ddm 라이브러리를 종료합니다.
`void`	`terminateDeviceMonitor()` 기기 모니터를 중지합니다.
`void`	`terminateDeviceRecovery()` 기기 복구 스레드를 중지합니다.
`void`	`terminateHard(String reason)` `terminateHard()`와 같습니다.
`void`	`terminateHard()` `terminate()`와 같지만 adb도 강제로 종료하려고 시도합니다.
`boolean`	`waitForFirstDeviceAdded(long timeout)` 첫 번째 물리적 기기가 연결될 때까지 기다립니다.

필드

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

알 수 없는 속성의 표시 문자열

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

공개 생성자

DeviceManager

public DeviceManager ()

DeviceManager는 GlobalConfiguration에서 가져와야 합니다.

공개 메서드

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

매개변수
`stubDevice`	`IDevice`

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

매개변수
`stubDevice`	`IDevice`

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

IDeviceMonitor 추가

매개변수
`mon`	`IDeviceMonitor`

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

매개변수
`fastbootDevice`	`DeviceManager.FastbootDevice`

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

리스너가 빠른 부팅 상태 변경에 관심이 있음을 관리자에게 알립니다.

현재 IDeviceManager는 활성 리스너가 하나 이상 있는 경우에만 빠른 부팅의 기기를 모니터링합니다.

TODO: 이 방법은 약간의 해킹입니다. 더 나은 해결책을 찾아보세요.

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

빠른 부팅 모니터에 기기를 추가합니다. 빠른 부팅 모니터는 'fastboot_serial'을 사용하여 기기와 통신합니다.

매개변수
`serial`	`String`: 기기의 일련번호입니다.
`fastboot_serial`	`String`: 기기의 빠른 부팅 모드 일련번호입니다.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

특정 기준을 충족하는 테스트 기기를 요청합니다.

매개변수
`options`	`IDeviceSelection`: 기기가 충족해야 하는 `IDeviceSelection`입니다.
`isTemporary`	`boolean`: 임시 NullDevice를 만들어야 하는지 여부입니다.

반환 값
`ITestDevice`	테스트용 `ITestDevice` 또는 사용할 수 없는 경우 `null`

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

특정 기준을 충족하는 테스트 기기를 요청합니다.

매개변수
`options`	`IDeviceSelection`: 기기가 충족해야 하는 `IDeviceSelection`입니다.

반환 값
`ITestDevice`	테스트용 `ITestDevice` 또는 사용할 수 없는 경우 `null`

allocateDevice

public ITestDevice allocateDevice ()

테스트용 실제 기기 요청

반환 값
`ITestDevice`	테스트용 `ITestDevice` 또는 사용할 수 없는 경우 `null`

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

adb-over-tcp로 기기에 연결

이 메서드는 새 기기를 할당하며, 이는 결국 disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)를 통해 해제되어야 합니다.

반환된 ITestDevice는 온라인 상태이지만 응답하지 않을 수 있습니다.

TCP 연결된 기기에서 재부팅과 같은 작업을 실행하면 기기에 대한 TCP 연결이 끊어지고 DeviceNotAvailableException가 발생합니다.

매개변수
`ipAndPort`	`String`: 연결하려는 기기의 원래 IP 주소 및 포트입니다.

반환 값
`ITestDevice`	tcp 연결을 형성할 수 없는 경우 `ITestDevice` 또는 `null`

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

adb-over-tcp 연결된 기기에서 연결 해제합니다.

기기를 USB 모드로 다시 전환하고 해제합니다.

매개변수
`tcpDevice`	`ITestDevice`: 현재 tcp 모드이며 이전에 `connectToTcpDevice(String)`를 통해 할당된 기기

반환 값
`boolean`	USB 모드로 전환에 성공한 경우 `true`

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

알려진 기기 목록, 기기 상태, 일반적으로 사용되는 IDeviceSelection 옵션의 값이 포함된 사용자 친화적인 설명을 출력합니다.

매개변수
`stream`	`PrintWriter`: 설명을 출력할 `ERROR(/PrintWriter)`입니다.
`includeStub`	`boolean`: 스텁 기기도 표시할지 여부입니다.

executeCmdOnAvailableDevice

public CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

사용 가능한 기기에서 셸 명령어를 실행하는 도우미 메서드입니다.

매개변수
`serial`	`String`: 기기 일련번호입니다.
`command`	`String`: 셸 명령어입니다.
`timeout`	`long`: 명령어가 완료되는 데 걸리는 시간입니다.
`timeUnit`	`TimeUnit`: 제한 시간의 단위입니다.

반환 값
`CommandResult`	`CommandResult` -

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

특정 기기를 타겟팅하지 않는 adb 명령어를 실행합니다(예: 'adb connect'

반환 값
`String`	명령어가 성공하면 std 출력, 그 외의 경우에는 null입니다.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

현재 사용할 수 없는 기기라도 무례하게 할당합니다.

기기가 이미 할당된 경우에는 영향을 미치지 않습니다.

매개변수
`serial`	`String`: 할당할 기기 일련번호입니다.

반환 값
`ITestDevice`	`ITestDevice` 또는 할당할 수 없는 경우 `null`

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

풀에 기기 반품하기

이전에 할당되지 않은 기기를 반품하려고 하면 무시됩니다.

매개변수
`device`	`ITestDevice`: 해제할 `ITestDevice`
`deviceState`	`FreeDeviceState`: `FreeDeviceState` 기기가 사용 가능한 기기 풀로 반환되는지 제어하는 데 사용됩니다.

getAdbPath

public String getAdbPath ()

사용할 adb 바이너리의 경로를 반환합니다.

반환 값
`String`

getAdbVersion

public String getAdbVersion ()

기기 관리자가 현재 사용 중인 adb 버전을 가져옵니다.

반환 값
`String`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

지정된 일련번호가 있는 DeviceDescriptor를 반환합니다.

매개변수
`serial`	`String`: 가져올 기기의 일련번호입니다.

반환 값
`DeviceDescriptor`	선택한 기기의 `DeviceDescriptor` 또는 일련번호가 알려진 기기와 일치하지 않는 경우 null입니다.

getFastbootPath

public String getFastbootPath ()

사용할 빠른 부팅 바이너리의 경로를 반환합니다.

반환 값
`String`

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors,

DeviceManager

요약

중첩된 클래스

필드

공개 생성자

공개 메서드

필드

UNKNOWN_DISPLAY_STRING

mDvcMon

mFastbootEnabled

공개 생성자

DeviceManager

공개 메서드

addAvailableDevice

addAvailableNativeDevice

addDeviceMonitor

addFastbootDevice

addFastbootListener

addMonitoringTcpFastbootDevice

allocateDevice

allocateDevice

allocateDevice

connectToTcpDevice

disconnectFromTcpDevice

displayDevicesInfo

executeCmdOnAvailableDevice

executeGlobalAdbCommand

forceAllocateDevice

freeDevice

getAdbPath

getAdbVersion

getDeviceDescriptor

getFastbootPath

init