2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

알려진 간접 하위 클래스

IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice

IManagedTestDevice	수명 주기가 관리되는 ITestDevice입니다.
LocalAndroidVirtualDevice	TradeFed 호스트에서 실행되는 로컬 가상 기기 클래스입니다.
ManagedRemoteDevice	VM 내의 Tradefed 인스턴스를 통해 원격으로 관리하는 가상 머신 내에서 실행되는 기기입니다.
NativeDevice	`ITestDevice` 비전체 스택 Android 기기의 기본 구현입니다.
NestedRemoteDevice	원격 Cuttlefish VM 내에서 실행되는 기기의 표현입니다.
RemoteAndroidDevice	adb connect를 통해 연결된 전체 스택 Android 기기의 `ITestDevice` 구현
RemoteAndroidVirtualDevice	Google Compute Engine (Gce)에서 실행되는 전체 스택 Android 기기의 `RemoteAndroidDevice` 동작을 확장합니다.
TestDevice	전체 스택 Android 기기의 `ITestDevice` 구현

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

구성 가능한 시간 동안 기기 명령어를 재시도하고 응답하지 않는 기기에 기기 복구 인터페이스를 제공합니다.

요약

중첩된 클래스
`class`	`ITestDevice.ApexInfo` 단일 APEX에 관한 정보를 저장하는 간단한 구조체 클래스
`class`	`ITestDevice.MountPointInfo` 단일 마운트 지점에 관한 정보를 저장하는 간단한 구조체 클래스

