NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object의 클래스
   ↳ com.android.tradefed.device.NativeDevice


풀 스택이 아닌 ITestDevice Android 기기의 기본 구현

요약

중첩된 클래스

class NativeDevice.AdbAction

OS 'adb ....' 명령어를 실행하기 위한 ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)입니다. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction): 기기 재부팅 

상수

int INVALID_USER_ID

잘못되거나 찾을 수 없는 사용자 ID에 대해 반환된 값: UserHandle이 -10000 값을 정의함

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

수행하려는 기본 명령어 재시도 횟수

필드

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

공개 생성자

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

TestDevice를 만듭니다.

공개 메서드

void batchPrefetchStartupBuildProps()

각 속성에 대해 'adb getprop'을 호출하는 대신 필요한 모든 속성을 미리 로드하여 마이크로 최적화 (약 400밀리초)

boolean canSwitchToHeadlessSystemUser()

헤드리스 시스템 사용자로 전환할 수 있는지 여부를 반환합니다.

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

최소 지원 수준에서 기능이 현재 지원되는지 여부를 확인합니다.

boolean checkConnectivity()

기기가 네트워크에 연결되어 있는지 확인합니다.

boolean clearErrorDialogs()

현재 기기 UI에 표시된 오류 대화상자를 닫습니다.

void clearLastConnectedWifiNetwork()

마지막으로 연결된 Wi-Fi 네트워크를 삭제합니다.

void clearLogcat()

누적된 logcat 데이터를 삭제합니다.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Wi-Fi 네트워크에 연결합니다.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Wi-Fi 네트워크에 연결합니다.

boolean connectToWifiNetwork( wifiSsidToPsk)

Wi-Fi 네트워크에 연결합니다.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)

Wi-Fi 네트워크에 연결합니다.

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)

기기가 현재 네트워크에 연결되어 있지 않은 경우에만 연결되는 connectToWifiNetwork(String, String)의 변형입니다.

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

기기가 현재 네트워크에 연결되어 있지 않은 경우에만 연결되는 connectToWifiNetwork(String, String)의 변형입니다.

int createUser(String name, boolean guest, boolean ephemeral)

지정된 이름과 제공된 플래그로 사용자 만들기

int createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)

지정된 이름과 제공된 플래그로 사용자 만들기

int createUser(String name)

지정된 이름과 기본 플래그 0으로 사용자를 만듭니다.

int createUserNoThrow(String name)

지정된 이름과 기본 플래그 0으로 사용자를 만듭니다.

void deleteFile(String deviceFilePath, int userId)

기기에서 파일 또는 디렉터리를 삭제하는 도우미 메서드입니다.

void deleteFile(String deviceFilePath)

기기에서 파일 또는 디렉터리를 삭제하는 도우미 메서드입니다.

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

등록된 IDeviceActionReceiver를 삭제합니다.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

현재 system_server를 이전 system_server ProcessInfo와 비교하여 기기가 조용히 다시 시작되었는지 확인하는 도우미 메서드입니다.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

기기 및 ERROR(/TimeUnit)의 에포크 이후 경과된 UTC 시간 이후 기기가 조용히 다시 시작되었는지 확인하는 도우미 메서드입니다.

boolean disableAdbRoot()

adb 루트를 사용 중지합니다.

void disableKeyguard()

키가드를 사용 중지하려고 시도합니다.

boolean disableNetworkMonitor()

기기에서 네트워크 모니터링을 사용 중지합니다.

boolean disconnectFromWifi()

Wi-Fi 네트워크 연결을 해제합니다.

boolean doesFileExist(String deviceFilePath, int userId)

기기의 파일이 특정 사용자에게 있는지 확인하는 도우미 메서드입니다.

boolean doesFileExist(String deviceFilePath)

기기에 파일이 있는지 확인하는 도우미 메서드입니다.

File dumpHeap(String process, String devicePath)

system_server에서 힙을 덤프하려고 시도합니다.

boolean enableAdbRoot()

adb 루트를 사용 설정합니다.

boolean enableNetworkMonitor()

기기에서 네트워크 모니터링을 사용 설정합니다.

String executeAdbCommand(long timeout, String... cmdArgs)

지정된 시간 제한으로 adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

String executeAdbCommand(long timeout, envMap, String... cmdArgs)

지정된 제한 시간으로 adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

String executeAdbCommand(String... cmdArgs)

adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

CommandResult executeFastbootCommand(String... cmdArgs)

기본 제한 시간 2분으로 빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

CommandResult executeFastbootCommand(long timeout, String... cmdArgs)

빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

CommandResult executeLongFastbootCommand(String... cmdArgs)

장기 실행 빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

시스템 환경 변수를 사용하여 시스템 명령어로 장기 실행 빠른 부팅 명령어를 실행하는 도우미 메서드입니다.

String executeShellCommand(String command)

adb 셸 명령어를 실행하고 출력을 String로 반환하는 도우미 메서드입니다.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

명령 동작을 제어하는 더 많은 매개변수와 함께 adb 셸 명령어를 실행합니다.

void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

명령어 동작을 제어하는 더 많은 매개변수를 사용하여 adb 셸 명령어를 실행합니다.

void executeShellCommand(String command, IShellOutputReceiver receiver)

주어진 adb 셸 명령어를 실행하고 명령어가 실패하면 여러 번 다시 시도합니다.

CommandResult executeShellV2Command(String cmd)

adb 셸 명령어를 실행하고 명령어 상태 출력, stdout, stderr로 올바르게 채워진 CommandResult로 결과를 반환하는 도우미 메서드입니다.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

adb 셸 명령어를 실행하고 명령어 상태 출력 및 stderr로 올바르게 채워진 CommandResult로 결과를 반환하는 도우미 메서드.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

adb 셸 명령어를 실행하고 명령어 상태 출력, stdout, stderr로 올바르게 채워진 CommandResult로 결과를 반환하는 도우미 메서드입니다.

CommandResult executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

명령어 동작을 제어하는 더 많은 매개변수를 사용하여 adb 셸 명령어를 실행합니다.

CommandResult executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

명령어 동작을 제어하는 더 많은 매개변수를 사용하여 adb 셸 명령어를 실행합니다.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

명령어 동작을 제어하는 더 많은 매개변수를 사용하여 adb 셸 명령어를 실행합니다.

CommandResult executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

명령 동작을 제어하는 더 많은 매개변수와 함께 adb 셸 명령어를 실행합니다.

CommandResult fastbootWipePartition(String partition)

기기의 파티션을 지우는 도우미 메서드입니다.

getActiveApexes()

기기에서 활성화된 APEX에 관한 정보를 가져옵니다.

getAllSettings(String namespace)

요청된 네임스페이스의 키-값 쌍을 반환합니다.

DeviceAllocationState getAllocationState()

기기의 현재 할당 상태 반환

String getAndroidId(int userId)

userId에 연결된 android-id를 찾아서 반환합니다. 찾을 수 없는 경우 null을 반환합니다.

getAndroidIds()

일치하는 사용자 ID를 찾은 Android ID 맵을 만듭니다.

int getApiLevel()

기기 API 수준을 가져옵니다.

PackageInfo getAppPackageInfo(String packageName)

기기에 설치된 패키지에 관한 정보를 가져옵니다.

getAppPackageInfos()

기기에 설치된 패키지의 정보를 가져옵니다.

String getBasebandVersion()

이 기기의 베이스밴드 (무선) 버전을 가져오는 편의 메서드입니다.

Integer getBattery()

기기의 현재 배터리 잔량을 반환하거나 배터리 잔량을 사용할 수 없는 경우 null을 반환합니다.

boolean getBooleanProperty(String name, boolean defaultValue)

지정된 속성의 불리언 값을 반환합니다.

getBootHistory()

도우미 메서드는 부팅 시간 및 부팅 이유가 포함된 부팅 기록 맵을 수집합니다.

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

도우미 메서드는 기기에서 지정된 에포크 이후 시간과 지정된 시간 단위 이후의 부팅 시간 및 부팅 이유가 포함된 부팅 기록 맵을 수집합니다.

String getBootloaderVersion()

이 기기의 부트로더 버전을 가져오는 편의 메서드입니다.

InputStreamSource getBugreport()

기기에서 버그 신고를 검색합니다.

InputStreamSource getBugreportz()

기기에서 bugreportz를 가져옵니다.

String getBuildAlias()

기기에서 현재 실행 중인 빌드의 별칭을 가져옵니다.

String getBuildFlavor()

기기의 빌드 버전을 가져옵니다.

String getBuildId()

기기에서 현재 실행 중인 빌드를 가져옵니다.

String getBuildSigningKeys()

기기 이미지에 서명하는 데 사용된 키 유형을 반환합니다.

일반적으로 Android 기기는 테스트 키 (예: AOSP) 또는 출시 키(개별 기기 제조업체에서 제어)로 서명될 수 있습니다.

DeviceDescriptor getCachedDeviceDescriptor()

기기가 할당된 경우 캐시된 DeviceDescriptor를 반환하고 그렇지 않으면 현재 DeviceDescriptor를 반환합니다.

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

기기가 할당되면 캐시된 DeviceDescriptor를 반환하고 그렇지 않으면 현재 DeviceDescriptor를 반환합니다.

String[] getChildren(String path)

권한으로 인해 가끔 작동하지 않는 IFileEntry 사용의 대안

AbstractConnection getConnection()

기기와 연결된 현재 연결입니다.

ContentProviderHandler getContentProvider(int userId)

ContentProviderHandler를 반환하거나 사용할 수 없는 경우 null을 반환합니다.

DeviceFoldableState getCurrentFoldableState()

기기의 현재 폴더블 상태를 반환하거나 문제가 발생한 경우 null을 반환합니다.

int getCurrentUser()

현재 실행 중인 사용자의 ID를 반환합니다.

String getDeviceClass()

기기 클래스를 가져옵니다.

long getDeviceDate()

에포크 이후 밀리초 단위로 기기의 날짜를 반환합니다.

DeviceDescriptor getDeviceDescriptor()

기기 정보에서 DeviceDescriptor를 반환하여 실제 기기 객체를 전달하지 않고 기기 정보를 가져옵니다.

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

기기 정보에서 DeviceDescriptor를 반환하여 실제 기기 객체를 전달하지 않고 기기 정보를 가져옵니다.

TestDeviceState getDeviceState()

기기의 상태를 가져옵니다.

long getDeviceTimeOffset(Date date)

기기와 지정된 ERROR(/Date) 간의 시차를 가져오는 도우미입니다.

InputStreamSource getEmulatorOutput()

에뮬레이터 stdout 및 stderr의 스트림 가져오기

Process getEmulatorProcess()

이 에뮬레이터에 해당하는 Process를 반환합니다.

final File getExecuteShellCommandLog()

모든 executeShellCommand(String) 로그가 포함된 로그

long getExternalStoreFreeSpace()

기기 외부 저장소의 여유 공간을 확인하는 도우미 메서드입니다.

String getFastbootPath()

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

String getFastbootProductType()

빠른 부팅 모드일 때 이 기기의 제품 유형을 가져오는 편의 메서드입니다.

String getFastbootProductVariant()

기기가 빠른 부팅 모드일 때 이 기기의 제품 유형을 가져오는 편의 메서드입니다.

String getFastbootSerialNumber()

빠른 부팅 모드 일련번호를 반환합니다.

String getFastbootVariable(String variableName)

기기에서 지정된 빠른 부팅 변수 값을 검색합니다.

String getFastbootVersion()

사용 중인 빠른 부팅 바이너리의 버전 문자열을 반환합니다.

IFileEntry getFileEntry(String path)

기기에서 원격 파일의 참조를 가져옵니다.

IFileEntry getFileEntry(FileListingService.FileEntry entry)

루트가 아닌 경로에서 FileEntry를 가져오는 비공식 도우미입니다.

getFoldableStates()

기기의 폴더블 상태 목록을 반환합니다.

IDevice getIDevice()

연결된 ddmlib IDevice에 대한 참조를 반환합니다.

getInstalledPackageNames()

기기에 있는 애플리케이션 패키지 이름을 가져옵니다.

long getIntProperty(String name, long defaultValue)

기기에서 지정된 속성의 정수 값을 반환합니다.

String getIpAddress()

기기의 IP 주소를 가져옵니다.

KeyguardControllerState getKeyguardState()

키가드의 현재 상태를 가져오는 객체를 반환하거나 지원되지 않는 경우 null을 반환합니다.

long getLastExpectedRebootTimeMillis()

System.currentTimeMillis()에 의해 반환된 EPOCH 이후 Tradefed API가 재부팅을 마지막으로 트리거한 시간(밀리초)을 반환합니다.

int getLaunchApiLevel()

기기가 처음 출시된 API 수준을 가져옵니다.

InputStreamSource getLogcat()

Logcat 데이터의 스냅샷 스트림을 가져옵니다.

InputStreamSource getLogcat(int maxBytes)

캡처된 logcat 데이터의 마지막 maxBytes개 스냅샷 스트림을 가져옵니다.

InputStreamSource getLogcatDump()

기기의 현재 logcat 덤프를 가져옵니다.

InputStreamSource getLogcatSince(long date)

제공된 날짜부터 캡처된 logcat 데이터의 스냅샷 스트림을 가져옵니다.

String getMacAddress()

기기의 MAC 주소를 반환합니다. 기기에서 쿼리하지 못하면 null을 반환합니다.

Integer getMainUserId()

기본 사용자 ID를 반환합니다.

getMainlineModuleInfo()

기기에 설치된 메인라인 모듈에 관한 정보를 가져옵니다.

int getMaxNumberOfRunningUsersSupported()

동시에 실행되는 최대 지원 사용자 수를 가져옵니다.

int getMaxNumberOfUsersSupported()

지원되는 최대 사용자 수를 가져옵니다.

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

기기와 연결된 IDeviceStateMonitor를 반환합니다.

String getMountPoint(String mountName)

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

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

지정된 마운트 포인트 경로에 해당하는 MountPointInfo를 반환하거나, 해당 경로에 마운트된 항목이 없거나 /proc/mounts에 마운트 포인트로 표시되지 않는 경우에는 null을 반환합니다.

getMountPointInfo()

기기의 /proc/mounts에 있는 정보를 파싱한 버전을 반환합니다.

TestDeviceOptions getOptions()

기기의 테스트 옵션을 가져옵니다.

long getPartitionFreeSpace(String partition)

기기 파티션의 여유 공간을 확인하는 도우미 메서드입니다.

Integer getPrimaryUserId()

기본 사용자 ID를 반환합니다.

ProcessInfo getProcessByName(String processName)

도우미 메서드는 'pidof' 및 'stat' 명령어를 실행하고 지정된 프로세스의 PID 및 프로세스 시작 시간이 포함된 ProcessInfo 객체를 반환합니다.

String getProcessPid(String process)

서비스의 PID를 반환하거나, 문제가 발생한 경우 null을 반환합니다.

String getProductType()

이 기기의 제품 유형을 가져오는 편의 메서드입니다.

String getProductVariant()

이 기기의 제품 옵션을 가져오는 편의 메서드입니다.

String getProperty(String name)

기기에서 지정된 속성 값을 검색합니다.

ITestDevice.RecoveryMode getRecoveryMode()

기기에 사용되는 현재 복구 모드를 가져옵니다.

InputStreamSource getScreenshot(long displayId)

디스플레이 ID가 지정된 기기에서 스크린샷을 가져옵니다.

InputStreamSource getScreenshot(String format)

기기에서 스크린샷을 캡처합니다.

InputStreamSource getScreenshot(String format, boolean rescale)

기기에서 스크린샷을 가져옵니다.

InputStreamSource getScreenshot()

기기에서 스크린샷을 캡처합니다.

String getSerialNumber()

이 기기의 일련번호를 가져오는 편리한 방법입니다.

String getSetting(int userId, String namespace, String key)

요청된 설정의 값을 반환합니다.

String getSetting(String namespace, String key)

