INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
ddmlib IDevice
에 안정적이고 약간 더 높은 수준의 API를 제공합니다.
요약
상수 | |
---|---|
int | UNKNOWN_API_LEVEL API 레벨을 감지할 수 없는 경우 기본값 |
공개 방법 | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) 최소 지원 수준에서 기능이 현재 지원되는지 여부를 확인합니다. |
abstract void | clearLogcat () 누적된 모든 logcat 데이터를 삭제합니다. |
abstract void | deleteFile (String deviceFilePath) 장치에서 파일 또는 디렉터리를 삭제하는 도우미 메서드입니다. |
abstract boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) 현재 system_server를 이전 system_server |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) device 및 해당 |
abstract boolean | disableAdbRoot () adb 루트를 끕니다. |
abstract boolean | doesFileExist (String deviceFilePath) 장치에 파일이 있는지 확인하는 도우미 메서드입니다. |
abstract boolean | enableAdbRoot () adb 루트를 켭니다. |
abstract String | executeAdbCommand (long timeout, String... commandArgs) 지정된 시간 초과로 adb 명령을 시스템 명령으로 실행하는 도우미 메서드입니다. |
abstract String | executeAdbCommand (String... commandArgs) adb 명령을 시스템 명령으로 실행하는 도우미 메서드입니다. |
abstract String | executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs) 지정된 시간 초과로 adb 명령을 시스템 명령으로 실행하는 도우미 메서드입니다. |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) fastboot 명령을 시스템 명령으로 실행하는 도우미 메서드입니다. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) 기본 제한 시간이 2분인 시스템 명령으로 fastboot 명령을 실행하는 도우미 메서드입니다. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) 오래 실행되는 fastboot 명령을 시스템 명령으로 실행하는 도우미 메서드입니다. |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) 장기 실행 fastboot 명령을 시스템 환경 변수와 함께 시스템 명령으로 실행하는 도우미 메서드입니다. |
abstract String | executeShellCommand (String command) adb shell 명령을 실행하고 출력을 |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) 명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) 명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) 지정된 adb 셸 명령을 실행하고 명령이 실패하면 여러 번 재시도합니다. |
abstract CommandResult | executeShellV2Command (String command) adb 셸 명령을 실행하고 명령 상태 출력, stdout 및 stderr로 적절하게 채워진 |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) adb 셸 명령을 실행하고 명령 상태 출력 및 stderr로 적절하게 채워진 |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) adb 셸 명령을 실행하고 명령 상태 출력, stdout 및 stderr로 적절하게 채워진 |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) 명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다. |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) 명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) 명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) 명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다. |
abstract CommandResult | fastbootWipePartition (String partition) 장치의 파티션을 지우는 도우미 메서드입니다. |
abstract int | getApiLevel () 장치 API 수준을 가져옵니다. |
abstract String | getBasebandVersion () 이 장치의 베이스밴드(라디오) 버전을 가져오는 편리한 방법입니다. |
abstract Integer | getBattery () 장치의 현재 배터리 수준을 반환하거나 배터리 수준을 사용할 수 없는 경우 Null을 반환합니다. |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) 주어진 속성의 부울 값을 반환합니다. |
abstract | getBootHistory () 도우미 메서드는 부팅 시간 및 부팅 이유와 함께 부팅 기록 맵을 수집합니다. |
abstract | getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Helper 메서드는 장치의 에포크 이후 지정된 시간 및 지정된 시간 단위 이후 부팅 시간 및 부팅 이유와 함께 부팅 기록 맵을 수집합니다. |
abstract String | getBootloaderVersion () 이 장치의 부트로더 버전을 가져오는 편리한 방법입니다. |
abstract String | getBuildAlias () 기기가 현재 실행 중인 빌드의 별칭을 검색합니다. |
abstract String | getBuildFlavor () 기기의 빌드 플레이버를 검색합니다. |
abstract String | getBuildId () 장치가 현재 실행 중인 빌드를 검색합니다. |
abstract String | getBuildSigningKeys () 장치 이미지 서명에 사용된 키 유형을 반환합니다. 일반적으로 Android 기기는 테스트 키(AOSP와 같은) 또는 릴리스 키(개별 기기 제조업체에서 제어)로 서명될 수 있습니다. |
abstract DeviceDescriptor | getCachedDeviceDescriptor () 장치가 할당된 경우 캐시된 |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) 장치가 할당된 경우 캐시된 |
abstract String[] | getChildren (String deviceFilePath) 권한으로 인해 때때로 작동하지 않는 |
abstract AbstractConnection | getConnection () 장치와 관련된 연결을 반환합니다. |
abstract String | getDeviceClass () 장치 클래스를 가져옵니다. |
abstract long | getDeviceDate () 에포크 이후의 장치 날짜를 밀리초 단위로 반환합니다. |
abstract DeviceDescriptor | getDeviceDescriptor () 장치 정보에서 |
abstract DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) 장치 정보에서 |
abstract TestDeviceState | getDeviceState () 장치의 상태를 가져옵니다. |
abstract long | getDeviceTimeOffset (Date date) 장치와 지정된 |
abstract InputStreamSource | getEmulatorOutput () 에뮬레이터 stdout 및 stderr 스트림 가져오기 |
abstract long | getExternalStoreFreeSpace () 장치 외부 저장소의 여유 공간을 결정하는 도우미 메서드입니다. |
abstract String | getFastbootProductType () 빠른 부팅 모드에 있을 때 이 장치의 제품 유형을 가져오는 편리한 방법입니다. |
abstract String | getFastbootProductVariant () 빠른 부팅 모드에 있을 때 이 장치의 제품 유형을 가져오는 편리한 방법입니다. |
abstract String | getFastbootSerialNumber () 빠른 부팅 모드 일련 번호를 반환합니다. |
abstract String | getFastbootVariable (String variableName) 장치에서 지정된 fastboot 변수 값을 검색합니다. |
abstract IFileEntry | getFileEntry (String path) 장치에서 원격 파일에 대한 참조를 검색합니다. |
abstract IDevice | getIDevice () 연결된 ddmlib |
abstract long | getIntProperty (String name, long defaultValue) 장치에서 주어진 속성의 정수 값을 반환합니다. |
abstract long | getLastExpectedRebootTimeMillis () |
abstract int | getLaunchApiLevel () 기기에서 처음 실행된 API 레벨을 가져옵니다. |
abstract InputStreamSource | getLogcat () logcat 데이터의 스냅샷 스트림을 가져옵니다. |
abstract InputStreamSource | getLogcat (int maxBytes) 캡처된 logcat 데이터의 마지막 |
abstract InputStreamSource | getLogcatDump () 장치에 대한 현재 logcat의 덤프를 가져옵니다. |
abstract InputStreamSource | getLogcatSince (long date) 제공된 날짜부터 캡처된 logcat 데이터의 스냅샷 스트림을 가져옵니다. |
abstract String | getMountPoint (String mountName) 마운트 지점을 반환합니다. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) 지정된 마운트 지점 경로에 해당하는 |
abstract | getMountPointInfo () 장치의 /proc/mounts에 있는 정보의 구문 분석된 버전을 반환합니다. |
abstract long | getPartitionFreeSpace (String partition) 장치 파티션의 여유 공간을 결정하는 도우미 메서드입니다. |
abstract ProcessInfo | getProcessByName (String processName) 도우미 메서드는 "pidof" 및 "stat" 명령을 실행하고 지정된 프로세스의 PID 및 프로세스 시작 시간과 함께 |
abstract String | getProcessPid (String process) 서비스의 pid를 반환하거나 문제가 발생한 경우 null을 반환합니다. |
abstract String | getProductType () 이 장치의 제품 유형을 가져오는 편리한 방법입니다. |
abstract String | getProductVariant () 이 장치의 제품 변형을 가져오는 편리한 방법입니다. |
abstract String | getProperty (String name) 장치에서 지정된 속성 값을 검색합니다. |
abstract ITestDevice.RecoveryMode | getRecoveryMode () 장치에 사용되는 현재 복구 모드를 가져옵니다. |
abstract String | getSerialNumber () 이 장치의 일련 번호를 얻는 편리한 방법입니다. |
abstract | getTombstones () 장치에서 삭제 표시 목록을 가져와서 반환합니다. |
abstract long | getTotalMemory () 총 물리적 메모리 크기를 바이트 단위로 반환하거나 내부 오류의 경우 -1을 반환합니다. |
abstract boolean | getUseFastbootErase () 빠른 부팅 삭제 또는 빠른 부팅 형식을 사용하여 장치의 파티션을 지울지 여부를 확인합니다. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () 기기의 플랫폼이 앱 열거를 지원하는지 확인 |
abstract boolean | isBypassLowTargetSdkBlockSupported () 기기의 플랫폼이 앱 설치 시 낮은 대상 SDK 차단 우회를 지원하는지 확인 |
abstract boolean | isDeviceEncrypted () 장치가 암호화된 경우 반환합니다. |
abstract boolean | isDirectory (String deviceFilePath) 장치의 경로가 디렉토리이면 True를 반환하고 그렇지 않으면 false를 반환합니다. |
abstract boolean | isEncryptionSupported () 장치에서 암호화가 지원되는지 여부를 반환합니다. |
abstract boolean | isExecutable (String fullPath) 장치의 파일 경로가 실행 파일이면 True를 반환하고 그렇지 않으면 false를 반환합니다. |
abstract boolean | isHeadless () 장치가 헤드리스(화면 없음)이면 true를 반환하고 그렇지 않으면 false를 반환합니다. |
abstract boolean | isRuntimePermissionSupported () 기기의 플랫폼이 런타임 권한 부여를 지원하는지 확인 |
abstract boolean | isStateBootloaderOrFastbootd () 장치가 |
abstract boolean | logAnrs ( ITestLogger logger) 기기에서 ANR을 수집하고 기록합니다. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) 장치의 logcat에 메시지를 기록합니다. |
abstract void | nonBlockingReboot () 장치를 재부팅하라는 명령을 실행하고 명령이 완료되고 장치가 더 이상 adb에 표시되지 않을 때 반환합니다. |
abstract void | postBootSetup () 모든 부팅 후 테스트를 위해 장치를 구성하는 지침을 수행하십시오. |
default void | postInvocationTearDown () 이 방법은 더 이상 사용되지 않습니다. 대신 |
abstract void | postInvocationTearDown (Throwable invocationException) 호출이 완료된 후 실행될 장치별 필수 정리를 위한 추가 단계입니다. |
default void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) 호출 흐름 이전에 장치에서 실행될 장치별 필수 설정을 위한 추가 단계입니다. |
abstract boolean | pullDir (String deviceFilePath, File localDir) 재귀적으로 장치에서 디렉터리 내용을 가져옵니다. |
abstract File | pullFile (String remoteFilePath, int userId) 장치에서 파일을 검색하여 로컬 임시 |
abstract File | pullFile (String remoteFilePath) 장치에서 파일을 검색하여 로컬 임시 |
abstract boolean | pullFile (String remoteFilePath, File localFile) 장치에서 파일을 검색합니다. |
abstract boolean | pullFile (String remoteFilePath, File localFile, int userId) 장치에서 파일을 검색합니다. |
abstract String | pullFileContents (String remoteFilePath) 장치에서 파일을 검색하고 내용을 반환합니다. |
abstract File | pullFileFromExternal (String remoteFilePath) 장치의 외부 저장소에서 파일을 검색하고 로컬 임시 |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) 필터링된 일부 디렉터리를 제외하면서 디렉터리 콘텐츠를 장치에 재귀적으로 푸시합니다. |
abstract boolean | pushDir (File localDir, String deviceFilePath) 재귀적으로 디렉터리 내용을 장치로 푸시합니다. |
abstract boolean | pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) 콘텐츠 공급자에 대한 필요성 평가를 선택적으로 고려할 수 있는 |
abstract boolean | pushFile (File localFile, String deviceFilePath) 파일을 장치로 푸시합니다. |
abstract boolean | pushString (String contents, String deviceFilePath) 문자열에서 생성된 파일을 장치로 푸시 |
abstract void | reboot () 기기를 adb 모드로 재부팅합니다. |
abstract void | reboot (String reason) 재부팅 후에도 지속되도록 지정된 |
abstract void | rebootIntoBootloader () 기기를 부트로더 모드로 재부팅합니다. |
abstract void | rebootIntoFastbootd () 기기를 fastbootd 모드로 재부팅합니다. |
abstract void | rebootIntoRecovery () 기기를 adb 복구 모드로 재부팅합니다. |
abstract void | rebootIntoSideload (boolean autoReboot) 기기를 adb 사이드로드 모드로 재부팅합니다(복구 중인 특수 모드임). 기기가 사이드로드 모드로 전환될 때까지 차단 |
abstract void | rebootIntoSideload () 기기를 adb 사이드로드 모드로 재부팅합니다(복구 중인 특수 모드임). 기기가 사이드로드 모드로 전환될 때까지 차단 |
abstract void | rebootUntilOnline () 장치가 온라인 상태가 될 때까지만 차단하는 |
abstract void | rebootUntilOnline (String reason) 장치가 온라인 상태가 될 때까지만 차단하는 |
abstract void | rebootUserspace () 기기의 사용자 공간 부분만 재부팅합니다. |
abstract void | rebootUserspaceUntilOnline () 장치가 온라인 상태가 될 때까지, 즉 adb에 표시될 때까지만 차단하는 |
abstract void | remountSystemWritable () 장치의 시스템 파티션을 쓰기 가능하게 만드십시오. |
abstract void | remountVendorWritable () 장치의 공급업체 파티션을 쓰기 가능하게 만드십시오. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) 매개변수로 전달된 하나 이상의 리스너로 |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) 계측 테스트를 실행하고 장치 복구를 제공합니다. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) |
abstract void | setDate (Date date) 기기의 날짜 설정 참고: 기기에서 날짜를 설정하려면 루트가 필요합니다. |
abstract void | setOptions ( TestDeviceOptions options) 장치에 대한 |
abstract boolean | setProperty (String propKey, String propValue) 장치에 지정된 속성 값을 설정합니다. |
abstract void | setRecovery ( IDeviceRecovery recovery) 이 장치에 사용할 |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) 장치에 사용할 현재 복구 모드를 설정합니다. |
abstract void | setUseFastbootErase (boolean useFastbootErase) 빠른 부팅 삭제 또는 빠른 부팅 형식을 사용하여 장치의 파티션을 지울지 여부를 설정합니다. |
abstract void | startLogcat () 백그라운드에서 기기의 logcat 출력 캡처를 시작합니다. |
abstract void | stopEmulatorOutput () 에뮬레이터 출력을 닫고 삭제합니다. |
abstract void | stopLogcat () 장치에서 logcat 출력 캡처를 중지하고 현재 저장된 logcat 데이터를 삭제합니다. |
abstract String | switchToAdbTcp () 장치를 adb-over-tcp 모드로 전환합니다. |
abstract boolean | switchToAdbUsb () 장치를 USB 모드를 통해 adb로 전환합니다. |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) 로컬 파일 디렉터리의 콘텐츠를 장치에 점진적으로 동기화합니다. |
abstract boolean | unlockDevice () 장치가 암호화된 상태인 경우 장치를 잠금 해제합니다. |
abstract boolean | waitForBootComplete (long timeOut) 장치의 부팅 완료 플래그가 설정될 때까지 차단합니다. |
abstract boolean | waitForDeviceAvailable () 장치가 응답하고 테스트에 사용할 수 있을 때까지 기다립니다. |
abstract boolean | waitForDeviceAvailable (long waitTime) 장치가 응답하고 테스트에 사용할 수 있을 때까지 기다립니다. |
abstract boolean | waitForDeviceAvailableInRecoverPath (long waitTime) 복구 경로를 고려하지 않고 장치가 응답하고 사용 가능할 때까지 기다립니다. |
abstract void | waitForDeviceBootloader () 빠른 부팅을 통해 장치가 표시될 때까지 차단합니다. |
abstract boolean | waitForDeviceInRecovery (long waitTime) 장치가 'adb 복구' 상태가 되도록 차단합니다( |
abstract boolean | waitForDeviceInSideload (long waitTime) 기기가 'adb 사이드로드' 상태가 되도록 차단 |
abstract boolean | waitForDeviceNotAvailable (long waitTime) 장치를 사용할 수 없는 블록, 즉 adb에서 누락된 블록 |
abstract void | waitForDeviceOnline () 장치가 adb를 통해 표시될 때까지 차단합니다. |
abstract void | waitForDeviceOnline (long waitTime) 장치가 adb를 통해 표시될 때까지 차단합니다. |
abstract boolean | waitForDeviceShell (long waitTime) 장치가 기본 adb 셸 명령에 응답할 때까지 기다립니다. |
상수
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
API 레벨을 감지할 수 없는 경우 기본값
상수 값: -1(0xffffffff)
공개 방법
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
최소 지원 수준에서 기능이 현재 지원되는지 여부를 확인합니다. 이 방법은 API 레벨이 올라가기 전에 아직 출시되지 않은 기능을 고려합니다.
매개변수 | |
---|---|
strictMinLevel | int : 기능을 지원하는 엄격한 최소 가능 수준입니다. |
보고 | |
---|---|
boolean | 수준이 지원되는 경우 True입니다. 그렇지 않으면 거짓입니다. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
누적된 모든 logcat 데이터를 삭제합니다.
이는ITestDevice#getLogcat()
특정 시점 이후에 생성된 로그 데이터만 반환하도록 하려는 경우에 유용합니다(예: 새 장치 빌드를 플래싱한 후 등). 삭제파일
public abstract void deleteFile (String deviceFilePath)
장치에서 파일 또는 디렉터리를 삭제하는 도우미 메서드입니다.
매개변수 | |
---|---|
deviceFilePath | String : 장치에 있는 파일의 절대 경로입니다. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deviceSoftRestarted
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
현재 system_server를 이전 system_server ProcessInfo
와 비교하여 장치가 소프트 재시작되었는지 확인하는 도우미 메서드입니다. getProcessByName(String)
사용하여 ProcessInfo
가져옵니다.
매개변수 | |
---|---|
prevSystemServerProcess | ProcessInfo : 이전 system_server 프로세스 ProcessInfo . |
보고 | |
---|---|
boolean | 장치가 소프트 재시작된 경우 true |
던지기 | |
---|---|
| 장치에 비정상적인 부팅 이유가 있는 경우 |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deviceSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
device 및 해당 ERROR(/TimeUnit)
의 에포크 이후 UTC 시간 이후 장치가 소프트 재시작되었는지 여부를 확인하는 도우미 메서드입니다. Soft-Restart는 장치 하드 재부팅(예: 요청된 재부팅) 외부에서 다시 시작된 system_server를 나타냅니다. 밀리초 단위의 현재 장치 utcEpochTime은 getDeviceDate()
메서드로 얻을 수 있습니다.
매개변수 | |
---|---|
utcEpochTime | long : 에포크 이후의 장치 시간(초). |
timeUnit | TimeUnit : 주어진 utcEpochTime의 시간 단위 TimeUnit . |
보고 | |
---|---|
boolean | 장치가 소프트 재시작된 경우 true |
던지기 | |
---|---|
| 장치에 비정상적인 부팅 이유가 있는 경우 |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
disableAdbRoot
public abstract boolean disableAdbRoot ()
adb 루트를 끕니다.
adb 루트를 비활성화하면 장치가 adb에서 연결 해제될 수 있습니다. 이 메서드는 장치를 사용할 수 있을 때까지 차단됩니다.보고 | |
---|---|
boolean | 성공하면 true . |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
파일 존재
public abstract boolean doesFileExist (String deviceFilePath)
장치에 파일이 있는지 확인하는 도우미 메서드입니다.
매개변수 | |
---|---|
deviceFilePath | String : 확인할 장치의 파일 절대 경로 |
보고 | |
---|---|
boolean | 파일이 있으면 true , 그렇지 않으면 false . |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
adb 루트를 켭니다. "enable-root" 설정이 "false"이면 루트를 활성화하지 않고 메시지를 기록하고 반환합니다.
adb 루트를 활성화하면 장치가 adb에서 연결 해제될 수 있습니다. 이 메서드는 장치를 사용할 수 있을 때까지 차단됩니다.보고 | |
---|---|
boolean | 성공하면 true . |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
지정된 시간 초과로 adb 명령을 시스템 명령으로 실행하는 도우미 메서드입니다.
executeShellCommand(String)
더 나은 오류 감지 및 성능을 제공하므로 가능하면 대신 사용해야 합니다.
매개변수 | |
---|---|
timeout | long : 장치가 응답하지 않는 것으로 간주되기 전의 시간(밀리초), 시간 초과가 없는 경우 0L |
commandArgs | String : 실행할 adb 명령 및 인수 |
보고 | |
---|---|
String | 명령의 stdout. 명령 실행에 실패한 경우 null . |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
adb 명령을 시스템 명령으로 실행하는 도우미 메서드입니다.
executeShellCommand(String)
더 나은 오류 감지 및 성능을 제공하므로 가능하면 대신 사용해야 합니다.매개변수 | |
---|---|
commandArgs | String : 실행할 adb 명령 및 인수 |
보고 | |
---|---|
String | 명령의 stdout. 명령 실행에 실패한 경우 null . |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
지정된 시간 초과로 adb 명령을 시스템 명령으로 실행하는 도우미 메서드입니다.
executeShellCommand(String)
더 나은 오류 감지 및 성능을 제공하므로 가능하면 대신 사용해야 합니다.
매개변수 | |
---|---|
timeout | long : 장치가 응답하지 않는 것으로 간주되기 전의 시간(밀리초), 시간 초과가 없는 경우 0L |
envMap | |
commandArgs | String : 실행할 adb 명령 및 인수 |
보고 | |
---|---|
String | 명령의 stdout. 명령 실행에 실패한 경우 null . |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
실행Fastboot명령
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
fastboot 명령을 시스템 명령으로 실행하는 도우미 메서드입니다.
기기가 이미 빠른 부팅 모드일 때 사용될 것으로 예상됩니다.매개변수 | |
---|---|
timeout | long : 명령이 만료되기 전의 시간(밀리초) |
commandArgs | String : 실행할 fastboot 명령 및 인수 |
보고 | |
---|---|
CommandResult | 명령의 출력을 포함하는 CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
실행Fastboot명령
public abstract CommandResult executeFastbootCommand (String... commandArgs)
기본 제한 시간이 2분인 시스템 명령으로 fastboot 명령을 실행하는 도우미 메서드입니다.
기기가 이미 빠른 부팅 모드일 때 사용될 것으로 예상됩니다.
매개변수 | |
---|---|
commandArgs | String : 실행할 fastboot 명령 및 인수 |
보고 | |
---|---|
CommandResult | 명령의 출력을 포함하는 CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeLongFastboot명령
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
오래 실행되는 fastboot 명령을 시스템 명령으로 실행하는 도우미 메서드입니다.
더 긴 시간 제한을 사용한다는 점을 제외하면executeFastbootCommand(String)
와 동일합니다.매개변수 | |
---|---|
commandArgs | String : 실행할 fastboot 명령 및 인수 |
보고 | |
---|---|
CommandResult | 명령의 출력을 포함하는 CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeLongFastboot명령
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
장기 실행 fastboot 명령을 시스템 환경 변수와 함께 시스템 명령으로 실행하는 도우미 메서드입니다.
더 긴 시간 제한을 사용한다는 점을 제외하면 executeFastbootCommand(String)
와 동일합니다.
매개변수 | |
---|---|
envVarMap | |
commandArgs | String : 실행할 fastboot 명령 및 인수 |
보고 | |
---|---|
CommandResult | 명령의 출력을 포함하는 CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellCommand
public abstract String executeShellCommand (String command)
adb shell 명령을 실행하고 출력을 ERROR(/String)
로 반환하는 도우미 메서드입니다.
매개변수 | |
---|---|
command | String : 실행할 adb 셸 명령 |
보고 | |
---|---|
String | 쉘 출력 |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellCommand
public abstract 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 abstract 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 abstract 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 abstract CommandResult executeShellV2Command (String command)
adb 셸 명령을 실행하고 명령 상태 출력, stdout 및 stderr로 적절하게 채워진 CommandResult
로 결과를 반환하는 도우미 메서드입니다.
매개변수 | |
---|---|
command | String : 실행해야 하는 명령입니다. |
보고 | |
---|---|
CommandResult | CommandResult 의 결과입니다. |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
adb 셸 명령을 실행하고 명령 상태 출력 및 stderr로 적절하게 채워진 CommandResult
로 결과를 반환하는 도우미 메서드입니다. stdout은 지정된 스트림으로 전달됩니다.
매개변수 | |
---|---|
command | String : 실행해야 하는 명령입니다. |
pipeToOutput | OutputStream : 표준 출력이 리디렉션되는 ERROR(/OutputStream) 또는 null입니다. |
보고 | |
---|---|
CommandResult | CommandResult 의 결과입니다. |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
adb 셸 명령을 실행하고 명령 상태 출력, stdout 및 stderr로 적절하게 채워진 CommandResult
로 결과를 반환하는 도우미 메서드입니다.
매개변수 | |
---|---|
command | String : 실행해야 하는 명령입니다. |
pipeAsInput | File : 명령에 대한 입력으로 파이프될 ERROR(/File) 또는 null입니다. |
보고 | |
---|---|
CommandResult | CommandResult 의 결과입니다. |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다.
매개변수 | |
---|---|
command | String : 실행할 adb 셸 명령 |
maxTimeoutForCommand | long : 명령이 완료되기 위한 최대 제한 시간입니다. timeUnit 에 지정된 단위 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse 의 단위 |
retryAttempts | int : 예외로 인해 실패한 경우 명령을 재시도할 최대 횟수입니다. retryAttempts 성공하지 않고 수행되면 DeviceNotResponsiveException이 발생합니다. |
보고 | |
---|---|
CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다.
매개변수 | |
---|---|
command | String : 실행할 adb 셸 명령 |
maxTimeoutForCommand | long : 명령이 완료되기 위한 최대 제한 시간입니다. timeUnit 에 지정된 단위 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse 의 단위 |
보고 | |
---|---|
CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다.
매개변수 | |
---|---|
command | String : 실행할 adb 셸 명령 |
pipeAsInput | File : 명령에 대한 입력으로 파이프될 ERROR(/File) 또는 null입니다. |
pipeToOutput | OutputStream : 표준 출력이 리디렉션되는 ERROR(/OutputStream) 또는 null입니다. |
maxTimeoutForCommand | long : 명령이 완료되기 위한 최대 제한 시간입니다. timeUnit 에 지정된 단위 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse 의 단위 |
retryAttempts | int : 예외로 인해 실패한 경우 명령을 재시도할 최대 횟수입니다. retryAttempts 성공하지 않고 수행되면 DeviceNotResponsiveException이 발생합니다. |
보고 | |
---|---|
CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
명령 동작을 제어하는 매개변수가 더 많은 adb 셸 명령을 실행합니다.
매개변수 | |
---|---|
command | String : 실행할 adb 셸 명령 |
pipeAsInput | File : 명령에 대한 입력으로 파이프될 ERROR(/File) 또는 null입니다. |
pipeToOutput | OutputStream : 표준 출력이 리디렉션되는 ERROR(/OutputStream) 또는 null입니다. |
pipeToError | OutputStream : 표준 오류가 리디렉션되는 ERROR(/OutputStream) 또는 null입니다. |
maxTimeoutForCommand | long : 명령이 완료되기 위한 최대 제한 시간입니다. timeUnit 에 지정된 단위 |
timeUnit | TimeUnit : maxTimeToOutputShellResponse 의 단위 |
retryAttempts | int : 예외로 인해 실패한 경우 명령을 재시도할 최대 횟수입니다. retryAttempts 성공하지 않고 수행되면 DeviceNotResponsiveException이 발생합니다. |
보고 | |
---|---|
CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
fastbootWipe파티션
public abstract CommandResult fastbootWipePartition (String partition)
장치의 파티션을 지우는 도우미 메서드입니다.
getUseFastbootErase()
가 true
이면 fastboot erase가 파티션을 지우는 데 사용됩니다. 그런 다음 장치는 다음에 장치가 부팅될 때 파일 시스템을 생성해야 합니다. 그렇지 않으면 장치에 새 파일 시스템을 생성하는 빠른 부팅 형식이 사용됩니다. 기기가 이미 빠른 부팅 모드일 때 사용될 것으로 예상됩니다.매개변수 | |
---|---|
partition | String : 지울 파티션 |
보고 | |
---|---|
CommandResult | 명령의 출력을 포함하는 CommandResult |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
getApiLevel
public abstract int getApiLevel ()
장치 API 수준을 가져옵니다. 기본값은 UNKNOWN_API_LEVEL
입니다.
보고 | |
---|---|
int | 장치의 API 레벨을 나타내는 정수 |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
이 장치의 베이스밴드(라디오) 버전을 가져오는 편리한 방법입니다. 라디오 버전을 가져오는 것은 장치마다 다르므로 모든 장치에 대해 올바른 정보를 반환하지 않을 수 있습니다. 이 방법은 올바른 버전 정보를 반환하기 위해 gsm.version.baseband 속성에 의존합니다. 이는 일부 CDMA 장치의 경우 정확하지 않으며 여기에 반환된 버전이 fastboot에서 보고된 버전과 일치하지 않을 수 있으며 CDMA 라디오 버전을 반환하지 않을 수 있습니다. TL;DR 이 방법은 gsm.version.baseband 속성이 fastboot getvar version-baseband
에서 반환된 버전과 동일한 경우에만 정확한 버전을 보고합니다.
보고 | |
---|---|
String | ERROR(/String) 기저대역 버전 또는 확인할 수 없는 경우 null (장치에 라디오가 없거나 버전 문자열을 읽을 수 없음) |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
getBattery
public abstract Integer getBattery ()
장치의 현재 배터리 수준을 반환하거나 배터리 수준을 사용할 수 없는 경우 Null을 반환합니다.
보고 | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
주어진 속성의 부울 값을 반환합니다.
매개변수 | |
---|---|
name | String : 속성 이름 |
defaultValue | boolean : 속성이 비어 있거나 존재하지 않는 경우 반환할 기본값입니다. |
보고 | |
---|---|
boolean | 속성 값이 "1" , "y" , "yes" , "on" 또는 "true" true 속성 값이 "0" , "n" , "no" , "off" 인 경우 false , "false" 또는 defaultValue 그렇지 않은 경우. |
던지기 | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
도우미 메서드는 부팅 시간 및 부팅 이유와 함께 부팅 기록 맵을 수집합니다.
보고 | |
---|---|
부팅 시간(Epoch 이후 초 단위의 UTC 시간) 및 부팅 이유의 맵 |
던지기 | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Helper 메서드는 장치의 에포크 이후 지정된 시간 및 지정된 시간 단위 이후 부팅 시간 및 부팅 이유와 함께 부팅 기록 맵을 수집합니다. 밀리초 단위의 현재 장치 utcEpochTime은 getDeviceDate()
메서드로 얻을 수 있습니다.
매개변수 | |
---|---|
utcEpochTime | long : Epoch 이후의 장치 시간입니다. |
timeUnit | TimeUnit : 시간 단위 TimeUnit . |
보고 | |
---|---|
부팅 시간(Epoch 이후 초 단위의 UTC 시간) 및 부팅 이유의 맵 |
던지기 | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
이 장치의 부트로더 버전을 가져오는 편리한 방법입니다.
기기의 현재 상태에서 부트로더 버전 검색을 시도합니다. (예: 장치가 빠른 부팅 모드인 경우 빠른 부팅에서 버전 검색을 시도합니다.)보고 | |
---|---|
String | ERROR(/String) 부트로더 버전 또는 찾을 수 없는 경우 null |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
getBuildAlias
public abstract String getBuildAlias ()
기기가 현재 실행 중인 빌드의 별칭을 검색합니다.
빌드 별칭은 일반적으로 빌드 ID(일반적으로 Nexus 빌드의 경우 숫자)보다 읽기 쉬운 문자열입니다. 예를 들어 최종 Android 4.2 릴리스의 빌드 별칭은 JDQ39이고 빌드 ID는 573038입니다.
보고 | |
---|---|
String | 빌드 별칭 또는 검색할 수 없는 경우 빌드 ID로 대체 |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
기기의 빌드 플레이버를 검색합니다.
보고 | |
---|---|
String | 빌드 플레이버 또는 검색할 수 없는 경우 null |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
장치가 현재 실행 중인 빌드를 검색합니다.
보고 | |
---|---|
String | 검색할 수 없는 경우 빌드 ID 또는 IBuildInfo#UNKNOWN_BUILD_ID |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
장치 이미지 서명에 사용된 키 유형을 반환합니다.
일반적으로 Android 기기는 테스트 키(AOSP와 같은) 또는 릴리스 키(개별 기기 제조업체에서 제어)로 서명될 수 있습니다.
보고 | |
---|---|
String | 발견된 경우 서명 키, 그렇지 않은 경우 null입니다. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
장치가 할당된 경우 캐시된 DeviceDescriptor
반환하고 그렇지 않으면 현재 DeviceDescriptor
반환합니다.
보고 | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
장치가 할당된 경우 캐시된 DeviceDescriptor
반환하고 그렇지 않으면 현재 DeviceDescriptor
반환합니다.
매개변수 | |
---|---|
shortDescriptor | boolean : 설명자를 최소한의 정보로 제한할지 여부 |
보고 | |
---|---|
DeviceDescriptor |
getChildren
public abstract String[] getChildren (String deviceFilePath)
권한으로 인해 때때로 작동하지 않는 IFileEntry
사용하는 대신 사용할 수 있습니다.
매개변수 | |
---|---|
deviceFilePath | String : 검색을 수행할 장치의 경로입니다. |
보고 | |
---|---|
String[] | 장치의 경로에 있는 모든 파일을 포함하는 문자열 배열입니다. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getConnection
public abstract AbstractConnection getConnection ()
장치와 관련된 연결을 반환합니다.
보고 | |
---|---|
AbstractConnection |
getDeviceClass
public abstract String getDeviceClass ()
장치 클래스를 가져옵니다.
보고 | |
---|---|
String | ERROR(/String) 장치 클래스. |
getDeviceDate
public abstract long getDeviceDate ()
에포크 이후의 장치 날짜를 밀리초 단위로 반환합니다.
보고 | |
---|---|
long | 에포크 형식의 장치 날짜. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
장치 정보에서 DeviceDescriptor
반환하여 실제 장치 개체를 전달하지 않고 장치에 대한 정보를 가져옵니다.
보고 | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
장치 정보에서 DeviceDescriptor
반환하여 실제 장치 개체를 전달하지 않고 장치에 대한 정보를 가져옵니다.
매개변수 | |
---|---|
shortDescriptor | boolean : 설명자를 최소한의 정보로 제한할지 여부 |
보고 | |
---|---|
DeviceDescriptor |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
장치와 지정된 ERROR(/Date)
사이의 시차를 가져오는 도우미입니다. 내부적으로 Epoch 시간을 사용합니다.
매개변수 | |
---|---|
date | Date |
보고 | |
---|---|
long | 밀리초의 차이 |
던지기 | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
에뮬레이터 stdout 및 stderr 스트림 가져오기
보고 | |
---|---|
InputStreamSource | 에뮬레이터 출력 |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
장치 외부 저장소의 여유 공간을 결정하는 도우미 메서드입니다.
보고 | |
---|---|
long | 여유 공간(KB) |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
getFastboot제품 유형
public abstract String getFastbootProductType ()
빠른 부팅 모드에 있을 때 이 장치의 제품 유형을 가져오는 편리한 방법입니다.
이 방법은 장치가 빠른 부팅 상태여야 하는 경우에만 사용해야 합니다. 이 경우 일반getProductType()
메서드보다 조금 더 안전한 변형입니다. ITestDevice는 장치가 잘못된 상태이거나 응답하지 않는 경우 빠른 부팅으로 장치를 복구해야 한다는 것을 알기 때문입니다.보고 | |
---|---|
String | ERROR(/String) 제품 유형 이름 또는 판별할 수 없는 경우 null |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
getFastboot제품 변형
public abstract String getFastbootProductVariant ()
빠른 부팅 모드에 있을 때 이 장치의 제품 유형을 가져오는 편리한 방법입니다.
이 방법은 장치가 빠른 부팅 상태여야 하는 경우에만 사용해야 합니다. 이 경우 일반getProductType()
메서드보다 조금 더 안전한 변형입니다. ITestDevice는 장치가 잘못된 상태이거나 응답하지 않는 경우 빠른 부팅으로 장치를 복구해야 한다는 것을 알기 때문입니다.보고 | |
---|---|
String | ERROR(/String) 제품 유형 이름 또는 판별할 수 없는 경우 null |
던지기 | |
---|---|
DeviceNotAvailableException | 장치와의 연결이 끊어지고 복구할 수 없는 경우. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
빠른 부팅 모드 일련 번호를 반환합니다.
보고 | |
---|---|
String |
getFastboot변수
public abstract String getFastbootVariable (String variableName)
장치에서 지정된 fastboot 변수 값을 검색합니다.
매개변수 | |
---|---|
variableName | String : 변수 이름 |
보고 | |
---|---|
String | 속성 값 또는 존재하지 않는 경우 null |
던지기 | |
---|---|
| 지원되지 않는 작업 예외 |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
장치에서 원격 파일에 대한 참조를 검색합니다.
매개변수 | |
---|---|
path | String : 검색할 파일 경로. 절대 경로이거나 '/'에 상대적인 경로일 수 있습니다. (예: "/system" 및 "system" 구문이 모두 지원됨) |
보고 | |
---|---|
IFileEntry | 지정된 path 에서 파일을 찾을 수 없는 경우 IFileEntry 또는 null |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
연결된 ddmlib IDevice
에 대한 참조를 반환합니다.
IDevice
할당할 수 있습니다. 따라서 호출자는 해당 참조가 오래될 수 있으므로 IDevice
에 대한 참조를 유지하면 안 됩니다.보고 | |
---|---|
IDevice | IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
장치에서 주어진 속성의 정수 값을 반환합니다.
매개변수 | |
---|---|
name | String : 속성 이름 |
defaultValue | long : 속성이 비어 있거나 존재하지 않는 경우 반환할 기본값입니다. |
보고 | |
---|---|
long | 속성이 비어 있거나 존재하지 않거나 정수 값이 없는 경우 속성 값 또는 defaultValue . |
던지기 | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
ERROR(/System#currentTimeMillis())
에 의해 반환된 EPOCH 이후 Tradefed API가 재부팅을 트리거한 마지막 시간(밀리초)을 반환합니다.
보고 | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Get the device's first launched API Level. Defaults to UNKNOWN_API_LEVEL
.
보고 | |
---|---|
int | an integer indicating the first launched API Level of device |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Grabs a snapshot stream of the logcat data.
Works in two modes:
TestDeviceOptions.getMaxLogcatDataSize()
bytes of the current contents of the background logcat capture보고 | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Grabs a snapshot stream of the last maxBytes
of captured logcat data.
Useful for cases when you want to capture frequent snapshots of the captured logcat data without incurring the potentially big disk space penalty of getting the entire getLogcat()
snapshot.
매개변수 | |
---|---|
maxBytes | int : the maximum amount of data to return. Should be an amount that can comfortably fit in memory |
보고 | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Get a dump of the current logcat for device. Unlike getLogcat()
, this method will always return a static dump of the logcat.
Has the disadvantage that nothing will be returned if device is not reachable.
보고 | |
---|---|
InputStreamSource | a InputStreamSource of the logcat data. An empty stream is returned if fail to capture logcat data. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate()
.
매개변수 | |
---|---|
date | long : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s') |
보고 | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Returns a mount point.
Queries the device directly if the cached info inIDevice
is not available. TODO: move this behavior to IDevice#getMountPoint(String)
매개변수 | |
---|---|
mountName | String : the name of the mount point |
보고 | |
---|---|
String | the mount point or null |
See also:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Returns a MountPointInfo
corresponding to the specified mountpoint path, or null
if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.
매개변수 | |
---|---|
mountpoint | String |
보고 | |
---|---|
ITestDevice.MountPointInfo | A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts" |
던지기 | |
---|---|
DeviceNotAvailableException |
See also:
getMountPointInfo
public abstractgetMountPointInfo ()
Returns a parsed version of the information in /proc/mounts on the device
보고 | |
---|---|
A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts" |
던지기 | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Helper method to determine amount of free space on device partition.
매개변수 | |
---|---|
partition | String |
보고 | |
---|---|
long | the amount of free space in KB |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
Helper method runs the "pidof" and "stat" command and returns ProcessInfo
object with PID and process start time of the given process.
매개변수 | |
---|---|
processName | String : the proces name String. |
보고 | |
---|---|
ProcessInfo | ProcessInfo of given processName |
던지기 | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Returns the pid of the service or null if something went wrong.
매개변수 | |
---|---|
process | String : The proces name String. |
보고 | |
---|---|
String |
던지기 | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Convenience method to get the product type of this device.
This method will work if device is in either adb or fastboot mode.보고 | |
---|---|
String | the ERROR(/String) product type name. Will not be null |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered, or if product type can not be determined |
getProductVariant
public abstract String getProductVariant ()
Convenience method to get the product variant of this device.
This method will work if device is in either adb or fastboot mode.보고 | |
---|---|
String | the ERROR(/String) product variant name or null if it cannot be determined |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
getProperty
public abstract String getProperty (String name)
Retrieve the given property value from the device.
매개변수 | |
---|---|
name | String : the property name |
보고 | |
---|---|
String | the property value or null if it does not exist |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Get the current recovery mode used for the device.
보고 | |
---|---|
ITestDevice.RecoveryMode | the current recovery mode used for the device. |
getSerialNumber
public abstract String getSerialNumber ()
Convenience method to get serial number of this device.
보고 | |
---|---|
String | the ERROR(/String) serial number |
getTombstones
public abstractgetTombstones ()
Fetch and return the list of tombstones from the devices. Requires root.
method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException
will terminate the method early.
보고 | |
---|---|
A list of tombstone files, empty if no tombstone. |
던지기 | |
---|---|
DeviceNotAvailableException |
See also:
getTotalMemory
public abstract long getTotalMemory ()
Returns total physical memory size in bytes or -1 in case of internal error
보고 | |
---|---|
long |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Get whether to use fastboot erase or fastboot format to wipe a partition on the device.
보고 | |
---|---|
boolean | true if fastboot erase will be used or false if fastboot format will be used. |
See also:
isAdbRoot
public abstract boolean isAdbRoot ()
보고 | |
---|---|
boolean | true if device currently has adb root, false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
isAdbTcp
public abstract boolean isAdbTcp ()
보고 | |
---|---|
boolean | true if device is connected to adb-over-tcp, false otherwise. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Check whether platform on device supports app enumeration
보고 | |
---|---|
boolean | True if app enumeration is supported, false otherwise |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Check whether platform on device supports bypassing low target sdk block on app installs
보고 | |
---|---|
boolean | True if bypass low target sdk block is supported, false otherwise |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Returns if the device is encrypted.
보고 | |
---|---|
boolean | true if the device is encrypted. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
isDirectory
public abstract boolean isDirectory (String deviceFilePath)
Return True if the path on the device is a directory, false otherwise.
매개변수 | |
---|---|
deviceFilePath | String |
보고 | |
---|---|
boolean |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Returns if encryption is supported on the device.
보고 | |
---|---|
boolean | true if the device supports encryption. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isExecutable
public abstract boolean isExecutable (String fullPath)
Returns True if the file path on the device is an executable file, false otherwise.
매개변수 | |
---|---|
fullPath | String |
보고 | |
---|---|
boolean |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isHeadless
public abstract boolean isHeadless ()
Return true if the device is headless (no screen), false otherwise.
보고 | |
---|---|
boolean |
던지기 | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Check whether platform on device supports runtime permission granting
보고 | |
---|---|
boolean | True if runtime permission are supported, false otherwise. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Returns true if device is in TestDeviceState#FASTBOOT
or TestDeviceState.FASTBOOTD
.
보고 | |
---|---|
boolean |
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Collects and log ANRs from the device.
매개변수 | |
---|---|
logger | ITestLogger : an ITestLogger to log the ANRs. |
보고 | |
---|---|
boolean | True if the logging was successful, false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException |
logOnDevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.
매개변수 | |
---|---|
tag | String : The tag under which we log our message in the logcat. |
level | Log.LogLevel : The debug level of the message in the logcat. |
format | String : The message format. |
args | Object : the args to be replaced via String.format(). |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Perform instructions to configure device for testing that after every boot.
Should be called after device is fully booted/available In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot. Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
postInvocationTearDown
public void postInvocationTearDown ()
This method is deprecated.
Use postInvocationTearDown(Throwable)
instead.
Extra steps for device specific required clean up that will be executed after the invocation is done.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Extra steps for device specific required clean up that will be executed after the invocation is done.
매개변수 | |
---|---|
invocationException | Throwable : if any, the final exception raised by the invocation failure. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.
매개변수 | |
---|---|
info | IBuildInfo : The IBuildInfo of the device. |
attributes | MultiMap : The attributes stored in the invocation context |
던지기 | |
---|---|
| com.android.tradefed.targetprep.TargetSetupError |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Recursively pull directory contents from device.
매개변수 | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
보고 | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract File pullFile (String remoteFilePath, int userId)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
매개변수 | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
userId | int : The user id to pull from |
보고 | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
매개변수 | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
보고 | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Retrieves a file off device.
매개변수 | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
보고 | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Retrieves a file off device.
매개변수 | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
userId | int : The user id to pull from |
보고 | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
매개변수 | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
보고 | |
---|---|
String | A ERROR(/String) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
던지기 | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
매개변수 | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
보고 | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
매개변수 | |
---|---|
localDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
보고 | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Recursively push directory contents to device.
매개변수 | |
---|---|
localDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
보고 | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
매개변수 | |
---|---|
localFile | File : the local file to push |
deviceFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
보고 | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Push a file to device. By default using a content provider.
매개변수 | |
---|---|
localFile | File : the local file to push |
deviceFilePath | String : the remote destination absolute file path |
보고 | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
pushString
public abstract boolean pushString (String contents, String deviceFilePath)
Push file created from a string to device
매개변수 | |
---|---|
contents | String : the contents of the file to push |
deviceFilePath | String : the remote destination absolute file path |
보고 | |
---|---|
boolean | true if string was pushed successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
reboot
public abstract void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
reboot
public abstract void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
매개변수 | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootIntoBootloader
public abstract void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
rebootIntoFastbootd
public abstract void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
rebootIntoRecovery
public abstract void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recovery던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
매개변수 | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
던지기 | |
---|---|
DeviceNotAvailableException | if device is not in sideload after reboot |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
던지기 | |
---|---|
DeviceNotAvailableException | if device is not in sideload after reboot |
rebootUntilOnline
public abstract void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootUntilOnline
public abstract void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
매개변수 | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
See also:
rebootUserspace
public abstract void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
WARNING. Userspace reboot is currently under active development, use it on your own risk.
던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
던지기 | |
---|---|
DeviceNotAvailableException | if device is not available after reboot |
remountSystemWritable
public abstract void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
매개변수 | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
보고 | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
매개변수 | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
보고 | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
매개변수 | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
보고 | |
---|---|
boolean |
던지기 | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
매개변수 | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
보고 | |
---|---|
boolean |
던지기 | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
매개변수 | |
---|---|
date | Date : specify a particular date; will use host date if null |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
매개변수 | |
---|---|
options | TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
매개변수 | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
보고 | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
매개변수 | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc매개변수 | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
매개변수 | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
See also:
startLogcat
public abstract void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public abstract void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.switchToAdbTcp
public abstract String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
보고 | |
---|---|
String | the tcp serial number or null if device could not be switched |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Switch device to adb over usb mode.
보고 | |
---|---|
boolean | true if switch was successful, false otherwise. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.매개변수 | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
보고 | |
---|---|
boolean | true if files were synced successfully. false otherwise. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
unlockDevice
public abstract boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.보고 | |
---|---|
boolean | true if successful or if the device is unencrypted. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
| if encryption is not supported on the device. |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
매개변수 | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
보고 | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
보고 | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
매개변수 | |
---|---|
waitTime | long : the time in ms to wait |
보고 | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
던지기 | |
---|---|
DeviceNotAvailableException | if device is still unresponsive after waitTime expires. |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
매개변수 | |
---|---|
waitTime | long |
보고 | |
---|---|
boolean | True if device is available, False if unavailable. |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceBootloader
public abstract void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
매개변수 | |
---|---|
waitTime | long : the time in ms to wait |
보고 | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
매개변수 | |
---|---|
waitTime | long : the time in ms to wait |
보고 | |
---|---|
boolean | true if device boots into sideload before time expires. false otherwise |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
매개변수 | |
---|---|
waitTime | long : the time in ms to wait |
보고 | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.매개변수 | |
---|---|
waitTime | long : the time in ms to wait |
던지기 | |
---|---|
DeviceNotAvailableException | if connection with device is lost and cannot be recovered. |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
매개변수 | |
---|---|
waitTime | long : the time in ms to wait |
보고 | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |