구성 가능한 양만큼 장치 명령을 재시도하고 응답하지 않는 장치에 대한 장치 복구 인터페이스를 제공합니다.
중첩 클래스 |
---|
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 () 장치에서 bugreportz를 검색합니다. |
abstract DeviceFoldableState | getCurrentFoldableState () 기기의 현재 폴더블 상태를 반환하거나 일부 문제가 발생한 경우 null을 반환합니다. |
abstract int | getCurrentUser () 현재 실행 중인 사용자의 ID를 반환합니다. |
abstract | getFoldableStates () 기기의 폴더블 상태 목록을 반환합니다. |
abstract | getInstalledPackageNames () 기기에 있는 애플리케이션 패키지 이름을 가져옵니다. |
abstract String | getIpAddress () 장치의 IP 주소를 가져옵니다. |
abstract KeyguardControllerState | getKeyguardState () keyguard의 현재 상태를 가져오려면 객체를 반환하거나 지원되지 않는 경우 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 파일(하나의 기본 및 추가 분할 패키지)으로 구성된 Android 애플리케이션을 설치합니다. |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Android 기기에 있는 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) 지정된 사용자를 위해 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) 지정된 사용자를 위해 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Android 기기에 있는 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Android 기기에 있는 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 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) 기본 시간 제한이 있는 다른 사용자 ID로 전환합니다. |
abstract boolean | switchUser (int userId, long timeout) 기한으로 제공된 제한 시간이 있는 다른 사용자 ID로 전환하십시오. |
abstract Bugreport | takeBugreport () 버그 보고서를 가져오고 이를 처리하기 위해 Bugreport 개체 내부에 반환합니다. |
abstract String | uninstallPackage (String packageName) 기기에서 Android 패키지를 제거합니다. |
abstract String | uninstallPackageForUser (String packageName, int userId) 지정된 사용자의 기기에서 Android 패키지를 제거합니다. |
공개 방법
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
헤드리스 SYSTEM 사용자로 전환할 수 있는지 여부를 반환합니다.
연결 확인
public abstract boolean checkConnectivity ()
장치가 네트워크에 연결되어 있는지 확인하십시오.
보고 |
---|
boolean | 장치에 작동 중인 네트워크 연결이 있는 경우 true , 전체적으로 false . |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
현재 장치 UI에 표시된 오류 대화 상자를 닫으십시오.
보고 |
---|
boolean | 대화 상자가 없거나 대화 상자가 성공적으로 지워진 경우 true . 그렇지 않으면 false . |
clearLastConnectedWifi네트워크
public abstract void clearLastConnectedWifiNetwork ()
마지막으로 연결된 Wi-Fi 네트워크를 지웁니다. 기기 재부팅 후 이전 테스트에서 사용된 Wi-Fi 네트워크에 연결하지 않도록 새 호출을 시작할 때 호출해야 합니다.
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Wi-Fi 네트워크에 연결합니다.
wifiSsidToPsk 맵에 지정된 Wi-Fi 네트워크 중 하나와 성공적으로 연결될 때까지 Wi-Fi를 켜고 차단합니다. 일단 연결되면 인스턴스는 ITestDevice#disconnectFromWifi()
또는 ITestDevice#clearLastConnectedWifiNetwork()
호출될 때까지 재부팅할 때마다 연결 복원을 시도합니다.
매개변수 |
---|
wifiSsidToPsk | : 비밀번호에 대한 Wi-Fi SSID 맵입니다. |
scanSsid | boolean : 이 네트워크의 숨겨진 SSID를 스캔할지 여부. |
보고 |
---|
boolean | Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Wi-Fi 네트워크에 연결합니다.
wifiSsidToPsk 맵에 지정된 Wi-Fi 네트워크 중 하나와 성공적으로 연결될 때까지 Wi-Fi를 켜고 차단합니다. 일단 연결되면 인스턴스는 ITestDevice#disconnectFromWifi()
또는 ITestDevice#clearLastConnectedWifiNetwork()
호출될 때까지 재부팅할 때마다 연결 복원을 시도합니다.
매개변수 |
---|
wifiSsidToPsk | : 비밀번호에 대한 Wi-Fi SSID 맵입니다. |
보고 |
---|
boolean | Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false |
connectToWifiNetwork
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 |
connectToWifiNetwork
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 |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
장치에 현재 네트워크 연결이 없는 경우에만 연결하는 connectToWifiNetwork(String, String)
의 변형입니다.
매개변수 |
---|
scanSsid | boolean : 이 네트워크의 숨겨진 SSID를 스캔할지 여부 |
보고 |
---|
boolean | Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
장치에 현재 네트워크 연결이 없는 경우에만 연결하는 connectToWifiNetwork(String, String)
의 변형입니다.
보고 |
---|
boolean | Wi-Fi 네트워크에 성공적으로 연결된 경우 true . 그렇지 않으면 false |
사용자 생성
public abstract int createUser (String name)
주어진 이름과 기본 플래그 0으로 사용자를 만듭니다.
매개변수 |
---|
name | String : 디바이스에서 생성할 사용자의 |
사용자 생성
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
주어진 이름과 제공된 플래그로 사용자를 만듭니다.
매개변수 |
---|
name | String : 디바이스에서 생성할 사용자의 |
guest | boolean : 생성 중 사용자 플래그 --guest 활성화 |
ephemeral | boolean : 생성 중 사용자 플래그 --ephemeral 활성화 |
forTesting | boolean : 작성 중 테스트 플래그 --for-testing 활성화 |
사용자 생성
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
주어진 이름과 제공된 플래그로 사용자를 만듭니다.
매개변수 |
---|
name | String : 디바이스에서 생성할 사용자의 |
guest | boolean : 생성 중 사용자 플래그 --guest 활성화 |
ephemeral | boolean : 생성 중 사용자 플래그 --ephemeral 활성화 |
createUserNoThrow
public abstract int createUserNoThrow (String name)
주어진 이름과 기본 플래그 0으로 사용자를 만듭니다.
매개변수 |
---|
name | String : 디바이스에서 생성할 사용자의 |
보고 |
---|
int | 생성된 사용자 ID의 정수 또는 오류의 경우 -1. |
키가드 비활성화
public abstract void disableKeyguard ()
키가드를 비활성화하려고 시도합니다.
먼저 입력 디스패치가 준비될 때까지 기다립니다. 이것은 현재 프레임워크 구현에 가끔 경합 조건이 있기 때문에 장치가 BOOT_COMPLETE를 보고하는 것과 거의 동시에 비동기적으로 발생합니다. 그런 다음 키가드를 해제하라는 명령이 전송됩니다(비보안 항목에서만 작동).
disableNetworkMonitor
public abstract boolean disableNetworkMonitor ()
장치에서 네트워크 모니터링을 비활성화합니다.
보고 |
---|
boolean | 모니터링이 성공적으로 비활성화된 경우 true . 실패하면 false . |
Wifi에서 연결 해제
public abstract boolean disconnectFromWifi ()
Wi-Fi 네트워크에서 연결을 끊습니다.
알려진 네트워크 목록에서 모든 네트워크를 제거하고 Wi-Fi를 비활성화합니다.
보고 |
---|
boolean | Wi-Fi 네트워크에서 성공적으로 연결이 끊긴 경우 true . 연결 해제에 실패하면 false . |
파일 존재
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
지정된 사용자에 대해 장치에 파일이 있는지 확인하는 도우미 메서드입니다.
매개변수 |
---|
deviceFilePath | String : 확인할 장치의 파일 절대 경로 |
userId | int : 파일 존재를 확인할 사용자 ID |
보고 |
---|
boolean | 파일이 있으면 true , 그렇지 않으면 false . |
덤프힙
public abstract File dumpHeap (String process,
String devicePath)
system_server에서 힙 덤프를 시도합니다. 덤프된 파일을 정리하는 것은 호출자의 책임입니다.
매개변수 |
---|
process | String : 덤프할 장치 프로세스의 이름. |
devicePath | String : 덤프를 넣을 장치의 경로입니다. 권한이 허용하는 위치여야 합니다. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
장치에서 네트워크 모니터링을 활성화합니다.
보고 |
---|
boolean | 모니터링이 성공적으로 활성화된 경우 true . 실패하면 false . |
getActiveApexes
public abstract getActiveApexes ()
기기에서 활성화된 APEX에 대한 정보를 가져옵니다.
getAllSettings
public abstract getAllSettings (String namespace)
요청된 네임스페이스의 키 값 쌍을 반환합니다.
매개변수 |
---|
namespace | String : {"system", "secure", "global"} 중 하나여야 합니다. |
보고 |
---|
| 키 값 쌍의 맵. 네임스페이스가 지원되지 않으면 Null입니다. |
getAndroidId
public abstract String getAndroidId (int userId)
userId와 연결된 android-id를 찾아서 반환합니다. 찾지 못하면 null입니다.
getAndroidIds
public abstract getAndroidIds ()
일치하는 사용자 ID를 찾은 Android ID의 맵을 만듭니다. 각 사용자 ID가 이 기능과 관련된 Android ID를 찾을 것이라는 보장이 없으므로 일부 사용자 ID가 null과 일치할 수 있습니다.
보고 |
---|
| 일치하는 사용자 ID를 찾은 Android ID의 지도입니다. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
장치에 설치된 패키지에 대한 정보를 가져옵니다.
getAppPackageInfos
public abstract getAppPackageInfos ()
장치에 설치된 패키지 정보를 가져옵니다.
getBugreport
public abstract InputStreamSource getBugreport ()
장치에서 버그 보고서를 검색합니다.
이 구현은 sdcard가 없는(또는 sdcard가 아직 마운트되지 않은) 장치에서 계속 작동하도록 보장됩니다.
getBugreportz
public abstract InputStreamSource getBugreportz ()
장치에서 bugreportz를 검색합니다. Zip 형식 버그 보고서에는 기본 버그 보고서와 디버깅에 유용한 기타 로그 파일이 포함되어 있습니다.
'adb 버전' > 1.0.36에서만 지원됨
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
기기의 현재 폴더블 상태를 반환하거나 일부 문제가 발생한 경우 null을 반환합니다.
getCurrentUser
public abstract int getCurrentUser ()
현재 실행 중인 사용자의 ID를 반환합니다. 오류인 경우 -10000을 반환합니다.
getFoldableStates
public abstract getFoldableStates ()
기기의 폴더블 상태 목록을 반환합니다. "cmd device_state print-states"로 얻을 수 있습니다.
getInstalledPackageNames
public abstract getInstalledPackageNames ()
기기에 있는 애플리케이션 패키지 이름을 가져옵니다.
getIpAddress
public abstract String getIpAddress ()
장치의 IP 주소를 가져옵니다.
보고 |
---|
String | 장치의 IP 주소 또는 장치에 IP 주소가 없는 경우 null |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
keyguard의 현재 상태를 가져오려면 객체를 반환하거나 지원되지 않는 경우 null을 반환합니다.
getMainUserId
public abstract Integer getMainUserId ()
기본 사용자 ID를 반환합니다.
보고 |
---|
Integer | 메인 유저가 있는 경우는 유저 ID, 메인 유저가 없는 경우는 null. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
장치에 설치된 기본 모듈에 대한 정보를 가져옵니다.
public abstract int getMaxNumberOfRunningUsersSupported ()
지원되는 동시 실행 사용자의 최대 수를 가져옵니다. 기본값은 0입니다.
보고 |
---|
int | 동시 실행 사용자 수를 나타내는 정수 |
public abstract int getMaxNumberOfUsersSupported ()
지원되는 최대 사용자 수를 가져옵니다. 기본값은 0입니다.
보고 |
---|
int | 지원되는 사용자 수를 나타내는 정수 |
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
기본 사용자 ID를 반환합니다.
보고 |
---|
Integer | 기본 사용자가 있으면 기본 사용자의 userId이고 기본 사용자가 없으면 null입니다. |
스크린샷 받기
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
장치에서 스크린샷을 가져옵니다. 더 작은 크기를 위해 JPEG 인코딩 대신 getScreenshot(String)
사용하는 것이 좋습니다.
매개변수 |
---|
format | String : 지원되는 PNG, JPEG |
rescale | boolean : 결과 이미지의 크기를 줄이기 위해 스크린샷의 크기를 다시 조정해야 하는 경우 |
스크린샷 받기
public abstract InputStreamSource getScreenshot (String format)
장치에서 스크린샷을 가져옵니다. 더 작은 크기를 위해 JPEG 인코딩 대신 getScreenshot(format)을 사용하는 것이 좋습니다.
매개변수 |
---|
format | String : 지원되는 PNG, JPEG |
스크린샷 받기
public abstract InputStreamSource getScreenshot (long displayId)
디스플레이 ID가 지정된 장치에서 스크린샷을 가져옵니다. 형식은 PNG입니다.
TODO: '형식' 및 '재배율'을 지원하도록 위의 구현을 확장합니다.
매개변수 |
---|
displayId | long : 스크린샷을 가져올 화면의 디스플레이 ID입니다. |
getSetting
public abstract String getSetting (String namespace,
String key)
getSetting(int, String, String)
참조하고 시스템 사용자에서 수행합니다.
매개변수 |
---|
namespace | String |
key | String |
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
요청한 설정 값을 반환합니다. 네임스페이스는 {"system", "secure", "global"} 중 하나여야 합니다.
매개변수 |
---|
userId | int |
namespace | String |
key | String |
보고 |
---|
String | 사용자의 namespace:key와 관련된 값. 찾을 수 없는 경우 null입니다. |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
제거할 수 있는 애플리케이션 패키지 이름을 가져옵니다. 이것은 현재 비시스템 패키지 및 업데이트된 시스템 패키지로 정의됩니다.
getUserFlags
public abstract int getUserFlags (int userId)
지정된 사용자의 플래그를 찾아 반환합니다. 플래그는 Android 오픈 소스 프로젝트의 "android.content.pm.UserInfo" 클래스에 정의되어 있습니다.
보고 |
---|
int | userId와 관련된 플래그가 있는 경우 제공되며, 다른 경우에는 -10000입니다. |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
발견되면 userId와 연관된 일련 번호를 반환하고, 다른 경우에는 -10000을 반환합니다.
특징
public abstract boolean hasFeature (String feature)
장치에서 기능을 사용할 수 있는지 확인하십시오.
매개변수 |
---|
feature | String : 어떤 형식이 "feature: " 또는 " " 곧장. |
보고 |
---|
boolean | 기능이 발견되면 True, 그렇지 않으면 False입니다. |
설치 패키지
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 . |
설치 패키지
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 . |
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 . |
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 . |
설치 패키지
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
여러 APK 파일(하나의 기본 및 추가 분할 패키지)으로 구성된 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 . |
설치 패키지
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Android 기기에 있는 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 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 . |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
지정된 사용자를 위해 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 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 . |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
지정된 사용자를 위해 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 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 . |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Android 기기에 있는 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 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 . |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Android 기기에 있는 여러 APK 파일(하나의 기본 및 추가 분할 패키지)로 구성된 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 . |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
장치가 헤드리스 시스템 사용자 모드를 사용하는지 여부를 반환합니다.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
기본 사용자가 영구 관리자이고 삭제하거나 비관리자 상태로 다운그레이드할 수 없는지 여부를 반환합니다.
다중 사용자 지원 여부
public abstract boolean isMultiUserSupported ()
다중 사용자가 지원되는지 여부를 결정합니다.
보고 |
---|
boolean | 다중 사용자가 지원되면 true, 그렇지 않으면 false |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
주어진 패키지 이름에 대한 장치를 쿼리하여 현재 설치되어 있는지 확인하십시오.
보고 |
---|
boolean | 패키지가 설치된 것으로 보고되면 참입니다. 그렇지 않으면 거짓입니다. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
주어진 패키지 이름과 주어진 사용자 ID에 대해 장치를 쿼리하여 해당 사용자에 대해 현재 설치되어 있는지 확인합니다.
매개변수 |
---|
packageName | String : 설치 여부를 확인하는 패키지입니다. |
userId | String : 패키지가 설치되었는지 확인하는 사용자 ID입니다. null인 경우 기본 사용자 0이 사용됩니다. |
보고 |
---|
boolean | 패키지가 설치된 것으로 보고되면 참입니다. 그렇지 않으면 거짓입니다. |
isUserRunning
public abstract boolean isUserRunning (int userId)
주어진 사용자가 실행 중인지 확인하십시오.
보고 |
---|
boolean | 사용자가 실행 중인 경우 True이고 다른 모든 경우에는 False입니다. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
플래그에 따라 지정된 사용자가 보조 사용자인지 여부를 반환합니다.
보고 |
---|
boolean | 사용자가 보조 사용자이면 true이고 그렇지 않으면 false입니다. |
isUserVisible
public abstract boolean isUserVisible (int userId)
주어진 사용자가 보이는지 확인합니다.
"보이는" 사용자는 "인간" 사용자와 상호 작용하는 사용자이므로 시작 활동을 시작할 수 있습니다(일반적으로 기본 디스플레이에서).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
지정된 디스플레이에 지정된 사용자가 표시되는지 확인합니다.
"보이는" 사용자는 "인간" 사용자와 상호 작용하는 사용자이므로 해당 디스플레이에서 시작 활동을 시작할 수 있습니다.
매개변수 |
---|
userId | int |
displayId | int |
isWifi활성화됨
public abstract boolean isWifiEnabled ()
Wi-Fi가 활성화되어 있는지 테스트합니다.
장치에서 Wi-Fi가 활성화되어 있는지 확인합니다. Wi-Fi로 실행하면 안 되는 테스트(예: 모바일 데이터 테스트) 전에 Wi-Fi 상태를 확인하는 데 유용합니다.
보고 |
---|
boolean | Wi-Fi가 활성화된 경우 true . 비활성화된 경우 false |
listDisplayIds
public abstract listDisplayIds ()
"dumpsys SurfaceFlinger"에서 보고한 대로 장치에서 사용 가능한 디스플레이 ID 목록을 수집합니다.
보고 |
---|
| 디스플레이 목록입니다. 기본값은 항상 기본 디스플레이 0을 반환합니다. |
logBugreport
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
버그 보고서를 가져와 보고자에게 기록하는 도우미 메서드입니다.
매개변수 |
---|
dataName | String : 버그 신고가 보고될 이름입니다. |
listener | ITestLogger : 버그 보고서를 기록하기 위한 ITestLogger 입니다. |
보고 |
---|
boolean | 로깅이 성공하면 True, 그렇지 않으면 False입니다. |
removeAdmin
public abstract boolean removeAdmin (String componentName,
int userId)
주어진 사용자에서 주어진 장치 관리자를 제거하고 성공하면 true
반환하고 그렇지 않으면 false
반환합니다.
매개변수 |
---|
componentName | String : 제거할 장치 관리자의. |
userId | int : 장치 관리자가 거주하는 사용자. |
보고 |
---|
boolean | 성공하면 true, 그렇지 않으면 false입니다. |
소유자 제거
public abstract void removeOwners ()
최선의 노력으로 모든 기존 장치 프로필 소유자를 제거합니다.
사용자 제거
public abstract boolean removeUser (int userId)
장치에서 지정된 사용자를 제거합니다.
매개변수 |
---|
userId | int : 제거할 사용자 |
보고 |
---|
boolean | 사용자 제거에 성공하면 true이고, 그렇지 않으면 false입니다. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
지정된 사용자의 기기 관리자 구성요소를 기기 소유자로 설정합니다.
매개변수 |
---|
componentName | String : 기기 소유자가 될 기기 관리자의 문자열입니다. |
userId | int : 장치 소유자가 거주하는 사용자의. |
보고 |
---|
boolean | 성공하면 true, 그렇지 않으면 false입니다. |
설정설정
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
주어진 사용자의 네임스페이스에 설정 값을 추가합니다. 일부 설정은 재부팅 후에만 사용할 수 있습니다. 네임스페이스는 {"system", "secure", "global"} 중 하나여야 합니다.
매개변수 |
---|
userId | int |
namespace | String |
key | String |
value | String |
시작 사용자
public abstract boolean startUser (int userId)
현재 중지된 경우 지정된 사용자를 백그라운드에서 시작합니다. 사용자가 이미 백그라운드에서 실행 중인 경우 이 메서드는 NOOP입니다.
매개변수 |
---|
userId | int : 백그라운드에서 시작할 사용자의 |
보고 |
---|
boolean | 사용자가 백그라운드에서 성공적으로 시작된 경우 true입니다. |
시작 사용자
public abstract boolean startUser (int userId,
boolean waitFlag)
현재 중지된 경우 지정된 사용자를 백그라운드에서 시작합니다. 사용자가 이미 백그라운드에서 실행 중인 경우 이 메서드는 NOOP입니다. Possible to provide extra flag to wait for the operation to have effect.
매개변수 |
---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
보고 |
---|
boolean | true if the user was successfully started in the background. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
매개변수 |
---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
보고 |
---|
boolean | true if the user was successfully started visible in the background. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
매개변수 |
---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
보고 |
---|
boolean | true if the user was successfully stopped. |
stopUser
public abstract boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
매개변수 |
---|
userId | int : of the user to stop. |
보고 |
---|
boolean | true if the user was successfully stopped. |
switchUser
public abstract boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
보고 |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
매개변수 |
---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
보고 |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
takeBugreport
public abstract Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
uninstallPackage
public abstract String uninstallPackage (String packageName)
Uninstall an Android package from device.
매개변수 |
---|
packageName | String : the Android package to uninstall |
보고 |
---|
String | a String with an error code, or null if success. |
uninstallPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
Uninstall an Android package from device for a given user.
매개변수 |
---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
보고 |
---|
String | a String with an error code, or null if success. |
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2023-07-19(UTC)
[]
[]