공개 메서드
`abstract String`	`adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)` adb 명령어로 기기에 Android 패키지를 설치합니다.
`abstract String`	`adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` adb 명령어로 기기에 Android 패키지를 설치합니다.
`abstract boolean`	`canSwitchToHeadlessSystemUser()` 헤드리스 시스템 사용자로 전환이 허용되는지 여부를 반환합니다.
`abstract boolean`	`checkConnectivity()` 기기가 네트워크에 연결되어 있는지 확인합니다.
`abstract boolean`	`clearErrorDialogs()` 현재 기기 UI에 표시된 오류 대화상자를 닫으려고 시도합니다.
`abstract void`	`clearLastConnectedWifiNetwork()` 마지막으로 연결된 Wi-Fi 네트워크를 지웁니다.
`default boolean`	`connectToWifiNetwork(Map<String, String> wifiSsidToPsk, boolean scanSsid)` 이 메서드는 지원 중단되었습니다. 대신 `connectToWifiNetworkWithResult(Map,boolean)`를 사용하세요.
`default boolean`	`connectToWifiNetwork(Map<String, String> wifiSsidToPsk)` 이 메서드는 지원 중단되었습니다. 대신 `connectToWifiNetworkWithResult(Map)`를 사용하세요.
`default boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` 이 메서드는 지원 중단되었습니다. 대신 `connectToWifiNetworkWithResult(String,String)`를 사용하세요.
`default boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` 이 메서드는 지원 중단되었습니다. 대신 `connectToWifiNetworkWithResult(String,String,boolean)`를 사용하세요.
`default boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` 이 메서드는 지원 중단되었습니다. 대신 `connectToWifiNetworkIfNeededWithResult(String,String,boolean)`를 사용하세요.
`default boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` 이 메서드는 지원 중단되었습니다. 대신 `connectToWifiNetworkIfNeededWithResult(String,String)`를 사용하세요.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` 기기에 현재 네트워크 연결이 없는 경우에만 연결되는 `connectToWifiNetwork(String,String)`의 변형입니다.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)` 기기에 현재 네트워크 연결이 없는 경우에만 연결되는 `connectToWifiNetwork(String,String)`의 변형입니다.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` Wi-Fi 네트워크에 연결합니다.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)` Wi-Fi 네트워크에 연결합니다.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)` Wi-Fi 네트워크에 연결합니다.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)` Wi-Fi 네트워크에 연결합니다.
`abstract int`	`createUser(String name)` 지정된 이름과 기본 플래그 0으로 사용자를 만듭니다.
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral)` 지정된 이름과 제공된 플래그로 사용자를 만듭니다.
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` 지정된 이름과 제공된 플래그로 사용자를 만듭니다.
`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 Set<ITestDevice.ApexInfo>`	`getActiveApexes()` 기기에서 활성화된 APEX에 관한 정보를 가져옵니다.
`abstract Map<String, String>`	`getAllSettings(String namespace)` 요청된 네임스페이스의 키-값 쌍을 반환합니다.
`abstract String`	`getAndroidId(int userId)` userId와 연결된 android-id를 찾아 반환합니다. 찾을 수 없는 경우 null을 반환합니다.
`abstract Map<Integer, String>`	`getAndroidIds()` 일치하는 사용자 ID가 있는 Android ID의 지도를 만듭니다.
`abstract PackageInfo`	`getAppPackageInfo(String packageName)` 기기에 설치된 패키지에 관한 정보를 가져옵니다.
`abstract List<PackageInfo>`	`getAppPackageInfos()` 기기에 설치된 패키지의 정보를 가져옵니다.
`abstract InputStreamSource`	`getBugreport()` 기기에서 버그 신고를 가져옵니다.
`abstract InputStreamSource`	`getBugreportz()` 기기에서 bugreportz를 가져옵니다.
`abstract DeviceFoldableState`	`getCurrentFoldableState()` 문제가 발생한 경우 기기의 현재 폴더블 상태를 반환하거나 null을 반환합니다.
`abstract int`	`getCurrentUser()` 현재 실행 중인 사용자의 ID를 반환합니다.
`abstract Set<DeviceFoldableState>`	`getFoldableStates()` 기기의 폴더블 상태 목록을 반환합니다.
`abstract Set<String>`	`getInstalledPackageNames()` 기기에 있는 애플리케이션 패키지 이름을 가져옵니다.
`abstract String`	`getIpAddress()` 기기의 IP 주소를 가져옵니다.
`abstract KeyguardControllerState`	`getKeyguardState()` 키가드의 현재 상태를 가져오는 객체를 반환하거나 지원되지 않는 경우 null을 반환합니다.
`abstract Integer`	`getMainUserId()` 기본 사용자 ID를 반환합니다.
`abstract Set<String>`	`getMainlineModuleInfo()` 기기에 설치된 Mainline 모듈에 관한 정보를 가져옵니다.
`abstract int`	`getMaxNumberOfRunningUsersSupported()` 지원되는 동시 실행 사용자 수를 가져옵니다.
`abstract int`	`getMaxNumberOfUsersSupported(String userType)` 지정된 사용자 유형의 지원되는 최대 사용자 수를 가져옵니다.
`abstract int`	`getMaxNumberOfUsersSupported()` 이 메서드는 지원 중단되었습니다. getMaxNumberOfUsersSupported(String userType)를 사용하여 지정된 사용자 유형에 지원되는 최대 사용자 수를 가져옵니다.
`abstract TestDeviceOptions`	`getOptions()` 기기의 테스트 옵션을 가져옵니다.
`abstract Integer`	`getPrimaryUserId()` 이 메서드는 지원 중단되었습니다. getPrimaryUser가 UserManager 서비스에서 지원 중단되었습니다. `ERROR(/android.os.UserManager#getMainUserId())`를 사용하여 첫 번째 전체 사용자 또는 시스템의 경우 0을 가져오세요. 헤드리스 시스템의 경우 전체 사용자가 아닙니다.
`abstract int`	`getRemainingCreatableUserCount(String userType)` 이 기기에서 만들 수 있는 지정된 사용자 유형의 사용자 수를 반환합니다.
`abstract InputStreamSource`	`getScreenshot(Long displayId, String format, boolean rescale)` 지원되는 형식으로 지정된 디스플레이 ID의 기기에서 스크린샷을 가져옵니다.
`abstract InputStreamSource`	`getScreenshot(String format, boolean rescale)` 기기에서 스크린샷을 가져옵니다.
`abstract InputStreamSource`	`getScreenshot(String format)` 기기에서 스크린샷을 가져옵니다.
`abstract InputStreamSource`	`getScreenshot(long displayId)` 지정된 디스플레이 ID의 기기에서 스크린샷을 가져옵니다.
`abstract InputStreamSource`	`getScreenshot()` 기기에서 스크린샷을 가져옵니다.
`abstract String`	`getSetting(int userId, String namespace, String key)` 요청된 설정의 값을 반환합니다.
`abstract String`	`getSetting(String namespace, String key)` `getSetting(int,String,String)`를 참고하고 시스템 사용자에 대해 실행됩니다.
`abstract Set<String>`	`getUninstallablePackageNames()` 제거할 수 있는 애플리케이션 패키지 이름을 가져옵니다.
`abstract int`	`getUserFlags(int userId)` 지정된 사용자의 플래그를 찾아 반환합니다.
`abstract Map<Integer, UserInfo>`	`getUserInfos()` 기기에서 useId와 `UserInfo`의 맵을 가져옵니다.
`abstract int`	`getUserSerialNumber(int userId)` userId와 연결된 일련번호를 찾은 경우 반환하고, 그 외의 경우에는 -10000을 반환합니다.
`abstract int`	`getUserVisibleOnDisplay(int displayId)` 지정된 디스플레이에서 표시되는 사용자의 사용자 ID를 가져옵니다.
`abstract boolean`	`hasFeature(String feature)` 기기에서 기능을 사용할 수 있는지 확인합니다.
`abstract String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` 기기에 Android 패키지를 설치합니다.
`abstract String`	`installPackage(File packageFile, boolean reinstall, 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 패키지를 설치합니다.
`abstract boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` 증분 모드로 APK를 설치합니다.
`default String`	`installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)` 여러 APK 파일 (기본 패키지 1개와 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다.
`default String`	`installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` Android 기기에 있는 여러 APK 파일 (하나의 기본 패키지와 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다.
`default String`	`installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)` 지정된 사용자를 위해 여러 APK 파일 (하나의 기본 패키지와 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다.
`default String`	`installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` 지정된 사용자를 위해 여러 APK 파일 (하나의 기본 패키지와 추가 분할 패키지)로 구성된 Android 애플리케이션을 설치합니다.
`abstract boolean`	`isHeadlessSystemUserMode()` 기기에서 헤드리스 시스템 사용자 모드를 사용하는지 여부를 반환합니다.
`abstract boolean`	`isMainUserPermanentAdmin()` 기본 사용자가 영구 관리자이며 삭제하거나 비관리자 상태로 다운그레이드할 수 없는지 여부를 반환합니다.
`abstract boolean`	`isMultiUserSupported()` 이 기기가 자체 로그인과 맞춤설정 가능한 공간이 있는 전환 가능한 여러 사용자를 지원하는지 여부를 반환합니다.
`abstract boolean`	`isPackageInstalled(String packageName, String userId)` 지정된 패키지 이름과 지정된 사용자 ID로 기기를 쿼리하여 해당 사용자에 대해 현재 설치되어 있는지 확인합니다.
`abstract boolean`	`isPackageInstalled(String packageName)` 특정 패키지 이름으로 기기를 쿼리하여 현재 설치되어 있는지 확인합니다.
`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 Set<Long>`	`listDisplayIds()` 'dumpsys SurfaceFlinger'에서 보고한 대로 기기에서 사용할 수 있는 디스플레이 ID 목록을 수집합니다.
`abstract Set<Integer>`	`listDisplayIdsForStartingVisibleBackgroundUsers()` `start a user visible in the background`에 사용할 수 있는 디스플레이 목록을 가져옵니다.
`abstract ArrayList<Integer>`	`listUsers()` 기기의 사용자 목록을 가져옵니다.
`abstract boolean`	`logBugreport(String dataName, ITestLogger listener)` 버그 신고를 가져와 신고자에게 로깅하는 도우미 메서드
`default void`	`notifySnapuserd(SnapuserdWaitPhase waitPhase)` snapuserd 완료를 기다리도록 기기에 알림
`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)` 지정된 사용자를 중지합니다.
`abstract boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` 특정 사용자를 중지합니다.
`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 패키지를 제거합니다.
`default void`	`waitForSnapuserd(SnapuserdWaitPhase currentPhase)` 예상되는 경우 snapuserd가 완료될 때까지 기다립니다.