getSetting(int, String, String)를 참고하고 시스템 사용자에게 실행됩니다.

String getSimOperator()

SIM 카드 사업자를 반환하거나, 사용할 수 없거나 기기를 사용할 수 없는 경우 null을 반환합니다.

String getSimState()

SIM 카드 상태를 반환하거나, 사용할 수 없거나 기기를 사용할 수 없는 경우 null을 반환합니다.

getTombstones()

기기에서 tombstone 목록을 가져와 반환합니다.

long getTotalMemory()

총 실제 메모리 크기(바이트)를 반환하거나 내부 오류가 발생하면 -1을 반환합니다.

String getTrackingSerial()

기기 관리 목적으로 기기를 추적하는 데 사용되는 일련번호를 가져옵니다.

getUninstallablePackageNames()

제거할 수 있는 애플리케이션 패키지 이름을 가져옵니다.

boolean getUseFastbootErase()

기기의 파티션을 삭제하는 데 빠른 부팅 삭제 또는 빠른 부팅 형식을 사용할지 여부를 가져옵니다.

int getUserFlags(int userId)

지정된 사용자의 신고를 찾아 반환합니다.

getUserInfos()

기기에서 useId와 UserInfo의 맵을 가져옵니다.

int getUserSerialNumber(int userId)

userId와 연결된 일련번호를 찾은 경우 반환하고, 그렇지 않은 경우에는 -10000을 반환합니다.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

지정된 DeviceEvent를 처리합니다.

이 기기를 새 할당 상태로 전환할 수도 있고 전환하지 않을 수도 있는 DeviceEvent를 처리합니다.

boolean hasFeature(String feature)

기기에서 기능을 사용할 수 있는지 확인합니다.

String installPackage(File packageFile, boolean reinstall, String... extraArgs)

기기에 Android 패키지를 설치합니다.

String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

기기에 Android 패키지를 설치합니다.

String installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

지정된 사용자의 기기에 Android 패키지를 설치합니다.

String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

지정된 사용자의 기기에 Android 패키지를 설치합니다.

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

기기의 플랫폼이 앱 열거를 지원하는지 확인

boolean isBypassLowTargetSdkBlockSupported()

기기의 플랫폼이 앱 설치 시 타겟이 낮은 SDK 차단 우회를 지원하는지 확인

boolean isDebugfsMounted()

debugfs가 마운트되어 있는지 확인합니다.

boolean isDeviceEncrypted()

기기가 암호화되었는지 여부를 반환합니다.

boolean isDirectory(String path)

기기 경로가 디렉터리인 경우 True를 반환하고 그렇지 않으면 false를 반환합니다.

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

기기에서 암호화가 지원되는지 여부를 반환합니다.

boolean isExecutable(String fullPath)

기기의 파일 경로가 실행 파일인 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

boolean isFastbootEnabled()

기기에서 빠른 부팅을 사용할 수 있는지 반환합니다.

boolean isHeadless()

기기가 헤드리스 (화면 없음)인 경우 true를 반환하고 그렇지 않으면 false를 반환합니다.

boolean isHeadlessSystemUserMode()

기기에서 헤드리스 시스템 사용자 모드를 사용하는지 여부를 반환합니다.

boolean isMainUserPermanentAdmin()

기본 사용자가 영구 관리자이며 삭제되거나 비관리자 상태로 다운그레이드될 수 없는지 여부를 반환합니다.

boolean isMultiUserSupported()

멀티 사용자를 지원하는지 확인합니다.

boolean isPackageInstalled(String packageName, String userId)

기기에서 지정된 패키지 이름과 지정된 사용자 ID를 쿼리하여 해당 사용자에게 현재 설치되어 있는지 확인합니다.

boolean isPackageInstalled(String packageName)

기기에 대해 지정된 패키지 이름을 쿼리하여 현재 설치되어 있는지 확인합니다.

boolean isRuntimePermissionSupported()

기기의 플랫폼이 런타임 권한 부여를 지원하는지 확인

boolean isStateBootloaderOrFastbootd()

기기가 TestDeviceState#FASTBOOT 또는 TestDeviceState.FASTBOOTD에 있으면 true를 반환합니다.

boolean isUserRunning(int userId)

특정 사용자가 실행 중인지 확인합니다.

boolean isUserSecondary(int userId)

지정된 사용자가 해당 플래그에 따라 보조 사용자인지 여부를 반환합니다.

boolean isUserVisible(int userId)

지정된 사용자가 표시되는지 확인합니다.

boolean isUserVisibleOnDisplay(int userId, int displayId)

지정된 사용자가 지정된 디스플레이에 표시되는지 확인합니다.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

기기가 사용자가 ERROR(/java.android.view.Display#DEFAULT_DISPLAY)에서 백그라운드에 표시되도록 시작할 수 있는지 여부를 반환합니다.

boolean isVisibleBackgroundUsersSupported()

기기에서 사용자가 백그라운드에서 표시되도록 시작할 수 있는지 여부를 반환합니다.

boolean isWifiEnabled()

Wi-Fi가 사용 설정되어 있는지 테스트합니다.

listDisplayIds()

'dumpsys SurfaceFlinger'에서 보고한 대로 기기에서 사용 가능한 디스플레이 ID 목록을 수집합니다.

listDisplayIdsForStartingVisibleBackgroundUsers()

start a user visible in the background에 사용할 수 있는 디스플레이 목록을 가져옵니다.

listUsers()

기기의 사용자 목록을 가져옵니다.

boolean logAnrs(ITestLogger logger)

기기에서 ANR을 수집하고 기록합니다.

boolean logBugreport(String dataName, ITestLogger listener)

버그 신고를 가져와 신고자에게 로깅하는 도우미 메서드입니다.

void logOnDevice(String tag, Log.LogLevel level, String format, Object... args)

기기의 Logcat에 메시지를 기록합니다.

void mountDebugfs()

debugfs를 마운트합니다.

void nonBlockingReboot()

기기를 재부팅하는 명령어를 실행하고 명령어 완료 시 및 기기가 더 이상 adb에 표시되지 않을 때 반환합니다.

void postAdbRootAction()

기기에서 adb root 후 기기가 다시 온라인 상태가 되기 전에 특정 작업을 실행해야 하는 경우 재정의합니다.

void postAdbUnrootAction()

adb 루트 해제 후 그리고 기기가 다시 온라인 상태가 되기 전에 기기에서 특정 작업을 실행해야 하는 경우 재정의합니다.

void postBootSetup()

모든 부팅 후 테스트를 위해 기기를 구성하는 안내를 실행합니다.

void postInvocationTearDown(Throwable exception)

호출이 완료된 후 실행되는 기기별 필수 정리에 관한 추가 단계입니다.

void preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)

호출 흐름 전에 기기에서 실행될 기기별 필수 설정을 위한 추가 단계입니다.

boolean pullDir(String deviceFilePath, File localDir, int userId)

기기에서 디렉터리 콘텐츠를 재귀적으로 가져옵니다.

boolean pullDir(String deviceFilePath, File localDir)

기기에서 디렉터리 콘텐츠를 재귀적으로 가져옵니다.

boolean pullFile(String remoteFilePath, File localFile)

기기에서 파일을 검색합니다.

File pullFile(String remoteFilePath, int userId)

기기에서 파일을 가져와 로컬 임시 ERROR(/File)에 저장하고 해당 File를 반환합니다.

File pullFile(String remoteFilePath)

기기에서 파일을 가져와 로컬 임시 ERROR(/File)에 저장하고 해당 File를 반환합니다.

boolean pullFile(String remoteFilePath, File localFile, int userId)

기기에서 파일을 검색합니다.

String pullFileContents(String remoteFilePath)

기기 외부에서 파일을 검색하고 콘텐츠를 반환합니다.

File pullFileFromExternal(String remoteFilePath)

기기의 외부 저장소에서 파일을 가져와 로컬 임시 ERROR(/File)에 저장하고 해당 File에 대한 참조를 반환하는 편의 메서드입니다.

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

필터링된 일부 디렉터리를 제외하면서 디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다.

boolean pushDir(File localFileDir, String deviceFilePath)

디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다.

boolean pushDir(File localFileDir, String deviceFilePath, int userId)

디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다.

boolean pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

선택적으로 콘텐츠 제공자의 필요성을 평가할 수 있는 pushFile(File, String)의 변형입니다.

boolean pushFile(File localFile, String remoteFilePath)

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

boolean pushFile(File localFile, String remoteFilePath, int userId)

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

boolean pushString(String contents, String remoteFilePath)

문자열로 생성된 파일을 기기에 푸시

void reboot(String reason)

재부팅 시 유지되도록 지정된 reason를 사용하여 기기를 adb 모드로 재부팅합니다.

void reboot()

기기를 adb 모드로 재부팅합니다.

void rebootIntoBootloader()

기기를 부트로더 모드로 재부팅합니다.

void rebootIntoFastbootd()

기기를 fastbootd 모드로 재부팅합니다.

void rebootIntoRecovery()

기기를 adb 복구 모드로 재부팅합니다.

void rebootIntoSideload()

기기를 adb 사이드로드 모드로 재부팅합니다 (복구 모드의 특수 모드입니다).

기기가 사이드로드 모드로 전환될 때까지 차단

void rebootIntoSideload(boolean autoReboot)

기기를 adb 사이드로드 모드로 재부팅합니다 (복구의 특수 모드임).

기기가 사이드로드 모드로 전환될 때까지 차단

void rebootUntilOnline()

기기가 온라인 상태가 될 때까지, 즉 adb에 표시될 때까지만 차단하는 reboot()의 대안입니다.

void rebootUntilOnline(String reason)

기기가 온라인 상태가 될 때까지(즉, adb에 표시될 때까지)만 차단하는 reboot()의 대체입니다.

void rebootUserspace()

기기의 사용자 공간 부분만 재부팅합니다.

void rebootUserspaceUntilOnline()

기기가 온라인 상태가 되어 adb에 표시될 때까지만 차단하는 rebootUserspace() ()}의 대안입니다.

boolean recoverDevice()

기기 통신 복구를 시도합니다.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

이 기기에 IDeviceActionReceiver를 등록합니다.

void remountSystemReadOnly()

기기의 시스템 파티션을 읽기 전용으로 설정합니다.

void remountSystemWritable()

기기의 시스템 파티션을 쓰기 가능하게 만듭니다.

void remountVendorReadOnly()

기기의 공급업체 파티션을 읽기 전용으로 만듭니다.

void remountVendorWritable()

기기의 공급업체 파티션을 쓰기 가능하게 만듭니다.

boolean removeAdmin(String componentName, int userId)

지정된 사용자의 기기 관리자를 삭제하고 성공하면 true를, 실패하면 false를 반환합니다.

void removeOwners()

최선을 다해 기존의 모든 기기 프로필 소유자를 삭제합니다.

boolean removeUser(int userId)

기기에서 특정 사용자를 삭제합니다.

void resetContentProviderSetup()

콘텐츠 제공업체 설정을 다시 트리거하려면 플래그를 재설정합니다.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

매개변수로 전달된 하나 이상의 리스너로 ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))를 실행하는 편의 메서드입니다.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

계측 테스트를 실행하고 기기 복구를 제공합니다.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))와 동일하지만 지정된 사용자에 대해 테스트를 실행합니다.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)와 동일하지만 지정된 사용자에 대해 테스트를 실행합니다.

void setConfiguration(IConfiguration configuration)

사용 중인 IConfiguration를 삽입합니다.

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

기기에 날짜 설정

참고: 기기에서 날짜를 설정하려면 루트 권한이 필요합니다.

boolean setDeviceOwner(String componentName, int userId)

특정 사용자의 기기 관리 구성요소를 기기 소유자로 설정합니다.

void setDeviceState(TestDeviceState deviceState)

기기의 상태를 업데이트합니다.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

에뮬레이터의 경우 SizeLimitedOutputStream를 로그 출력으로 설정합니다.

void setEmulatorProcess(Process p)

이 기기가 에뮬레이터인 경우 Process를 설정합니다.

void setFastbootEnabled(boolean fastbootEnabled)

기기의 빠른 부팅 옵션을 설정합니다.

void setFastbootPath(String fastbootPath)

사용해야 하는 빠른 부팅 바이너리의 경로를 설정합니다.

void setIDevice(IDevice newDevice)

이 ITestDevice와 연결된 IDevice를 업데이트합니다.

void setLogStartDelay(int delay)

온라인 기기의 logcat 캡처를 시작하기 전에 대기할 시간을 밀리초 단위로 설정합니다.

void setOptions(TestDeviceOptions options)

기기의 TestDeviceOptions를 설정합니다.

boolean setProperty(String propKey, String propValue)

기기에서 지정된 속성 값을 설정합니다.

void setRecovery(IDeviceRecovery recovery)

이 기기에 사용할 IDeviceRecovery를 설정합니다.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

기기에 사용할 현재 복구 모드를 설정합니다.

void setSetting(String namespace, String key, String value)

setSetting(int, String, String, String)를 참고하고 시스템 사용자에게 실행됩니다.

void setSetting(int userId, String namespace, String key, String value)

특정 사용자의 네임스페이스에 설정 값을 추가합니다.

void setTestLogger(ITestLogger testLogger)

ITestLogger 인스턴스를 삽입합니다.

void setTrackingSerial(String trackingSerial)

기기 관리 목적으로 기기를 참조하는 데 사용하는 일련번호를 추적합니다.

void setUseFastbootErase(boolean useFastbootErase)

빠른 부팅 삭제 또는 빠른 부팅 형식을 사용하여 기기의 파티션을 삭제할지 설정합니다.

void startLogcat()

백그라운드에서 기기의 logcat 출력 캡처를 시작합니다.

boolean startUser(int userId)

현재 중지된 경우 지정된 사용자를 백그라운드에서 시작합니다.

boolean startUser(int userId, boolean waitFlag)

현재 중지된 경우 백그라운드에서 지정된 사용자를 시작합니다.

boolean startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)

지정된 디스플레이에 표시되도록 백그라운드에서 지정된 사용자를 시작합니다 (즉, 사용자가 해당 디스플레이에서 활동을 실행할 수 있음).

void stopEmulatorOutput()

에뮬레이터 출력을 닫고 삭제합니다.

void stopLogcat()

기기에서 logcat 출력 캡처를 중지하고 현재 저장된 logcat 데이터를 삭제합니다.

boolean stopUser(int userId)

지정된 사용자를 중지합니다.

boolean stopUser(int userId, boolean waitFlag, boolean forceFlag)

지정된 사용자를 중지합니다.

String switchToAdbTcp()

기기를 adb-over-tcp 모드로 전환합니다.

boolean switchToAdbUsb()

기기를 USB를 통한 ADB 모드로 전환합니다.

boolean switchUser(int userId)

기본 시간 제한으로 다른 userId로 전환합니다.

boolean switchUser(int userId, long timeout)

제공된 제한 시간을 기한으로 다른 userId로 전환합니다.

boolean syncFiles(File localFileDir, String deviceFilePath)

로컬 파일 디렉터리의 콘텐츠를 기기에 점진적으로 동기화합니다.

Bugreport takeBugreport()

버그 신고를 가져와 처리하기 위해 Bugreport 객체 내에서 반환합니다.

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

지정된 사용자의 기기에서 Android 패키지를 제거합니다.

boolean unlockDevice()

기기가 암호화된 상태이면 기기를 잠금 해제합니다.

void unmountDebugfs()

debugfs를 마운트 해제합니다.

boolean waitForBootComplete(long timeOut)

기기의 부팅 완료 플래그가 설정될 때까지 차단합니다.

boolean waitForDeviceAvailable()

기기가 응답하고 테스트할 수 있을 때까지 기다립니다.

boolean waitForDeviceAvailable(long waitTime)

기기가 응답하고 테스트할 수 있을 때까지 기다립니다.

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

복구 경로를 고려하지 않고 기기가 응답하고 사용 가능해질 때까지 기다립니다.

