ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


ddmlib IDevice 에 안정적이고 약간 더 높은 수준의 API를 제공합니다.

구성 가능한 양만큼 장치 명령을 재시도하고, 응답하지 않는 장치에 대해 장치 복구 인터페이스를 제공합니다.

요약

중첩 클래스

class ITestDevice.ApexInfo

단일 APEX에 대한 정보를 저장하는 간단한 구조체 클래스

class ITestDevice.MountPointInfo

단일 마운트 지점에 대한 정보를 저장하는 간단한 구조체 클래스

공개 메소드

abstract boolean canSwitchToHeadlessSystemUser ()

헤드리스 SYSTEM 사용자로 전환이 허용되는지 여부를 반환합니다.

abstract boolean checkConnectivity ()

장치가 네트워크에 연결되어 있는지 확인하십시오.

abstract boolean clearErrorDialogs ()

현재 장치 UI에 표시되는 오류 대화 상자를 닫으려고 합니다.

abstract void clearLastConnectedWifiNetwork ()

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

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

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

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

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

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

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

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

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

abstract int createUser (String name)

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

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

주어진 이름과 제공된 플래그를 사용하여 사용자를 생성합니다.

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

주어진 이름과 제공된 플래그를 사용하여 사용자를 생성합니다.

abstract int createUserNoThrow (String name)

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

등록된 IDeviceActionReceiver 제거합니다.

abstract void disableKeyguard ()

키가드를 비활성화하려고 시도합니다.

abstract boolean disableNetworkMonitor ()

장치에서 네트워크 모니터링을 비활성화합니다.

abstract boolean disconnectFromWifi ()

Wi-Fi 네트워크 연결을 끊습니다.

abstract boolean doesFileExist (String deviceFilePath, int userId)

특정 사용자에 대해 장치에 파일이 있는지 확인하는 도우미 메서드입니다.

abstract File dumpHeap (String process, String devicePath)

system_server에서 힙 덤프를 시도합니다.

abstract boolean enableNetworkMonitor ()

장치에서 네트워크 모니터링을 활성화합니다.

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

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

abstract String getAndroidId (int userId)

userId에 연결된 android-id를 찾아서 반환합니다. 찾을 수 없으면 null입니다.

abstract getAndroidIds ()

사용자 ID와 일치하는 Android ID의 맵을 만듭니다.

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

장치에서 버그 보고서를 검색합니다.

abstract InputStreamSource getBugreportz ()

장치에서 버그 보고서를 검색합니다.

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

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

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

장치의 IP 주소를 가져옵니다.

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

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

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

지원되는 최대 사용자 수를 확보하세요.

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

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

abstract InputStreamSource getScreenshot ()

장치에서 스크린샷을 찍습니다.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

장치에서 스크린샷을 찍습니다.

abstract InputStreamSource getScreenshot (String format)

장치에서 스크린샷을 찍습니다.

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

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

abstract getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

특정 사용자의 플래그를 찾아 반환합니다.

abstract getUserInfos ()

장치의 UserInfo 에 대한 useId 맵을 가져옵니다.

abstract int getUserSerialNumber (int userId)

발견된 경우 userId와 연관된 일련 번호를 반환하고, 다른 경우에는 -10000을 반환합니다.

abstract boolean hasFeature (String feature)

장치에서 기능을 사용할 수 있는지 확인하십시오.

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

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

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

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

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

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

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

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

default String installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)

여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다.

default String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

Android 장치에 있는 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다.

default String installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

특정 사용자를 위해 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다.

default String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

특정 사용자를 위해 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다.

default String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

Android 장치에 있는 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다.

default String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Android 장치에 있는 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다.

abstract boolean isHeadlessSystemUserMode ()

장치가 헤드리스 시스템 사용자 모드를 사용하는지 여부를 반환합니다.

abstract boolean isMainUserPermanentAdmin ()

기본 사용자가 영구 관리자인지, 삭제하거나 관리자가 아닌 상태로 다운그레이드할 수 없는지 여부를 반환합니다.

abstract boolean isMultiUserSupported ()

다중 사용자가 지원되는지 결정합니다.

abstract boolean isPackageInstalled (String packageName)

특정 패키지 이름을 장치에 쿼리하여 현재 설치되어 있는지 확인하세요.

abstract boolean isPackageInstalled (String packageName, String userId)

주어진 패키지 이름과 주어진 사용자 ID에 대해 장치를 쿼리하여 해당 사용자에 대해 현재 설치되어 있는지 확인합니다.

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