공개 메서드

adbInstallPackage

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

adb 명령어로 기기에 Android 패키지를 설치합니다.

매개변수
`packageFile`	`File`: 설치할 APK 파일
`reinstall`	`boolean`: 재설치를 실행해야 하는 경우 `true`
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

반환
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

adbInstallPackage

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

adb 명령어로 기기에 Android 패키지를 설치합니다.

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

매개변수
`packageFile`	`File`: 설치할 APK 파일
`reinstall`	`boolean`: 재설치를 실행해야 하는 경우 `true`
`grantPermissions`	`boolean`: 설치 시 모든 런타임 권한을 부여해야 하는 경우
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

반환
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

반환
`boolean`

생성 값
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity ()

기기가 네트워크에 연결되어 있는지 확인합니다.

반환
`boolean`	`true` 기기에 작동하는 네트워크 연결이 있는 경우, `false` 그렇지 않은 경우

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

현재 기기 UI에 표시된 오류 대화상자를 닫으려고 시도합니다.

반환
`boolean`	대화상자가 없거나 대화상자가 성공적으로 삭제된 경우 `true` 그 외의 경우 `false`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

이 메서드는 지원 중단되었습니다.
대신 connectToWifiNetworkWithResult(Map,boolean)를 사용하세요.

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

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

매개변수
`wifiSsidToPsk`	`Map`: Wi-Fi SSID와 비밀번호의 맵입니다.
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 검색할지 여부입니다.

반환
`boolean`	`true` Wi-Fi 네트워크에 연결된 경우 `false` 그 외의 경우

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

이 메서드는 지원 중단되었습니다.
대신 connectToWifiNetworkWithResult(Map)를 사용하세요.

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