void waitForDeviceBootloader()

빠른 부팅을 통해 기기가 표시될 때까지 차단합니다.

boolean waitForDeviceInRecovery(long waitTime)

기기가 'adb recovery' 상태에 있는 블록입니다 (IDeviceRecovery과 구분됨).

boolean waitForDeviceInSideload(long waitTime)

기기가 'adb 사이드로드' 상태가 되는 것을 차단합니다.

boolean waitForDeviceNotAvailable(long waitTime)

기기를 사용할 수 없도록 차단합니다(예: adb에서 누락됨).

void waitForDeviceOnline()

adb를 통해 기기가 표시될 때까지 차단됩니다.

void waitForDeviceOnline(long waitTime)

adb를 통해 기기가 표시될 때까지 차단합니다.

boolean waitForDeviceShell(long waitTime)

기기가 기본 adb 셸 명령어에 응답할 때까지 기다립니다.

보호된 메서드

void addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand(String command, boolean forceExitStatusDetection)

지정된 adb 셸 명령어 세션 및 인수의 OS 명령어를 빌드합니다.

void checkApiLevelAgainst(String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)

재부팅 작업을 실행할 때 사용할 RebootDeviceAction를 만듭니다.

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

adb 재부팅을 실행합니다.

void ensureRuntimePermissionSupported()

런타임 권한이 지원되지 않는 경우 예외를 발생시키는 도우미 메서드

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

사용할 RunUtil 인스턴스를 가져옵니다.

void initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
String internalGetProperty(String propName, String fastbootVar, String description)

기본적으로 ddmlib 캐시에서 기기 속성을 가져오고, 기기가 빠른 부팅 상태인지 여부에 따라 `adb shell getprop` 또는 `fastboot getvar` 로 대체합니다.

boolean isInRebootCallback()

재부팅 콜백이 현재 실행 중인지 여부를 반환합니다.

boolean isNewer(File localFile, IFileEntry entry)

로컬 파일이 원격 파일보다 최신인 경우 true를 반환합니다.

void notifyRebootEnded()

모든 IDeviceActionReceiver에 재부팅 종료 이벤트에 관해 알립니다.

void notifyRebootStarted()

모든 IDeviceActionReceiver에 재부팅 시작 이벤트에 관해 알립니다.

boolean performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

이 기기에서 작업을 실행합니다.

void postAdbReboot()

재부팅 후 취할 수 있는 추가 작업

void prePostBootSetup()

각 기기 유형 (AndroidNativeDevice, TestDevice)에서 특정 부팅 후 설정을 위해 이 메서드를 재정의하도록 허용합니다.

boolean pullFileInternal(String remoteFilePath, File localFile)
void setClock(Clock clock)

사용할 시계 인스턴스를 설정합니다.

void setMicrodroidProcess(Process process)

TestDevice를 microdroid로 표시하고 CID를 설정합니다.

void setTestDeviceOptions( deviceOptions)
CommandResult simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)

환경 변수를 사용하여 간단한 빠른 부팅 명령어를 실행하고 명령어의 상태를 보고합니다.

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

간단한 빠른 부팅 명령어를 실행하고 명령어의 상태를 보고합니다.

boolean waitForDeviceNotAvailable(String operationDesc, long time)

기기가 사용 불가 상태가 될 때까지 기다립니다 (adb에 보고 중지).

상수

INVALID_USER_ID

public static final int INVALID_USER_ID

잘못되거나 찾을 수 없는 사용자 ID에 대해 반환된 값: UserHandle이 -10000 값을 정의함

상수 값: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

상수 값: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

실행할 기본 명령어 재시도 횟수

상수 값: 2 (0x00000002)

필드

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

공개 생성자

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

TestDevice를 만듭니다.

매개변수
device IDevice: 연결된 IDevice

stateMonitor IDeviceStateMonitor: 사용할 IDeviceStateMonitor 메커니즘

allocationMonitor IDeviceMonitor: 할당 상태 변경을 알리는 IDeviceMonitor입니다. null일 수 있음

공개 메서드

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

각 속성에 대해 'adb getprop'을 호출하는 대신 필요한 모든 속성을 미리 로드하여 마이크로 최적화 (약 400밀리초)를 실행합니다. 즉, 하나의 속성을 가져오는 것만큼 모든 속성을 가져오는 속도도 빠릅니다. device.getApiLevel(), checkApiLevelAgainstNextRelease, getBuildAlias와 같은 항목은 모두 내부적으로 `adb getprop` 을 호출합니다. 한 번의 호출로 가져와 NativeDevice.setProperty를 호출합니다. 이렇게 하지 않더라도 NativeDevice는 자체적으로 setProperty를 호출하고 향후 호출을 위해 결과를 캐시합니다. 조금 더 일찍 업데이트하는 것입니다. 기기가 복구 중이거나 속성을 가져오는 중에 다른 오류가 발생하면 무시됩니다.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

헤드리스 시스템 사용자로 전환할 수 있는지 여부를 반환합니다.

반환 값
boolean

생성 값
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

최소 지원 수준을 고려하여 현재 기능이 지원되는지 확인합니다. 이 메서드는 API 수준이 올라가기 전에 아직 출시되지 않은 기능을 고려합니다.

매개변수
strictMinLevel int: 기능을 지원하는 가능한 최소 수준입니다.

반환 값
boolean 수준이 지원되는 경우 true입니다. 그렇지 않으면 false입니다.

생성 값
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

기기가 네트워크에 연결되어 있는지 확인합니다.

반환 값
boolean 기기에 작동하는 네트워크 연결이 있으면 true이고 그렇지 않으면 false입니다.

생성 값
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

현재 기기 UI에 표시된 오류 대화상자를 닫습니다.

반환 값
boolean 대화상자가 없거나 대화상자가 성공적으로 삭제된 경우 true 그 밖의 경우에는 false입니다.

생성 값
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

마지막으로 연결된 Wi-Fi 네트워크를 삭제합니다. 기기가 재부팅된 후 이전 테스트에서 사용된 Wi-Fi 네트워크에 연결하지 않으려면 새 호출을 시작할 때 이 메서드를 호출해야 합니다.

clearLogcat

public void clearLogcat ()

누적된 logcat 데이터를 삭제합니다.

이는 ITestDevice#getLogcat()가 특정 지점 (예: 새 기기 빌드 플래시 후) 이후에 생성된 로그 데이터만 반환하도록 하려는 경우에 유용합니다.

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Wi-Fi 네트워크에 연결

Wi-Fi를 사용 설정하고 wifiSsidToPsk 맵에 제공된 Wi-Fi 네트워크 중 하나와 성공적으로 연결될 때까지 차단합니다. 연결이 설정되면 인스턴스는 ITestDevice#disconnectFromWifi() 또는 ITestDevice#clearLastConnectedWifiNetwork()이 호출될 때까지 재부팅할 때마다 연결을 복원하려고 시도합니다.

매개변수
wifiSsidToPsk : Wi-Fi SSID와 비밀번호의 매핑입니다.

scanSsid boolean: 이 네트워크의 숨겨진 SSID를 스캔할지 여부입니다.

반환 값
boolean Wi-Fi 네트워크에 연결된 경우 true입니다. false 그 외의 경우

생성 값
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Wi-Fi 네트워크에 연결합니다.

Wi-Fi를 사용 설정하고 지정된 Wi-Fi 네트워크에 연결될 때까지 차단합니다. 연결되면 인스턴스는 ITestDevice#disconnectFromWifi() 또는 ITestDevice#clearLastConnectedWifiNetwork()가 호출될 때까지 재부팅할 때마다 연결 복원을 시도합니다.

매개변수
wifiSsid String: 연결할 Wi-Fi SSID

wifiPsk String: PSK 암호 또는 암호화되지 않은 경우 null

반환 값
boolean Wi-Fi 네트워크에 연결된 경우 true입니다. false 그 외의 경우

생성 값
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Wi-Fi 네트워크에 연결

Wi-Fi를 사용 설정하고 wifiSsidToPsk 맵에 제공된 Wi-Fi 네트워크 중 하나와 성공적으로 연결될 때까지 차단합니다. 연결되면 인스턴스는 ITestDevice#disconnectFromWifi() 또는 ITestDevice#clearLastConnectedWifiNetwork()가 호출될 때까지 재부팅할 때마다 연결 복원을 시도합니다.

매개변수
wifiSsidToPsk : Wi-Fi SSID와 비밀번호의 매핑입니다.

반환 값
boolean Wi-Fi 네트워크에 연결된 경우 true입니다. false 그 외의 경우

생성 값
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Wi-Fi 네트워크에 연결합니다.

Wi-Fi를 사용 설정하고 지정된 Wi-Fi 네트워크에 연결될 때까지 차단합니다. 연결이 설정되면 인스턴스는 ITestDevice#disconnectFromWifi() 또는 ITestDevice#clearLastConnectedWifiNetwork()이 호출될 때까지 매번 재부팅 후 연결을 복원하려고 시도합니다.

매개변수
wifiSsid String: 연결할 Wi-Fi SSID

wifiPsk String: PSK 암호 또는 암호화되지 않은 경우 null

scanSsid boolean: 이 네트워크의 숨겨진 SSID를 스캔할지 여부입니다.

반환 값
boolean Wi-Fi 네트워크에 연결된 경우 true입니다. false 그 외의 경우

생성 값
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

기기가 현재 네트워크에 연결되어 있지 않은 경우에만 연결되는 connectToWifiNetwork(String, String)의 변형입니다.

매개변수
scanSsid boolean: 이 네트워크의 숨겨진 SSID를 스캔할지 여부

반환 값
boolean Wi-Fi 네트워크에 연결된 경우 true입니다. false 그 외의 경우

생성 값
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

기기가 현재 네트워크에 연결되어 있지 않은 경우에만 연결되는 connectToWifiNetwork(String, String)의 변형입니다.

반환 값
boolean Wi-Fi 네트워크에 연결된 경우 true입니다. false 그 외의 경우

생성 값
DeviceNotAvailableException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

지정된 이름과 제공된 플래그로 사용자 만들기

매개변수
name String: 기기에서 만들 사용자

guest boolean: 생성 중에 사용자 플래그 --guest를 사용 설정합니다.

ephemeral boolean: 생성 중에 사용자 플래그 --ephemeral을 사용 설정합니다.

반환 값
int 생성된 사용자의 ID입니다.

생성 값
DeviceNotAvailableException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

지정된 이름과 제공된 플래그로 사용자 만들기

매개변수
name String: 기기에서 만들 사용자

guest boolean: 생성 중에 사용자 플래그 --guest를 사용 설정합니다.

ephemeral boolean: 생성 중에 사용자 플래그 --ephemeral을 사용 설정합니다.

forTesting boolean: 생성 중에 테스트 플래그 --for-testing을 사용 설정합니다.

반환 값
int 생성된 사용자의 ID입니다.

생성 값
DeviceNotAvailableException

createUser

public int createUser (String name)

지정된 이름과 기본 플래그 0으로 사용자를 만듭니다.

매개변수
name String: 기기에서 만들 사용자의 권한

반환 값
int 생성된 사용자 ID의 정수입니다.

생성 값
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

지정된 이름과 기본 플래그 0으로 사용자를 만듭니다.

매개변수
name String: 기기에서 만들 사용자의 권한

반환 값
int 생성된 사용자 ID의 정수 또는 오류의 경우 -1입니다.

생성 값
DeviceNotAvailableException

파일 삭제

public void deleteFile (String deviceFilePath, 
                int userId)

기기에서 파일 또는 디렉터리를 삭제하는 도우미 메서드입니다.

매개변수
deviceFilePath String: 기기의 파일 절대 경로입니다.

userId int: 삭제할 사용자 ID입니다.

생성 값
DeviceNotAvailableException

파일 삭제

public void deleteFile (String deviceFilePath)

기기에서 파일 또는 디렉터리를 삭제하는 도우미 메서드입니다.

매개변수
deviceFilePath String: 기기의 파일 절대 경로입니다.

생성 값
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

등록된 IDeviceActionReceiver를 삭제합니다.

매개변수
deviceActionReceiver IDeviceActionReceiver: 삭제할 IDeviceActionReceiver입니다.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

현재 system_server와 이전 system_server ProcessInfo를 비교하여 기기가 소프트 재시작되었는지 확인하는 도우미 메서드입니다. getProcessByName(String) 사용 시 ProcessInfo 받기

매개변수
prevSystemServerProcess ProcessInfo: 이전 system_server 프로세스 ProcessInfo입니다.

반환 값
boolean true: 기기가 조용히 다시 시작된 경우

생성 값
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

기기 및 ERROR(/TimeUnit)의 에포크 이후 경과된 UTC 시간 이후 기기가 조용히 다시 시작되었는지 확인하는 도우미 메서드입니다. 조용히 다시 시작은 기기 하드 재부팅 외부에서 다시 시작된 system_server를 의미합니다 (예: 요청된 재부팅). 현재 기기 utcEpochTime(밀리초)은 getDeviceDate() 메서드로 가져올 수 있습니다.

매개변수
utcEpochTime long: 에포크 이후 기기 시간(초)입니다.

timeUnit TimeUnit: 지정된 utcEpochTime의 시간 단위 TimeUnit입니다.

반환 값
boolean true: 기기가 조용히 다시 시작된 경우

생성 값
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

adb 루트를 사용 중지합니다.

adb root를 사용 중지하면 기기가 adb에서 연결 해제될 수 있습니다. 이 메서드는 기기를 사용할 수 있을 때까지 차단됩니다.

반환 값
boolean 성공한 경우 true

생성 값
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

키가드를 사용 중지하려고 시도합니다.

먼저 입력 전달이 준비될 때까지 기다립니다. 현재 프레임워크 구현에 간헐적인 경합 상태가 발생하므로 이는 기기가 비동기식으로 보이는 BOOT_COMPLETE를 보고하는 것과 거의 동시에 발생합니다. 그런 다음 키가드를 닫도록 명령어가 전송됩니다 (비보안 키에서만 작동함).

생성 값
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

기기에서 네트워크 모니터링을 사용 중지합니다.

반환 값
boolean true: 모니터링이 사용 중지된 경우 false입니다.

생성 값
DeviceNotAvailableException

disconnectFromWifi

public boolean disconnectFromWifi ()

Wi-Fi 네트워크 연결을 해제합니다.

알려진 네트워크 목록에서 모든 네트워크를 삭제하고 Wi-Fi를 사용 중지합니다.

반환 값
boolean true: Wi-Fi 네트워크에서 연결이 해제된 경우 false 연결 해제에 실패한 경우

생성 값
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

기기의 파일이 특정 사용자에게 있는지 확인하는 도우미 메서드입니다.

매개변수
deviceFilePath String: 확인할 기기의 파일의 절대 경로입니다.

userId int: 파일 존재 여부를 확인할 사용자 ID입니다.

반환 값
boolean 파일이 있는 경우 true이고, 그렇지 않으면 false입니다.

생성 값
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

기기에 파일이 있는지 확인하는 도우미 메서드입니다.

매개변수
deviceFilePath String: 확인할 기기의 파일의 절대 경로입니다.

반환 값
boolean 파일이 있는 경우 true이고, 그렇지 않으면 false입니다.

생성 값
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

system_server에서 힙을 덤프해 봅니다. 덤프된 파일을 정리하는 것은 호출자의 책임입니다.

매개변수
process String: 덤프할 기기 프로세스의 이름입니다.

devicePath String: 기기에서 덤프를 저장할 경로입니다. 권한이 허용하는 위치여야 합니다.

반환 값
File 보고서가 포함된 ERROR(/File) 실패한 경우 null입니다.

생성 값
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

adb 루트를 사용 설정합니다. 'enable-root' 설정이 'false'인 경우 메시지를 로깅하고 루트를 사용 설정하지 않고 반환합니다.

adb root를 사용 설정하면 기기가 adb에서 연결 해제될 수 있습니다. 이 메서드는 기기를 사용할 수 있을 때까지 차단합니다.

