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 ....' 명령어를 실행하기 위한 |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
상수 | |
---|---|
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)
|
공개 메서드 | |
---|---|
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(
Wi-Fi 네트워크에 연결합니다. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Wi-Fi 네트워크에 연결합니다. |
boolean
|
connectToWifiNetwork(
Wi-Fi 네트워크에 연결합니다. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Wi-Fi 네트워크에 연결합니다. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
기기가 현재 네트워크에 연결되어 있지 않은 경우에만 연결되는 |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
기기가 현재 네트워크에 연결되어 있지 않은 경우에만 연결되는 |
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)
등록된 |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
현재 system_server를 이전 system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
기기 및 |
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,
지정된 제한 시간으로 adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다. |
String
|
executeAdbCommand(String... cmdArgs)
adb 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
기본 제한 시간 2분으로 빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
장기 실행 빠른 부팅 명령어를 시스템 명령어로 실행하는 도우미 메서드입니다. |
CommandResult
|
executeLongFastbootCommand(
시스템 환경 변수를 사용하여 시스템 명령어로 장기 실행 빠른 부팅 명령어를 실행하는 도우미 메서드입니다. |
String
|
executeShellCommand(String command)
adb 셸 명령어를 실행하고 출력을 |
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
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
adb 셸 명령어를 실행하고 명령어 상태 출력 및 stderr로 올바르게 채워진 |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
adb 셸 명령어를 실행하고 명령어 상태 출력, stdout, stderr로 올바르게 채워진 |
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
|
getCachedDeviceDescriptor(boolean shortDescriptor)
기기가 할당되면 캐시된 |
String[]
|
getChildren(String path)
권한으로 인해 가끔 작동하지 않는 |
AbstractConnection
|
getConnection()
기기와 연결된 현재 연결입니다. |
ContentProviderHandler
|
getContentProvider(int userId)
|
DeviceFoldableState
|
getCurrentFoldableState()
기기의 현재 폴더블 상태를 반환하거나 문제가 발생한 경우 null을 반환합니다. |
int
|
getCurrentUser()
현재 실행 중인 사용자의 ID를 반환합니다. |
String
|
getDeviceClass()
기기 클래스를 가져옵니다. |
long
|
getDeviceDate()
에포크 이후 밀리초 단위로 기기의 날짜를 반환합니다. |
DeviceDescriptor
|
getDeviceDescriptor()
기기 정보에서 |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
기기 정보에서 |
TestDeviceState
|
getDeviceState()
기기의 상태를 가져옵니다. |
long
|
getDeviceTimeOffset(Date date)
기기와 지정된 |
InputStreamSource
|
getEmulatorOutput()
에뮬레이터 stdout 및 stderr의 스트림 가져오기 |
Process
|
getEmulatorProcess()
이 에뮬레이터에 해당하는 |
final
File
|
getExecuteShellCommandLog()
모든 |
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)
루트가 아닌 경로에서 |
|
getFoldableStates()
기기의 폴더블 상태 목록을 반환합니다. |
IDevice
|
getIDevice()
연결된 ddmlib |
|
getInstalledPackageNames()
기기에 있는 애플리케이션 패키지 이름을 가져옵니다. |
long
|
getIntProperty(String name, long defaultValue)
기기에서 지정된 속성의 정수 값을 반환합니다. |
String
|
getIpAddress()
기기의 IP 주소를 가져옵니다. |
KeyguardControllerState
|
getKeyguardState()
키가드의 현재 상태를 가져오는 객체를 반환하거나 지원되지 않는 경우 null을 반환합니다. |
long
|
getLastExpectedRebootTimeMillis()
|
int
|
getLaunchApiLevel()
기기가 처음 출시된 API 수준을 가져옵니다. |
InputStreamSource
|
getLogcat()
Logcat 데이터의 스냅샷 스트림을 가져옵니다. |
InputStreamSource
|
getLogcat(int maxBytes)
캡처된 logcat 데이터의 마지막 |
InputStreamSource
|
getLogcatDump()
기기의 현재 logcat 덤프를 가져옵니다. |
InputStreamSource
|
getLogcatSince(long date)
제공된 날짜부터 캡처된 logcat 데이터의 스냅샷 스트림을 가져옵니다. |
String
|
getMacAddress()
기기의 MAC 주소를 반환합니다. 기기에서 쿼리하지 못하면 null을 반환합니다. |
Integer
|
getMainUserId()
기본 사용자 ID를 반환합니다. |
|
getMainlineModuleInfo()
기기에 설치된 메인라인 모듈에 관한 정보를 가져옵니다. |
int
|
getMaxNumberOfRunningUsersSupported()
동시에 실행되는 최대 지원 사용자 수를 가져옵니다. |
int
|
getMaxNumberOfUsersSupported()
지원되는 최대 사용자 수를 가져옵니다. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
기기와 연결된 |
String
|
getMountPoint(String mountName)
마운트 지점을 반환합니다. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
지정된 마운트 포인트 경로에 해당하는 |
|
getMountPointInfo()
기기의 /proc/mounts에 있는 정보를 파싱한 버전을 반환합니다. |
TestDeviceOptions
|
getOptions()
기기의 테스트 옵션을 가져옵니다. |
long
|
getPartitionFreeSpace(String partition)
기기 파티션의 여유 공간을 확인하는 도우미 메서드입니다. |
Integer
|
getPrimaryUserId()
기본 사용자 ID를 반환합니다. |
ProcessInfo
|
getProcessByName(String processName)
도우미 메서드는 'pidof' 및 'stat' 명령어를 실행하고 지정된 프로세스의 PID 및 프로세스 시작 시간이 포함된 |
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)
|
String
|
getSimOperator()
SIM 카드 사업자를 반환하거나, 사용할 수 없거나 기기를 사용할 수 없는 경우 null을 반환합니다. |
String
|
getSimState()
SIM 카드 상태를 반환하거나, 사용할 수 없거나 기기를 사용할 수 없는 경우 null을 반환합니다. |
|
getTombstones()
기기에서 tombstone 목록을 가져와 반환합니다. |
long
|
getTotalMemory()
총 실제 메모리 크기(바이트)를 반환하거나 내부 오류가 발생하면 -1을 반환합니다. |
String
|
getTrackingSerial()
기기 관리 목적으로 기기를 추적하는 데 사용되는 일련번호를 가져옵니다. |
|
getUninstallablePackageNames()
제거할 수 있는 애플리케이션 패키지 이름을 가져옵니다. |
boolean
|
getUseFastbootErase()
기기의 파티션을 삭제하는 데 빠른 부팅 삭제 또는 빠른 부팅 형식을 사용할지 여부를 가져옵니다. |
int
|
getUserFlags(int userId)
지정된 사용자의 신고를 찾아 반환합니다. |
|
getUserInfos()
기기에서 useId와 |
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()
기기가 |
boolean
|
isUserRunning(int userId)
특정 사용자가 실행 중인지 확인합니다. |
boolean
|
isUserSecondary(int userId)
지정된 사용자가 해당 플래그에 따라 보조 사용자인지 여부를 반환합니다. |
boolean
|
isUserVisible(int userId)
지정된 사용자가 표시되는지 확인합니다. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
지정된 사용자가 지정된 디스플레이에 표시되는지 확인합니다. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
기기가 사용자가 |
boolean
|
isVisibleBackgroundUsersSupported()
기기에서 사용자가 백그라운드에서 표시되도록 시작할 수 있는지 여부를 반환합니다. |
boolean
|
isWifiEnabled()
Wi-Fi가 사용 설정되어 있는지 테스트합니다. |
|
listDisplayIds()
'dumpsys SurfaceFlinger'에서 보고한 대로 기기에서 사용 가능한 디스플레이 ID 목록을 수집합니다. |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
|
|
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)
기기에서 파일을 가져와 로컬 임시 |
File
|
pullFile(String remoteFilePath)
기기에서 파일을 가져와 로컬 임시 |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
기기에서 파일을 검색합니다. |
String
|
pullFileContents(String remoteFilePath)
기기 외부에서 파일을 검색하고 콘텐츠를 반환합니다. |
File
|
pullFileFromExternal(String remoteFilePath)
기기의 외부 저장소에서 파일을 가져와 로컬 임시 |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
필터링된 일부 디렉터리를 제외하면서 디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
디렉터리 콘텐츠를 기기에 재귀적으로 푸시합니다. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
선택적으로 콘텐츠 제공자의 필요성을 평가할 수 있는 |
boolean
|
pushFile(File localFile, String remoteFilePath)
기기에 파일을 푸시합니다. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
기기에 파일을 푸시합니다. |
boolean
|
pushString(String contents, String remoteFilePath)
문자열로 생성된 파일을 기기에 푸시 |
void
|
reboot(String reason)
재부팅 시 유지되도록 지정된 |
void
|
reboot()
기기를 adb 모드로 재부팅합니다. |
void
|
rebootIntoBootloader()
기기를 부트로더 모드로 재부팅합니다. |
void
|
rebootIntoFastbootd()
기기를 fastbootd 모드로 재부팅합니다. |
void
|
rebootIntoRecovery()
기기를 adb 복구 모드로 재부팅합니다. |
void
|
rebootIntoSideload()
기기를 adb 사이드로드 모드로 재부팅합니다 (복구 모드의 특수 모드입니다). 기기가 사이드로드 모드로 전환될 때까지 차단 |
void
|
rebootIntoSideload(boolean autoReboot)
기기를 adb 사이드로드 모드로 재부팅합니다 (복구의 특수 모드임). 기기가 사이드로드 모드로 전환될 때까지 차단 |
void
|
rebootUntilOnline()
기기가 온라인 상태가 될 때까지, 즉 adb에 표시될 때까지만 차단하는 |
void
|
rebootUntilOnline(String reason)
기기가 온라인 상태가 될 때까지(즉, adb에 표시될 때까지)만 차단하는 |
void
|
rebootUserspace()
기기의 사용자 공간 부분만 재부팅합니다. |
void
|
rebootUserspaceUntilOnline()
기기가 온라인 상태가 되어 adb에 표시될 때까지만 차단하는 |
boolean
|
recoverDevice()
기기 통신 복구를 시도합니다. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
이 기기에 |
void
|
remountSystemReadOnly()
기기의 시스템 파티션을 읽기 전용으로 설정합니다. |
void
|
remountSystemWritable()
기기의 시스템 파티션을 쓰기 가능하게 만듭니다. |
void
|
remountVendorReadOnly()
기기의 공급업체 파티션을 읽기 전용으로 만듭니다. |
void
|
remountVendorWritable()
기기의 공급업체 파티션을 쓰기 가능하게 만듭니다. |
boolean
|
removeAdmin(String componentName, int userId)
지정된 사용자의 기기 관리자를 삭제하고 성공하면 |
void
|
removeOwners()
최선을 다해 기존의 모든 기기 프로필 소유자를 삭제합니다. |
boolean
|
removeUser(int userId)
기기에서 특정 사용자를 삭제합니다. |
void
|
resetContentProviderSetup()
콘텐츠 제공업체 설정을 다시 트리거하려면 플래그를 재설정합니다. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
매개변수로 전달된 하나 이상의 리스너로 |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
계측 테스트를 실행하고 기기 복구를 제공합니다. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
|
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
|
void
|
setConfiguration(IConfiguration configuration)
사용 중인 |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
기기에 날짜 설정 참고: 기기에서 날짜를 설정하려면 루트 권한이 필요합니다. |
boolean
|
setDeviceOwner(String componentName, int userId)
특정 사용자의 기기 관리 구성요소를 기기 소유자로 설정합니다. |
void
|
setDeviceState(TestDeviceState deviceState)
기기의 상태를 업데이트합니다. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
에뮬레이터의 경우 |
void
|
setEmulatorProcess(Process p)
이 기기가 에뮬레이터인 경우 |
void
|
setFastbootEnabled(boolean fastbootEnabled)
기기의 빠른 부팅 옵션을 설정합니다. |
void
|
setFastbootPath(String fastbootPath)
사용해야 하는 빠른 부팅 바이너리의 경로를 설정합니다. |
void
|
setIDevice(IDevice newDevice)
이 ITestDevice와 연결된 IDevice를 업데이트합니다. |
void
|
setLogStartDelay(int delay)
온라인 기기의 logcat 캡처를 시작하기 전에 대기할 시간을 밀리초 단위로 설정합니다. |
void
|
setOptions(TestDeviceOptions options)
기기의 |
boolean
|
setProperty(String propKey, String propValue)
기기에서 지정된 속성 값을 설정합니다. |
void
|
setRecovery(IDeviceRecovery recovery)
이 기기에 사용할 |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
기기에 사용할 현재 복구 모드를 설정합니다. |
void
|
setSetting(String namespace, String key, String value)
|
void
|
setSetting(int userId, String namespace, String key, String value)
특정 사용자의 네임스페이스에 설정 값을 추가합니다. |
void
|
setTestLogger(ITestLogger testLogger)
|
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()
버그 신고를 가져와 처리하기 위해 |
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' 상태에 있는 블록입니다 ( |
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)
재부팅 작업을 실행할 때 사용할 |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
adb 재부팅을 실행합니다. |
void
|
ensureRuntimePermissionSupported()
런타임 권한이 지원되지 않는 경우 예외를 발생시키는 도우미 메서드 |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
사용할 |
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)
로컬 파일이 원격 파일보다 최신인 경우 |
void
|
notifyRebootEnded()
모든 |
void
|
notifyRebootStarted()
모든 |
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(
|
CommandResult
|
simpleFastbootCommand(long timeout,
환경 변수를 사용하여 간단한 빠른 부팅 명령어를 실행하고 명령어의 상태를 보고합니다. |
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
공개 생성자
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
publicgetActiveApexes ()
기기에서 활성화된 APEX에 관한 정보를 가져옵니다.
반환 값 | |
---|---|
|
현재 기기에서 활성화된 ApexInfo 중 ERROR(/Set) 개 |
생성 값 | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (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
publicgetAndroidIds ()
일치하는 사용자 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
publicgetAppPackageInfos ()
기기에 설치된 패키지 정보를 가져옵니다.
반환 값 | |
---|---|
|
기기에 설치된 PackageInfo 중 ERROR(/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
publicgetBootHistory ()
도우미 메서드는 부팅 시간 및 부팅 이유가 포함된 부팅 기록 맵을 수집합니다.
반환 값 | |
---|---|
|
부팅 시간(에포크 이후 경과된 UTC 시간(초)) 및 부팅 이유 맵 |
생성 값 | |
---|---|
DeviceNotAvailableException |
이후 부팅 기록 가져오기
publicgetBootHistorySince (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 |
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 |
getDeviceDate
public long getDeviceDate ()
기기의 날짜를 에포크 이후 밀리초 단위로 반환합니다.
반환 값 | |
---|---|
long |
기기의 날짜(에포크 형식)입니다. |
생성 값 | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
기기 정보에서 DeviceDescriptor
를 반환하여 실제 기기 객체를 전달하지 않고 기기 정보를 가져옵니다.
반환 값 | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
기기 정보에서 DeviceDescriptor
를 반환하여 실제 기기 객체를 전달하지 않고 기기 정보를 가져옵니다.
매개변수 | |
---|---|
shortDescriptor |
boolean : 설명자를 최소한의 정보로 제한할지 여부입니다. |
반환 값 | |
---|---|
DeviceDescriptor |
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
publicgetFoldableStates ()
기기의 폴더블 상태 목록을 반환합니다. 'cmd device_state print-states'로 가져올 수 있습니다.
반환 값 | |
---|---|
|
생성 값 | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
연결된 ddmlib IDevice
에 대한 참조를 반환합니다.
기기가 adb에서 연결 해제되었다가 다시 연결될 때마다 DDMS에서 새 IDevice
를 할당할 수 있습니다. 따라서 호출자는 IDevice
에 대한 참조를 유지해서는 안 됩니다. 참조가 비활성 상태가 될 수 있기 때문입니다.
반환 값 | |
---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
기기에 있는 애플리케이션 패키지 이름을 가져옵니다.
반환 값 | |
---|---|
|
현재 기기에 설치된 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 데이터의 스냅샷 스트림을 가져옵니다.
다음 두 가지 모드로 작동합니다.
TestDeviceOptions.getMaxLogcatDataSize()
바이트 반환합니다.
반환 값 | |
---|---|
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
publicgetMainlineModuleInfo ()
기기에 설치된 메인라인 모듈에 관한 정보를 가져옵니다.
반환 값 | |
---|---|
|
현재 기기에 설치된 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'의 정보를 포함하는 MountPointInfo 의 ERROR(/List) |
생성 값 | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
기기의 /proc/mounts에 있는 정보를 파싱한 버전을 반환합니다.
반환 값 | |
---|---|
|
'/proc/mounts'의 정보를 포함하는 MountPointInfo 의 ERROR(/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
publicgetTombstones ()
기기에서 tombstone 목록을 가져와 반환합니다. 루트 권한이 필요합니다.
메서드는 최선의 방식으로 실행되므로 어떤 이유로든 하나의 삭제된 항목을 가져오지 못하면 목록에서 누락됩니다. DeviceNotAvailableException
만 메서드를 조기 종료합니다.
반환 값 | |
---|---|
|
삭제된 파일 목록입니다. 삭제된 파일이 없으면 비어 있습니다. |
생성 값 | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
총 물리적 메모리 크기를 바이트 단위로 반환하거나 내부 오류가 발생하면 -1을 반환합니다.
반환 값 | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
기기 관리 목적으로 기기를 추적하는 데 사용되는 일련번호를 가져옵니다.
반환 값 | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
제거할 수 있는 애플리케이션 패키지 이름을 가져옵니다. 이는 현재 비시스템 패키지 및 업데이트된 시스템 패키지로 정의됩니다.
반환 값 | |
---|---|
|
현재 기기에 설치된 제거 불가능한 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
publicgetUserInfos ()
기기에서 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 ()
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
publiclistDisplayIds ()
'dumpsys SurfaceFlinger'에서 보고한 대로 기기에서 사용 가능한 디스플레이 ID 목록을 수집합니다.
반환 값 | |
---|---|
|
디스플레이 목록입니다. 기본값은 항상 기본 디스플레이 0을 반환합니다. |
생성 값 | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
start a user visible in the background
에 사용할 수 있는 디스플레이 목록을 가져옵니다.
반환 값 | |
---|---|
|
생성 값 | |
---|---|
DeviceNotAvailableException |
listUsers
publiclistUsers ()
기기의 사용자 목록을 가져옵니다. 기기의 출력이 예상과 다르면 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입니다. |
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)
매개변수 | |
---|---|
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 |
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 |
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 |
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입니다. |