해당 사용자가 표시되는지 확인합니다.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

abstract boolean isVisibleBackgroundUsersSupported ()

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

abstract boolean isWifiEnabled ()

Wi-Fi가 활성화되어 있는지 테스트합니다.

abstract listDisplayIds ()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract listUsers ()

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

abstract boolean logBugreport (String dataName, ITestLogger listener)

버그 신고를 받아 기자에게 기록하는 도우미 메서드입니다.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

이 장치에 대한 IDeviceActionReceiver 를 등록합니다.

abstract boolean removeAdmin (String componentName, int userId)

특정 사용자에서 해당 장치 관리자를 제거하고 성공하면 true 반환하고, 그렇지 않으면 false 반환합니다.

abstract void removeOwners ()

최선을 다해 기존 장치 프로필 소유자를 모두 제거하세요.

abstract boolean removeUser (int userId)

장치에서 특정 사용자를 제거합니다.

abstract boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

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

abstract boolean startUser (int userId)

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

abstract boolean startUser (int userId, boolean waitFlag)

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

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

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

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

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

abstract boolean stopUser (int userId)

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

abstract boolean switchUser (int userId)

기본 시간 제한을 사용하여 다른 userId로 전환합니다.

abstract boolean switchUser (int userId, long timeout)

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

abstract Bugreport takeBugreport ()

버그 보고서를 가져와 Bugreport 개체 내부에 반환하여 처리합니다.

abstract String uninstallPackage (String packageName)

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

abstract String uninstallPackageForUser (String packageName, int userId)

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

공개 메소드

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

헤드리스 SYSTEM 사용자로 전환이 허용되는지 여부를 반환합니다.

보고
boolean

던지기
DeviceNotAvailableException

연결 확인

public abstract boolean checkConnectivity ()

장치가 네트워크에 연결되어 있는지 확인하십시오.

보고
boolean 장치에 작동 중인 네트워크 연결이 있으면 true 이고, 그렇지 않으면 false .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

클리어오류대화상자

public abstract boolean clearErrorDialogs ()

현재 장치 UI에 표시되는 오류 대화 상자를 닫으려고 합니다.

보고
boolean 대화 상자가 없거나 대화 상자가 성공적으로 지워진 경우 true . 그렇지 않으면 false .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

지우기마지막 연결WiFi네트워크

public abstract void clearLastConnectedWifiNetwork ()

마지막으로 연결된 Wi-Fi 네트워크를 지웁니다. 기기 재부팅 후 이전 테스트에서 사용된 Wi-Fi 네트워크에 연결되지 않도록 새 호출을 시작할 때 이 호출을 호출해야 합니다.

connectToWiFi네트워크

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

매개변수
wifiSsidToPsk : Wi-Fi SSID를 비밀번호로 매핑한 것입니다.

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

보고
boolean Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

connectToWiFi네트워크

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

매개변수
wifiSsidToPsk : Wi-Fi SSID를 비밀번호로 매핑한 것입니다.

보고
boolean Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

connectToWiFi네트워크

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

보고
boolean Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

connectToWiFi네트워크

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

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

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

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

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

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

보고
boolean Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

connectToWifiNetworkIf필요한 경우

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

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

매개변수
scanSsid boolean : 이 네트워크에 대해 숨겨진 SSID를 검색할지 여부

보고
boolean Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIf필요한 경우

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

보고
boolean Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

사용자 생성

public abstract int createUser (String name)

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

매개변수
name String : 장치에서 생성할 사용자의 것입니다.

보고
int 생성된 사용자 ID의 정수

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

사용자 생성

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

주어진 이름과 제공된 플래그를 사용하여 사용자를 생성합니다.

매개변수
name String : 장치에서 생성할 사용자의 것입니다.

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

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

forTesting boolean : 생성 중에 테스트 플래그 --for-testing을 활성화합니다.

보고
int 생성된 사용자의 ID

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

사용자 생성

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

주어진 이름과 제공된 플래그를 사용하여 사용자를 생성합니다.

매개변수
name String : 장치에서 생성할 사용자의 것입니다.

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

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

보고
int 생성된 사용자의 ID

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

매개변수
name String : 장치에서 생성할 사용자의 것입니다.

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

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

등록된 IDeviceActionReceiver 제거합니다.

매개변수
deviceActionReceiver IDeviceActionReceiver : 제거될 IDeviceActionReceiver 입니다.

비활성화키가드

public abstract void disableKeyguard ()

키가드를 비활성화하려고 시도합니다.

