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 ProcessInfo 와 비교하여 장치가 소프트 재시작되었는지 확인하는 도우미 메서드입니다.

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

device 및 해당 ERROR(/TimeUnit) 의 에포크 이후 UTC 시간 이후 장치가 소프트 재시작되었는지 여부를 확인하는 도우미 메서드입니다.

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 명령을 실행하고 출력을 ERROR(/String) 로 반환하는 도우미 메서드입니다.

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로 적절하게 채워진 CommandResult 로 결과를 반환하는 도우미 메서드입니다.

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

adb 셸 명령을 실행하고 명령 상태 출력 및 stderr로 적절하게 채워진 CommandResult 로 결과를 반환하는 도우미 메서드입니다.

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

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

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 ()

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

abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

abstract String[] getChildren (String deviceFilePath)

권한으로 인해 때때로 작동하지 않는 IFileEntry 사용하는 대신 사용할 수 있습니다.

abstract AbstractConnection getConnection ()

장치와 관련된 연결을 반환합니다.

abstract String getDeviceClass ()

장치 클래스를 가져옵니다.

abstract long getDeviceDate ()

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

abstract DeviceDescriptor getDeviceDescriptor ()

장치 정보에서 DeviceDescriptor 반환하여 실제 장치 개체를 전달하지 않고 장치에 대한 정보를 가져옵니다.

abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

장치 정보에서 DeviceDescriptor 반환하여 실제 장치 개체를 전달하지 않고 장치에 대한 정보를 가져옵니다.

abstract TestDeviceState getDeviceState ()

장치의 상태를 가져옵니다.

abstract long getDeviceTimeOffset (Date date)

장치와 지정된 ERROR(/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 IDevice 에 대한 참조를 반환합니다.

abstract long getIntProperty (String name, long defaultValue)

장치에서 주어진 속성의 정수 값을 반환합니다.

abstract long getLastExpectedRebootTimeMillis ()

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

abstract int getLaunchApiLevel ()

기기에서 처음 실행된 API 레벨을 가져옵니다.

abstract InputStreamSource getLogcat ()

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

abstract InputStreamSource getLogcat (int maxBytes)

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

abstract InputStreamSource getLogcatDump ()

장치에 대한 현재 logcat의 덤프를 가져옵니다.

abstract InputStreamSource getLogcatSince (long date)

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

abstract String getMountPoint (String mountName)

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

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

지정된 마운트 지점 경로에 해당하는 MountPointInfo 반환하거나 해당 경로에 마운트된 항목이 없거나 마운트 지점으로 /proc/mounts에 나타나지 않으면 null 반환합니다.

abstract getMountPointInfo ()

장치의 /proc/mounts에 있는 정보의 구문 분석된 버전을 반환합니다.

abstract long getPartitionFreeSpace (String partition)

장치 파티션의 여유 공간을 결정하는 도우미 메서드입니다.

abstract ProcessInfo getProcessByName (String processName)

도우미 메서드는 "pidof" 및 "stat" 명령을 실행하고 지정된 프로세스의 PID 및 프로세스 시작 시간과 함께 ProcessInfo 개체를 반환합니다.

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 ()

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

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 ()

이 방법은 더 이상 사용되지 않습니다. 대신 postInvocationTearDown(Throwable) 사용하십시오.

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)

장치에서 파일을 검색하여 로컬 임시 ERROR(/File) 에 저장하고 해당 File 반환합니다.

abstract File pullFile (String remoteFilePath)

장치에서 파일을 검색하여 로컬 임시 ERROR(/File) 에 저장하고 해당 File 반환합니다.

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)

장치의 외부 저장소에서 파일을 검색하고 로컬 임시 ERROR(/File) 에 저장하고 해당 File 에 대한 참조를 반환하는 편리한 방법입니다.

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)

콘텐츠 공급자에 대한 필요성 평가를 선택적으로 고려할 수 있는 pushFile(File, String) 의 변형입니다.

abstract boolean pushFile (File localFile, String deviceFilePath)

파일을 장치로 푸시합니다.

abstract boolean pushString (String contents, String deviceFilePath)

문자열에서 생성된 파일을 장치로 푸시

abstract void reboot ()

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

abstract void reboot (String reason)

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

abstract void rebootIntoBootloader ()

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

abstract void rebootIntoFastbootd ()

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

abstract void rebootIntoRecovery ()

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

abstract void rebootIntoSideload (boolean autoReboot)

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

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

abstract void rebootIntoSideload ()

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

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

abstract void rebootUntilOnline ()

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

abstract void rebootUntilOnline (String reason)

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

abstract void rebootUserspace ()

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

abstract void rebootUserspaceUntilOnline ()

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

abstract void remountSystemWritable ()

장치의 시스템 파티션을 쓰기 가능하게 만드십시오.

abstract void remountVendorWritable ()

장치의 공급업체 파티션을 쓰기 가능하게 만드십시오.

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

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

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

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

abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)

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

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

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

abstract void setDate (Date date)

기기의 날짜 설정

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

abstract void setOptions ( TestDeviceOptions options)

장치에 대한 TestDeviceOptions 설정

abstract boolean setProperty (String propKey, String propValue)

장치에 지정된 속성 값을 설정합니다.

abstract void setRecovery ( IDeviceRecovery recovery)

이 장치에 사용할 IDeviceRecovery 설정합니다.

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 복구' 상태가 되도록 차단합니다( IDeviceRecovery 와 구별됨).

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 : fastboot 명령이 실행되는 시스템 환경 변수

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 abstract  getBootHistory ()

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

보고
부팅 시간(Epoch 이후 초 단위의 UTC 시간) 및 부팅 이유의 맵

던지기
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (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

getDeviceState

public abstract TestDeviceState getDeviceState ()

장치의 상태를 가져옵니다.

보고
TestDeviceState

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 에 대한 참조를 반환합니다.

장치가 adb에서 연결 해제되고 다시 연결될 때마다 DDMS에서 새 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:

  • If the logcat is currently being captured in the background, will return up to TestDeviceOptions.getMaxLogcatDataSize() bytes of the current contents of the background logcat capture
  • Otherwise, will return a static dump of the logcat data if device is currently responding

    보고
    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 in IDevice 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

    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

    getMountPointInfo

    public abstract  getMountPointInfo ()

    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 abstract  getTombstones ()

    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

    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.

    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 : Set of excluded directories names that shouldn't be pushed.

    보고
    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 : the test result 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.

    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 call postBootSetup() . 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. Use waitForDeviceAvailable() 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. Use waitForDeviceAvailable() 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.