반환 값
boolean 성공한 경우 true

생성 값
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

기기에서 네트워크 모니터링을 사용 설정합니다.

반환 값
boolean 모니터링이 성공적으로 사용 설정된 경우 true입니다. 실패한 경우 false

생성 값
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

지정된 시간 제한으로 adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

executeShellCommand(String)는 실패 감지 및 성능이 더 우수하므로 가능하면 대신 사용해야 합니다.

매개변수
timeout long: 기기가 응답하지 않는 것으로 간주되기까지의 시간(밀리초 단위, 제한 시간 없음의 경우 0L)

cmdArgs String: 실행할 adb 명령어 및 인수입니다.

반환 값
String 명령어의 stdout을 가져옵니다. 명령어 실행에 실패한 경우 null입니다.

생성 값
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

지정된 시간 제한으로 adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

executeShellCommand(String)는 실패 감지 및 성능이 더 우수하므로 가능하면 대신 사용해야 합니다.

매개변수
timeout long: 기기가 응답하지 않는 것으로 간주되기까지의 시간(밀리초 단위, 제한 시간 없음의 경우 0L)

envMap : 명령어에 설정할 환경

cmdArgs String: 실행할 adb 명령어 및 인수입니다.

반환 값
String 명령어의 stdout을 가져옵니다. 명령어 실행에 실패한 경우 null입니다.

생성 값
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

executeShellCommand(String)는 실패 감지 및 성능이 더 우수하므로 가능하면 대신 사용해야 합니다.

매개변수
cmdArgs String: 실행할 adb 명령어 및 인수입니다.

반환 값
String 명령어의 stdout을 가져옵니다. 명령어 실행에 실패한 경우 null입니다.

생성 값
DeviceNotAvailableException

runFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

기본 제한 시간 2분으로 빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

기기가 이미 빠른 부팅 모드일 때 사용될 것으로 예상됩니다.

매개변수
cmdArgs String: 실행할 빠른 부팅 명령어 및 인수입니다.

반환 값
CommandResult 명령어 출력이 포함된 CommandResult

생성 값
DeviceNotAvailableException

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

기기가 이미 빠른 부팅 모드일 때 사용될 것으로 예상됩니다.

매개변수
timeout long: 명령어가 만료되기까지의 시간(밀리초)

cmdArgs String: 실행할 빠른 부팅 명령어 및 인수

반환 값
CommandResult 명령어 출력이 포함된 CommandResult

생성 값
DeviceNotAvailableException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

장시간 실행되는 빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다.

더 긴 시간 제한을 사용하는 것을 제외하고 executeFastbootCommand(String)와 동일합니다.

매개변수
cmdArgs String: 실행할 빠른 부팅 명령어 및 인수입니다.

반환 값
CommandResult 명령어 출력이 포함된 CommandResult

생성 값
DeviceNotAvailableException

runLongFastbootCommand를 실행합니다.

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

시스템 환경 변수를 사용하여 시스템 명령어로 장기 실행 빠른 부팅 명령어를 실행하는 도우미 메서드입니다.

더 긴 시간 제한을 사용하는 것을 제외하고 executeFastbootCommand(String)와 동일합니다.

매개변수
envVarMap : 빠른 부팅 명령어가 실행되는 시스템 환경 변수

cmdArgs String: 실행할 빠른 부팅 명령어 및 인수

반환 값
CommandResult 명령어 출력이 포함된 CommandResult

생성 값
DeviceNotAvailableException

runShellCommand

public String executeShellCommand (String command)

adb 셸 명령어를 실행하고 출력을 String로 반환하는 도우미 메서드입니다.

매개변수
command String: 실행할 adb 셸 명령어입니다.

반환 값
String 셸 출력

생성 값
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

명령어 동작을 제어하는 더 많은 매개변수를 사용하여 adb 셸 명령어를 실행합니다.

매개변수
command String: 실행할 adb 셸 명령어입니다.

receiver IShellOutputReceiver: 셸 출력을 전달할 IShellOutputReceiver입니다.

maxTimeToOutputShellResponse long: 명령어가 응답을 출력하지 않을 수 있는 최대 시간입니다. 단위는 timeUnit에 지정된 대로 합니다.

timeUnit TimeUnit: maxTimeToOutputShellResponse의 단위

retryAttempts int: 예외로 인해 실패한 경우 명령어를 다시 시도할 최대 횟수입니다. retryAttempts가 성공적으로 실행되지 않으면 DeviceNotResponsiveException이 발생합니다.

생성 값
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

명령어 동작을 제어하는 더 많은 매개변수를 사용하여 adb 셸 명령어를 실행합니다.

매개변수
command String: 실행할 adb 셸 명령어입니다.

receiver IShellOutputReceiver: 셸 출력을 전달할 IShellOutputReceiver입니다.

maxTimeoutForCommand long: 명령어가 완료될 때까지의 최대 제한 시간입니다. 단위는 timeUnit에 지정된 대로입니다.

maxTimeToOutputShellResponse long: 명령어가 응답을 출력할 수 없는 최대 시간. timeUnit에 지정된 단위입니다.

timeUnit TimeUnit: maxTimeToOutputShellResponse의 단위

retryAttempts int: 예외로 인해 실패한 경우 명령어를 다시 시도할 최대 횟수입니다. retryAttempts가 실패로 실행되면 DeviceNotResponsiveException이 발생합니다.

생성 값
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

주어진 adb 셸 명령어를 실행하고 명령어가 실패하면 여러 번 다시 시도합니다.

기본값이 있는 더 간단한 형태의 executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)입니다.

매개변수
command String: 실행할 adb 셸 명령어

receiver IShellOutputReceiver: 셸 출력을 전달할 IShellOutputReceiver입니다.

생성 값
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

adb 셸 명령어를 실행하고 명령어 상태 출력, stdout, stderr로 올바르게 채워진 CommandResult로 결과를 반환하는 도우미 메서드입니다.

매개변수
cmd String: 실행해야 하는 명령어입니다.

반환 값
CommandResult CommandResult의 결과입니다.

생성 값
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

adb 셸 명령어를 실행하고 명령어 상태 출력으로 올바르게 채워진 CommandResult로 결과를 반환하는 도우미 메서드. stdout은 지정된 스트림으로 전달됩니다.

매개변수
cmd String: 실행해야 하는 명령어입니다.

pipeToOutput OutputStream: std 출력이 리디렉션되는 ERROR(/OutputStream) 또는 null입니다.

반환 값
CommandResult CommandResult의 결과입니다.

생성 값
DeviceNotAvailableException

launchShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

adb 셸 명령어를 실행하고 명령어 상태 출력, stdout, stderr로 올바르게 채워진 CommandResult로 결과를 반환하는 도우미 메서드입니다.

매개변수
cmd String: 실행해야 하는 명령어입니다.

pipeAsInput File: 명령어에 입력으로 파이프될 ERROR(/File) 또는 null입니다.

반환 값
CommandResult CommandResult의 결과입니다.

생성 값
DeviceNotAvailableException

launchShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

명령 동작을 제어하는 더 많은 매개변수와 함께 adb 셸 명령어를 실행합니다.

매개변수
cmd String: 실행할 adb 셸 명령어입니다.

maxTimeoutForCommand long: 명령어가 완료될 때까지의 최대 제한 시간입니다. 단위는 timeUnit에 지정된 대로입니다.

timeUnit TimeUnit: maxTimeToOutputShellResponse의 단위

retryAttempts int: 예외로 인해 실패한 경우 명령어를 다시 시도할 최대 횟수입니다. retryAttempts가 실패로 실행되면 DeviceNotResponsiveException이 발생합니다.

반환 값
CommandResult

생성 값
DeviceNotAvailableException

launchShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

명령 동작을 제어하는 더 많은 매개변수와 함께 adb 셸 명령어를 실행합니다.

매개변수
cmd String: 실행할 adb 셸 명령어입니다.

maxTimeoutForCommand long: 명령어가 완료될 때까지의 최대 제한 시간입니다. 단위는 timeUnit에 지정된 대로입니다.

timeUnit TimeUnit: maxTimeToOutputShellResponse의 단위

반환 값
CommandResult

생성 값
DeviceNotAvailableException

launchShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

명령 동작을 제어하는 더 많은 매개변수와 함께 adb 셸 명령어를 실행합니다.

매개변수
cmd String: 실행할 adb 셸 명령어입니다.

pipeAsInput File: 명령어에 입력으로 파이프될 ERROR(/File) 또는 null입니다.

pipeToOutput OutputStream: std 출력이 리디렉션되는 ERROR(/OutputStream) 또는 null입니다.

maxTimeoutForCommand long: 명령어가 완료될 때까지의 최대 제한 시간입니다. 단위는 timeUnit에 지정된 대로입니다.

timeUnit TimeUnit: maxTimeToOutputShellResponse의 단위

retryAttempts int: 예외로 인해 실패한 경우 명령어를 다시 시도할 최대 횟수입니다. retryAttempts가 실패로 실행되면 DeviceNotResponsiveException이 발생합니다.

반환 값
CommandResult

생성 값
DeviceNotAvailableException

launchShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

명령 동작을 제어하는 더 많은 매개변수와 함께 adb 셸 명령어를 실행합니다.

매개변수
cmd String: 실행할 adb 셸 명령어

pipeAsInput File: 명령어에 대한 입력으로 파이핑될 ERROR(/File) 또는 null입니다.

pipeToOutput OutputStream: std 출력이 리디렉션되는 ERROR(/OutputStream) 또는 null입니다.

pipeToError OutputStream: std 오류가 리디렉션되는 ERROR(/OutputStream) 또는 null입니다.

maxTimeoutForCommand long: 명령어가 완료될 때까지의 최대 제한 시간입니다. 단위는 timeUnit에 지정된 대로입니다.

timeUnit TimeUnit: maxTimeToOutputShellResponse의 단위

retryAttempts int: 예외로 인해 실패한 경우 명령어를 다시 시도할 최대 횟수입니다. retryAttempts가 실패로 실행되면 DeviceNotResponsiveException이 발생합니다.

반환 값
CommandResult

생성 값
DeviceNotAvailableException

빠른 부팅 삭제 파티션

public CommandResult fastbootWipePartition (String partition)

기기의 파티션을 지우는 도우미 메서드입니다.

getUseFastbootErase()true이면 빠른 부팅 삭제가 파티션을 삭제하는 데 사용됩니다. 그러면 다음에 기기가 부팅될 때 기기가 파일 시스템을 만들어야 합니다. 그렇지 않으면 기기에 새 파일 시스템을 만드는 빠른 부팅 형식이 사용됩니다.

기기가 이미 빠른 부팅 모드일 때 사용될 것으로 예상됩니다.

매개변수
partition String: 완전 삭제할 파티션입니다.

반환 값
CommandResult 명령어 출력이 포함된 CommandResult

생성 값
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

기기에서 활성화된 APEX에 관한 정보를 가져옵니다.

반환 값
현재 기기에서 활성화된 ApexInfoERROR(/Set)

생성 값
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

요청된 네임스페이스의 키-값 쌍을 반환합니다.

매개변수
namespace String: {"system", "secure", "global"} 중 하나여야 합니다.

반환 값
키-값 쌍의 매핑입니다. 네임스페이스가 지원되지 않는 경우 null입니다.

생성 값
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

기기의 현재 할당 상태를 반환합니다.

반환 값
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

userId에 연결된 android-id를 찾아서 반환합니다. 찾을 수 없는 경우 null을 반환합니다.

매개변수
userId int

반환 값
String

생성 값
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

일치하는 사용자 ID를 찾은 Android ID 맵을 만듭니다. 각 사용자 ID가 이 함수에 연결된 Android ID를 발견한다는 보험은 없으므로 일부 사용자 ID가 null과 일치할 수 있습니다.

반환 값
사용자 ID와 일치하는 Android ID의 맵입니다.

생성 값
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

기기 API 수준을 가져옵니다. 기본값은 UNKNOWN_API_LEVEL입니다.

반환 값
int 기기의 API 수준을 나타내는 정수

생성 값
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

기기에 설치된 패키지에 관한 정보를 가져옵니다.

매개변수
packageName String

반환 값
PackageInfo 정보를 가져올 수 없는 경우 PackageInfo 또는 null

생성 값
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

기기에 설치된 패키지 정보를 가져옵니다.

반환 값
기기에 설치된 PackageInfoERROR(/List)

생성 값
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

이 기기의 베이스밴드 (무선) 버전을 가져오는 편의 메서드입니다. 라디오 버전을 가져오는 것은 기기별이므로 일부 기기에서는 올바른 정보를 반환하지 않을 수 있습니다. 이 메서드는 gsm.version.baseband 속성을 사용하여 올바른 버전 정보를 반환합니다. 일부 CDMA 기기의 경우 정확하지 않을 수 있으며 여기에 반환된 버전은 빠른 부팅에서 보고된 버전과 일치하지 않을 수 있으며 CDMA 라디오 버전을 반환하지 않을 수 있습니다. 요약: 이 메서드는 gsm.version.baseband 속성이 fastboot getvar version-baseband에서 반환한 버전과 동일한 경우에만 정확한 버전을 보고합니다.

반환 값
String String 베이스밴드 버전 또는 확인할 수 없는 경우 null(기기에 라디오가 없거나 버전 문자열을 읽을 수 없음)

생성 값
DeviceNotAvailableException

getBattery

public Integer getBattery ()

기기의 현재 배터리 잔량을 반환하거나 배터리 잔량을 사용할 수 없는 경우 null을 반환합니다.

반환 값
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

지정된 속성의 불리언 값을 반환합니다.

매개변수
name String: 속성 이름

defaultValue boolean: 속성이 비어 있거나 존재하지 않는 경우 반환할 기본값입니다.

반환 값
boolean 속성의 값이 "1", "y", "yes", "on" 또는 "true"이면 true이고, 속성의 값이 "0", "n", "no", "off", "false" 또는 defaultValue이면 false입니다.

생성 값
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

도우미 메서드는 부팅 시간 및 부팅 이유가 포함된 부팅 기록 맵을 수집합니다.

반환 값
부팅 시간(에포크 이후 경과된 UTC 시간(초)) 및 부팅 이유 맵

생성 값
DeviceNotAvailableException

이후 부팅 기록 가져오기

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

도우미 메서드는 기기로부터 에포크 이후 지정된 시간 및 지정된 시간 단위 이후의 부팅 시간 및 부팅 이유와 함께 부팅 기록 맵을 수집합니다. 현재 기기 utcEpochTime(밀리초)은 getDeviceDate() 메서드로 가져올 수 있습니다.

매개변수
utcEpochTime long: 에포크 이후 기기 시간입니다.

timeUnit TimeUnit: 시간 단위 TimeUnit입니다.

반환 값
부팅 시간(에포크 이후 경과된 UTC 시간(초)) 및 부팅 이유 맵

생성 값
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

이 기기의 부트로더 버전을 가져오는 편의 메서드입니다.

기기의 현재 상태에서 부트로더 버전을 가져오려고 시도합니다. 즉, 기기가 빠른 부팅 모드(Fastboot mode)인 경우 빠른 부팅에서 버전 검색을 시도합니다.

반환 값
String String 부트로더 버전 또는 찾을 수 없는 경우 null

생성 값
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

기기에서 버그 신고를 가져옵니다.

이 구현은 sdcard가 없는 기기(또는 sdcard가 아직 마운트되지 않은 기기)에서 계속 작동하도록 보장됩니다.

반환 값
InputStreamSource 요청 시 버그 신고 콘텐츠를 생성하는 InputStreamSource입니다. 실패하면 InputStreamSource에서 빈 ERROR(/InputStream)를 생성합니다.

getBugreportz

public InputStreamSource getBugreportz ()

기기에서 bugreportz를 가져옵니다. Zip 형식 버그 신고에는 기본 버그 신고와 디버깅에 유용한 기타 로그 파일이 포함됩니다.

'adb 버전'이 1.0.36보다 큰 경우에만 지원됩니다.

반환 값
InputStreamSource bugreportz가 포함된 ZIP 파일의 InputStreamSource이며 실패 시 null을 반환합니다.

getBuildAlias

public String getBuildAlias ()

기기가 현재 실행 중인 빌드의 별칭을 검색합니다.

빌드 별칭은 일반적으로 빌드 ID (일반적으로 Nexus 빌드의 경우 숫자)보다 읽기 쉬운 문자열입니다. 예를 들어 최종 Android 4.2 출시에는 빌드 별칭 JDQ39와 빌드 ID 573038이 포함됩니다.

반환 값
String 빌드 별칭 또는 가져올 수 없는 경우 빌드 ID로 대체

생성 값
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

기기의 빌드 버전을 가져옵니다.

반환 값
String 빌드 버전 또는 검색할 수 없는 경우 null

생성 값
DeviceNotAvailableException

getBuildId

public String getBuildId ()

기기에서 현재 실행 중인 빌드를 가져옵니다.

반환 값
String 빌드 ID 또는 검색할 수 없는 경우 IBuildInfo#UNKNOWN_BUILD_ID

생성 값
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

기기 이미지에 서명하는 데 사용되는 키 유형을 반환합니다.

일반적으로 Android 기기는 테스트 키 (예: AOSP) 또는 릴리스 키(개별 기기 제조업체에서 제어)로 서명될 수 있습니다.

반환 값
String 서명 키가 있는 경우 서명 키, 그렇지 않은 경우 null입니다.

생성 값
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

기기가 할당되면 캐시된 DeviceDescriptor를 반환하고 그렇지 않으면 현재 DeviceDescriptor를 반환합니다.

반환 값
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

기기가 할당된 경우 캐시된 DeviceDescriptor를 반환하고 그렇지 않으면 현재 DeviceDescriptor를 반환합니다.

매개변수
shortDescriptor boolean: 설명자를 최소한의 정보로 제한할지 여부입니다.

반환 값
DeviceDescriptor

getChildren

public String[] getChildren (String path)

권한 문제로 인해 작동하지 않는 경우도 있는 IFileEntry 사용의 대안입니다.

매개변수
path String: 검색을 실행할 기기의 경로입니다.

반환 값
String[] 기기의 경로에 있는 모든 파일을 포함하는 문자열 배열입니다.

생성 값
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

기기와 연결된 현재 연결입니다.

반환 값
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

ContentProviderHandler를 반환하거나 사용할 수 없는 경우 null을 반환합니다.

콘텐츠 제공업체가 이전에 동일한 userId로 생성된 경우 재사용할 수 있습니다.

매개변수
userId int: 콘텐츠 제공업체를 초기화하는 데 사용할 사용자 ID입니다.

반환 값
ContentProviderHandler

생성 값
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

기기의 현재 폴더블 상태를 반환하거나 문제가 발생한 경우 null을 반환합니다.

반환 값
DeviceFoldableState

생성 값
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

현재 실행 중인 사용자의 ID를 반환합니다. 오류가 발생하면 -10000을 반환합니다.

반환 값
int

생성 값
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

기기 클래스를 가져옵니다.

반환 값
String String 기기 클래스

getDeviceDate

public long getDeviceDate ()

기기의 날짜를 에포크 이후 밀리초 단위로 반환합니다.

반환 값
long 기기의 날짜(에포크 형식)입니다.

생성 값
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

기기 정보에서 DeviceDescriptor를 반환하여 실제 기기 객체를 전달하지 않고 기기 정보를 가져옵니다.

반환 값
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

기기 정보에서 DeviceDescriptor를 반환하여 실제 기기 객체를 전달하지 않고 기기 정보를 가져옵니다.

매개변수
shortDescriptor boolean: 설명자를 최소한의 정보로 제한할지 여부입니다.

반환 값
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

기기의 상태를 가져옵니다.

반환 값
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

기기와 지정된 ERROR(/Date) 간의 시차를 가져오는 도우미입니다. 내부적으로 에포크 시간을 사용합니다.

매개변수
date Date

반환 값
long 밀리초 차이

생성 값
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

에뮬레이터 stdout 및 stderr의 스트림 가져오기

반환 값
InputStreamSource 에뮬레이터 출력

getEmulatorProcess

public Process getEmulatorProcess ()

이 에뮬레이터에 해당하는 Process를 반환합니다.

반환 값
Process Process 또는 null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

모든 executeShellCommand(String) 로그가 포함된 로그

반환 값
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

기기 외부 저장소의 여유 공간을 확인하는 도우미 메서드입니다.

반환 값
long 여유 공간(KB)

생성 값
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

사용 중인 빠른 부팅 바이너리의 경로를 반환합니다. 빠른 부팅 기능을 사용 설정하려면 여전히 isFastbootEnabled()이(가) true여야 합니다.

반환 값
String

getFastbootProductType

public String getFastbootProductType ()

기기가 빠른 부팅 모드일 때 이 기기의 제품 유형을 가져오는 편의 메서드입니다.

이 방법은 기기가 빠른 부팅이어야 하는 경우에만 사용해야 합니다. 이 경우의 일반 getProductType() 메서드보다 조금 더 안전한 변형입니다. 기기가 잘못된 상태에 있거나 응답하지 않는 경우 ITestDevice에서 기기를 빠른 부팅으로 복구하는 것을 인지하기 때문입니다.

반환 값
String String 제품 유형 이름 또는 null를 확인할 수 없는 경우

생성 값
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

기기가 빠른 부팅 모드일 때 이 기기의 제품 유형을 가져오는 편의 메서드입니다.

이 방법은 기기가 빠른 부팅이어야 하는 경우에만 사용해야 합니다. 이 경우의 일반 getProductType() 메서드보다 조금 더 안전한 변형입니다. 기기가 잘못된 상태에 있거나 응답하지 않는 경우 ITestDevice에서 기기를 빠른 부팅으로 복구하는 것을 인지하기 때문입니다.

반환 값
String String 제품 유형 이름 또는 null를 확인할 수 없는 경우

생성 값
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

빠른 부팅 모드 일련번호를 반환합니다.

반환 값
String

getFastbootVariable

public String getFastbootVariable (String variableName)

기기에서 지정된 빠른 부팅 변수 값을 검색합니다.

매개변수
variableName String: 변수 이름

반환 값
String 속성 값 또는 null(존재하지 않는 경우)

생성 값
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

사용 중인 빠른 부팅 바이너리의 버전 문자열을 반환합니다. 문제가 발생하면 null입니다.

반환 값
String

getFileEntry

public IFileEntry getFileEntry (String path)

기기에서 원격 파일의 참조를 가져옵니다.

매개변수
path String: 가져올 파일 경로입니다. 절대 경로이거나 '/'를 기준으로 한 상대 경로일 수 있습니다. 즉, '/system'과 'system' 문법이 모두 지원됩니다.

반환 값
IFileEntry 지정된 path의 파일을 찾을 수 없는 경우 IFileEntry 또는 null

생성 값
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

루트가 아닌 경로에서 FileEntry를 가져오는 비공식 도우미입니다. FIXME: 모든 경로에서 사용할 수 있도록 FileEntry 시스템을 리팩터링합니다. (루트가 아닌 경우에도 해당)

매개변수
entry FileListingService.FileEntry: Ddmlib에서 요구하는 것처럼 FileEntry가 꼭 루트일 필요는 없습니다.

반환 값
IFileEntry FileEntry를 나타내는 FileEntryWrapper입니다.

생성 값
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

기기의 폴더블 상태 목록을 반환합니다. 'cmd device_state print-states'로 가져올 수 있습니다.

반환 값

생성 값
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

연결된 ddmlib IDevice에 대한 참조를 반환합니다.

기기가 adb에서 연결 해제되었다가 다시 연결될 때마다 DDMS에서 새 IDevice를 할당할 수 있습니다. 따라서 호출자는 IDevice에 대한 참조를 유지해서는 안 됩니다. 참조가 비활성 상태가 될 수 있기 때문입니다.

반환 값
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

기기에 있는 애플리케이션 패키지 이름을 가져옵니다.

반환 값
현재 기기에 설치된 String 패키지 이름의 ERROR(/Set)입니다.

생성 값
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

기기에서 지정된 속성의 정수 값을 반환합니다.

매개변수
name String: 속성 이름

defaultValue long: 속성이 비어 있거나 존재하지 않는 경우 반환되는 기본값입니다.

반환 값
long 속성 값 또는 속성이 비어 있거나 존재하지 않거나 정수 값이 없는 경우 defaultValue

생성 값
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

기기의 IP 주소를 가져옵니다.

반환 값
String 기기의 IP 주소 또는 기기에 IP 주소가 없는 경우 null

생성 값
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

키가드의 현재 상태를 가져오는 객체를 반환하거나 지원되지 않는 경우 null을 반환합니다.

반환 값
KeyguardControllerState 키가드 상태의 스냅샷을 포함하는 KeyguardControllerState이며 키가드 쿼리가 지원되지 않는 경우 Null을 반환합니다.

생성 값
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Tradefed API가 System.currentTimeMillis()에서 반환한 것처럼 EPOCH 이후 마지막으로 재부팅을 트리거한 시간(밀리초)을 반환합니다.

반환 값
long

getLaunchApiLevel

public int getLaunchApiLevel ()

기기가 처음 출시된 API 수준을 가져옵니다. 기본값은 UNKNOWN_API_LEVEL입니다.

반환 값
int 기기의 최초 실행 API 수준을 나타내는 정수

생성 값
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Logcat 데이터의 스냅샷 스트림을 가져옵니다.

다음 두 가지 모드로 작동합니다.

  • Logcat이 현재 백그라운드에서 캡처 중인 경우 백그라운드 logcat 캡처의 현재 콘텐츠를 최대 TestDeviceOptions.getMaxLogcatDataSize()바이트 반환합니다.
  • 그렇지 않으면 기기가 현재 응답 중이면 logcat 데이터의 정적 덤프를 반환합니다.

    반환 값
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    캡처된 logcat 데이터의 마지막 maxBytes개 스냅샷 스트림을 가져옵니다.

    전체 getLogcat() 스냅샷을 가져올 때 발생할 수 있는 큰 디스크 공간 패널티 없이 캡처된 logcat 데이터의 스냅샷을 자주 캡처하려는 경우에 유용합니다.

    매개변수
    maxBytes int: 반환할 최대 데이터 양입니다. 메모리에 편안하게 들어갈 수 있는 양이어야 합니다.

    반환 값
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

    기기의 현재 logcat 덤프를 가져옵니다. getLogcat()와 달리 이 메서드는 항상 Logcat의 정적 덤프를 반환합니다.

    기기에 연결할 수 없는 경우 아무것도 반환되지 않는다는 단점이 있습니다.

    반환 값
    InputStreamSource Logcat 데이터의 InputStreamSource입니다. Logcat 데이터 캡처에 실패하면 빈 스트림이 반환됩니다.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

    제공된 날짜부터 캡처된 logcat 데이터의 스냅샷 스트림을 가져옵니다. 기기의 시간은 getDeviceDate()를 사용해야 합니다.

    매개변수
    date long: 에포크 형식 이후 현재까지 스냅샷을 시작할 시간(밀리초)입니다. ('date +%s'를 사용하여 가져올 수 있음)

    반환 값
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    기기의 MAC 주소를 반환합니다. 기기에서 쿼리하지 못하면 null을 반환합니다.

    반환 값
    String

    getMainUserId

    public Integer getMainUserId ()

    기본 사용자 ID를 반환합니다.

    반환 값
    Integer 기본 사용자가 있는 경우 기본 사용자의 userId이고 기본 사용자가 없는 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

    기기에 설치된 메인라인 모듈에 관한 정보를 가져옵니다.

    반환 값
    현재 기기에 설치된 String 메인라인 모듈 중 ERROR(/Set)

    생성 값
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    동시에 실행되는 최대 지원 사용자 수를 가져옵니다. 기본값은 0입니다.

    반환 값
    int 동시에 실행 중인 사용자 수를 나타내는 정수

    생성 값
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

    지원되는 최대 사용자 수를 가져옵니다. 기본값은 0입니다.

    반환 값
    int 지원되는 사용자 수를 나타내는 정수

    생성 값
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

    반환 값
    Process Microdroid VM의 프로세스를 반환합니다. TestDevice가 Microdroid가 아니면 null을 반환합니다.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    기기와 연결된 IDeviceStateMonitor를 반환합니다.

    반환 값
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

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

    IDevice의 캐시된 정보를 사용할 수 없는 경우 기기를 직접 쿼리합니다.

    TODO: 이 동작을 IDevice#getMountPoint(String)로 이동

    매개변수
    mountName String: 마운트 지점의 이름

    반환 값
    String 마운트 지점 또는 null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    지정된 마운트 포인트 경로에 해당하는 MountPointInfo를 반환하거나, 해당 경로에 마운트된 항목이 없거나 /proc/mounts에 마운트 포인트로 표시되지 않는 경우에는 null을 반환합니다.

    매개변수
    mountpoint String

    반환 값
    ITestDevice.MountPointInfo '/proc/mounts'의 정보를 포함하는 MountPointInfoERROR(/List)

    생성 값
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    기기의 /proc/mounts에 있는 정보를 파싱한 버전을 반환합니다.

    반환 값
    '/proc/mounts'의 정보를 포함하는 MountPointInfoERROR(/List)

    생성 값
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    기기의 테스트 옵션을 가져옵니다.

    반환 값
    TestDeviceOptions 테스트 대상 기기와 관련된 TestDeviceOptions입니다.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

    기기 파티션의 여유 공간을 확인하는 도우미 메서드입니다.

    매개변수
    partition String

    반환 값
    long 여유 공간(KB)

    생성 값
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    기본 사용자 ID를 반환합니다.

    반환 값
    Integer 기본 사용자가 있는 경우 기본 사용자의 userId이고 기본 사용자가 없는 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    도우미 메서드는 'pidof' 및 'stat' 명령어를 실행하고 지정된 프로세스의 PID 및 프로세스 시작 시간이 포함된 ProcessInfo 객체를 반환합니다.

    매개변수
    processName String: 프로세스 이름 문자열입니다.

    반환 값
    ProcessInfo 지정된 processName의 ProcessInfo

    생성 값
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

    서비스의 pid를 반환하거나 문제가 발생한 경우 null을 반환합니다.

    매개변수
    process String: 프로세스 이름 문자열입니다.

    반환 값
    String

    생성 값
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    이 기기의 제품 유형을 가져오는 편의 메서드입니다.

    이 메서드는 기기가 adb 또는 빠른 부팅 모드일 때 작동합니다.

    반환 값
    String String 제품 유형 이름 null이 아님

    생성 값
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    이 기기의 제품 옵션을 가져오는 편의 메서드입니다.

    이 메서드는 기기가 adb 또는 빠른 부팅 모드에 있는 경우에 작동합니다.

    반환 값
    String String 제품 옵션 이름 또는 확인할 수 없는 경우 null

    생성 값
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    기기에서 지정된 속성 값을 검색합니다.

    매개변수
    name String: 속성 이름

    반환 값
    String 속성 값 또는 null(존재하지 않는 경우)

    생성 값
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    기기에 사용되는 현재 복구 모드를 가져옵니다.

    반환 값
    ITestDevice.RecoveryMode 기기에 사용되는 현재 복구 모드입니다.

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

    디스플레이 ID가 지정된 기기에서 스크린샷을 가져옵니다. 형식은 PNG입니다.

    TODO: 'format' 및 'rescale'을 지원하도록 위의 구현을 확장합니다.

    매개변수
    displayId long: 스크린샷을 가져올 화면의 디스플레이 ID입니다.

    반환 값
    InputStreamSource 스크린샷의 InputStreamSource(형식) 또는 스크린샷을 찍지 못한 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    스크린샷 가져오기

    public InputStreamSource getScreenshot (String format)

    기기에서 스크린샷을 가져옵니다. 더 작은 크기를 위해 JPEG 인코딩으로 getScreenshot(format)을 사용하는 것이 좋습니다.

    매개변수
    format String: 지원되는 PNG, JPEG

    반환 값
    InputStreamSource 스크린샷의 InputStreamSource(형식) 또는 스크린샷을 찍지 못한 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    스크린샷 가져오기

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    기기에서 스크린샷을 캡처합니다. 크기를 줄이려면 getScreenshot(String)를 JPEG 인코딩과 함께 사용하는 것이 좋습니다.

    매개변수
    format String: 지원되는 PNG, JPEG

    rescale boolean: 결과 이미지의 크기를 줄이기 위해 스크린샷의 크기를 조정해야 하는 경우

    반환 값
    InputStreamSource 스크린샷의 InputStreamSource(형식) 또는 스크린샷을 찍지 못한 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    스크린샷 가져오기

    public InputStreamSource getScreenshot ()

    기기에서 스크린샷을 캡처합니다.

    반환 값
    InputStreamSource 스크린샷의 InputStreamSource(PNG 형식) 또는 스크린샷을 찍지 못한 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    이 기기의 일련번호를 가져오는 편의 메서드입니다.

    반환 값
    String String 일련번호

    getSetting

    public String getSetting (int userId, 
                    String namespace, 
                    String key)

    요청된 설정의 값을 반환합니다. 네임스페이스는 {"system", "secure", "global"} 중 하나여야 합니다.

    매개변수
    userId int

    namespace String

    key String

    반환 값
    String 사용자의 namespace:key와 연결된 값입니다. 찾을 수 없는 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

    getSetting(int, String, String)를 참고하고 시스템 사용자에게 실행됩니다.

    매개변수
    namespace String

    key String

    반환 값
    String

    생성 값
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

    SIM 카드 운영자를 반환하거나 사용 불가하거나 기기를 사용할 수 없는 경우 null을 반환합니다.

    반환 값
    String

    getSimState

    public String getSimState ()

    SIM 카드 상태를 반환하거나, 사용할 수 없거나 기기를 사용할 수 없는 경우 null을 반환합니다.

    반환 값
    String

    getTombstones

    public  getTombstones ()

    기기에서 tombstone 목록을 가져와 반환합니다. 루트 권한이 필요합니다.

    메서드는 최선의 방식으로 실행되므로 어떤 이유로든 하나의 삭제된 항목을 가져오지 못하면 목록에서 누락됩니다. DeviceNotAvailableException만 메서드를 조기 종료합니다.

    반환 값
    삭제된 파일 목록입니다. 삭제된 파일이 없으면 비어 있습니다.

    생성 값
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

    총 물리적 메모리 크기를 바이트 단위로 반환하거나 내부 오류가 발생하면 -1을 반환합니다.

    반환 값
    long

    getTrackingSerial

    public String getTrackingSerial ()

    기기 관리 목적으로 기기를 추적하는 데 사용되는 일련번호를 가져옵니다.

    반환 값
    String

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

    제거할 수 있는 애플리케이션 패키지 이름을 가져옵니다. 이는 현재 비시스템 패키지 및 업데이트된 시스템 패키지로 정의됩니다.

    반환 값
    현재 기기에 설치된 제거 불가능한 String 패키지 이름의 ERROR(/Set)입니다.

    생성 값
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

    기기의 파티션을 삭제하는 데 빠른 부팅 삭제 또는 빠른 부팅 형식을 사용할지 여부를 가져옵니다.

    반환 값
    boolean 빠른 부팅 삭제를 사용할 경우 true이고 빠른 부팅 형식을 사용할 경우 false입니다.

    getUserFlags

    public int getUserFlags (int userId)

    지정된 사용자의 신고를 찾아 반환합니다. 플래그는 Android 오픈소스 프로젝트의 'android.content.pm.UserInfo' 클래스에 정의됩니다.

    매개변수
    userId int

    반환 값
    int 제공된 userId와 연결된 플래그(있는 경우), 다른 경우에는 -10000입니다.

    생성 값
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

    기기에서 UserInfo에 대한 useId의 맵을 가져옵니다. 기기의 출력이 예상과 다르면 DeviceRuntimeException이 발생합니다.

    반환 값
    UserInfo 객체 목록입니다.

    생성 값
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    userId와 연결된 일련번호를 찾은 경우 반환하고, 그렇지 않은 경우에는 -10000을 반환합니다.

    매개변수
    userId int

    반환 값
    int

    생성 값
    DeviceNotAvailableException

    핸들 할당 이벤트

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    지정된 DeviceEvent를 처리합니다. 기기를 새 상태로 전환할 수 있습니다. IDeviceMonitor에 상태 전환을 알립니다.

    이 기기를 새 할당 상태로 전환할 수도 있고 전환하지 않을 수도 있는 DeviceEvent를 처리합니다.

    매개변수
    event DeviceEvent

    반환 값
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

    기기에서 기능을 사용할 수 있는지 확인합니다.

    매개변수
    feature String: 형식은 'feature:' 또는 ''여야 합니다.

    반환 값
    boolean 기능이 있으면 true, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    installPackage

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    String... extraArgs)

    기기에 Android 패키지를 설치합니다.

    매개변수
    packageFile File: 설치할 APK 파일

    reinstall boolean: 재설치가 필요한 경우 true

    extraArgs String: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

    반환 값
    String 오류 코드가 있는 String 또는 성공인 경우 null

    생성 값
    DeviceNotAvailableException

    installPackage

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    String... extraArgs)

    기기에 Android 패키지를 설치합니다.

    참고: 설치 시 런타임 권한 부여를 명시적으로 제어해야 하는 사용 사례에서만 이 함수를 호출해야 합니다.

    매개변수
    packageFile File: 설치할 APK 파일

    reinstall boolean: 재설치가 필요한 경우 true

    grantPermissions boolean: 설치 시 모든 런타임 권한을 부여해야 하는 경우

    extraArgs String: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

    반환 값
    String 오류 코드가 있는 String 또는 성공인 경우 null

    생성 값
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    int userId, 
                    String... extraArgs)

    지정된 사용자의 기기에 Android 패키지를 설치합니다.

    매개변수
    packageFile File: 설치할 APK 파일

    reinstall boolean: 재설치가 필요한 경우 true

    userId int: 설치할 정수 사용자 ID입니다.

    extraArgs String: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

    반환 값
    String 오류 코드가 있는 String 또는 성공인 경우 null

    생성 값
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    int userId, 
                    String... extraArgs)

    지정된 사용자의 기기에 Android 패키지를 설치합니다.

    참고: 설치 시 런타임 권한 부여를 명시적으로 제어해야 하는 사용 사례만 이 함수를 호출해야 합니다.

    매개변수
    packageFile File: 설치할 APK 파일

    reinstall boolean: 재설치가 필요한 경우 true

    grantPermissions boolean: 설치 시 모든 런타임 권한을 부여해야 하는 경우

    userId int: 설치할 정수 사용자 ID입니다.

    extraArgs String: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

    반환 값
    String 오류 코드가 있는 String 또는 성공인 경우 null

    생성 값
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    반환 값
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

    기기의 플랫폼이 앱 열거를 지원하는지 확인

    반환 값
    boolean 앱 열거가 지원되는 경우 true이고, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    기기의 플랫폼이 앱 설치 시 낮은 타겟 SDK 차단을 우회하는지 확인

    반환 값
    boolean 낮은 타겟 SDK 블록 우회가 지원되는 경우 true이고, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    debugfs가 마운트되었는지 확인합니다.

    반환 값
    boolean debugfs가 마운트된 경우 true

    생성 값
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

    기기가 암호화되었는지 여부를 반환합니다.

    반환 값
    boolean true: 기기가 암호화된 경우

    생성 값
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

    기기의 경로가 디렉터리인 경우 True를 반환하고, 그렇지 않으면 false를 반환합니다.

    매개변수
    path String

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

    반환 값
    boolean true: 기기에서 adb 루트를 사용 설정해야 하는 경우

    isEncryptionSupported

    public boolean isEncryptionSupported ()

    기기에서 암호화가 지원되는지 여부를 반환합니다.

    반환 값
    boolean true: 기기에서 암호화를 지원하는 경우

    생성 값
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

    기기의 파일 경로가 실행 파일인 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

    매개변수
    fullPath String

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

    기기에서 빠른 부팅을 사용할 수 있는지 반환합니다.

    반환 값
    boolean

    isHeadless

    public boolean isHeadless ()

    기기가 헤드리스 (화면 없음)이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

    기기에서 헤드리스 시스템 사용자 모드를 사용하는지 여부를 반환합니다.

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

    기본 사용자가 영구 관리자이며 삭제되거나 비관리자 상태로 다운그레이드될 수 없는지 여부를 반환합니다.

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

    멀티 사용자를 지원하는지 확인합니다.

    반환 값
    boolean 멀티 사용자를 지원하는 경우 true이고 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    패키지 설치됨

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    기기에 지정된 패키지 이름과 지정된 사용자 ID를 쿼리하여 해당 사용자에게 패키지가 현재 설치되어 있는지 여부를 확인합니다.

    매개변수
    packageName String: 설치 여부를 확인하는 패키지입니다.

    userId String: 패키지가 설치되어 있는지 확인하는 사용자 ID입니다. null이면 기본 사용자 0이 사용됩니다.

    반환 값
    boolean 패키지가 설치된 것으로 보고되면 true입니다. 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    패키지 설치됨

    public boolean isPackageInstalled (String packageName)

    기기에 대해 지정된 패키지 이름을 쿼리하여 현재 설치되어 있는지 확인합니다.

    매개변수
    packageName String

    반환 값
    boolean 패키지가 설치된 것으로 보고되면 true입니다. 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

    기기의 플랫폼이 런타임 권한 부여를 지원하는지 확인

    반환 값
    boolean 런타임 권한이 지원되는 경우 true이고, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

    기기가 TestDeviceState#FASTBOOT 또는 TestDeviceState.FASTBOOTD에 있으면 true를 반환합니다.

    반환 값
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    특정 사용자가 실행 중인지 확인합니다.

    매개변수
    userId int

    반환 값
    boolean 사용자가 실행 중인 경우 true이고, 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

    지정된 사용자가 플래그에 따라 보조 사용자인지 여부를 반환합니다.

    매개변수
    userId int

    반환 값
    boolean 사용자가 보조 사용자인 경우 true이고, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    지정된 사용자가 표시되는지 확인합니다.

    '표시된' 사용자는 '인간' 사용자와 상호작용하고 있으므로 활동을 실행할 수 있는 사용자입니다 (일반적으로 기본 디스플레이에서).

    매개변수
    userId int

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    지정된 사용자가 지정된 디스플레이에 표시되는지 확인합니다.

    '보이는' 사용자는 '사람'과 상호작용하고 따라서 이 디스플레이에서 시작 활동을 실행할 수 있는 사용자입니다.

    매개변수
    userId int

    displayId int

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    기기가 사용자가 ERROR(/java.android.view.Display#DEFAULT_DISPLAY)에서 백그라운드에 표시되도록 시작할 수 있는지 여부를 반환합니다.

    이 경우 startVisibleBackgroundUser(int, int, boolean)를 호출하여 listDisplayIdsForStartingVisibleBackgroundUsers()에서 반환된 디스플레이 (ERROR(/java.android.view.Display#DEFAULT_DISPLAY) 포함)를 전달할 수 있습니다.

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

    기기에서 사용자가 백그라운드에서 표시되도록 시작할 수 있는지 여부를 반환합니다.

    이 경우 listDisplayIdsForStartingVisibleBackgroundUsers()에서 반환된 디스플레이를 전달하여 startVisibleBackgroundUser(int, int, boolean)를 호출할 수 있습니다.

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

    Wi-Fi가 사용 설정되어 있는지 테스트합니다.

    기기에서 Wi-Fi가 사용 설정되어 있는지 확인합니다. Wi-Fi로 실행해서는 안 되는 테스트(예: 모바일 데이터 테스트) 전에 Wi-Fi 상태를 어설션하는 데 유용합니다.

    반환 값
    boolean Wi-Fi가 사용 설정된 경우 true입니다. false(사용 중지된 경우)

    생성 값
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

    'dumpsys SurfaceFlinger'에서 보고한 대로 기기에서 사용 가능한 디스플레이 ID 목록을 수집합니다.

    반환 값
    디스플레이 목록입니다. 기본값은 항상 기본 디스플레이 0을 반환합니다.

    생성 값
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    start a user visible in the background에 사용할 수 있는 디스플레이 목록을 가져옵니다.

    반환 값

    생성 값
    DeviceNotAvailableException

    listUsers

    public  listUsers ()

    기기의 사용자 목록을 가져옵니다. 기기의 출력이 예상과 다르면 DeviceRuntimeException이 발생합니다.

    반환 값
    사용자 ID 목록입니다.

    생성 값
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

    기기에서 ANR을 수집하고 기록합니다.

    매개변수
    logger ITestLogger: ANR을 로깅하는 ITestLogger입니다.

    반환 값
    boolean 로깅에 성공하면 true, 실패하면 false입니다.

    생성 값
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    버그 신고를 가져와 신고자에게 로깅하는 도우미 메서드입니다.

    매개변수
    dataName String: 버그 신고가 보고될 이름입니다.

    listener ITestLogger: 버그 신고를 기록하는 ITestLogger입니다.

    반환 값
    boolean 로깅이 성공하면 true, 그렇지 않으면 false입니다.

    로그온디바이스

    public void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    기기의 logcat에 메시지를 로깅합니다. 로깅에 실패하더라도 발생하지 않는 안전한 호출입니다.

    매개변수
    tag String: Logcat에 메시지를 기록할 때 사용하는 태그입니다.

    level Log.LogLevel: Logcat의 메시지 디버그 수준입니다.

    format String: 메시지 형식입니다.

    args Object: String.format()을 통해 대체할 args입니다.

    mountDebugfs

    public void mountDebugfs ()

    debugfs를 마운트합니다.

    생성 값
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

    기기를 재부팅하는 명령어를 실행하고 명령어 완료 시 및 기기가 더 이상 adb에 표시되지 않을 때 반환합니다.

    생성 값
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    adb 루트 후 그리고 기기가 다시 온라인 상태가 되기 전에 기기에서 특정 작업을 실행해야 하는 경우 재정의합니다. 기본 구현에는 추가 작업이 포함되어 있지 않습니다. 이 단계에서는 adb root가 사용 설정되지 않을 수도 있습니다.

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    adb 제거 후 기기가 다시 온라인 상태가 되기 전에 기기에서 특정 작업을 실행해야 하는 경우 재정의합니다. 기본 구현에는 추가 작업이 포함되지 않습니다. 이 단계에서 adb root가 사용 중지되지 않을 수도 있습니다.

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

    모든 부팅 후 테스트를 위해 기기를 구성하는 안내를 실행합니다.

    기기가 완전히 부팅되거나 사용 가능한 상태가 되면 호출해야 합니다.

    일반적으로 이 메서드는 명시적으로 호출할 필요가 없습니다. 구현은 재부팅을 실행할 때 이러한 단계를 자동으로 실행해야 하기 때문입니다.

    다른 이벤트로 인해 기기가 재부팅되는 경우 (예: 빠른 부팅 업데이트 명령어가 완료된 경우) 호출해야 할 수 있습니다.

    생성 값
    DeviceNotAvailableException

    호출 후 해체

    public void postInvocationTearDown (Throwable exception)

    호출이 완료된 후 실행되는 기기별 필수 정리에 관한 추가 단계입니다.

    매개변수
    exception Throwable: 호출 실패로 인해 발생한 최종 예외입니다(있는 경우).

    preInvocationSetup

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    호출 흐름 전에 기기에서 실행될 기기별 필수 설정을 위한 추가 단계입니다.

    매개변수
    info IBuildInfo: 기기의 IBuildInfo입니다.

    attributes MultiMap: 호출 컨텍스트에 저장된 속성

    생성 값
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId)

    기기에서 디렉터리 콘텐츠를 재귀적으로 가져옵니다.

    매개변수
    deviceFilePath String: 원격 소스의 절대 파일 경로

    localDir File: 파일을 가져올 로컬 디렉터리

    userId int: 가져올 사용자 ID

    반환 값
    boolean 파일을 성공적으로 가져왔다면 true입니다. 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    기기에서 디렉터리 콘텐츠를 재귀적으로 가져옵니다.

    매개변수
    deviceFilePath String: 원격 소스의 절대 파일 경로

    localDir File: 파일을 가져올 로컬 디렉터리

    반환 값
    boolean 파일을 성공적으로 가져왔다면 true입니다. 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    기기에서 파일을 검색합니다.

    매개변수
    remoteFilePath String: 기기의 파일 절대 경로입니다.

    localFile File: 콘텐츠를 저장할 로컬 파일입니다. 내용이 비어 있지 않으면 콘텐츠가 대체됩니다.

    반환 값
    boolean true: 파일을 가져오는 데 성공한 경우 그 외에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pull파일

    public File pullFile (String remoteFilePath, 
                    int userId)

    기기에서 파일을 검색하여 로컬 임시 ERROR(/File)에 저장하고 해당 File를 반환합니다.

    매개변수
    remoteFilePath String: 기기에 있는 파일의 절대 경로입니다.

    userId int: 가져올 사용자 ID

    반환 값
    File 기기 파일의 콘텐츠가 포함된 ERROR(/File) 또는 어떤 이유로든 (호스트 파일 시스템 문제 포함) 복사가 실패한 경우 null

    생성 값
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    기기에서 파일을 검색하여 로컬 임시 ERROR(/File)에 저장하고 해당 File를 반환합니다.

    매개변수
    remoteFilePath String: 기기의 파일 절대 경로입니다.

    반환 값
    File 기기 파일의 콘텐츠를 포함하는 ERROR(/File) 또는 어떤 이유로든 복사에 실패한 경우 null (호스트 파일 시스템 문제 포함)

    생성 값
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    기기에서 파일을 검색합니다.

    매개변수
    remoteFilePath String: 기기의 파일 절대 경로입니다.

    localFile File: 콘텐츠를 저장할 로컬 파일입니다. 내용이 비어 있지 않으면 콘텐츠가 대체됩니다.

    userId int: 가져올 사용자 ID입니다.

    반환 값
    boolean true: 파일을 가져오는 데 성공한 경우 그 외에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    기기에서 파일을 검색하고 콘텐츠를 반환합니다.

    매개변수
    remoteFilePath String: 기기의 파일 절대 경로입니다.

    반환 값
    String 기기 파일의 콘텐츠를 포함하는 String 또는 어떤 이유로든 복사에 실패한 경우 null (호스트 파일 시스템 문제 포함)

    생성 값
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    기기의 외부 저장소에서 파일을 가져와 로컬 임시 ERROR(/File)에 저장하고 해당 File에 대한 참조를 반환하는 편의 메서드입니다.

    매개변수
    remoteFilePath String: 기기의 외부 저장소 마운트 지점을 기준으로 기기의 파일 경로입니다.

    반환 값
    File 기기 파일의 콘텐츠가 포함된 ERROR(/File) 또는 어떤 이유로든 (호스트 파일 시스템 문제 포함) 복사가 실패한 경우 null

    생성 값
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    필터링된 일부 디렉터리를 제외하면서 디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다.

    매개변수
    localFileDir File: 푸시할 로컬 디렉터리

    deviceFilePath String: 원격 대상의 절대 파일 경로입니다.

    excludedDirectories : 푸시해서는 안 되는 제외된 디렉터리 이름 집합입니다.

    반환 값
    boolean 파일이 푸시된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다.

    매개변수
    localFileDir File: 푸시할 로컬 디렉터리

    deviceFilePath String: 원격 대상의 절대 파일 경로입니다.

    반환 값
    boolean 파일이 푸시된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                    int userId)

    디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다.

    매개변수
    localFileDir File: 푸시할 로컬 디렉터리

    deviceFilePath String: 원격 대상의 절대 파일 경로입니다.

    userId int: 푸시할 사용자 ID입니다.

    반환 값
    boolean 파일이 푸시된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    푸시 파일

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    선택적으로 콘텐츠 제공자의 필요성을 평가할 수 있는 pushFile(File, String)의 변형입니다.

    매개변수
    localFile File: 푸시할 로컬 파일

    remoteFilePath String: 원격 대상 절대 파일 경로입니다.

    evaluateContentProviderNeeded boolean: 콘텐츠 제공자가 필요한지 확인 여부

    반환 값
    boolean 파일이 푸시된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    기기에 파일을 푸시합니다. 기본적으로 콘텐츠 제공자를 사용합니다.

    매개변수
    localFile File: 푸시할 로컬 파일

    remoteFilePath String: 원격 대상의 절대 파일 경로입니다.

    반환 값
    boolean 파일이 푸시된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    int userId)

    기기에 파일을 푸시합니다. 기본적으로 콘텐츠 제공자를 사용합니다.

    매개변수
    localFile File: 푸시할 로컬 파일

    remoteFilePath String: 원격 대상의 절대 파일 경로입니다.

    userId int: 푸시할 userId입니다.

    반환 값
    boolean 파일이 푸시된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    문자열에서 생성된 파일을 기기로 푸시

    매개변수
    contents String: 푸시할 파일의 콘텐츠

    remoteFilePath String: 원격 대상의 절대 파일 경로입니다.

    반환 값
    boolean 문자열이 푸시된 경우 true입니다. 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    재부팅

    public void reboot (String reason)

    재부팅 시 유지되도록 지정된 reason를 사용하여 기기를 adb 모드로 재부팅합니다.

    기기를 사용할 수 있을 때까지 차단됩니다.

    마지막 재부팅 사유는 sys.boot.reason 속성을 쿼리하여 가져올 수 있습니다.

    매개변수
    reason String: 이 재부팅 이유 또는 이유가 지정되지 않은 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    재부팅

    public void reboot ()

    기기를 adb 모드로 재부팅합니다.

    기기를 사용할 수 있을 때까지 차단됩니다.

    생성 값
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    기기를 부트로더 모드로 재부팅합니다.

    기기가 부트로더 모드가 될 때까지 차단합니다.

    생성 값
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    기기를 fastbootd 모드로 재부팅합니다.

    기기가 빠른 부팅 모드(Fastbootd mode)가 될 때까지 차단합니다.

    생성 값
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    기기를 adb 복구 모드로 재부팅합니다.

    기기가 복구 모드로 전환될 때까지 차단

    생성 값
    DeviceNotAvailableException

    재부팅으로 사이드로드

    public void rebootIntoSideload ()

    기기를 adb 사이드로드 모드로 재부팅합니다 (복구의 특수 모드임).

    기기가 사이드로드 모드로 전환될 때까지 차단

    생성 값
    DeviceNotAvailableException

    재부팅으로 사이드로드

    public void rebootIntoSideload (boolean autoReboot)

    기기를 adb 사이드로드 모드로 재부팅합니다 (복구의 특수 모드임).

    기기가 사이드로드 모드로 전환될 때까지 차단

    매개변수
    autoReboot boolean: 사이드로드 후 기기를 자동으로 재부팅할지 여부입니다.

    생성 값
    DeviceNotAvailableException

    재부팅UntilOnline

    public void rebootUntilOnline ()

    기기가 온라인 상태가 될 때까지(즉, adb에 표시될 때까지)만 차단하는 reboot()의 대체입니다.

    생성 값
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    기기가 온라인 상태가 될 때까지, 즉 adb에 표시될 때까지만 차단하는 reboot()의 대안입니다.

    매개변수
    reason String: 이 재부팅 이유 또는 이유가 지정되지 않은 경우 null입니다.

    생성 값
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    기기의 사용자 공간 부분만 재부팅합니다.

    기기를 사용할 수 있을 때까지 차단합니다.

    경고 사용자 공간 재부팅은 현재 개발 중이며 사용에 따른 책임은 사용자에게 있습니다.

    생성 값
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    기기가 온라인 상태가 될 때까지(즉, adb에 표시될 때까지)만 차단하는 rebootUserspace() ()}의 대체입니다.

    생성 값
    DeviceNotAvailableException

    기기 복구

    public boolean recoverDevice ()

    기기 통신을 복구하려고 시도합니다.

    반환 값
    boolean 복구가 시도되고 성공하면 true를 반환하고 복구가 건너뛰어지면 false를 반환합니다.

    생성 값
    DeviceNotAvailableException 기기를 더 이상 사용할 수 없는 경우

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    이 기기에 IDeviceActionReceiver를 등록합니다.

    기기 작업이 시작되기 전과 기기 작업이 종료된 후 등록된 모든 IDeviceActionReceiver가 알림을 받습니다.

    매개변수
    deviceActionReceiver IDeviceActionReceiver: 등록할 IDeviceActionReceiver입니다.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    기기의 시스템 파티션을 읽기 전용으로 만듭니다. 기기가 재부팅될 수 있습니다.

    생성 값
    DeviceNotAvailableException

    시스템 쓰기 가능 다시 마운트

    public void remountSystemWritable ()

    기기의 시스템 파티션을 쓰기 가능하게 만듭니다. 기기를 재부팅할 수 있습니다.

    생성 값
    DeviceNotAvailableException

    VendorReadOnly 다시 마운트하기

    public void remountVendorReadOnly ()

    기기의 공급업체 파티션을 읽기 전용으로 만듭니다. 기기가 재부팅될 수 있습니다.

    생성 값
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    기기의 공급업체 파티션을 쓰기 가능하게 만듭니다. 기기가 재부팅될 수 있습니다.

    생성 값
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    지정된 사용자에서 지정된 기기 관리자를 삭제하고 성공하면 true를, 실패하면 false를 반환합니다.

    매개변수
    componentName String: 삭제할 기기 관리자의 ID입니다.

    userId int: 기기 관리자가 거주하는 사용자입니다.

    반환 값
    boolean 성공하면 true, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    최선을 다해 기존의 모든 기기 프로필 소유자를 삭제합니다.

    생성 값
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    기기에서 특정 사용자를 삭제합니다.

    매개변수
    userId int: 삭제할 사용자의 권한

    반환 값
    boolean 사용자를 삭제하는 데 성공하면 true를 반환하고 그렇지 않으면 false를 반환합니다.

    생성 값
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    콘텐츠 제공업체 설정을 다시 트리거하려면 플래그를 재설정합니다.

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    매개변수로 전달된 하나 이상의 리스너로 ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))를 실행하는 편의 메서드입니다.

    매개변수
    runner IRemoteAndroidTestRunner: 테스트를 실행하는 IRemoteAndroidTestRunner

    listeners ITestLifeCycleReceiver: 테스트 결과 리스너

    반환 값
    boolean 테스트 명령어가 완료된 경우 true false(완료에 실패했지만 복구에 성공한 경우)

    생성 값
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    계측 테스트를 실행하고 기기 복구를 제공합니다.

    테스트 실행이 완료되기 전에 기기와의 연결이 끊어지고 복구에 성공하면 모든 리스너에게 testRunFailed에 대한 알림이 전송되고 'false'가 반환됩니다. 테스트 명령어는 다시 실행되지 않습니다. 필요한 경우 호출자가 재시도해야 합니다.

    테스트 실행이 완료되기 전에 기기와의 연결이 끊기고 복구에 실패하면 모든 리스너에 testRunFailed에 대한 알림이 전송되고 DeviceNotAvailableException이 발생합니다.

    매개변수
    runner IRemoteAndroidTestRunner: 테스트를 실행하는 IRemoteAndroidTestRunner입니다.

    listeners : 테스트 결과 리스너

    반환 값
    boolean 테스트 명령어가 완료된 경우 true입니다. 기기 통신 예외로 인해 완료되지 못했지만 복구에 성공한 경우 false

    생성 값
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))와 동일하지만 지정된 사용자에 대해 테스트를 실행합니다.

    매개변수
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)와 동일하지만 지정된 사용자에 대해 테스트를 실행합니다.

    매개변수
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    사용 중인 IConfiguration를 삽입합니다.

    매개변수
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    매개변수
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    기기의 날짜 설정

    참고: 기기에서 날짜를 설정하려면 루트 권한이 필요합니다.

    매개변수
    date Date: 특정 날짜를 지정합니다. null인 경우 호스트 날짜를 사용합니다.

    생성 값
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    특정 사용자의 기기 관리자 구성요소를 기기 소유자로 설정합니다.

    매개변수
    componentName String: 기기 관리자가 기기 소유자입니다.

    userId int: 기기 소유자가 거주하는 사용자의 수입니다.

    반환 값
    boolean 성공하면 true, 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    기기의 상태를 업데이트합니다.

    매개변수
    deviceState TestDeviceState: TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    에뮬레이터의 경우 SizeLimitedOutputStream를 로그 출력으로 설정합니다.

    매개변수
    output SizeLimitedOutputStream: 출력을 로깅합니다.

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    이 기기가 에뮬레이터인 경우 Process를 설정합니다.

    매개변수
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    기기의 빠른 부팅 옵션을 설정합니다. 기기가 처음 할당될 때 설정해야 합니다.

    매개변수
    fastbootEnabled boolean: 기기에서 빠른 부팅을 사용할 수 있는지 여부입니다.

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    사용해야 하는 빠른 부팅 바이너리의 경로를 설정합니다. 빠른 부팅 기능을 사용 설정하려면 여전히 isFastbootEnabled()이(가) true여야 합니다.

    매개변수
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    이 ITestDevice와 연결된 IDevice를 업데이트합니다.

    새 IDevice는 현재 참조와 동일한 실제 기기를 참조해야 합니다. DDMS에서 새 IDevice를 할당한 경우 이 메서드가 호출됩니다.

    매개변수
    newDevice IDevice: IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    온라인 기기의 logcat 캡처를 시작하기 전에 대기할 시간을 밀리초 단위로 설정합니다.

    매개변수
    delay int: 지연 시간(밀리초)

    setOptions에

    public void setOptions (TestDeviceOptions options)

    기기의 TestDeviceOptions 설정

    매개변수
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    기기에서 지정된 속성 값을 설정합니다. adb 루트가 true여야 합니다.

    매개변수
    propKey String: 설정할 타겟팅 키입니다.

    propValue String: 설정할 속성 값입니다.

    반환 값
    boolean setprop 명령어가 성공하면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

    생성 값
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    이 기기에 사용할 IDeviceRecovery를 설정합니다. 기기가 처음 할당될 때 설정해야 합니다.

    매개변수
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    기기에 사용할 현재 복구 모드를 설정합니다.

    기기 통신 문제가 발생할 때 사용할 복구 방법을 제어하는 데 사용됩니다. 이 메서드는 필요한 경우에만 쓰고 (예: 프레임워크가 다운된 경우 등)

    매개변수
    mode ITestDevice.RecoveryMode: '온라인 상태가 될 때까지 복구' 모드를 사용 설정할지 여부입니다.

    setSetting

    public void setSetting (String namespace, 
                    String key, 
                    String value)

    setSetting(int, String, String, String)를 참고하고 시스템 사용자에게 실행됩니다.

    매개변수
    namespace String

    key String

    value String

    생성 값
    DeviceNotAvailableException

    setSetting

    public void setSetting (int userId, 
                    String namespace, 
                    String key, 
                    String value)

    특정 사용자의 네임스페이스에 설정 값을 추가합니다. 일부 설정은 재부팅 후에만 사용할 수 있습니다. 네임스페이스는 {"system", "secure", "global"} 중 하나여야 합니다.

    매개변수
    userId int

    namespace String

    key String

    value String

    생성 값
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    ITestLogger 인스턴스를 삽입합니다.

    매개변수
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    기기 관리 목적으로 기기를 참조하는 데 사용하는 일련번호를 추적합니다.

    매개변수
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    빠른 부팅 삭제 또는 빠른 부팅 형식을 사용하여 기기의 파티션을 삭제할지 설정합니다.

    매개변수
    useFastbootErase boolean: 빠른 부팅 지우기를 사용해야 하는 경우 true, 빠른 부팅 형식을 사용해야 하는 경우 false입니다.

    startLogcat

    public void startLogcat ()

    백그라운드에서 기기의 logcat 출력 캡처를 시작합니다.

    logcat 출력이 이미 캡처되고 있는 경우에는 영향을 미치지 않습니다. 나중에 getLogcat을 통해 데이터를 가져올 수 있습니다.

    기기를 더 이상 사용하지 않으면 stopLogcat()를 호출해야 합니다.

    TF 프레임워크가 logcat을 시작하고 중지하므로 일반적으로 TF 호출 컨텍스트 내에서 startLogcat()stopLogcat()를 호출할 필요가 없습니다.

    startUser

    public boolean startUser (int userId)

    현재 중지된 경우 백그라운드에서 지정된 사용자를 시작합니다. 사용자가 이미 백그라운드에서 실행 중인 경우 이 메서드는 NOOP입니다.

    매개변수
    userId int: 백그라운드에서 시작할 사용자의 권한

    반환 값
    boolean 사용자가 백그라운드에서 성공적으로 시작했으면 true를 반환합니다.

    생성 값
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    현재 중지된 경우 백그라운드에서 지정된 사용자를 시작합니다. 사용자가 이미 백그라운드에서 실행 중인 경우 이 메서드는 NOOP입니다. 작업이 적용될 때까지 기다리는 추가 플래그를 제공할 수 있습니다.

    매개변수
    userId int: 백그라운드에서 시작할 사용자입니다.

    waitFlag boolean: 사용자가 시작되고 잠금 해제될 때까지 명령어가 대기합니다.

    반환 값
    boolean 사용자가 백그라운드에서 성공적으로 시작했으면 true를 반환합니다.

    생성 값
    DeviceNotAvailableException

    startVisibleBackgroundUser

    public boolean startVisibleBackgroundUser (int userId, 
                    int displayId, 
                    boolean waitFlag)

    백그라운드에서 지정된 사용자를 시작하여 지정된 디스플레이에 표시합니다 (즉, 사용자가 해당 디스플레이에서 활동을 실행할 수 있도록 허용).

    참고: 이 명령어는 사용자가 존재하는지, 디스플레이를 사용할 수 있는지, device supports such feature 등을 확인하지 않습니다.

    매개변수
    userId int: 백그라운드에서 시작할 사용자입니다.

    displayId int: 사용자가 표시할 시작 표시

    waitFlag boolean: 사용자가 시작되고 잠금 해제될 때까지 명령어가 대기합니다.

    반환 값
    boolean true: 사용자가 백그라운드에서 성공적으로 표시된 경우

    생성 값
    DeviceNotAvailableException

    StopEmulatorOutput

    public void stopEmulatorOutput ()

    에뮬레이터 출력을 닫고 삭제합니다.

    stopLogcat

    public void stopLogcat ()

    기기에서 logcat 출력 캡처를 중지하고 현재 저장된 logcat 데이터를 삭제합니다.

    Logcat 출력이 캡처되지 않으면 아무런 영향을 미치지 않습니다.

    stopUser

    public boolean stopUser (int userId)

    지정된 사용자를 중지합니다. 사용자가 이미 중지된 경우 이 메서드는 NOOP입니다. 현재 사용자와 시스템 사용자는 중지할 수 없습니다.

    매개변수
    userId int: 중지할 사용자입니다.

    반환 값
    boolean 사용자가 중지된 경우 true입니다.

    생성 값
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId, 
                    boolean waitFlag, 
                    boolean forceFlag)

    지정된 사용자를 중지합니다. 작업이 적용될 때까지 기다리고 사용자를 강제 종료하는 추가 플래그를 제공할 수 있습니다. 현재 사용자와 시스템 사용자는 중지할 수 없습니다.

    매개변수
    userId int: 중지할 사용자입니다.

    waitFlag boolean: 사용자가 중지될 때까지 명령어를 대기시킵니다.

    forceFlag boolean: 사용자를 강제 종료합니다.

    반환 값
    boolean 사용자가 중지된 경우 true입니다.

    생성 값
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    기기를 adb-over-tcp 모드로 전환합니다.

    반환 값
    String 기기를 전환할 수 없는 경우 tcp 일련번호 또는 null

    생성 값
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    USB 모드를 통해 기기를 adb로 전환합니다.

    반환 값
    boolean 전환에 성공하면 true이고 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

    기본 시간 제한으로 다른 userId로 전환합니다. switchUser(int, long).

    매개변수
    userId int

    반환 값
    boolean 새 userId가 userId 제공업체와 일치하는 경우 true입니다. 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    제공된 제한 시간을 기한으로 다른 userId로 전환합니다. 사용자 변경이 완료된 후 키가드 사용 중지를 시도합니다.

    매개변수
    userId int

    timeout long: switch-user 실패에 대해 false를 반환하기 전에 기다립니다.

    반환 값
    boolean 새 userId가 userId 제공업체와 일치하는 경우 true입니다. 그렇지 않으면 false입니다.

    생성 값
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    로컬 파일 디렉터리의 콘텐츠를 기기에 점진적으로 동기화합니다.

    로컬 파일의 타임스탬프를 원격 파일의 타임스탬프와 비교하여 푸시할 파일을 결정합니다. '최신' 파일 또는 존재하지 않는 파일만 기기에 푸시됩니다. 따라서 기기에 설정된 파일이 이미 최신 상태인 경우 오버헤드는 비교적 작습니다.

    이름이 '.'으로 시작하는 숨겨진 파일은 무시됩니다.

    사용 예: syncFiles("/tmp/files", "/sdcard")는 /sdcard/files 디렉터리가 아직 없는 경우 이를 만들고 /tmp/files 콘텐츠를 /sdcard/files에 재귀적으로 푸시합니다.

    매개변수
    localFileDir File: 재귀적으로 푸시할 파일이 포함된 로컬 파일 디렉터리입니다.

    deviceFilePath String: 원격 대상 절대 파일 경로 루트입니다. 이 파일 경로의 모든 디렉터리는 읽을 수 있어야 합니다. 즉, adb가 루트가 아닐 때 /data/local/tmp로 푸시하면 실패합니다.

    반환 값
    boolean 파일이 동기화된 경우 true 그 밖의 경우에는 false입니다.

    생성 값
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    버그 신고를 가져와 처리하기 위해 Bugreport 객체 내에서 반환합니다. 문제가 발생하면 null을 반환합니다. Bugreport 객체에서 참조된 파일은 Bugreport.close()를 통해 정리해야 합니다.

    반환 값
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

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

    매개변수
    packageName String: 제거할 Android 패키지입니다.

    반환 값
    String 오류 코드가 있는 String 또는 성공인 경우 null

    생성 값
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    지정된 사용자의 기기에서 Android 패키지를 제거합니다.

    매개변수
    packageName String: 제거할 Android 패키지입니다.

    userId int: 제거할 정수 사용자 ID입니다.

    반환 값
    String 오류 코드가 있는 String 또는 성공인 경우 null

    생성 값
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    기기가 암호화된 상태인 경우 기기를 잠금 해제합니다.

    이 메서드는 프레임워크를 다시 시작할 수 있지만 postBootSetup()를 호출하지 않습니다. 따라서 이 메서드가 반환될 때 기기가 테스트할 준비가 완전히 되지 않았을 수 있습니다.

    반환 값
    boolean 성공한 경우 또는 기기가 암호화되지 않은 경우 true.

    생성 값
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    debugfs를 마운트 해제합니다.

    생성 값
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    기기의 부팅 완료 플래그가 설정될 때까지 차단합니다.

    매개변수
    timeOut long: 플래그가 설정될 때까지 기다리는 시간(밀리초)

    반환 값
    boolean 기기의 부팅 완료 플래그가 제한 시간 내에 설정된 경우 true

    생성 값
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    기기가 반응하고 테스트에 사용할 수 있을 때까지 기다립니다. 기본 시간 제한을 사용합니다.

    반환 값
    boolean 기기를 사용할 수 있는 경우 true이고 복구가 사용 중지되어 사용할 수 없는 경우 false입니다.

    생성 값
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    기기가 응답하고 테스트할 수 있을 때까지 기다립니다.

    매개변수
    waitTime long: 대기할 시간(밀리초)

    반환 값
    boolean 기기를 사용할 수 있는 경우 true이고 복구가 사용 중지되어 사용할 수 없는 경우 false입니다.

    생성 값
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    복구 경로를 고려하지 않고 기기가 응답하고 사용 가능해질 때까지 기다립니다.

    매개변수
    waitTime long

    반환 값
    boolean 기기를 사용할 수 있으면 true, 사용할 수 없으면 false입니다.

    생성 값
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    빠른 부팅을 통해 기기가 표시될 때까지 차단합니다. 기본 시간 제한을 사용합니다.

    생성 값
    DeviceNotAvailableException

    기기 복구 대기

    public boolean waitForDeviceInRecovery (long waitTime)

    기기가 'adb recovery' 상태에 있는 블록입니다 (IDeviceRecovery과 구분됨).

    매개변수
    waitTime long: 대기할 시간(밀리초)

    반환 값
    boolean 시간이 만료되기 전에 기기가 복구 모드로 부팅되면 true입니다. 그 밖의 경우 false

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    기기가 'adb 사이드로드' 상태가 되는 것을 차단합니다.

    매개변수
    waitTime long: 대기할 시간(밀리초)

    반환 값
    boolean 시간이 만료되기 전에 기기가 사이드로드로 부팅되는 경우 true입니다. 그 밖의 경우 false

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    기기를 사용할 수 없도록 차단합니다(예: adb에서 누락됨).

    매개변수
    waitTime long: 대기할 시간(밀리초)

    반환 값
    boolean 시간이 만료되기 전에 기기를 사용할 수 없게 된 경우 true 그 밖의 경우 false

    WaitForDeviceOnline

    public void waitForDeviceOnline ()

    adb를 통해 기기가 표시될 때까지 차단합니다. 기본 제한 시간 사용

    기기가 완료 시 명령어에 응답하지 않을 수도 있습니다. 대신 waitForDeviceAvailable()를 사용하세요.

    생성 값
    DeviceNotAvailableException

    WaitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    adb를 통해 기기가 표시될 때까지 차단합니다.

    완료 시 기기가 명령어에 응답하지 않을 수도 있습니다. 대신 waitForDeviceAvailable()를 사용하세요.

    매개변수
    waitTime long: 대기할 시간(밀리초)

    생성 값
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    기기가 기본 adb 셸 명령어에 응답할 때까지 기다립니다.

    매개변수
    waitTime long: 대기할 시간(밀리초)

    반환 값
    boolean waitTime이 경과하기 전에 기기가 응답하는 경우 true

    보호된 메서드

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    매개변수
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    지정된 adb 셸 명령어 세션 및 인수의 OS 명령어를 빌드합니다.

    매개변수
    command String

    forceExitStatusDetection boolean

    반환 값
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    매개변수
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    재부팅 작업을 실행할 때 사용할 RebootDeviceAction를 만듭니다.

    매개변수
    rebootMode NativeDevice.RebootMode: 이 재부팅의 모드입니다.

    reason String: 이 재부팅에 관한 정보입니다.

    반환 값
    NativeDevice.RebootDeviceAction 생성된 RebootDeviceAction

    createRunUtil

    protected IRunUtil createRunUtil ()

    반환 값
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    adb 재부팅을 실행합니다.

    매개변수
    rebootMode NativeDevice.RebootMode: 이 재부팅의 모드입니다.

    reason String: 이 재부팅에 관한 정보입니다.

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    런타임 권한이 지원되지 않는 경우 예외를 발생시키는 도우미 메서드

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    반환 값
    int

    getLogger

    protected ITestLogger getLogger ()

    반환 값
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    사용할 RunUtil 인스턴스를 가져옵니다.

    반환 값
    IRunUtil

    initializeConnection

    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    매개변수
    info IBuildInfo

    attributes MultiMap

    생성 값
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    기본적으로 ddmlib 캐시에서 기기 속성을 가져오고, 기기가 빠른 부팅 상태인지 여부에 따라 `adb shell getprop` 또는 `fastboot getvar` 로 대체합니다.

    매개변수
    propName String: `adb shell getprop`에서 반환한 기기 속성의 이름

    fastbootVar String: 쿼리할 동등한 빠른 부팅 변수의 이름입니다. null인 경우 빠른 부팅 쿼리를 시도하지 않습니다.

    description String: 변수에 대한 간단한 설명입니다. 첫 글자는 대문자로 표기해야 합니다.

    반환 값
    String 지정된 속성의 값을 포함하는 문자열(null 또는 비어 있을 수 있음)

    생성 값
    DeviceNotAvailableException

    isIn재부팅 콜백

    protected boolean isInRebootCallback ()

    재부팅 콜백이 현재 실행 중인지 여부를 반환합니다. 이 속성이 true이면 재부팅을 위한 모든 공개 API를 사용 중지해야 합니다.

    반환 값
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    로컬 파일이 원격 파일보다 최신인 경우 true를 반환합니다. IFileEntry는 분 단위로 정확하며 시간이 동일한 경우 파일이 더 최신으로 간주됩니다.

    매개변수
    localFile File

    entry IFileEntry

    반환 값
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    모든 IDeviceActionReceiver에 재부팅 종료 이벤트에 관해 알립니다.

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    모든 IDeviceActionReceiver에 재부팅 시작 이벤트에 관해 알립니다.

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    수행기기 작업

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    이 기기에서 작업을 실행합니다. 기기를 복구하려고 시도하고 작업이 실패하면 원하는 경우 명령어를 다시 시도합니다.

    매개변수
    actionDescription String: 실행할 작업에 대한 간단한 설명입니다. 로깅 목적으로만 사용됩니다.

    action NativeDevice.DeviceAction: 실행할 작업입니다.

    retryAttempts int: 실패하지만 복구에 성공한 경우 작업을 위한 재시도

    반환 값
    boolean 작업이 성공적으로 실행된 경우 true

    생성 값
    DeviceNotAvailableException 복구 시도가 실패하거나 성공하지 못한 채 최대 시도 횟수를 모두 사용한 경우

    postAdbReboot

    protected void postAdbReboot ()

    재부팅 후 취할 수 있는 추가 작업

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    각 기기 유형 (AndroidNativeDevice, TestDevice)이 특정 부팅 후 설정에 대해 이 메서드를 재정의할 수 있습니다.

    생성 값
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    매개변수
    remoteFilePath String

    localFile File

    반환 값
    boolean

    생성 값
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    사용할 시계 인스턴스를 설정합니다.

    매개변수
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    TestDevice를 microdroid로 표시하고 CID를 설정합니다.

    매개변수
    process Process: Microdroid VM의 프로세스입니다.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    매개변수
    deviceOptions

    SimpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    환경 변수를 사용하여 간단한 빠른 부팅 명령어를 실행하고 명령어의 상태를 보고합니다.

    매개변수
    timeout long

    envVarMap

    fullCmd String

    반환 값
    CommandResult

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    간단한 빠른 부팅 명령어를 실행하고 명령어 상태를 보고합니다.

    매개변수
    timeout long

    fullCmd String

    반환 값
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    기기가 사용 불가 상태가 될 때까지 기다립니다 (adb에 보고 중지).

    매개변수
    operationDesc String: 사용할 수 없게 대기 중인 작업의 이름입니다.

    time long: 사용 불가 상태가 발생할 때까지 기다리는 시간입니다.

    반환 값
    boolean 기기를 사용할 수 없게 된 경우 true입니다.