먼저 입력 디스패치가 준비될 때까지 기다립니다. 이는 장치가 BOOT_COMPLETE를 비동기적으로 보고하는 것과 거의 동시에 발생합니다. 현재 프레임워크 구현에 가끔 경쟁 조건이 있기 때문입니다. 그런 다음 키가드를 해제하라는 명령이 전송됩니다(비보안 키가드에서만 작동).

던지기
DeviceNotAvailableException

비활성화네트워크모니터

public abstract boolean disableNetworkMonitor ()

장치에서 네트워크 모니터링을 비활성화합니다.

보고
boolean 모니터링이 성공적으로 비활성화된 경우 true . 실패하면 false .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

Wi-Fi 연결 해제

public abstract boolean disconnectFromWifi ()

Wi-Fi 네트워크 연결을 끊습니다.

알려진 네트워크 목록에서 모든 네트워크를 제거하고 Wi-Fi를 비활성화합니다.

보고
boolean Wi-Fi 네트워크 연결이 성공적으로 끊어지면 true . 연결 해제에 실패하면 false .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

파일이 존재합니까?

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

특정 사용자에 대해 장치에 파일이 있는지 확인하는 도우미 메서드입니다.

매개변수
deviceFilePath String : 확인할 장치의 파일 절대 경로

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

보고
boolean 파일이 존재하면 true , 그렇지 않으면 false .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

덤프힙

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

devicePath String : 덤프를 넣을 장치의 경로입니다. 권한이 허용되는 위치여야 합니다.

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

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

활성화네트워크모니터

public abstract boolean enableNetworkMonitor ()

장치에서 네트워크 모니터링을 활성화합니다.

보고
boolean 모니터링이 성공적으로 활성화되면 true 입니다. 실패하면 false .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

getActiveApexes

public abstract  getActiveApexes ()

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

보고
현재 장치에서 활성화된 ApexInfoERROR(/Set)

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

보고
키 값 쌍의 맵입니다. 네임스페이스가 지원되지 않으면 Null입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

userId에 연결된 android-id를 찾아서 반환합니다. 찾을 수 없으면 null입니다.

매개변수
userId int

보고
String

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract  getAndroidIds ()

사용자 ID와 일치하는 Android ID의 맵을 만듭니다. 각 사용자 ID가 이 함수와 연관된 Android ID를 발견하므로 일부 사용자 ID가 null과 일치할 수 있다는 보장은 없습니다.

보고
Android ID 지도에서 사용자 ID와 일치하는 것을 찾았습니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackage정보

public abstract PackageInfo getAppPackageInfo (String packageName)

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

매개변수
packageName String

보고
PackageInfo PackageInfo . 정보를 검색할 수 없는 경우는 null

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

보고
장치에 설치된 PackageInfoERROR(/List) .

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

장치에서 버그 보고서를 검색합니다.

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

보고
InputStreamSource 요청 시 버그 보고서 콘텐츠를 생성하는 InputStreamSource . 실패할 경우, InputStreamSourceERROR(/InputStream) 생성합니다.

getBugreportz

public abstract InputStreamSource getBugreportz ()

장치에서 버그 보고서를 검색합니다. Zip 형식의 버그 보고서에는 디버깅에 유용한 기본 버그 보고서와 기타 로그 파일이 포함되어 있습니다.

'adb 버전' > 1.0.36에서만 지원됩니다.

보고
InputStreamSource bugreportz가 포함된 zip 파일의 InputStreamSource 실패할 경우 null을 반환합니다.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

보고
DeviceFoldableState

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

보고
int

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

보고

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

보고
현재 장치에 설치된 String 패키지 이름의 ERROR(/Set) .

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIp주소

public abstract String getIpAddress ()

장치의 IP 주소를 가져옵니다.

보고
String 장치의 IP 주소, 또는 장치에 IP 주소가 없는 경우 null

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

getKeyguard상태

public abstract KeyguardControllerState getKeyguardState ()

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

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

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

getMainUserId

public abstract Integer getMainUserId ()

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

보고
Integer 기본 사용자가 있으면 해당 사용자의 userId이고, 기본 사용자가 없으면 null입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException 장치의 출력이 예상과 다른 경우.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

보고
현재 장치에 설치된 String 메인라인 모듈의 ERROR(/Set) .

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsers지원됨

public abstract int getMaxNumberOfRunningUsersSupported ()

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

보고
int 동시에 실행 중인 사용자 수를 나타내는 정수

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsers지원됨