매개변수
`wifiSsidToPsk`	`Map`: Wi-Fi SSID와 비밀번호의 맵입니다.

반환
`boolean`	`true` Wi-Fi 네트워크에 연결된 경우 `false` 그 외의 경우

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

이 메서드는 지원 중단되었습니다.
대신 connectToWifiNetworkWithResult(String,String)를 사용하세요.

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

Wi-Fi를 사용 설정하고 지정된 Wi-Fi 네트워크에 연결될 때까지 차단합니다. 연결이 설정되면 인스턴스는 ITestDevice.disconnectFromWifi() 또는 ITestDevice.clearLastConnectedWifiNetwork()이 호출될 때까지 재부팅할 때마다 연결을 복원하려고 합니다.

매개변수
`wifiSsid`	`String`: 연결할 Wi-Fi SSID
`wifiPsk`	`String`: PSK 암호 또는 암호화되지 않은 경우 null

반환
`boolean`	`true` Wi-Fi 네트워크에 연결된 경우 `false` 그 외의 경우

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

connectToWifiNetwork

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

이 메서드는 지원 중단되었습니다.
대신 connectToWifiNetworkWithResult(String,String,boolean)를 사용하세요.

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

매개변수
`wifiSsid`	`String`: 연결할 Wi-Fi SSID
`wifiPsk`	`String`: PSK 암호 또는 암호화되지 않은 경우 null
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 검색할지 여부입니다.

반환
`boolean`	`true` Wi-Fi 네트워크에 연결된 경우 `false` 그 외의 경우

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

필요한 경우 connectToWifiNetwork

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

이 메서드는 지원 중단되었습니다.
대신 connectToWifiNetworkIfNeededWithResult(String,String,boolean)를 사용하세요.

기기에 현재 네트워크 연결이 없는 경우에만 연결되는 connectToWifiNetwork(String,String)의 변형입니다.

매개변수
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 스캔할지 여부

반환
`boolean`	`true` Wi-Fi 네트워크에 연결된 경우 `false` 그 외의 경우

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

필요한 경우 connectToWifiNetwork

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

이 메서드는 지원 중단되었습니다.
대신 connectToWifiNetworkIfNeededWithResult(String,String)를 사용하세요.

기기에 현재 네트워크 연결이 없는 경우에만 연결되는 connectToWifiNetwork(String,String)의 변형입니다.

반환
`boolean`	`true` Wi-Fi 네트워크에 연결된 경우 `false` 그 외의 경우

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

기기에 현재 네트워크 연결이 없는 경우에만 연결되는 connectToWifiNetwork(String,String)의 변형입니다.

매개변수
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 스캔할지 여부

반환
`IWifiHelper.WifiConnectionResult`	연결 상태를 나타내는 `WifiConnectionResult`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

기기에 현재 네트워크 연결이 없는 경우에만 연결되는 connectToWifiNetwork(String,String)의 변형입니다.

반환
`IWifiHelper.WifiConnectionResult`	연결 상태를 나타내는 `WifiConnectionResult`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

매개변수
`wifiSsid`	`String`: 연결할 Wi-Fi SSID
`wifiPsk`	`String`: PSK 암호 또는 암호화되지 않은 경우 null
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 검색할지 여부입니다.

반환
`IWifiHelper.WifiConnectionResult`	연결 상태를 나타내는 `WifiConnectionResult`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

매개변수
`wifiSsidToPsk`	`Map`: Wi-Fi SSID와 비밀번호의 맵입니다.

반환
`IWifiHelper.WifiConnectionResult`	연결 상태를 나타내는 `WifiConnectionResult`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

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

매개변수
`wifiSsidToPsk`	`Map`: Wi-Fi SSID와 비밀번호의 맵입니다.
`scanSsid`	`boolean`: 이 네트워크의 숨겨진 SSID를 검색할지 여부입니다.

반환
`IWifiHelper.WifiConnectionResult`	연결 상태를 나타내는 `WifiConnectionResult`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

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

매개변수
`wifiSsid`	`String`: 연결할 Wi-Fi SSID
`wifiPsk`	`String`: PSK 암호 또는 암호화되지 않은 경우 null

반환
`IWifiHelper.WifiConnectionResult`	연결 상태를 나타내는 `WifiConnectionResult`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

createUser

public abstract int createUser (String name)

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

매개변수
`name`	`String`: 기기에 생성할 사용자

반환
`int`	생성된 사용자 ID의 정수

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`
`IllegalStateException`

createUser

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`
`IllegalStateException`

createUser

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`
`IllegalStateException`

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`입니다.

disableKeyguard

public abstract void disableKeyguard ()

키가드를 사용 중지하려고 시도합니다.

먼저 입력 디스패치가 준비될 때까지 기다립니다. 이는 기기에서 BOOT_COMPLETE를 보고하는 시점과 거의 동시에 발생합니다. 현재 프레임워크 구현에 가끔 경합 상태가 있기 때문에 비동기식으로 발생합니다. 그런 다음 키가드를 닫는 명령어가 전송됩니다 (보안되지 않은 기기에서만 작동).

생성 값
`DeviceNotAvailableException`

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

기기에서 네트워크 모니터링을 사용 중지합니다.

반환
`boolean`	모니터링이 사용 중지되면 `true`를 반환합니다. `false`를 반환합니다.

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Wi-Fi 네트워크에서 연결을 해제합니다.

알려진 네트워크 목록에서 모든 네트워크를 삭제하고 Wi-Fi를 사용 중지합니다.

반환
`boolean`	Wi-Fi 네트워크에서 연결이 해제되면 `true` `false` 연결 해제에 실패한 경우

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

지정된 사용자의 기기에 파일이 있는지 확인하는 도우미 메서드

매개변수
`deviceFilePath`	`String`: 확인할 기기의 파일 절대 경로
`userId`	`int`: 파일 존재 여부를 확인할 사용자 ID

반환
`boolean`	파일이 있으면 `true`, 그렇지 않으면 `false`입니다.

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

매개변수
`process`	`String`: dumpheap할 기기 프로세스의 이름입니다.
`devicePath`	`String`: 덤프를 배치할 기기의 경로입니다. 권한이 허용되는 위치여야 합니다.

반환
`File`	보고서가 포함된 `File` 실패한 경우 null입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

기기에서 네트워크 모니터링을 사용 설정합니다.

반환
`boolean`	모니터링이 사용 설정된 경우 `true` `false`를 반환합니다.

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

getActiveApexes

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

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

반환
`Set<ITestDevice.ApexInfo>`	현재 기기에서 활성화된 `Set`/`ApexInfo`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAllSettings

public abstract Map<String, String> getAllSettings (String namespace)

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

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

반환
`Map<String, String>`	키-값 쌍의 맵입니다. 네임스페이스가 지원되지 않는 경우 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`

getAndroidIds

public abstract Map<Integer, String> getAndroidIds ()

일치하는 사용자 ID가 있는 Android ID의 지도를 만듭니다. 각 사용자 ID가 이 함수에서 연결된 Android ID를 찾을 수 있다는 보장은 없으므로 일부 사용자 ID는 null과 일치할 수 있습니다.

반환
`Map<Integer, String>`	일치하는 사용자 ID가 발견된 Android ID의 맵입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

매개변수
`packageName`	`String`

반환
`PackageInfo`	정보를 가져올 수 없는 경우 `PackageInfo` 또는 `null`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAppPackageInfos

public abstract List<PackageInfo> getAppPackageInfos ()

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

반환
`List<PackageInfo>`	기기에 설치된 `List`의 수입니다.`PackageInfo`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBugreport

public abstract InputStreamSource getBugreport ()

기기에서 버그 신고를 가져옵니다.

이 구현은 sdcard가 없는 기기(또는 sdcard가 아직 마운트되지 않은 기기)에서 계속 작동합니다.

반환
`InputStreamSource`	요청 시 버그 신고 콘텐츠를 생성하는 `InputStreamSource` 실패하면 `InputStreamSource`에서 빈 `InputStream`이 생성됩니다.

getBugreportz

public abstract InputStreamSource getBugreportz ()

기기에서 bugreportz를 가져옵니다. ZIP 형식 버그 신고에는 디버깅에 유용한 기본 버그 신고와 기타 로그 파일이 포함됩니다.

'adb version' > 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 Set<DeviceFoldableState> getFoldableStates ()

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

반환
`Set<DeviceFoldableState>`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getInstalledPackageNames

public abstract Set<String> getInstalledPackageNames ()

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

반환
`Set<String>`	현재 기기에 설치된 패키지 이름 `String`개의 `Set`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIpAddress

public abstract String getIpAddress ()

기기의 IP 주소를 가져옵니다.

반환
`String`	기기의 IP 주소 또는 기기에 IP 주소가 없는 경우 `null`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

getKeyguardState

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 Set<String> getMainlineModuleInfo ()

기기에 설치된 Mainline 모듈에 관한 정보를 가져옵니다.

반환
`Set<String>`	현재 기기에 설치된 `String` 메인라인 모듈의 `Set`입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

반환
`int`	동시에 실행되는 사용자 수를 나타내는 정수

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported (String userType)

지정된 사용자 유형의 지원되는 최대 사용자 수를 가져옵니다. 기본값은 0입니다.

매개변수
`userType`	`String`: UserManager에 정의된 사용자 유형입니다(예: 'android.os.usertype.full.SECONDARY').

반환
`int`	지정된 사용자 유형의 지원되는 사용자 수를 나타내는 정수

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

이 메서드는 지원 중단되었습니다.
getMaxNumberOfUsersSupported(String userType)를 사용하여 지정된 사용자 유형에 지원되는 최대 사용자 수를 가져옵니다.

게스트를 제외하고 지원되는 전환 가능한 최대 사용자 수를 가져옵니다. API 버전 36 이후에는 전환할 수 없는 사용자 (예: 프로필)가 포함되지 않습니다. 기본값은 0입니다.

반환
`int`	지원되는 전환 가능한 사용자 수를 나타내는 정수

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getOptions

public abstract TestDeviceOptions getOptions ()

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

반환
`TestDeviceOptions`	`TestDeviceOptions`를 테스트 대상 기기에 연결합니다.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

이 메서드는 지원 중단되었습니다.
getPrimaryUser가 UserManager 서비스에서 지원 중단되었습니다. ERROR(/android.os.UserManager#getMainUserId())를 사용하여 첫 번째 전체 사용자 또는 시스템의 경우 0을 가져오세요. 헤드리스 시스템의 경우 전체 사용자가 아닙니다.

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

반환
`Integer`	기본 사용자가 있는 경우 기본 사용자의 userId이고, 기본 사용자가 없는 경우 null입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	기기의 출력이 예상과 다른 경우
`DeviceNotAvailableException`

getRemainingCreatableUserCount

public abstract int getRemainingCreatableUserCount (String userType)

이 기기에서 만들 수 있는 지정된 사용자 유형의 사용자 수를 반환합니다.

매개변수
`userType`	`String`: UserManager에 정의된 사용자 유형입니다(예: 'android.os.usertype.full.SECONDARY').

반환
`int`	지정된 사용자 유형의 사용자를 얼마나 추가할 수 있는지

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getScreenshot

public abstract InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

지원되는 형식으로 지정된 디스플레이 ID의 기기에서 스크린샷을 가져옵니다. 더 작은 크기를 지원하기 위해 크기 조절 허용

매개변수
`displayId`	`Long`: 스크린샷을 가져올 화면의 표시 ID입니다.
`format`	`String`: 지원되는 형식은 PNG, JPEG입니다.
`rescale`	`boolean`: 결과 이미지의 크기를 줄이기 위해 스크린샷의 크기를 조정해야 하는 경우

반환
`InputStreamSource`	스크린샷이 성공하지 못한 경우 `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: 위의 구현을 확장하여 'format' 및 'rescale' 지원

매개변수
`displayId`	`long`: 스크린샷을 가져올 화면의 표시 ID입니다.

반환
`InputStreamSource`	스크린샷이 성공하지 못한 경우 `InputStreamSource` 형식의 스크린샷 또는 `null`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getScreenshot

public abstract InputStreamSource getScreenshot ()

기기에서 스크린샷을 가져옵니다.

반환
`InputStreamSource`	스크린샷이 성공하지 못한 경우 png 형식의 스크린샷 `InputStreamSource` 또는 `null`

생성 값
	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`

getSetting

public abstract String getSetting (String namespace, 
                String key)

getSetting(int,String,String)를 참고하고 시스템 사용자에 대해 실행됩니다.

매개변수
`namespace`	`String`
`key`	`String`

반환
`String`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getUninstallablePackageNames

public abstract Set<String> getUninstallablePackageNames ()

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

반환
`Set<String>`	`Set`(제거할 수 없는 `String` 패키지 이름)이 현재 기기에 설치되어 있습니다.

생성 값
	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 Map<Integer, UserInfo> getUserInfos ()

기기에서 useId와 UserInfo의 맵을 가져옵니다. 기기의 출력이 예상과 다르면 DeviceRuntimeException이 발생합니다.

반환
`Map<Integer, UserInfo>`	UserInfo 객체 목록입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

userId와 연결된 일련번호를 찾은 경우 반환하고, 그 외의 경우에는 -10000을 반환합니다.

매개변수
`userId`	`int`

반환
`int`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getUserVisibleOnDisplay

public abstract int getUserVisibleOnDisplay (int displayId)

지정된 디스플레이에서 표시되는 사용자의 사용자 ID를 가져옵니다.

매개변수
`displayId`	`int`: 디스플레이의 ID입니다.

반환
`int`	지정된 디스플레이에 표시되는 사용자의 사용자 ID입니다. 표시되는 백그라운드 사용자와 현재 포그라운드 사용자를 구분하지 않습니다. 두 유형 모두 표시되기 때문입니다. 구분하려면 getCurrentUser() 결과와 추가로 비교하세요.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasFeature

public abstract boolean hasFeature (String feature)

기기에서 기능을 사용할 수 있는지 확인합니다.

매개변수
`feature`	`String`: 형식은 'feature:' 또는 ''여야 합니다.

반환
`boolean`	기능이 있으면 true, 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

installPackage

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`	기기와의 연결이 끊어져 복구할 수 없는 경우

installPackage

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`	기기와의 연결이 끊어져 복구할 수 없는 경우

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`	기기와의 연결이 끊어져 복구할 수 없는 경우

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`	기기와의 연결이 끊어져 복구할 수 없는 경우

installPackageWithIncrementalMode

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

증분 모드로 APK를 설치합니다.

매개변수
`apkFiles`	`File`: 설치할 APK 파일입니다.
`extraArgs`	`String`
`userId`	`String`

반환
`boolean`

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

매개변수
`packageFiles`	`List`: 로컬 APK 파일
`reinstall`	`boolean`: 재설치를 실행해야 하는 경우 `true`
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

반환
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우
`UnsupportedOperationException`	런타임 권한이 기기에서 플랫폼에 의해 지원되지 않는 경우

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

매개변수
`packageFiles`	`List`: 설치할 원격 APK 파일 경로
`reinstall`	`boolean`: 재설치를 실행해야 하는 경우 `true`
`grantPermissions`	`boolean`: 설치 시 모든 런타임 권한을 부여해야 하는 경우
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

반환
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우
`UnsupportedOperationException`	런타임 권한이 기기에서 플랫폼에 의해 지원되지 않는 경우

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

매개변수
`packageFiles`	`List`: 로컬 APK 파일
`reinstall`	`boolean`: 재설치를 실행해야 하는 경우 `true`
`userId`	`int`: 설치할 정수 사용자 ID입니다.
`extraArgs`	`String`: 전달할 선택적 추가 인수입니다. 사용 가능한 옵션은 'adb shell pm -h'를 참고하세요.

반환
`String`	오류 코드가 있는 `String` 또는 성공 시 `null`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우
`UnsupportedOperationException`	런타임 권한이 기기에서 플랫폼에 의해 지원되지 않는 경우

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

매개변수
`packageFiles`	`List`: 로컬 APK 파일
`reinstall`	`boolean`: 재설치를 실행해야 하는 경우 `true`
`grantPermissions`	`boolean`: 설치 시 모든 런타임 권한을 부여해야 하는 경우
`userId`	`int`: 설치할 정수 사용자 ID입니다.
`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`

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

이 기기가 자체 로그인과 맞춤설정 가능한 공간이 있는 전환 가능한 여러 사용자를 지원하는지 여부를 반환합니다.

false인 경우에도 로그인 UI가 필요하지 않은 한 여러 사용자가 가능할 수 있습니다. 예를 들어 프로필은 로그인 UI가 필요하지 않으므로 계속 지원될 수 있습니다.

config_enableMultiUserUI도 확인합니다. 요구사항에 따라 이 값이 true인 기기는 adb를 통해 보조 사용자를 추가하도록 구성되어 있다고 가정할 수 있습니다.

반환
`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`	패키지가 설치된 것으로 보고되면 true입니다. 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

특정 패키지 이름으로 기기를 쿼리하여 현재 설치되어 있는지 확인합니다.

매개변수
`packageName`	`String`

반환
`boolean`	패키지가 설치된 것으로 보고되면 true입니다. 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isUserRunning

public abstract boolean isUserRunning (int userId)

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

매개변수
`userId`	`int`

반환
`boolean`	사용자가 달리고 있으면 true, 그 외의 경우에는 false입니다.

생성 값
	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`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

반환
`boolean`

생성 값
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

반환
`boolean`

생성 값
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

Wi-Fi가 사용 설정되어 있는지 테스트합니다.

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

반환
`boolean`	Wi-Fi가 사용 설정된 경우 `true` 사용 중지된 경우 `false`

생성 값
`DeviceNotAvailableException`	기기와의 연결이 끊어져 복구할 수 없는 경우

listDisplayIds

public abstract Set<Long> listDisplayIds ()

'dumpsys SurfaceFlinger'에서 보고한 대로 기기에서 사용할 수 있는 디스플레이 ID 목록을 수집합니다.

반환
`Set<Long>`	디스플레이 목록입니다. 기본값은 항상 기본 디스플레이 0을 반환합니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

반환
`Set<Integer>`

생성 값
`DeviceNotAvailableException`

listUsers

public abstract ArrayList<Integer> listUsers ()

기기의 사용자 목록을 가져옵니다. 기기의 출력이 예상과 다르면 DeviceRuntimeException이 발생합니다.

반환
`ArrayList<Integer>`	사용자 ID 목록입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

버그 신고를 가져와 신고자에게 로깅하는 도우미 메서드

매개변수
`dataName`	`String`: 버그 신고가 보고될 이름입니다.
`listener`	`ITestLogger`: 버그 신고를 로깅하는 `ITestLogger`

반환
`boolean`	로깅이 성공하면 true, 그렇지 않으면 false입니다.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

snapuserd 완료를 기다리도록 기기에 알림

매개변수
`waitPhase`	`SnapuserdWaitPhase`

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

이 기기의 IDeviceActionReceiver를 등록합니다.

등록된 모든 IDeviceActionReceiver에게 기기 작업이 시작되기 전과 기기 작업이 종료된 후 알림이 전송됩니다.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

지정된 사용자의 지정된 기기 관리자를 삭제하고 성공하면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

매개변수
`componentName`	`String`: 삭제할 기기 관리자입니다.
`userId`	`int`: 기기 관리자가 있는 사용자

반환
`boolean`	성공하면 true, 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

removeOwners

public abstract void removeOwners ()

최선을 다해 기존 기기 프로필 소유자를 모두 삭제합니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

removeUser

public abstract boolean removeUser (int userId)

기기에서 지정된 사용자를 삭제합니다.

매개변수
`userId`	`int`: 삭제할 사용자의 ID

반환
`boolean`	사용자 삭제에 성공하면 true, 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

지정된 사용자의 기기 소유자로 기기 관리 구성요소를 설정합니다.

매개변수
`componentName`	`String`: 기기 관리자가 기기 소유자가 되도록 합니다.
`userId`	`int`: 기기 소유자가 거주하는 국가입니다.

반환
`boolean`	성공하면 true, 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setSetting

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`

setSetting

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`

startUser

public abstract boolean startUser (int userId)

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

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

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

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

매개변수
`userId`	`int`: 백그라운드에서 시작할 사용자의 ID
`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`: 백그라운드에서 시작할 사용자의 ID
`displayId`	`int`: 사용자가 볼 수 있는 디스플레이를 시작합니다.
`waitFlag`	`boolean`: 사용자가 시작되고 잠금 해제될 때까지 명령어가 대기하도록 합니다.

반환
`boolean`	사용자가 백그라운드에서 표시되도록 성공적으로 시작된 경우 `true`

생성 값
`DeviceNotAvailableException`

stopUser

public abstract boolean stopUser (int userId)

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

매개변수
`userId`	`int`: 중지할 사용자

반환
`boolean`	사용자가 성공적으로 중지되었으면 true입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopUser

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

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

매개변수
`userId`	`int`: 중지할 사용자
`waitFlag`	`boolean`: 사용자가 중지될 때까지 명령어가 대기하도록 합니다.
`forceFlag`	`boolean`: 사용자를 강제 종료합니다.

반환
`boolean`	사용자가 성공적으로 중지되었으면 true입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchUser

public abstract boolean switchUser (int userId)

기본 제한 시간으로 다른 userId로 전환합니다. switchUser(int, long).

매개변수
`userId`	`int`

반환
`boolean`	새 userId가 userId 제공자와 일치하는 경우 true입니다. 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

제공된 시간 제한을 기한으로 사용하여 다른 userId로 전환합니다. 사용자 변경이 성공한 후 키가드를 사용 중지하려고 시도합니다.

매개변수
`userId`	`int`
`timeout`	`long`: 사용자 전환 실패에 대해 false를 반환하기 전에 대기합니다.

반환
`boolean`	새 userId가 userId 제공자와 일치하는 경우 true입니다. 그렇지 않으면 false입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

takeBugreport

public abstract Bugreport takeBugreport ()

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

반환
`Bugreport`

uninstallPackage

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`	기기와의 연결이 끊어져 복구할 수 없는 경우

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

예상되는 경우 snapuserd가 완료될 때까지 기다립니다.

매개변수
`currentPhase`	`SnapuserdWaitPhase`

생성 값
`DeviceNotAvailableException`

ITestDevice

요약

중첩된 클래스

공개 메서드

공개 메서드

adbInstallPackage

adbInstallPackage

canSwitchToHeadlessSystemUser

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

필요한 경우 connectToWifiNetwork

필요한 경우 connectToWifiNetwork

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

createUser

createUser

createUser

createUserNoThrow

deregisterDeviceActionReceiver

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

dumpHeap

enableNetworkMonitor

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getIpAddress

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getMaxNumberOfUsersSupported

getOptions

getPrimaryUserId

getRemainingCreatableUserCount

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

getUserVisibleOnDisplay

hasFeature

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackageWithIncrementalMode

installPackages

installPackages

installPackagesForUser

installPackagesForUser

isHeadlessSystemUserMode

isMainUserPermanentAdmin