public abstract int getMaxNumberOfUsersSupported ()

지원되는 최대 사용자 수를 확보하세요. 기본값은 0입니다.

보고
int 지원되는 사용자 수를 나타내는 정수

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

보고
TestDeviceOptions 테스트 중인 장치와 관련된 TestDeviceOptions 입니다.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

보고
Integer 기본 사용자가 있는 경우 기본 사용자의 userId이고, 기본 사용자가 없으면 null입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException 장치의 출력이 예상과 다른 경우.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

장치에서 스크린샷을 찍습니다.

보고
InputStreamSource png 형식의 스크린샷의 InputStreamSource . 스크린샷이 성공하지 못한 경우는 null 입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

장치에서 스크린샷을 찍습니다. 더 작은 크기를 위해 JPEG 인코딩 대신 getScreenshot(String) 사용하는 것이 좋습니다.

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

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

보고
InputStreamSource 스크린샷 형식의 InputStreamSource . 스크린샷이 성공하지 못한 경우 null 입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

장치에서 스크린샷을 찍습니다. 더 작은 크기를 위해 JPEG 인코딩 대신 getScreenshot(format)을 사용하는 것이 좋습니다.

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

보고
InputStreamSource 스크린샷 형식의 InputStreamSource . 스크린샷이 성공하지 못한 경우 null 입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: 위 구현을 확장하여 '형식' 및 '크기 조정'을 지원합니다.

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

보고
InputStreamSource 스크린샷 형식의 InputStreamSource . 스크린샷이 성공하지 못한 경우 null 입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

매개변수
namespace String

key String

보고
String

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

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

매개변수
userId int

namespace String

key String

보고
String 사용자의 네임스페이스:키와 연관된 값입니다. 찾을 수 없으면 Null입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

보고
현재 장치에 설치되어 있는 제거 가능한 String 패키지 이름의 ERROR(/Set) .

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

특정 사용자의 플래그를 찾아 반환합니다. 플래그는 Android 오픈소스 프로젝트의 "android.content.pm.UserInfo" 클래스에 정의되어 있습니다.

매개변수
userId int

보고
int 발견된 경우 제공된 userId와 관련된 플래그, 다른 경우에는 -10000입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

장치의 UserInfo 에 대한 useId 맵을 가져옵니다. 장치의 출력이 예상과 다른 경우 DeviceRuntimeException 발생합니다.

보고
UserInfo 개체 목록입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUser일련번호

public abstract int getUserSerialNumber (int userId)

발견된 경우 userId와 연관된 일련 번호를 반환하고, 다른 경우에는 -10000을 반환합니다.

매개변수
userId int

보고
int

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

기능 있음

public abstract boolean hasFeature (String feature)

장치에서 기능을 사용할 수 있는지 확인하십시오.

매개변수
feature String : "feature:" 형식이어야 합니다. " 또는 " " 곧장.

보고
boolean 기능이 발견되면 참이고, 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

설치패키지

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

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

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

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

설치패키지

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

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

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

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

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

installPackageForUser

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

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

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

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

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

installPackageForUser

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

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

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

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

설치패키지

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다. apk를 여러 파일로 분할하는 방법은 "https://developer.android.com/studio/build/configure-apk-splits"를 참조하세요.

매개변수
packageFiles : 로컬 apk 파일

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

설치패키지

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Android 장치에 있는 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다. apk를 여러 파일로 분할하는 방법은 "https://developer.android.com/studio/build/configure-apk-splits"를 참조하세요.

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

매개변수
packageFiles : 설치할 원격 apk 파일 경로

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

특정 사용자를 위해 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다. apk를 여러 파일로 분할하는 방법은 "https://developer.android.com/studio/build/configure-apk-splits"를 참조하세요.

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

매개변수
packageFiles : 로컬 apk 파일

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

특정 사용자를 위해 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다. apk를 여러 파일로 분할하는 방법은 "https://developer.android.com/studio/build/configure-apk-splits"를 참조하세요.

매개변수
packageFiles : 로컬 apk 파일

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

원격 패키지 설치

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Android 장치에 있는 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다. apk를 여러 파일로 분할하는 방법은 "https://developer.android.com/studio/build/configure-apk-splits"를 참조하세요.

매개변수
remoteApkPaths : 원격 apk 파일 경로

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

원격 패키지 설치

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Android 장치에 있는 여러 APK 파일(기본 및 추가 분할 패키지 1개)로 구성된 Android 애플리케이션을 설치합니다. apk를 여러 파일로 분할하는 방법은 "https://developer.android.com/studio/build/configure-apk-splits"를 참조하세요.

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

매개변수
remoteApkPaths : 원격 apk 파일 경로

reinstall boolean : 재설치를 수행해야 하는 경우 true

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

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

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.
UnsupportedOperationException 장치의 플랫폼에서 런타임 권한을 지원하지 않는 경우.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

장치가 헤드리스 시스템 사용자 모드를 사용하는지 여부를 반환합니다.

보고
boolean

던지기
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

기본 사용자가 영구 관리자인지, 삭제하거나 관리자가 아닌 상태로 다운그레이드할 수 없는지 여부를 반환합니다.

보고
boolean

던지기
DeviceNotAvailableException

다중 사용자 지원됨

public abstract boolean isMultiUserSupported ()

다중 사용자가 지원되는지 결정합니다.

보고
boolean 다중 사용자가 지원되면 true, 그렇지 않으면 false

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled입니다.

public abstract boolean isPackageInstalled (String packageName)

특정 패키지 이름을 장치에 쿼리하여 현재 설치되어 있는지 확인하세요.

매개변수
packageName String

보고
boolean 패키지가 설치된 것으로 보고되면 참입니다. 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled입니다.

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

주어진 패키지 이름과 주어진 사용자 ID에 대해 장치를 쿼리하여 해당 사용자에 대해 현재 설치되어 있는지 확인합니다.

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

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

보고
boolean 패키지가 설치된 것으로 보고되면 참입니다. 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

매개변수
userId int

보고
boolean 사용자가 실행 중이면 참이고, 다른 모든 경우에는 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

매개변수
userId int

보고
boolean 사용자가 보조 사용자이면 true이고, 그렇지 않으면 false입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

해당 사용자가 표시되는지 확인합니다.

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

매개변수
userId int

보고
boolean

던지기
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

"보이는" 사용자는 "사람" 사용자와 상호 작용하므로 해당 디스플레이에서 실행 활동을 시작할 수 있는 사용자입니다.

매개변수
userId int

displayId int

보고
boolean

던지기
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplay지원됨

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

보고
boolean

던지기
DeviceNotAvailableException

isVisibleBackgroundUsers지원됨

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

보고
boolean

던지기
DeviceNotAvailableException

Wi-Fi 활성화됨

public abstract boolean isWifiEnabled ()

Wi-Fi가 활성화되어 있는지 테스트합니다.

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

보고
boolean Wi-Fi가 활성화된 경우 true . 비활성화된 경우 false

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

목록디스플레이 ID

public abstract  listDisplayIds ()

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

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

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

보고

던지기
DeviceNotAvailableException

목록사용자

public abstract  listUsers ()

기기의 사용자 목록을 가져옵니다. 장치의 출력이 예상과 다른 경우 DeviceRuntimeException 발생합니다.

보고
사용자 ID 목록입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

로그버그 신고

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

버그 신고를 받아 기자에게 기록하는 도우미 메서드입니다.

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

listener ITestLogger : 버그 보고서를 기록하는 ITestLogger 입니다.

보고
boolean 로깅이 성공하면 True이고, 그렇지 않으면 False입니다.

RegisterDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

이 장치에 대한 IDeviceActionReceiver 를 등록합니다.

등록된 모든 IDeviceActionReceiver 는 장치 작업이 시작되기 전과 장치 작업이 끝난 후에 알림을 받습니다.

매개변수
deviceActionReceiver IDeviceActionReceiver : 등록할 IDeviceActionReceiver 입니다.

제거관리자

public abstract boolean removeAdmin (String componentName, 
                int userId)

특정 사용자에서 해당 장치 관리자를 제거하고 성공하면 true 반환하고, 그렇지 않으면 false 반환합니다.

매개변수
componentName String : 제거할 장치 관리자의 이름입니다.

userId int : 장치 관리자가 거주하는 사용자입니다.

보고
boolean 성공하면 참, 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

소유자 제거

public abstract void removeOwners ()

최선을 다해 기존 장치 프로필 소유자를 모두 제거하세요.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

사용자 제거

public abstract boolean removeUser (int userId)

장치에서 특정 사용자를 제거합니다.

매개변수
userId int : 제거할 사용자의

보고
boolean 사용자 제거에 성공하면 true이고, 그렇지 않으면 false입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

매개변수
componentName String : 장치 관리자가 장치 소유자가 됩니다.

userId int : 장치 소유자가 거주하는 사용자입니다.

보고
boolean 성공하면 참, 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

설정설정

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

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

매개변수
namespace String

key String

value String

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

설정설정

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

특정 사용자의 네임스페이스에 설정 값을 추가합니다. 일부 설정은 재부팅 후에만 사용할 수 있습니다. 네임스페이스는 {"system", "secure", "global"} 중 하나여야 합니다.

매개변수
userId int

namespace String

key String

value String

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

시작사용자

public abstract boolean startUser (int userId)

현재 중지된 경우 지정된 사용자를 백그라운드에서 시작합니다. 사용자가 이미 백그라운드에서 실행 중인 경우 이 메서드는 NOOP입니다.

매개변수
userId int : 백그라운드에서 시작할 사용자

보고
boolean 사용자가 백그라운드에서 성공적으로 시작된 경우 true입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

시작사용자

public abstract boolean startUser (int userId, 
                boolean waitFlag)

현재 중지된 경우 지정된 사용자를 백그라운드에서 시작합니다. 사용자가 이미 백그라운드에서 실행 중인 경우 이 메서드는 NOOP입니다. 작업이 적용될 때까지 기다리기 위해 추가 플래그를 제공할 수 있습니다.

매개변수
userId int : 백그라운드에서 시작할 사용자

waitFlag boolean : 사용자가 시작되고 잠금이 해제될 때까지 명령을 기다리게 합니다.

보고
boolean 사용자가 백그라운드에서 성공적으로 시작된 경우 true입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

참고: 이 명령은 사용자가 존재하는지, 디스플레이가 사용 가능한지, device supports such feature 등을 확인하지 않습니다.

매개변수
userId int : 백그라운드에서 시작할 사용자

displayId int : 사용자가 볼 수 있는 시작 표시

waitFlag boolean : 사용자가 시작되고 잠금이 해제될 때까지 명령을 기다리게 합니다.

보고
boolean 사용자가 성공적으로 시작된 경우 true . 백그라운드에 표시됩니다.

던지기
DeviceNotAvailableException

중지사용자

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

특정 사용자를 중지합니다. 작업이 적용될 때까지 기다리기 위한 추가 플래그를 제공하고 사용자를 강제 종료할 수 있습니다. 현재 사용자와 시스템 사용자를 중지할 수 없습니다.

매개변수
userId int : 중지할 사용자의 이름입니다.

waitFlag boolean : 사용자가 중지될 때까지 명령을 기다리게 합니다.

forceFlag boolean : 사용자를 강제로 중지합니다.

보고
boolean 사용자가 성공적으로 중지된 경우 true입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

중지사용자

public abstract boolean stopUser (int userId)

지정된 사용자를 중지합니다. 사용자가 이미 중지된 경우 이 메서드는 NOOP입니다. 현재 사용자와 시스템 사용자를 중지할 수 없습니다.

매개변수
userId int : 중지할 사용자의 이름입니다.

보고
boolean 사용자가 성공적으로 중지된 경우 true입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

스위치사용자

public abstract boolean switchUser (int userId)

기본 시간 제한을 사용하여 다른 userId로 전환합니다. switchUser(int, long) .

매개변수
userId int

보고
boolean 새 userId가 userId 공급자와 일치하면 참입니다. 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

스위치사용자

public abstract boolean switchUser (int userId, 
                long timeout)

제공된 제한 시간을 기한으로 사용하여 다른 userId로 전환합니다. 사용자 변경이 성공한 후 키가드를 비활성화해 보십시오.

매개변수
userId int

timeout long : 사용자 전환이 실패했을 때 false를 반환하기 전에 기다립니다.

보고
boolean 새 userId가 userId 공급자와 일치하면 참입니다. 그렇지 않으면 거짓입니다.

던지기
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

버그 신고

public abstract Bugreport takeBugreport ()

버그 보고서를 가져와 Bugreport 개체 내부에 반환하여 처리합니다. 문제가 있는 경우 null을 반환합니다. Bugreport 개체에서 참조된 파일은 Bugreport.close() 통해 정리해야 합니다.

보고
Bugreport

제거패키지

public abstract String uninstallPackage (String packageName)

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

매개변수
packageName String : 제거할 Android 패키지

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

매개변수
packageName String : 제거할 Android 패키지

userId int : 제거할 정수 사용자 ID입니다.

보고
String 오류 코드가 포함된 String . 성공하면 null .

던지기
DeviceNotAvailableException 장치와의 연결이 끊어져 복구할 수 없는 경우.