Cette page a été traduite par l'API Cloud Translation.

Appareil natif

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.device.NativeDevice

Sous-classes directes connues

Appareil test

Appareil test Implémentation d'un ITestDevice pour un appareil Android full stack

Sous-classes indirectes connues

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

Appareil virtuel LocalAndroid	Classe destinée aux appareils virtuels locaux exécutés sur un hôte TradeFed.
ManagedRemoteDevice	Un appareil s'exécutant dans une machine virtuelle que nous gérons à distance via une instance Tradefed la VM.
NestedRemoteDevice	Représentation de l'appareil s'exécutant dans une VM Cuttlefish distante.
AppareilAndroidDistant	Implémentation d'un `ITestDevice` pour un appareil Android full stack connecté via adb connect.
Appareil virtuel d'appareil distant	Étend le comportement de `RemoteAndroidDevice` pour un appareil Android full stack exécuté dans le Google Compute Engine (Gce).

Implémentation par défaut d'un appareil Android ITestDevice non full stack.

Résumé

Classes imbriquées
`class`	`NativeDevice.AdbAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` pour l'exécution d'un système d'exploitation "adb ...". .
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` pour redémarrer un appareil.

Constantes
`int`	`INVALID_USER_ID` Valeur renvoyée pour tout ID utilisateur non valide/introuvable: UserHandle a défini la valeur -10000.
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` le nombre de tentatives d'exécution de la commande par défaut

Champs
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

Constructeurs publics
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Crée un `TestDevice`.

Méthodes publiques
`void`	`batchPrefetchStartupBuildProps()` Micro-optimisation (environ 400 millisecondes) en préchargeant tous les accessoires dont nous avons besoin au lieu d'appeler "adb" getprop' pour chacune d'entre elles.
`boolean`	`canSwitchToHeadlessSystemUser()` Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Vérifier si une fonctionnalité est actuellement compatible avec un niveau de compatibilité minimal.
`boolean`	`checkConnectivity()` Vérifiez que l'appareil est connecté au réseau.
`boolean`	`clearErrorDialogs()` Essayez de fermer les boîtes de dialogue d'erreur affichées dans l'interface utilisateur de l'appareil.
`void`	`clearLastConnectedWifiNetwork()` Efface le dernier réseau Wi-Fi connecté.
`void`	`clearLogcat()` Supprime toutes les données logcat accumulées.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Se connecte à un réseau Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Se connecte à un réseau Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Se connecte à un réseau Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Se connecte à un réseau Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Variante de `connectToWifiNetwork(String, String)` qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Variante de `connectToWifiNetwork(String, String)` qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Créer un utilisateur avec un nom donné et les options fournies
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Créer un utilisateur avec un nom donné et les options fournies
`int`	`createUser(String name)` Créez un utilisateur avec un nom donné et les options par défaut de 0.
`int`	`createUserNoThrow(String name)` Créez un utilisateur avec un nom donné et les options par défaut de 0.
`void`	`deleteFile(String deviceFilePath, int userId)` Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil.
`void`	`deleteFile(String deviceFilePath)` Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Supprime le `IDeviceActionReceiver` enregistré.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible en comparant le serveur system_server actuel avec Le `ProcessInfo` system_server précédent.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible depuis l'heure UTC depuis l'epoch appareil et son `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Désactive la racine adb.
`void`	`disableKeyguard()` Tente de désactiver la protection du clavier.
`boolean`	`disableNetworkMonitor()` Désactive la surveillance du réseau sur l'appareil.
`boolean`	`disconnectFromWifi()` Se déconnecte d'un réseau Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Méthode d'assistance permettant de déterminer si un fichier sur l'appareil existe pour un utilisateur donné.
`boolean`	`doesFileExist(String deviceFilePath)` Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.
`File`	`dumpHeap(String process, String devicePath)` Essayez de vider le tas de mémoire à partir de system_server.
`boolean`	`enableAdbRoot()` Active la racine adb.
`boolean`	`enableNetworkMonitor()` Active la surveillance du réseau sur l'appareil.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'expiration spécifié.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'expiration spécifié.
`String`	`executeAdbCommand(String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'inactivité par défaut de 2 minutes
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Méthode d'assistance qui exécute une commande fastboot en tant que commande système.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système avec l'état système variables d'environnement.
`String`	`executeShellCommand(String command)` Méthode d'assistance qui exécute une commande shell adb et renvoie le résultat en tant que `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Exécute la commande shell adb donnée, en effectuant plusieurs tentatives si la commande échoue.
`CommandResult`	`executeShellV2Command(String cmd)` Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément `CommandResult` correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément `CommandResult` correctement renseigné avec le résultat de l'état de la commande et "stderr".
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément `CommandResult` correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
`CommandResult`	`fastbootWipePartition(String partition)` Méthode d'assistance qui efface une partition de l'appareil.
	`getActiveApexes()` Récupérez les informations sur les apex activés sur l'appareil.
	`getAllSettings(String namespace)` Renvoie les paires clé/valeur de l'espace de noms demandé.
`DeviceAllocationState`	`getAllocationState()` Renvoyer l'état d'allocation actuel de l'appareil
`String`	`getAndroidId(int userId)` Recherchez et renvoyez l'android-id associé à un userId. La valeur "null" est absente si vous ne l'avez pas trouvé.
	`getAndroidIds()` Créer une carte des identifiants Android trouvés pour les ID utilisateur correspondants.
`int`	`getApiLevel()` Obtenir le niveau d'API de l'appareil
`PackageInfo`	`getAppPackageInfo(String packageName)` Récupérer des informations sur un package installé sur l'appareil
	`getAppPackageInfos()` Récupère des informations sur les packages installés sur l'appareil.
`String`	`getBasebandVersion()` Méthode pratique permettant d'obtenir la version bande de base (radio) de cet appareil.
`Integer`	`getBattery()` Renvoie le niveau de batterie actuel d'un appareil, ou la valeur "null" si le niveau de batterie n'est pas disponible.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Renvoie la valeur booléenne d'une propriété donnée.
	`getBootHistory()` La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps de démarrage et le motif du démarrage le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée.
`String`	`getBootloaderVersion()` Méthode pratique permettant d'obtenir la version du bootloader de cet appareil.
`InputStreamSource`	`getBugreport()` Récupère un rapport de bug de l'appareil.
`InputStreamSource`	`getBugreportz()` Récupère un rapport de bug de l'appareil.
`String`	`getBuildAlias()` Récupérez l'alias de la compilation en cours d'exécution par l'appareil.
`String`	`getBuildFlavor()` Récupérez le type de compilation pour l'appareil.
`String`	`getBuildId()` Récupérez la version en cours d'exécution de l'appareil.
`String`	`getBuildSigningKeys()` Renvoie le type de clé utilisé pour signer l'image de l'appareil En règle générale, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de version (contrôlé par des fabricants d'appareils individuels)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Renvoie un `DeviceDescriptor` mis en cache si l'appareil est alloué. Sinon, renvoie le `DeviceDescriptor` en cours.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Renvoie un `DeviceDescriptor` mis en cache si l'appareil est alloué. Sinon, renvoie le `DeviceDescriptor` en cours.
`String[]`	`getChildren(String path)` Alternative à l'utilisation de `IFileEntry` qui ne fonctionne parfois pas en raison des autorisations
`AbstractConnection`	`getConnection()` Connexion actuelle associée à l'appareil.
`ContentProviderHandler`	`getContentProvider(int userId)` Renvoie `ContentProviderHandler` ou la valeur "null" si aucune valeur n'est disponible.
`DeviceFoldableState`	`getCurrentFoldableState()` Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème.
`int`	`getCurrentUser()` Renvoie l'identifiant de l'utilisateur actuel.
`String`	`getDeviceClass()` Permet d'obtenir la classe de l'appareil.
`long`	`getDeviceDate()` Renvoie la date de l'appareil en millisecondes depuis l'epoch.
`DeviceDescriptor`	`getDeviceDescriptor()` Renvoyez un `DeviceDescriptor` à partir des informations de l'appareil pour obtenir des informations le concernant sans en transmettant l'objet réel de l'appareil.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Renvoyez un `DeviceDescriptor` à partir des informations de l'appareil pour obtenir des informations le concernant sans en transmettant l'objet réel de l'appareil.
`TestDeviceState`	`getDeviceState()` Obtenez l'état de l'appareil.
`long`	`getDeviceTimeOffset(Date date)` Outil d'aide pour obtenir le décalage horaire entre l'appareil et un `ERROR(/Date)` donné.
`InputStreamSource`	`getEmulatorOutput()` Obtenir le flux de l'émulateur stdout et stderr
`Process`	`getEmulatorProcess()` Renvoyez le `Process` correspondant à cet émulateur.
`final File`	`getExecuteShellCommandLog()` Journal contenant tous les journaux `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la mémoire de stockage externe de l'appareil.
`String`	`getFastbootPath()` Renvoie le chemin d'accès au binaire fastboot utilisé.
`String`	`getFastbootProductType()` Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.
`String`	`getFastbootProductVariant()` Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.
`String`	`getFastbootSerialNumber()` Renvoie le numéro de série du mode fastboot.
`String`	`getFastbootVariable(String variableName)` Récupérez la valeur de variable fastboot donnée à partir de l'appareil.
`String`	`getFastbootVersion()` Renvoie la chaîne de version du binaire fastboot utilisé.
`IFileEntry`	`getFileEntry(String path)` Récupérer une référence à un fichier distant sur un appareil
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Outil d'aide non officiel pour obtenir un `FileEntry` à partir d'un chemin d'accès non racine.
	`getFoldableStates()` Renvoie la liste des états des appareils pliables sur l'appareil.
`IDevice`	`getIDevice()` Renvoie une référence au fichier ddmlib `IDevice` associé.
	`getInstalledPackageNames()` Récupérez les noms des packages d'application présents sur l'appareil.
`long`	`getIntProperty(String name, long defaultValue)` Renvoie la valeur entière de la propriété donnée à partir de l'appareil.
`String`	`getIpAddress()` Récupère l'adresse IP de l'appareil.
`KeyguardControllerState`	`getKeyguardState()` Renvoyez un objet pour obtenir l'état actuel du verrouillage du clavier ou la valeur "null" si cette fonctionnalité n'est pas disponible.
`long`	`getLastExpectedRebootTimeMillis()` Renvoie la dernière fois où les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH en tant que renvoyé par `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Permet d'obtenir le premier niveau d'API lancé sur l'appareil.
`InputStreamSource`	`getLogcat()` Récupère un flux d'instantanés des données logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Récupère un flux d'instantanés de la dernière `maxBytes` de données logcat capturées.
`InputStreamSource`	`getLogcatDump()` Obtenir un vidage du logcat actuel pour l'appareil
`InputStreamSource`	`getLogcatSince(long date)` Récupère un flux d'instantanés des données logcat capturées à partir de la date fournie.
`String`	`getMacAddress()` Renvoie l'adresse MAC de l'appareil, qui est nulle si la requête échoue.
`Integer`	`getMainUserId()` Renvoie l'ID utilisateur principal.
	`getMainlineModuleInfo()` Obtenez les informations sur les modules principaux installés sur l'appareil.
`int`	`getMaxNumberOfRunningUsersSupported()` Obtenir le nombre maximal d'utilisateurs pouvant s'exécuter simultanément
`int`	`getMaxNumberOfUsersSupported()` Obtenir le nombre maximal d'utilisateurs pris en charge
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Renvoie le `IDeviceStateMonitor` associé à l'appareil.
`String`	`getMountPoint(String mountName)` Renvoie un point d'installation.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Renvoie un `MountPointInfo` correspondant au chemin d'accès au point de montage spécifié, ou `null` si ce chemin d'accès n'a rien à installer ou n'apparaît pas dans /proc/mounts comme point de montage.
	`getMountPointInfo()` Renvoie une version analysée des informations contenues dans /proc/mounts sur l'appareil.
`TestDeviceOptions`	`getOptions()` Récupérez les options de test pour l'appareil.
`long`	`getPartitionFreeSpace(String partition)` Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la partition de l'appareil.
`Integer`	`getPrimaryUserId()` Renvoie l'identifiant de l'utilisateur principal.
`ProcessInfo`	`getProcessByName(String processName)` La méthode d'assistance exécute la fonction "pidof" et "stat" et renvoie l'objet `ProcessInfo` avec PID et heure de début du processus donné.
`String`	`getProcessPid(String process)` Renvoie le pid du service ou la valeur "null" en cas de problème.
`String`	`getProductType()` Méthode pratique permettant d'obtenir le type de produit de cet appareil.
`String`	`getProductVariant()` Méthode pratique permettant d'obtenir la variante du produit de cet appareil.
`String`	`getProperty(String name)` Récupère la valeur de propriété donnée à partir de l'appareil.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Obtenez le mode de récupération actuellement utilisé pour l'appareil.
`InputStreamSource`	`getScreenshot(String format)` Permet de prendre une capture d'écran de l'appareil.
`InputStreamSource`	`getScreenshot(long displayId)` Récupère une capture d'écran de l'appareil correspondant à l'identifiant d'affichage.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Permet de prendre une capture d'écran de l'appareil.
`InputStreamSource`	`getScreenshot()` Permet de prendre une capture d'écran de l'appareil.
`String`	`getSerialNumber()` Méthode pratique permettant d'obtenir le numéro de série de cet appareil.
`String`	`getSetting(int userId, String namespace, String key)` Renvoie la valeur du paramètre demandé.
`String`	`getSetting(String namespace, String key)` Voir `getSetting(int, String, String)` et effectué sur l'utilisateur système.
`String`	`getSimOperator()` Renvoyez l'opérateur de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible.
`String`	`getSimState()` Renvoyez l'état de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible.
	`getTombstones()` Récupérez et renvoyez la liste des tombstones des appareils.
`long`	`getTotalMemory()` Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne.
`String`	`getTrackingSerial()` Pour gérer les appareils, récupérez le numéro de série utilisé pour le suivre.
	`getUninstallablePackageNames()` Récupérez les noms des packages d'application qui peuvent être désinstallés.
`boolean`	`getUseFastbootErase()` Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.
`int`	`getUserFlags(int userId)` Rechercher et renvoyer les indicateurs d'un utilisateur donné
	`getUserInfos()` Récupère la carte de useId sur `UserInfo` sur l'appareil.
`int`	`getUserSerialNumber(int userId)` Renvoyez le numéro de série associé à l'ID utilisateur s'il est trouvé, et -10000 dans les autres cas.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Traitement de l'événement DeviceEvent donné. Traiter DeviceEvent, qui peut ou non faire passer cet appareil à une nouvelle allocation de l'état.
`boolean`	`hasFeature(String feature)` Vérifier si une fonctionnalité est disponible sur un appareil
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Installer un package Android sur l'appareil
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Installer un package Android sur l'appareil
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Installer un package Android sur l'appareil d'un utilisateur donné
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installer un package Android sur l'appareil d'un utilisateur donné
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Vérifier si la plate-forme de l'appareil est compatible avec l'énumération d'applications
`boolean`	`isBypassLowTargetSdkBlockSupported()` Vérifier si la plate-forme sur l'appareil permet de contourner le blocage du SDK cible faible lors des installations d'applications
`boolean`	`isDebugfsMounted()` Vérifiez si debugfs est installé.
`boolean`	`isDeviceEncrypted()` Indique si l'appareil est chiffré.
`boolean`	`isDirectory(String path)` Renvoyez la valeur "True" si le chemin d'accès sur l'appareil est un répertoire, et la valeur "false" dans le cas contraire.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Indique si l'appareil est compatible avec le chiffrement.
`boolean`	`isExecutable(String fullPath)` Affiche la valeur "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, et la valeur "false" dans le cas contraire.
`boolean`	`isFastbootEnabled()` Renvoie si fastboot est disponible pour l'appareil.
`boolean`	`isHeadless()` Renvoie la valeur "true" si l'appareil est headless (aucun écran), sinon la valeur "false".
`boolean`	`isHeadlessSystemUserMode()` Indique si l'appareil utilise le mode utilisateur système headless.
`boolean`	`isMainUserPermanentAdmin()` Indique si l'utilisateur principal est un administrateur permanent et si celui-ci ne peut pas être supprimé ou rétrogradé non-administrateur.
`boolean`	`isMultiUserSupported()` Détermine si le mode multi-utilisateur est pris en charge.
`boolean`	`isPackageInstalled(String packageName, String userId)` Interrogez l'appareil à la recherche d'un nom de package et d'un ID utilisateur donnés pour vérifier s'il est actuellement installé ou non pour cet utilisateur.
`boolean`	`isPackageInstalled(String packageName)` Interrogez l'appareil sur le nom de package donné pour vérifier s'il est actuellement installé ou non.
`boolean`	`isRuntimePermissionSupported()` Vérifier si la plate-forme sur l'appareil est compatible avec l'octroi d'autorisations d'exécution
`boolean`	`isStateBootloaderOrFastbootd()` Renvoie la valeur "true" si l'appareil se trouve dans `TestDeviceState#FASTBOOT` ou `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Vérifiez si un utilisateur donné est en cours d'exécution.
`boolean`	`isUserSecondary(int userId)` Indique si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.
`boolean`	`isUserVisible(int userId)` Vérifie si l'utilisateur donné est visible.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Vérifie si l'utilisateur donné est visible sur l'écran donné.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan dans `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.
`boolean`	`isWifiEnabled()` Vérifiez si le Wi-Fi est activé.
	`listDisplayIds()` Collecter la liste des identifiants d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys" SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Récupère la liste des écrans pouvant être utilisés pour `start a user visible in the background`.
	`listUsers()` Récupère la liste des utilisateurs de l'appareil.
`boolean`	`logAnrs(ITestLogger logger)` Recueille et consigne les erreurs ANR de l'appareil.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Méthode d'assistance permettant de générer un rapport de bug et de l'enregistrer dans les rapports
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Consigner un message dans le fichier logcat de l'appareil.
`void`	`mountDebugfs()` Installation de debugfs
`void`	`nonBlockingReboot()` Émet une commande pour redémarrer l'appareil et renvoie une commande terminée et plus visible par adb.
`void`	`postAdbRootAction()` À remplacer si l'appareil nécessite des actions spécifiques après la racine adb et avant la l'appareil est à nouveau connecté.
`void`	`postAdbUnrootAction()` À remplacer si l'appareil nécessite des actions spécifiques après le retrait d'adb et avant l'appareil est à nouveau connecté.
`void`	`postBootSetup()` Suivez les instructions pour configurer l'appareil afin de le tester après chaque démarrage.
`void`	`postInvocationTearDown(Throwable exception)` Des étapes supplémentaires pour un nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est terminé.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Étapes supplémentaires pour une configuration spécifique à l'appareil qui sera exécutée sur l'appareil avant le flux d'appel.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Récupérez de manière récursive le contenu du répertoire de l'appareil.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Récupérez de manière récursive le contenu du répertoire de l'appareil.
`boolean`	`pullFile(String remoteFilePath, File localFile)` Récupère un fichier depuis l'appareil.
`File`	`pullFile(String remoteFilePath, int userId)` Récupère un fichier depuis l'appareil, le stocke dans un `ERROR(/File)` temporaire local, puis l'affiche `File`
`File`	`pullFile(String remoteFilePath)` Récupère un fichier depuis l'appareil, le stocke dans un `ERROR(/File)` temporaire local, puis l'affiche `File`
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Récupère un fichier depuis l'appareil.
`String`	`pullFileContents(String remoteFilePath)` Récupère un fichier depuis l'appareil, puis renvoie son contenu.
`File`	`pullFileFromExternal(String remoteFilePath)` Méthode pratique permettant de récupérer un fichier de la mémoire de stockage externe de l'appareil, en le stockant dans un un `ERROR(/File)` temporaire local et renvoyer une référence à ce `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Transférez le contenu du répertoire de manière récursive sur l'appareil tout en excluant certains répertoires filtrée.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Transférez le contenu du répertoire de manière récursive sur l'appareil.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Transférez le contenu du répertoire de manière récursive sur l'appareil.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)`, qui peut éventuellement envisager d'évaluer le besoin pour le fournisseur de contenu.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Transférer un fichier sur l'appareil
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Transférer un fichier sur l'appareil
`boolean`	`pushString(String contents, String remoteFilePath)` Envoyer le fichier créé à partir d'une chaîne vers l'appareil
`void`	`reboot(String reason)` Redémarre l'appareil en mode adb avec la valeur `reason` donnée pour être conservée lors du redémarrage.
`void`	`reboot()` Redémarre l'appareil en mode adb.
`void`	`rebootIntoBootloader()` Redémarre l'appareil en mode bootloader.
`void`	`rebootIntoFastbootd()` Redémarre l'appareil en mode fastbootd.
`void`	`rebootIntoRecovery()` Redémarre l'appareil en mode de récupération adb.
`void`	`rebootIntoSideload()` Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération). Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant
`void`	`rebootIntoSideload(boolean autoReboot)` Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération). Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant
`void`	`rebootUntilOnline()` Alternative à `reboot()` qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`void`	`rebootUntilOnline(String reason)` Alternative à `reboot()` qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`void`	`rebootUserspace()` Redémarre uniquement une partie de l'espace utilisateur de l'appareil.
`void`	`rebootUserspaceUntilOnline()` Autre solution à `rebootUserspace()` ()} qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`boolean`	`recoverDevice()` Tentatives de récupération de la communication de l'appareil.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Enregistre un `IDeviceActionReceiver` pour cet appareil.
`void`	`remountSystemReadOnly()` Rendez la partition système de l'appareil en lecture seule.
`void`	`remountSystemWritable()` Rendez la partition système de l'appareil accessible en écriture.
`void`	`remountVendorReadOnly()` Définissez la partition du fournisseur sur l'appareil en lecture seule.
`void`	`remountVendorWritable()` Rendez la partition du fournisseur accessible en écriture sur l'appareil.
`boolean`	`removeAdmin(String componentName, int userId)` Supprimer l'administrateur de l'appareil indiqué pour l'utilisateur concerné et renvoyer `true` si l'opération réussit, ou `false` dans le cas contraire.
`void`	`removeOwners()` Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.
`boolean`	`removeUser(int userId)` Supprimer un utilisateur donné de l'appareil
`void`	`resetContentProviderSetup()` Réinitialisez l'indicateur de configuration du fournisseur de contenu afin de le déclencher de nouveau.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Méthode pratique permettant d'exécuter `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` avec un ou plusieurs écouteurs transmis en tant que paramètres.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Exécute des tests d'instrumentation et permet de récupérer l'appareil.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Identique à `ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, mais exécute le test pour l'utilisateur donné.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Identique à `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, mais exécute le test pour un utilisateur donné.
`void`	`setConfiguration(IConfiguration configuration)` Il injecte les `IConfiguration` en cours d'utilisation.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Définit la date sur l'appareil Remarque: Pour définir la date sur l'appareil, vous devez être en mode root
`boolean`	`setDeviceOwner(String componentName, int userId)` Définissez un composant d'administrateur de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné.
`void`	`setDeviceState(TestDeviceState deviceState)` Mettez à jour l'état de l'appareil.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Pour l'émulateur, définissez `SizeLimitedOutputStream` pour consigner la sortie.
`void`	`setEmulatorProcess(Process p)` Définit `Process` lorsque cet appareil est un émulateur.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Définissez l'option fastboot pour l'appareil.
`void`	`setFastbootPath(String fastbootPath)` Définit le chemin d'accès au binaire fastboot à utiliser.
`void`	`setIDevice(IDevice newDevice)` Mettez à jour l'IDevice associé à cet ITestDevice.
`void`	`setLogStartDelay(int delay)` Définit le délai d'attente, en millisecondes, avant de lancer la capture logcat pour un appareil en ligne.
`void`	`setOptions(TestDeviceOptions options)` Définir le `TestDeviceOptions` pour l'appareil
`boolean`	`setProperty(String propKey, String propValue)` Définit la valeur de propriété donnée sur l'appareil.
`void`	`setRecovery(IDeviceRecovery recovery)` Définissez les `IDeviceRecovery` à utiliser pour cet appareil.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Définissez le mode de récupération à utiliser pour l'appareil.
`void`	`setSetting(String namespace, String key, String value)` Voir `setSetting(int, String, String, String)` et effectué sur l'utilisateur système.
`void`	`setSetting(int userId, String namespace, String key, String value)` Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné.
`void`	`setTestLogger(ITestLogger testLogger)` Il injecte l'instance `ITestLogger`.
`void`	`setTrackingSerial(String trackingSerial)` Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer l'appareil.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.
`void`	`startLogcat()` Commencez à capturer la sortie logcat de l'appareil en arrière-plan.
`boolean`	`startUser(int userId)` Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté.
`boolean`	`startUser(int userId, boolean waitFlag)` Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui signifie que l'utilisateur pour lancer des activités sur cet affichage).
`void`	`stopEmulatorOutput()` Fermez et supprimez la sortie de l'émulateur.
`void`	`stopLogcat()` Arrêtez la capture de la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.
`boolean`	`stopUser(int userId)` Arrête un utilisateur donné.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Arrêter un utilisateur donné.
`String`	`switchToAdbTcp()` Basculez l'appareil en mode adb-over-tcp.
`boolean`	`switchToAdbUsb()` Basculez l'appareil en mode adb via USB.
`boolean`	`switchUser(int userId)` Passez à un autre ID utilisateur avec un délai d'inactivité par défaut.
`boolean`	`switchUser(int userId, long timeout)` Passez à un autre ID utilisateur avec le délai d'expiration fourni comme délai.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Synchronise de manière incrémentielle le contenu d'un répertoire de fichiers local sur l'appareil.
`Bugreport`	`takeBugreport()` Créez un rapport de bug et renvoyez-le dans un objet `Bugreport` pour le gérer.
`String`	`uninstallPackage(String packageName)` Désinstaller un package Android de l'appareil
`String`	`uninstallPackageForUser(String packageName, int userId)` Désinstallez un package Android de l'appareil d'un utilisateur donné.
`boolean`	`unlockDevice()` Déverrouille l'appareil s'il est chiffré.
`void`	`unmountDebugfs()` Désinstallez debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Bloque jusqu'à ce que l'indicateur de démarrage terminé de l'appareil soit défini.
`boolean`	`waitForDeviceAvailable()` Attend que l'appareil réponde et soit disponible pour des tests.
`boolean`	`waitForDeviceAvailable(long waitTime)` Attend que l'appareil réponde et soit disponible pour des tests.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération.
`void`	`waitForDeviceBootloader()` Bloque jusqu'à ce que l'appareil soit visible en fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Blocs pour que l'appareil soit dans la récupération adb (notez qu'il ne s'agit pas `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocs pour que l'appareil soit dans le téléchargement indépendant adb état
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Blocages pour que l'appareil soit indisponible, c'est-à-dire absent d'adb
`void`	`waitForDeviceOnline()` Bloque jusqu'à ce que l'appareil soit visible via adb.
`void`	`waitForDeviceOnline(long waitTime)` Bloque jusqu'à ce que l'appareil soit visible via adb.
`boolean`	`waitForDeviceShell(long waitTime)` Attend que l'appareil réponde à une commande adb shell de base.

Méthodes protégées
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Crée la commande OS pour la session de commande shell adb et les arguments donnés.
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Créez un `RebootDeviceAction` à utiliser lors d'une action de redémarrage.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Effectuez un redémarrage adb.
`void`	`ensureRuntimePermissionSupported()` Méthode d'assistance permettant de générer une exception si l'autorisation d'exécution n'est pas prise en charge
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Obtenez l'instance `RunUtil` à utiliser.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Récupère une propriété d'appareil, à partir du cache ddmlib par défaut, et en revenant à adb shell getprop" ou "fastboot getvar", selon que l'appareil est en Fastboot ou non.
`boolean`	`isInRebootCallback()` Indique si des rappels de redémarrage sont en cours d'exécution ou non.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Renvoie `true` si le fichier local est plus récent que le fichier distant.
`void`	`notifyRebootEnded()` Notifie toutes les `IDeviceActionReceiver` de l'événement de fin de redémarrage.
`void`	`notifyRebootStarted()` Notifie toutes les `IDeviceActionReceiver` de l'événement de début de redémarrage.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Effectue une action sur cet appareil.
`void`	`postAdbReboot()` Actions supplémentaires possibles après un redémarrage.
`void`	`prePostBootSetup()` Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Définissez l'instance Clock à utiliser.
`void`	`setMicrodroidProcess(Process process)` Marque l'appareil TestDevice comme microdroid et définit son numéro client.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Exécute une commande fastboot simple avec des variables d'environnement et indique l'état du .
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Exécute une commande fastboot simple et indique l'état de la commande.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Attendez que l'appareil devienne indisponible (arrêtez de signaler à adb).

Constantes

ID_UTILISATEUR_NON_VALIDE

public static final int INVALID_USER_ID

Valeur renvoyée pour tout ID utilisateur non valide/introuvable: UserHandle a défini la valeur -10000.

Valeur constante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valeur constante: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

le nombre de tentatives d'exécution de la commande par défaut

Valeur constante: 2. (0x00000002)

Champs

CHEMIN_DEBUGFS

public static final String DEBUGFS_PATH

CARTE_SD

protected static final String SD_CARD

STOCKAGE_ÉMULÉ

protected static final String STORAGE_EMULATED

Options mobiles

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructeurs publics

Appareil natif

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Crée un TestDevice.

Paramètres
`device`	`IDevice`: le `IDevice` associé
`stateMonitor`	`IDeviceStateMonitor`: mécanisme `IDeviceStateMonitor` à utiliser
`allocationMonitor`	`IDeviceMonitor`: `IDeviceMonitor` pour informer les changements d'état d'allocation. Peut être nul

Méthodes publiques

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Micro-optimisation (environ 400 millisecondes) en préchargeant tous les accessoires dont nous avons besoin au lieu d'appeler "adb" getprop' pour chacune d'entre elles. Autrement dit, récupérer toutes les propriétés est aussi rapide qu'une propriété. Des éléments tels que device.getApiLevel(), checkApiLevelAgainstNextRelease et getBuildAlias font tous l'appel "adb getprop" en arrière-plan. Nous les récupérons en un seul appel et appelons "NativeDevice.setProperty". Même si nous ne le faisons pas, NativeDevice appellera setProperty et mettra en cache le résultat pour les prochains appels. C'est ce que nous faisons un peu plus tôt. Si l'appareil est en cours de récupération d'autres erreurs lors de la récupération des props, nous les ignorons.

CanSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifier si une fonctionnalité est actuellement compatible avec un niveau de compatibilité minimal. Ce prend en compte les fonctionnalités qui n'ont pas encore été publiées, avant que le niveau d'API ne soit augmenté.

Paramètres
`strictMinLevel`	`int`: niveau minimal strict possible pour la fonctionnalité.

Renvoie
`boolean`	"True" si le niveau est accepté. Sinon, cette valeur est "false".

Génère
`DeviceNotAvailableException`

vérifier la connectivité

public boolean checkConnectivity ()

Vérifiez que l'appareil est connecté au réseau.

Renvoie
`boolean`	`true` si la connexion réseau de l'appareil fonctionne `false` en excès.

Génère
`DeviceNotAvailableException`

ClearErrorDialogs

public boolean clearErrorDialogs ()

Essayez de fermer les boîtes de dialogue d'erreur affichées dans l'interface utilisateur de l'appareil.

Renvoie
`boolean`	`true` si aucune boîte de dialogue n'était présente ou si les boîtes de dialogue ont bien été effacées. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

ClearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Efface le dernier réseau Wi-Fi connecté. Ce nom doit être appelé lors du démarrage d'un nouvel appel pour éviter de vous connecter au réseau Wi-Fi utilisé lors du test précédent après le redémarrage de l'appareil.

ClearLogcat

public void clearLogcat ()

Supprime toutes les données logcat accumulées.

Cela est utile lorsque vous voulez vous assurer que ITestDevice#getLogcat() ne renvoie que des les données de journal générées après un certain point (par exemple, après le flash d'un nouveau build d'appareil, etc.).

se connecter au réseauWi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce que la connexion soit établie avec l'un des réseaux Wi-Fi réseaux donnés dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance restaurer la connexion après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() est appelé.

Paramètres
`wifiSsidToPsk`	: mappage des SSID Wi-Fi et des mots de passe.
`scanSsid`	`boolean`: rechercher les SSID masqués pour ce réseau

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`

se connecter au réseauWi-Fi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce que la connexion au réseau Wi-Fi spécifié soit établie. Une fois la connexion établie, l'instance tentera de la restaurer après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() est appelé.

Paramètres
`wifiSsid`	`String`: indicateur Wi-Fi auquel se connecter
`wifiPsk`	`String`: phrase secrète de la clé pré-partagée ou valeur nulle en l'absence de chiffrement

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`

se connecter au réseauWi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecte à un réseau Wi-Fi.

Paramètres
`wifiSsidToPsk`	: mappage des SSID Wi-Fi et des mots de passe.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`

se connecter au réseauWi-Fi

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

Se connecte à un réseau Wi-Fi.

Paramètres
`wifiSsid`	`String`: indicateur Wi-Fi auquel se connecter
`wifiPsk`	`String`: phrase secrète de la clé pré-partagée ou valeur nulle en l'absence de chiffrement
`scanSsid`	`boolean`: rechercher ou non le SSID masqué pour ce réseau

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

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

Variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.

Paramètres
`scanSsid`	`boolean`: rechercher ou non le SSID masqué pour ce réseau

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`

créerutilisateur

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

Créer un utilisateur avec un nom donné et les options fournies

Paramètres
`name`	`String`: de l'utilisateur à créer sur l'appareil
`guest`	`boolean`: activer l'indicateur utilisateur --guest lors de la création
`ephemeral`	`boolean`: activer l'option utilisateur --ephemeral lors de la création

Renvoie
`int`	ID de l'utilisateur créé

Génère
`DeviceNotAvailableException`

créerutilisateur

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

Créer un utilisateur avec un nom donné et les options fournies

Paramètres
`name`	`String`: de l'utilisateur à créer sur l'appareil
`guest`	`boolean`: activer l'indicateur utilisateur --guest lors de la création
`ephemeral`	`boolean`: activer l'option utilisateur --ephemeral lors de la création
`forTesting`	`boolean`: active l'indicateur de test --for-testing lors de la création.

Renvoie
`int`	ID de l'utilisateur créé

Génère
`DeviceNotAvailableException`

créerutilisateur

public int createUser (String name)

Créez un utilisateur avec un nom donné et les options par défaut de 0.

Paramètres
`name`	`String`: de l'utilisateur à créer sur l'appareil

Renvoie
`int`	l'entier pour l'ID utilisateur créé

Génère
`DeviceNotAvailableException`

créerUtilisateurPasDeJeter

public int createUserNoThrow (String name)

Créez un utilisateur avec un nom donné et les options par défaut de 0.

Paramètres
`name`	`String`: de l'utilisateur à créer sur l'appareil

Renvoie
`int`	l'entier pour l'ID utilisateur créé ou -1 pour l'erreur.

Génère
`DeviceNotAvailableException`

Supprimer le fichier

public void deleteFile (String deviceFilePath, 
                int userId)

Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil.

Paramètres
`deviceFilePath`	`String`: chemin absolu du fichier sur l'appareil.
`userId`	`int`: ID utilisateur à supprimer

Génère
`DeviceNotAvailableException`

Supprimer le fichier

public void deleteFile (String deviceFilePath)

Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil.

Paramètres
`deviceFilePath`	`String`: chemin absolu du fichier sur l'appareil.

Génère
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

Paramètres
`deviceActionReceiver`	`IDeviceActionReceiver`: `IDeviceActionReceiver` qui sera supprimé.

appareilSoftRedémarré

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible en comparant le serveur system_server actuel avec Le ProcessInfo system_server précédent. Utilisez getProcessByName(String) pour obtenir ProcessInfo.

Paramètres
`prevSystemServerProcess`	`ProcessInfo`: `ProcessInfo` du processus system_server précédent.

Renvoie
`boolean`	`true` si l'appareil a redémarré de façon réversible

Génère
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible depuis l'heure UTC depuis l'epoch appareil et son ERROR(/TimeUnit). Soft-Restart fait référence au système « system_server » redémarré en dehors d’un un redémarrage matériel de l'appareil (redémarrage demandé, par exemple) ; L'utcEpochTime de l'appareil actuel dans Vous pouvez obtenir Milliseccond à l'aide de la méthode getDeviceDate().

Paramètres
`utcEpochTime`	`long`: heure de l'appareil en secondes depuis l'epoch.
`timeUnit`	`TimeUnit`: unité de temps `TimeUnit` pour l'objet utcEpochTime donné.

Renvoie
`boolean`	`true` si l'appareil a redémarré de façon réversible

Génère
`DeviceNotAvailableException`

désactiverAdbRoot

public boolean disableAdbRoot ()

Désactive la racine adb.

La désactivation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode bloque jusqu'à appareil est disponible.

Renvoie
`boolean`	`true` si l'opération réussit.

Génère
`DeviceNotAvailableException`

désactiver la protection des touches

public void disableKeyguard ()

Tente de désactiver la protection du clavier.

Attendez d'abord que l'envoi des entrées soit prêt. Cela se produit au même moment, lorsque la fonction l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car le framework actuel présente une condition de concurrence occasionnelle. Ensuite, la commande est envoyée pour désactiver la protection du clavier (uniquement sur les sites non sécurisés)

Génère
`DeviceNotAvailableException`

désactiver MoniteurRéseau

public boolean disableNetworkMonitor ()

Désactive la surveillance du réseau sur l'appareil.

Renvoie
`boolean`	`true` si la surveillance est désactivée. `false` en cas d'échec.

Génère
`DeviceNotAvailableException`

déconnecter du Wifi

public boolean disconnectFromWifi ()

Se déconnecte d'un réseau Wi-Fi.

Supprime tous les réseaux de la liste des réseaux connus et désactive le Wi-Fi.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` si la déconnexion échoue.

Génère
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Méthode d'assistance permettant de déterminer si un fichier sur l'appareil existe pour un utilisateur donné.

Paramètres
`deviceFilePath`	`String`: chemin absolu du fichier sur l'appareil à vérifier
`userId`	`int`: ID utilisateur par rapport auquel l'existence du fichier doit être vérifiée.

Renvoie
`boolean`	`true` si le fichier existe, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.

Paramètres
`deviceFilePath`	`String`: chemin absolu du fichier sur l'appareil à vérifier

Renvoie
`boolean`	`true` si le fichier existe, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

tas de mémoire

public File dumpHeap (String process, 
                String devicePath)

Essayez de vider le tas de mémoire à partir de system_server. Il incombe à l'appelant de nettoyer le fichier vidé.

Paramètres
`process`	`String`: nom du processus de l'appareil sur lequel vider le tas.
`devicePath`	`String`: chemin d'accès sur l'appareil où placer le fichier de vidage. Il doit s'agir d'un emplacement où les autorisations le permettent.

Renvoie
`File`	le `ERROR(/File)` contenant le rapport. Null en cas d'échec.

Génère
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Active la racine adb. Si la commande "enable-root" est défini sur "false", un message est consigné sans activer la racine.

L'activation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode bloque jusqu'à appareil est disponible.

Renvoie
`boolean`	`true` si l'opération réussit.

Génère
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Active la surveillance du réseau sur l'appareil.

Renvoie
`boolean`	`true` si la surveillance a bien été activée. `false` en cas d'échec.

Génère
`DeviceNotAvailableException`

exécuterAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'expiration spécifié.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cela permet d'améliorer la détection des défaillances et les performances.

Paramètres
`timeout`	`long`: temps écoulé en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas, 0L pour aucun délai
`cmdArgs`	`String`: commande adb et arguments à exécuter

Renvoie
`String`	la commande stdout from. `null` si l'exécution de la commande a échoué.

Génère
`DeviceNotAvailableException`

exécuterAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'expiration spécifié.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cela permet d'améliorer la détection des défaillances et les performances.

Paramètres
`timeout`	`long`: temps écoulé en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas, 0L pour aucun délai
`envMap`	: environnement à définir pour la commande
`cmdArgs`	`String`: commande adb et arguments à exécuter

Renvoie
`String`	la commande stdout from. `null` si l'exécution de la commande a échoué.

Génère
`DeviceNotAvailableException`

exécuterAdbCommand

public String executeAdbCommand (String... cmdArgs)

Méthode d'assistance qui exécute une commande adb en tant que commande système.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cela permet d'améliorer la détection des défaillances et les performances.

Paramètres
`cmdArgs`	`String`: commande adb et arguments à exécuter

Renvoie
`String`	la commande stdout from. `null` si l'exécution de la commande a échoué.

Génère
`DeviceNotAvailableException`

exécuterFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'inactivité par défaut de 2 minutes

À utiliser lorsque l'appareil est déjà en mode fastboot.

Paramètres
`cmdArgs`	`String`: commande fastboot et arguments à exécuter

Renvoie
`CommandResult`	la commande CommandResult contenant le résultat de la commande

Génère
`DeviceNotAvailableException`

exécuterFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Méthode d'assistance qui exécute une commande fastboot en tant que commande système.

À utiliser lorsque l'appareil est déjà en mode fastboot.

Paramètres
`timeout`	`long`: durée (en millisecondes) avant l'expiration de la commande.
`cmdArgs`	`String`: commande fastboot et arguments à exécuter

Renvoie
`CommandResult`	la commande CommandResult contenant le résultat de la commande

Génère
`DeviceNotAvailableException`

ExécuterLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système.

Identique à executeFastbootCommand(String), mais utilise un délai d'inactivité plus long.

Paramètres
`cmdArgs`	`String`: commande fastboot et arguments à exécuter

Renvoie
`CommandResult`	la commande CommandResult contenant le résultat de la commande

Génère
`DeviceNotAvailableException`

ExécuterLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système avec l'état système variables d'environnement.

Identique à executeFastbootCommand(String), mais utilise un délai d'inactivité plus long.

Paramètres
`envVarMap`	: variables d'environnement système exécutées par la commande fastboot
`cmdArgs`	`String`: commande fastboot et arguments à exécuter

Renvoie
`CommandResult`	la commande CommandResult contenant le résultat de la commande

Génère
`DeviceNotAvailableException`

exécuterShellCommand

public String executeShellCommand (String command)

Méthode d'assistance qui exécute une commande shell adb et renvoie le résultat en tant que String.

Paramètres
`command`	`String`: commande shell adb à exécuter

Renvoie
`String`	la sortie du shell

Génère
`DeviceNotAvailableException`

exécuterShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.

Paramètres
`command`	`String`: commande shell adb à exécuter
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` vers lequel diriger la sortie du shell.
`maxTimeToOutputShellResponse`	`long`: durée maximale pendant laquelle la commande est autorisé à ne générer aucune réponse ; l'unité, comme indiqué dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si `retryAttempts` sont effectuées sans succès.

Génère
`DeviceNotAvailableException`

exécuterShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.

Paramètres
`command`	`String`: commande shell adb à exécuter
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` vers lequel diriger la sortie du shell.
`maxTimeoutForCommand`	`long`: délai maximal avant l'exécution de la commande unité spécifié dans `timeUnit`
`maxTimeToOutputShellResponse`	`long`: durée maximale pendant laquelle la commande est autorisé à ne générer aucune réponse ; l'unité, comme indiqué dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les `retryAttempts` sont sans succès.

Génère
`DeviceNotAvailableException`

exécuterShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Exécute la commande shell adb donnée, en effectuant plusieurs tentatives si la commande échoue.

Une forme plus simple de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) avec valeurs par défaut.

Paramètres
`command`	`String`: commande shell adb à exécuter
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` vers lequel diriger la sortie du shell.

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd)

Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément CommandResult correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.

Paramètres
`cmd`	`String`: commande à exécuter.

Renvoie
`CommandResult`	Résultat dans `CommandResult`.

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Paramètres
`cmd`	`String`: commande à exécuter.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` où la sortie std sera redirigée, ou valeur null.

Renvoie
`CommandResult`	Résultat dans `CommandResult`.

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Paramètres
`cmd`	`String`: commande à exécuter.
`pipeAsInput`	`File`: valeur `ERROR(/File)` qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle.

Renvoie
`CommandResult`	Résultat dans `CommandResult`.

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.

Paramètres
`cmd`	`String`: commande shell adb à exécuter
`maxTimeoutForCommand`	`long`: délai maximal avant l'exécution de la commande unité spécifié dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les `retryAttempts` sont sans succès.

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.

Paramètres
`cmd`	`String`: commande shell adb à exécuter
`maxTimeoutForCommand`	`long`: délai maximal avant l'exécution de la commande unité spécifié dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.

Paramètres
`cmd`	`String`: commande shell adb à exécuter
`pipeAsInput`	`File`: valeur `ERROR(/File)` qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` où la sortie std sera redirigée, ou valeur null.
`maxTimeoutForCommand`	`long`: délai maximal avant l'exécution de la commande unité spécifié dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les `retryAttempts` sont sans succès.

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

ExécuterShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.

Paramètres
`cmd`	`String`: commande shell adb à exécuter
`pipeAsInput`	`File`: valeur `ERROR(/File)` qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` où la sortie std sera redirigée, ou valeur null.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` où l'erreur std sera redirigée, ou valeur null.
`maxTimeoutForCommand`	`long`: délai maximal avant l'exécution de la commande unité spécifié dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les `retryAttempts` sont sans succès.

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

fastbootEffacerPartition

public CommandResult fastbootWipePartition (String partition)

Méthode d'assistance qui efface une partition de l'appareil.

Si getUseFastbootErase() est défini sur true, l'effacement rapide sera utilisé pour effacer la partition. L'appareil doit ensuite créer un système de fichiers au démarrage suivant. Sinon, le format fastboot est utilisé, ce qui crée un nouveau système de fichiers sur le périphérique.

À utiliser lorsque l'appareil est déjà en mode fastboot.

Paramètres
`partition`	`String`: partition à effacer

Renvoie
`CommandResult`	la commande CommandResult contenant le résultat de la commande

Génère
`DeviceNotAvailableException`

GetActiveApexes

public  getActiveApexes ()

Récupérez les informations sur les apex activés sur l'appareil.

Renvoie
	`ERROR(/Set)` sur `ApexInfo` actuellement activés sur l'appareil

Génère
`DeviceNotAvailableException`

getTous les paramètres

public  getAllSettings (String namespace)

Renvoie les paires clé/valeur de l'espace de noms demandé.

Paramètres
`namespace`	`String` : doit correspondre à l'une des valeurs suivantes : {"system", "secure", "global"}

Renvoie
	le mappage des paires clé-valeur. Valeur Null si l'espace de noms n'est pas accepté.

Génère
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Renvoyer l'état d'allocation actuel de l'appareil

Renvoie
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Recherchez et renvoyez l'android-id associé à un userId. La valeur "null" est absente si vous ne l'avez pas trouvé.

Paramètres
`userId`	`int`

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Créer une carte des identifiants Android trouvés pour les ID utilisateur correspondants. Il n’y a pas d’assurance que chaque utilisateur id trouve un identifiant Android associé à cette fonction. Certains ID utilisateur peuvent donc correspondre à "null".

Renvoie
	Carte des ID Android trouvés pour les ID utilisateur correspondants.

Génère
`DeviceNotAvailableException`

niveau getApi

public int getApiLevel ()

Obtenir le niveau d'API de l'appareil La valeur par défaut est UNKNOWN_API_LEVEL.

Renvoie
`int`	Nombre entier indiquant le niveau d'API de l'appareil

Génère
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Récupérer des informations sur un package installé sur l'appareil

Paramètres
`packageName`	`String`

Renvoie
`PackageInfo`	`PackageInfo` ou `null` si les informations n'ont pas pu être récupérées

Génère
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Récupère des informations sur les packages installés sur l'appareil.

Renvoie
	`ERROR(/List)` applications sur `PackageInfo` installées sur l'appareil.

Génère
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Méthode pratique permettant d'obtenir la version bande de base (radio) de cet appareil. Obtenir la version radio est spécifique à un appareil, et il est donc possible qu'elle ne renvoie pas les bonnes informations pour tous les appareils. Ce repose sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Cette valeur est inexacte pour certains appareils CDMA et peut ne pas correspondre à la version renvoyée ici. la version signalée par fastboot et peut ne pas renvoyer la version du signal radio CDMA. En résumé, cette méthode ne signale la version précise que si la propriété gsm.version.baseband est la identique à la version renvoyée par fastboot getvar version-baseband.

Renvoie
`String`	la version de bande de base `String` ou `null` si elle ne peut pas être déterminée ; (l'appareil n'a pas d'option, ou la chaîne de version ne peut pas être lue)

Génère
`DeviceNotAvailableException`

getBatterie

public Integer getBattery ()

Renvoie le niveau de batterie actuel d'un appareil, ou la valeur "null" si le niveau de batterie n'est pas disponible.

Renvoie
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Renvoie la valeur booléenne d'une propriété donnée.

Paramètres
`name`	`String`: nom de la propriété
`defaultValue`	`boolean`: valeur par défaut à renvoyer si la propriété est vide ou n'existe pas.

Renvoie
`boolean`	`true` si la propriété a la valeur `"1"`, `"y"`, `"yes"`, `"on"`, ou `"true"`, `false` si la propriété a la valeur `"0"`, `"n"`, `"no"`, `"off"`, `"false"` ou `defaultValue` sinon.

Génère
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage.

Renvoie
	Carte du temps de démarrage (temps UTC en seconde depuis l'epoch) et du motif de démarrage

Génère
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps de démarrage et le motif du démarrage le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée. L'utcEpochTime de l'appareil actuel dans La milliseconde peut être obtenue par la méthode getDeviceDate().

Paramètres
`utcEpochTime`	`long`: durée de l'appareil depuis l'epoch.
`timeUnit`	`TimeUnit`: unité de temps `TimeUnit`.

Renvoie
	Carte du temps de démarrage (temps UTC en seconde depuis l'epoch) et du motif de démarrage

Génère
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Méthode pratique permettant d'obtenir la version du bootloader de cet appareil.

Tentative de récupération de la version du bootloader à partir de l'état actuel de l'appareil. (c'est-à-dire si l'appareil est en mode fastboot, il tentera de récupérer la version à partir de fastboot).

Renvoie
`String`	La version du bootloader `String` ou `null` si elle est introuvable

Génère
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Récupère un rapport de bug de l'appareil.

La mise en œuvre de cette fonctionnalité continuera de fonctionner sur un appareil sans carte SD (ou là où la carte SD n'est pas encore installée).

Renvoie
`InputStreamSource`	Un `InputStreamSource` qui génère le contenu du rapport de bug à la demande. Dans en cas d'échec, `InputStreamSource` produira un `ERROR(/InputStream)` vide.

GetBugreportz

public InputStreamSource getBugreportz ()

Récupère un rapport de bug de l'appareil. Le rapport de bug au format Zip contient le rapport de bug principal et d'autres fichiers journaux utiles pour le débogage.

Uniquement compatible avec la "version adb" > 1.0.36

Renvoie
`InputStreamSource`	Une `InputStreamSource` du fichier ZIP contenant bugreportz, renvoie la valeur "null" dans en cas d'échec.

getBuildAlias

public String getBuildAlias ()

Récupérez l'alias de la compilation en cours d'exécution par l'appareil.

L'alias de compilation est généralement une chaîne plus lisible que l'ID de compilation (généralement un nombre pour les builds Nexus). Par exemple, la version finale d'Android 4.2 est associée à l'alias de build JDQ39 et à un ID de build. 573038

Renvoie
`String`	l'alias de build ou passer à l'ID de build s'il n'a pas pu être récupéré

Génère
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Récupérez le type de compilation pour l'appareil.

Renvoie
`String`	le type de compilation ou la valeur "null" si elle n'a pas pu être récupérée ;

Génère
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Récupérez la version en cours d'exécution de l'appareil.

Renvoie
`String`	L'ID de la compilation ou `IBuildInfo#UNKNOWN_BUILD_ID` s'il n'a pas pu être récupéré

Génère
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

Renvoie le type de clé utilisé pour signer l'image de l'appareil

En règle générale, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de version (contrôlé par des fabricants d'appareils individuels)

Renvoie
`String`	Clé de signature si trouvée, valeur null dans le cas contraire.

Génère
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Renvoie un DeviceDescriptor mis en cache si l'appareil est alloué. Sinon, renvoie le DeviceDescriptor en cours.

Renvoie
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Renvoie un DeviceDescriptor mis en cache si l'appareil est alloué. Sinon, renvoie le DeviceDescriptor en cours.

Paramètres
`shortDescriptor`	`boolean`: indique s'il faut limiter ou non le descripteur à un minimum d'informations.

Renvoie
`DeviceDescriptor`

EnfantsEnfants

public String[] getChildren (String path)

Alternative à l'utilisation de IFileEntry qui ne fonctionne parfois pas en raison des autorisations

Paramètres
`path`	`String`: est le chemin d'accès sur l'appareil où effectuer la recherche.

Renvoie
`String[]`	Tableau de chaîne contenant tous les fichiers d'un chemin d'accès sur l'appareil.

Génère
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

Connexion actuelle associée à l'appareil.

Renvoie
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Renvoie ContentProviderHandler ou la valeur "null" si aucune valeur n'est disponible.

Le fournisseur de contenu peut être réutilisé s'il a été créé précédemment avec le même userId.

Paramètres
`userId`	`int`: ID utilisateur avec lequel initialiser le fournisseur de contenu.

Renvoie
`ContentProviderHandler`

Génère
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème.

Renvoie
`DeviceFoldableState`

Génère
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Renvoie l'identifiant de l'utilisateur actuel. En cas d'erreur, renvoyez -10000.

Renvoie
`int`

Génère
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Permet d'obtenir la classe de l'appareil.

Renvoie
`String`	la classe d'appareil `String`.

getDeviceDate

public long getDeviceDate ()

Renvoie la date de l'appareil en millisecondes depuis l'epoch.

Renvoie
`long`	la date de l'appareil au format epoch.

Génère
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations le concernant sans en transmettant l'objet réel de l'appareil.

Renvoie
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations le concernant sans en transmettant l'objet réel de l'appareil.

Paramètres
`shortDescriptor`	`boolean`: indique s'il faut limiter ou non le descripteur à un minimum d'informations.

Renvoie
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Renvoie
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Outil d'aide pour obtenir le décalage horaire entre l'appareil et un ERROR(/Date) donné. Utiliser l'epoch en interne.

Paramètres
`date`	`Date`

Renvoie
`long`	la différence en millisecondes

Génère
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Obtenir le flux de l'émulateur stdout et stderr

Renvoie
`InputStreamSource`	sortie de l'émulateur

getEmulatorProcess

public Process getEmulatorProcess ()

Renvoyez le Process correspondant à cet émulateur.

Renvoie
`Process`	le `Process` ou `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Journal contenant tous les journaux executeShellCommand(String).

Renvoie
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la mémoire de stockage externe de l'appareil.

Renvoie
`long`	quantité d'espace disponible en Ko

Génère
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Renvoie le chemin d'accès au binaire fastboot utilisé. Pour que les fonctions fastboot soient activées, isFastbootEnabled() doit toujours être défini sur "true".

Renvoie
`String`

getFastbootProductType

public String getFastbootProductType ()

Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.

Cette méthode ne doit être utilisée que si l'appareil doit être en mode Fastboot. C'est une variante un peu plus sûre que la méthode générique getProductType() dans ce cas, car ITestDevice saura qu'il doit récupérer l'appareil en fastboot si son état est incorrect ou s'il est ne répond pas.

Renvoie
`String`	Nom du type de produit `String` ou `null` s'il ne peut pas être déterminé

Génère
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.

Renvoie
`String`	Nom du type de produit `String` ou `null` s'il ne peut pas être déterminé

Génère
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Renvoie le numéro de série du mode fastboot.

Renvoie
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Récupérez la valeur de variable fastboot donnée à partir de l'appareil.

Paramètres
`variableName`	`String`: nom de la variable.

Renvoie
`String`	La valeur de la propriété ou `null` si elle n'existe pas

Génère
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Renvoie la chaîne de version du binaire fastboot utilisé. Ou "null" si quelque chose se passe faux.

Renvoie
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Récupérer une référence à un fichier distant sur un appareil

Paramètres
`path`	`String`: chemin d'accès au fichier à récupérer. Il peut s'agir d'un chemin absolu ou relatif à "/". (ex. : à la fois "/system" et "système" est compatible)

Renvoie
`IFileEntry`	`IFileEntry` ou `null` si le fichier à l'`path` donné ne peut pas être trouvé

Génère
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Outil d'aide non officiel pour obtenir un FileEntry à partir d'un chemin d'accès non racine. CORRIGÉ: refactoriser le fichier FileEntry pour qu'il soit disponible depuis n'importe quel chemin d'accès. (même non racine).

Paramètres
`entry`	`FileListingService.FileEntry`: un élément `FileEntry` qui n'est pas nécessairement racine, comme l'exige Ddmlib.

Renvoie
`IFileEntry`	un FileEntryWrapper représentant l'entrée FileEntry.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

Renvoie la liste des états des appareils pliables sur l'appareil. Obtention de la commande "cmd device_state" "print-states" (états d'impression).

Renvoie

Génère
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Renvoie une référence au fichier ddmlib IDevice associé.

Un nouveau IDevice peut être alloué par le service de gestion des données (DMS) chaque fois que l'appareil se déconnecte et se reconnecte à partir d'adb. Ainsi, les appelants ne doivent pas garder de référence à IDevice, car cette référence peut devenir obsolète.

Renvoie
`IDevice`	l'/le/la `IDevice`

getInstallPackageNames

public  getInstalledPackageNames ()

Récupérez les noms des packages d'application présents sur l'appareil.

Renvoie
	`ERROR(/Set)` noms de packages sur `String` sont actuellement installés sur l'appareil.

Génère
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Renvoie la valeur entière de la propriété donnée à partir de l'appareil.

Paramètres
`name`	`String`: nom de la propriété
`defaultValue`	`long`: valeur par défaut à renvoyer si la propriété est vide ou n'existe pas.

Renvoie
`long`	la valeur de la propriété ou `defaultValue` si la propriété est vide ou n'existe pas ; ou n'a pas de valeur entière.

Génère
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Récupère l'adresse IP de l'appareil.

Renvoie
`String`	l'adresse IP de l'appareil, ou `null` si l'appareil n'en a pas ;

Génère
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Renvoyez un objet pour obtenir l'état actuel du verrouillage du clavier ou la valeur "null" si cette fonctionnalité n'est pas disponible.

Renvoie
`KeyguardControllerState`	Une `KeyguardControllerState` contenant un instantané de l'état de la protection du clavier et renvoie Null si la requête de garde du clavier n'est pas prise en charge.

Génère
`DeviceNotAvailableException`

getLastExpectRestartTimeMillis

public long getLastExpectedRebootTimeMillis ()

Renvoie la dernière fois où les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH en tant que renvoyé par System.currentTimeMillis().

Renvoie
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

Permet d'obtenir le premier niveau d'API lancé sur l'appareil. La valeur par défaut est UNKNOWN_API_LEVEL.

Renvoie
`int`	Nombre entier indiquant le premier niveau d'API de l'appareil

Génère
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Récupère un flux d'instantanés des données logcat.

Fonctionne dans deux modes:

Si le fichier logcat est actuellement capturé en arrière-plan, la fonction renvoie jusqu'à TestDeviceOptions.getMaxLogcatDataSize() octets du contenu actuel de l'arrière-plan. capture logcat

Sinon, renverra un vidage statique des données logcat si l'appareil répond actuellement.

Renvoie
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Récupère un flux d'instantanés de la dernière maxBytes de données logcat capturées.

Utile pour les cas où vous souhaitez capturer des instantanés fréquents des données logcat capturées sans subir la pénalité d'espace disque potentiellement importante que représente l'obtention de l'instantané getLogcat() complet.

Paramètres
`maxBytes`	`int`: quantité maximale de données à renvoyer. Il doit s'agir d'un montant pouvant s'adaptent parfaitement à la mémoire

Renvoie
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

Obtenir un vidage du logcat actuel pour l'appareil Contrairement à getLogcat(), cette méthode renvoie toujours un vidage statique du fichier logcat.

L'inconvénient est que rien n'est renvoyé si l'appareil n'est pas accessible.

Renvoie
`InputStreamSource`	une `InputStreamSource` des données logcat. Un flux vide est renvoyé en cas d'échec. pour capturer les données logcat.

getLogcatLogcat

public InputStreamSource getLogcatSince (long date)

Récupère un flux d'instantanés des données logcat capturées à partir de la date fournie. L'heure du l'appareil doit être utilisé getDeviceDate().

Paramètres
`date`	`long`: en millisecondes depuis le format epoch du démarrage de l'instantané jusqu'à présent. (peut être obtenu en utilisant "date +%s")

Renvoie
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Renvoie l'adresse MAC de l'appareil, qui est nulle si la requête échoue.

Renvoie
`String`

IDUtilisateurMain

public Integer getMainUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
`Integer`	L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas.

Génère
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Obtenez les informations sur les modules principaux installés sur l'appareil.

Renvoie
	`ERROR(/Set)` module principal sur `String` actuellement installé sur l'appareil.

Génère
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersCompatibles

public int getMaxNumberOfRunningUsersSupported ()

Obtenir le nombre maximal d'utilisateurs pouvant s'exécuter simultanément La valeur par défaut est 0.

Renvoie
`int`	Nombre entier indiquant le nombre d'utilisateurs exécutant simultanément

Génère
`DeviceNotAvailableException`

getMaxNumberOfUsersCompatibles

public int getMaxNumberOfUsersSupported ()

Obtenir le nombre maximal d'utilisateurs pris en charge La valeur par défaut est 0.

Renvoie
`int`	Nombre entier indiquant le nombre d'utilisateurs acceptés

Génère
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Renvoie
`Process`	Renvoie le processus de la VM Microdroid. Si TestDevice n'est pas un Microdroid, renvoie "null".

getMonitor

public IDeviceStateMonitor getMonitor ()

Renvoie le IDeviceStateMonitor associé à l'appareil.

Renvoie
`IDeviceStateMonitor`

GetMountPoint

public String getMountPoint (String mountName)

Renvoie un point d'installation.

Interroge directement l'appareil si les informations mises en cache dans IDevice ne sont pas disponibles.

À FAIRE: déplacer ce comportement vers IDevice#getMountPoint(String)

Paramètres
`mountName`	`String`: nom du point d'installation

Renvoie
`String`	le point d'installation ou `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Renvoie un MountPointInfo correspondant au chemin d'accès au point de montage spécifié, ou null si ce chemin d'accès n'a rien à installer ou n'apparaît pas dans /proc/mounts comme point de montage.

Paramètres
`mountpoint`	`String`

Renvoie
`ITestDevice.MountPointInfo`	Une `ERROR(/List)` de `MountPointInfo` contenant les informations dans "/proc/mounts"

Génère
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

Renvoie une version analysée des informations contenues dans /proc/mounts sur l'appareil.

Renvoie
	Une `ERROR(/List)` de `MountPointInfo` contenant les informations dans "/proc/mounts"

Génère
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

Récupérez les options de test pour l'appareil.

Renvoie
`TestDeviceOptions`	`TestDeviceOptions` associé à l'appareil testé.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la partition de l'appareil.

Paramètres
`partition`	`String`

Renvoie
`long`	quantité d'espace disponible en Ko

Génère
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

Renvoie l'identifiant de l'utilisateur principal.

Renvoie
`Integer`	L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas.

Génère
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

La méthode d'assistance exécute la fonction "pidof" et "stat" et renvoie l'objet ProcessInfo avec PID et heure de début du processus donné.

Paramètres
`processName`	`String`: nom du processus (String).

Renvoie
`ProcessInfo`	ProcessInfo associé au nom processName donné

Génère
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Renvoie le pid du service ou la valeur "null" en cas de problème.

Paramètres
`process`	`String`: chaîne du nom du processus.

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Méthode pratique permettant d'obtenir le type de produit de cet appareil.

Cette méthode fonctionne si l'appareil est en mode adb ou fastboot.

Renvoie
`String`	le nom du type de produit `String`. Ne sera pas nul

Génère
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Méthode pratique permettant d'obtenir la variante du produit de cet appareil.

Cette méthode fonctionne si l'appareil est en mode adb ou fastboot.

Renvoie
`String`	le nom de la variante du produit `String` ou `null` s'il ne peut pas être déterminé

Génère
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Récupère la valeur de propriété donnée à partir de l'appareil.

Paramètres
`name`	`String`: nom de la propriété

Renvoie
`String`	La valeur de la propriété ou `null` si elle n'existe pas

Génère
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

Obtenez le mode de récupération actuellement utilisé pour l'appareil.

Renvoie
`ITestDevice.RecoveryMode`	le mode de récupération actuellement utilisé pour l'appareil.

getScreenshot

public InputStreamSource getScreenshot (String format)

Permet de prendre une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot(format) à la place avec l'encodage JPEG pour réduire la taille.

Paramètres
`format`	`String`: fichiers PNG et JPEG acceptés.

Renvoie
`InputStreamSource`	un `InputStreamSource` de la capture d'écran au format, ou `null` si la capture d'écran a échoué.

Génère
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Récupère une capture d'écran de l'appareil correspondant à l'identifiant d'affichage. Le format est PNG.

À FAIRE: étendre les implémentations ci-dessus pour prendre en charge le "format" et "redimensionner"

Paramètres
`displayId`	`long`: ID d'affichage de l'écran à partir duquel obtenir la capture d'écran.

Renvoie
`InputStreamSource`	un `InputStreamSource` de la capture d'écran au format, ou `null` si le la capture d'écran a échoué.

Génère
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Permet de prendre une capture d'écran de l'appareil. Il est recommandé d'utiliser plutôt getScreenshot(String) avec un encodage JPEG pour une taille plus petite.

Paramètres
`format`	`String`: fichiers PNG et JPEG acceptés.
`rescale`	`boolean`: si la capture d'écran doit être redimensionnée pour réduire la taille de l'image obtenue

Renvoie
`InputStreamSource`	un `InputStreamSource` de la capture d'écran au format, ou `null` si le la capture d'écran a échoué.

Génère
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Permet de prendre une capture d'écran de l'appareil.

Renvoie
`InputStreamSource`	Une `InputStreamSource` de la capture d'écran au format png, ou `null` si la capture d'écran a échoué.

Génère
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Méthode pratique permettant d'obtenir le numéro de série de cet appareil.

Renvoie
`String`	le numéro de série `String`

getSetting

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

Renvoie la valeur du paramètre demandé. L'espace de noms doit être l'un des suivants: {"system", "secure", "global"}

Paramètres
`userId`	`int`
`namespace`	`String`
`key`	`String`

Renvoie
`String`	la valeur associée à l'espace de noms "namespace:key" d'un utilisateur. Null si introuvable.

Génère
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Voir getSetting(int, String, String) et effectué sur l'utilisateur système.

Paramètres
`namespace`	`String`
`key`	`String`

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Renvoyez l'opérateur de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible.

Renvoie
`String`

getSimState

public String getSimState ()

Renvoyez l'état de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible.

Renvoie
`String`

getTombstones

public  getTombstones ()

Récupérez et renvoyez la liste des tombstones des appareils. Racine requise.

est la meilleure méthode. Ainsi, si une pierre tombale n'est pas tirée pour une raison quelconque, elle sera absents de la liste. Seul un DeviceNotAvailableException mettra fin à la méthode. plus tôt.

Renvoie
	Liste de fichiers tombstone, vide s'il n'y en a pas.

Génère
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne.

Renvoie
`long`

getTrackingSerial

public String getTrackingSerial ()

Pour gérer les appareils, récupérez le numéro de série utilisé pour le suivre.

Renvoie
`String`

getDésinstallerablePackageNames

public  getUninstallablePackageNames ()

Récupérez les noms des packages d'application qui peuvent être désinstallés. Elle est actuellement définie comme les packages non-système et les packages système mis à jour.

Renvoie
	`ERROR(/Set)` des noms de packages `String` pouvant être désinstallés actuellement installés sur le appareil.

Génère
`DeviceNotAvailableException`

getUseFastbootEffacer

public boolean getUseFastbootErase ()

Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.

Renvoie
`boolean`	`true` si l'effacement rapide est utilisé ou `false` si le format Fastboot est être utilisée.

getUserFlags

public int getUserFlags (int userId)

Rechercher et renvoyer les indicateurs d'un utilisateur donné Les indicateurs sont définis dans "android.content.pm.UserInfo" dans le projet Android Open Source.

Paramètres
`userId`	`int`

Renvoie
`int`	les indicateurs associés à l'ID utilisateur fourni s'il est trouvé, -10000 dans les autres cas.

Génère
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Récupère la carte de useId sur UserInfo sur l'appareil. Une erreur DeviceRuntimeException est générée si le résultat de l'appareil n'est pas conforme à vos attentes.

Renvoie
	la liste des objets UserInfo.

Génère
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Renvoyez le numéro de série associé à l'ID utilisateur s'il est trouvé, et -10000 dans les autres cas.

Paramètres
`userId`	`int`

Renvoie
`int`

Génère
`DeviceNotAvailableException`

Événement de gestion des allocations

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Traitement de l'événement DeviceEvent donné. Passage possible de l'appareil au nouvel état. Informer IDeviceMonitor de toute transition d'état.

Traiter DeviceEvent, qui peut ou non faire passer cet appareil à une nouvelle allocation de l'état.

Paramètres
`event`	`DeviceEvent`

Renvoie
`IManagedTestDevice.DeviceEventResponse`

Fonction

public boolean hasFeature (String feature)

Vérifier si une fonctionnalité est disponible sur un appareil

Paramètres
`feature`	`String`: quel format devrait être "feature:" ou "" directement.

Renvoie
`boolean`	"True" si la caractéristique est détectée, false dans le cas contraire.

Génère
`DeviceNotAvailableException`

Installer le package

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

Installer un package Android sur l'appareil

Paramètres
`packageFile`	`File`: fichier APK à installer.
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`

Installer le package

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

Installer un package Android sur l'appareil

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
`packageFile`	`File`: fichier APK à installer.
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`

installPackageForUser

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

Installer un package Android sur l'appareil d'un utilisateur donné

Paramètres
`packageFile`	`File`: fichier APK à installer.
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`userId`	`int`: ID utilisateur entier pour lequel installer l'application.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`

installPackageForUser

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

Installer un package Android sur l'appareil d'un utilisateur donné

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
`packageFile`	`File`: fichier APK à installer.
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`userId`	`int`: ID utilisateur entier pour lequel installer l'application.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

IsAdbRoot

public boolean isAdbRoot ()

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Renvoie
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Vérifier si la plate-forme de l'appareil est compatible avec l'énumération d'applications

Renvoie
`boolean`	"True" si l'énumération d'applications est compatible, "false" dans le cas contraire

Génère
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockCompatible

public boolean isBypassLowTargetSdkBlockSupported ()

Vérifier si la plate-forme sur l'appareil permet de contourner le blocage du SDK cible faible lors des installations d'applications

Renvoie
`boolean`	"True" si le bloc du SDK cible de contournement à faible valeur est accepté, ou "false" dans le cas contraire

Génère
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Vérifiez si debugfs est installé.

Renvoie
`boolean`	`true` si debugfs est installé

Génère
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Indique si l'appareil est chiffré.

Renvoie
`boolean`	`true` si l'appareil est chiffré

Génère
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

Renvoyez la valeur "True" si le chemin d'accès sur l'appareil est un répertoire, et la valeur "false" dans le cas contraire.

Paramètres
`path`	`String`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Renvoie
`boolean`	`true` si la racine adb doit être activée sur l'appareil

isEncryptionCompatible

public boolean isEncryptionSupported ()

Indique si l'appareil est compatible avec le chiffrement.

Renvoie
`boolean`	`true` si l'appareil est compatible avec le chiffrement.

Génère
`DeviceNotAvailableException`

isExecutable (isExecutable)

public boolean isExecutable (String fullPath)

Affiche la valeur "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, et la valeur "false" dans le cas contraire.

Paramètres
`fullPath`	`String`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

IsFastbootEnabled

public boolean isFastbootEnabled ()

Renvoie si fastboot est disponible pour l'appareil.

Renvoie
`boolean`

IsHeadless

public boolean isHeadless ()

Renvoie la valeur "true" si l'appareil est headless (aucun écran), sinon la valeur "false".

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Indique si l'appareil utilise le mode utilisateur système headless.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Indique si l'utilisateur principal est un administrateur permanent et si celui-ci ne peut pas être supprimé ou rétrogradé non-administrateur.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isMultiUserCompatible

public boolean isMultiUserSupported ()

Détermine si le mode multi-utilisateur est pris en charge.

Renvoie
`boolean`	"true" si le mode multi-utilisateur est pris en charge, "false" dans le cas contraire

Génère
`DeviceNotAvailableException`

isPackageInstallée

public boolean isPackageInstalled (String packageName, 
                String userId)

Interrogez l'appareil à la recherche d'un nom de package et d'un ID utilisateur donnés pour vérifier s'il est actuellement installé ou non pour cet utilisateur.

Paramètres
`packageName`	`String`: le package dont nous vérifions s'il est installé.
`userId`	`String`: l'ID utilisateur pour lequel nous vérifions que le package est installé. Si la valeur est null, l'utilisateur principal zéro sera utilisé.

Renvoie
`boolean`	"True" si le package est signalé comme installé. Sinon, cette valeur est "false".

Génère
`DeviceNotAvailableException`

isPackageInstallée

public boolean isPackageInstalled (String packageName)

Interrogez l'appareil sur le nom de package donné pour vérifier s'il est actuellement installé ou non.

Paramètres
`packageName`	`String`

Renvoie
`boolean`	"True" si le package est signalé comme installé. Sinon, cette valeur est "false".

Génère
`DeviceNotAvailableException`

isRuntimePermissionCompatible

public boolean isRuntimePermissionSupported ()

Vérifier si la plate-forme sur l'appareil est compatible avec l'octroi d'autorisations d'exécution

Renvoie
`boolean`	"True" si les autorisations d'exécution sont prises en charge, et "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

Renvoie la valeur "true" si l'appareil se trouve dans TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD.

Renvoie
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Vérifiez si un utilisateur donné est en cours d'exécution.

Paramètres
`userId`	`int`

Renvoie
`boolean`	"True" si l'utilisateur est en cours d'exécution, "false" dans tous les autres cas.

Génère
`DeviceNotAvailableException`

isUserSecondaire

public boolean isUserSecondary (int userId)

Indique si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.

Paramètres
`userId`	`int`

Renvoie
`boolean`	La valeur est "true" si l'utilisateur est un utilisateur secondaire, et la valeur "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Vérifie si l'utilisateur donné est visible.

Un élément "visible" l'utilisateur est un utilisateur qui interagit avec un "humain" utilisateur et peut donc lancer les activités de lancement (généralement sur l'écran par défaut).

Paramètres
`userId`	`int`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Vérifie si l'utilisateur donné est visible sur l'écran donné.

Un élément "visible" l'utilisateur est un utilisateur qui interagit avec un "humain" utilisateur et peut donc lancer des activités de lancement dans cet affichage.

Paramètres
`userId`	`int`
`displayId`	`int`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplayCompatible

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Si c'est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean) en transmettant un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers() (qui doit inclure ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersCompatible

public boolean isVisibleBackgroundUsersSupported ()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.

Si c'est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean) en transmettant un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers().

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Vérifiez si le Wi-Fi est activé.

Vérifie si le Wi-Fi est activé sur l'appareil. Utile pour vérifier l'état du Wi-Fi avant de tester que ne doit pas fonctionner en Wi-Fi les tests de données mobiles.

Renvoie
`boolean`	`true` si le Wi-Fi est activé. `false` si désactivé

Génère
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Collecter la liste des identifiants d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys" SurfaceFlinger".

Renvoie
	Liste des écrans. La valeur par défaut renvoie toujours la valeur d'affichage par défaut 0.

Génère
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Récupère la liste des écrans pouvant être utilisés pour start a user visible in the background.

Renvoie

Génère
`DeviceNotAvailableException`

Lister les utilisateurs

public  listUsers ()

Récupère la liste des utilisateurs de l'appareil. Une erreur DeviceRuntimeException est générée en cas de sortie. de l'appareil n'est pas conforme à vos attentes.

Renvoie
	la liste des ID utilisateur.

Génère
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Recueille et consigne les erreurs ANR de l'appareil.

Paramètres
`logger`	`ITestLogger`: `ITestLogger` pour consigner les erreurs ANR.

Renvoie
`boolean`	"True" si la journalisation a réussi, sinon "false".

Génère
`DeviceNotAvailableException`

Rapport logBug

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Méthode d'assistance permettant de générer un rapport de bug et de l'enregistrer dans les rapports

Paramètres
`dataName`	`String`: nom sous lequel le rapport de bug sera signalé.
`listener`	`ITestLogger`: `ITestLogger` pour consigner le rapport de bug.

Renvoie
`boolean`	"True" si la journalisation a réussi, sinon "false".

ouverture de session sur l'appareil

public void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

Consigner un message dans le fichier logcat de l'appareil. Il s'agit d'un appel sécurisé qui ne sera pas généré, même si la journalisation échoue.

Paramètres
`tag`	`String`: balise sous laquelle nous enregistrons notre message dans logcat.
`level`	`Log.LogLevel`: niveau de débogage du message dans Logcat.
`format`	`String`: format du message.
`args`	`Object`: arguments à remplacer via String.format().

MountDebugfs

public void mountDebugfs ()

Installation de debugfs

Génère
`DeviceNotAvailableException`

nonBlockingRedémarrer

public void nonBlockingReboot ()

Émet une commande pour redémarrer l'appareil et renvoie une commande terminée et plus visible par adb.

Génère
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

À remplacer si l'appareil nécessite des actions spécifiques après la racine adb et avant la l'appareil est à nouveau connecté. L'implémentation par défaut n'inclut aucune action supplémentaire. L'activation de la racine adb n'est pas garantie à ce stade.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

À remplacer si l'appareil nécessite des actions spécifiques après le retrait d'adb et avant l'appareil est à nouveau connecté. L'implémentation par défaut n'inclut aucune autre action. Il n'est pas garanti que la racine adb soit désactivée à ce stade.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

Suivez les instructions pour configurer l'appareil afin de le tester après chaque démarrage.

Doit être appelé une fois l'appareil entièrement démarré/disponible

En règle générale, il n'est pas nécessaire d'appeler cette méthode explicitement, car les implémentations doivent effectuer ces étapes automatiquement lors d'un redémarrage.

Il peut être nécessaire de l'appeler lorsque l'appareil redémarre en raison d'autres événements (par exemple, lorsqu'un fastboot update est terminée).

Génère
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Des étapes supplémentaires pour un nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est terminé.

Paramètres
`exception`	`Throwable`: le cas échéant, exception finale générée par l'échec de l'appel.

PreInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

Étapes supplémentaires pour une configuration spécifique à l'appareil qui sera exécutée sur l'appareil avant le flux d'appel.

Paramètres
`info`	`IBuildInfo`: `IBuildInfo` de l'appareil.
`attributes`	`MultiMap`: attributs stockés dans le contexte d'appel

Génère
`DeviceNotAvailableException`
`TargetSetupError`

Fonction pull Dir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

Récupérez de manière récursive le contenu du répertoire de l'appareil.

Paramètres
`deviceFilePath`	`String`: chemin d'accès absolu au fichier de la source distante
`localDir`	`File`: répertoire local dans lequel extraire les fichiers
`userId`	`int`: ID utilisateur à partir duquel effectuer l'extraction.

Renvoie
`boolean`	`true` si le fichier a bien été extrait. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

Fonction pull Dir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Récupérez de manière récursive le contenu du répertoire de l'appareil.

Paramètres
`deviceFilePath`	`String`: chemin d'accès absolu au fichier de la source distante
`localDir`	`File`: répertoire local dans lequel extraire les fichiers

Renvoie
`boolean`	`true` si le fichier a bien été extrait. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Récupère un fichier depuis l'appareil.

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil
`localFile`	`File`: fichier local dans lequel stocker le contenu. Si vous n'indiquez aucune valeur, le contenu sera remplacé.

Renvoie
`boolean`	`true` si le fichier a bien été récupéré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Récupère un fichier depuis l'appareil, le stocke dans un ERROR(/File) temporaire local, puis l'affiche File

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil
`userId`	`int`: ID utilisateur à partir duquel effectuer l'extraction.

Renvoie
`File`	Un `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si le Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

Génère
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

Récupère un fichier depuis l'appareil, le stocke dans un ERROR(/File) temporaire local, puis l'affiche File

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil

Renvoie
`File`	Un `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si le Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

Génère
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

Récupère un fichier depuis l'appareil.

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil
`localFile`	`File`: fichier local dans lequel stocker le contenu. Si vous n'indiquez aucune valeur, le contenu sera remplacé.
`userId`	`int`: ID utilisateur à partir duquel effectuer l'extraction.

Renvoie
`boolean`	`true` si le fichier a bien été récupéré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Récupère un fichier depuis l'appareil, puis renvoie son contenu.

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil

Renvoie
`String`	Un `String` contenant le contenu du fichier de l'appareil, ou `null` si le Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

Génère
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

Méthode pratique permettant de récupérer un fichier de la mémoire de stockage externe de l'appareil, en le stockant dans un un ERROR(/File) temporaire local et renvoyer une référence à ce File.

Paramètres
`remoteFilePath`	`String`: chemin d'accès au fichier sur l'appareil, par rapport à son espace de stockage externe Mountpoint

Renvoie
`File`	Un `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si le Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

Génère
`DeviceNotAvailableException`

Rép. push

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Transférez le contenu du répertoire de manière récursive sur l'appareil tout en excluant certains répertoires filtrée.

Paramètres
`localFileDir`	`File`: répertoire local à transférer
`deviceFilePath`	`String`: chemin d'accès absolu au fichier de la destination distante
`excludedDirectories`	: ensemble de noms de répertoires exclus à ne pas transférer.

Renvoie
`boolean`	`true` si le fichier a bien été transféré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

Rép. push

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Transférez le contenu du répertoire de manière récursive sur l'appareil.

Paramètres
`localFileDir`	`File`: répertoire local à transférer
`deviceFilePath`	`String`: chemin d'accès absolu au fichier de la destination distante

Renvoie
`boolean`	`true` si le fichier a bien été transféré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

Rép. push

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

Transférez le contenu du répertoire de manière récursive sur l'appareil.

Paramètres
`localFileDir`	`File`: répertoire local à transférer
`deviceFilePath`	`String`: chemin d'accès absolu au fichier de la destination distante
`userId`	`int`: ID utilisateur vers lequel transférer le contenu

Renvoie
`boolean`	`true` si le fichier a bien été transféré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

fichier push

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

Variante de pushFile(File, String), qui peut éventuellement envisager d'évaluer le besoin pour le fournisseur de contenu.

Paramètres
`localFile`	`File`: fichier local à transférer
`remoteFilePath`	`String`: chemin d'accès absolu au fichier de destination à distance
`evaluateContentProviderNeeded`	`boolean`: indique si nous avons besoin du fournisseur de contenu.

Renvoie
`boolean`	`true` si le fichier a bien été transféré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

fichier push

public boolean pushFile (File localFile, 
                String remoteFilePath)

Transférer un fichier sur l'appareil Utilisation par défaut d'un fournisseur de contenu.

Paramètres
`localFile`	`File`: fichier local à transférer
`remoteFilePath`	`String`: chemin d'accès absolu au fichier de destination à distance

Renvoie
`boolean`	`true` si le fichier a bien été transféré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

fichier push

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

Transférer un fichier sur l'appareil Utilisation par défaut d'un fournisseur de contenu.

Paramètres
`localFile`	`File`: fichier local à transférer
`remoteFilePath`	`String`: chemin d'accès absolu au fichier de destination à distance
`userId`	`int`: ID utilisateur vers lequel envoyer le transfert

Renvoie
`boolean`	`true` si le fichier a bien été transféré. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Envoyer le fichier créé à partir d'une chaîne vers l'appareil

Paramètres
`contents`	`String`: contenu du fichier à transférer
`remoteFilePath`	`String`: chemin d'accès absolu au fichier de destination à distance

Renvoie
`boolean`	`true` si la chaîne a bien été transmise. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

redémarrer

public void reboot (String reason)

Redémarre l'appareil en mode adb avec la valeur reason donnée pour être conservée lors du redémarrage.

Bloque jusqu'à ce que l'appareil soit disponible.

Vous pouvez obtenir le motif du dernier redémarrage en interrogeant la propriété sys.boot.reason.

Paramètres
`reason`	`String`: motif de ce redémarrage ou `null` si aucun motif n'est spécifié.

Génère
`DeviceNotAvailableException`

redémarrer

public void reboot ()

Redémarre l'appareil en mode adb.

Bloque jusqu'à ce que l'appareil soit disponible.

Génère
`DeviceNotAvailableException`

redémarrer le bootloader dans le bootloader

public void rebootIntoBootloader ()

Redémarre l'appareil en mode bootloader.

Blocages jusqu'à ce que l'appareil soit en mode bootloader.

Génère
`DeviceNotAvailableException`

redémarrer

public void rebootIntoFastbootd ()

Redémarre l'appareil en mode fastbootd.

Blocages jusqu'à ce que l'appareil soit en mode fastbootd

Génère
`DeviceNotAvailableException`

redémarrer votre navigateur

public void rebootIntoRecovery ()

Redémarre l'appareil en mode de récupération adb.

Blocages tant que l'appareil n'entre pas dans le processus de récupération

Génère
`DeviceNotAvailableException`

redémarrer le chargement latéral

public void rebootIntoSideload ()

Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).

Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant

Génère
`DeviceNotAvailableException`

redémarrer le chargement latéral

public void rebootIntoSideload (boolean autoReboot)

Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).

Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant

Paramètres
`autoReboot`	`boolean`: indique si l'appareil doit être redémarré automatiquement après un téléchargement indépendant.

Génère
`DeviceNotAvailableException`

redémarrer jusqu'au magasin en ligne

public void rebootUntilOnline ()

Alternative à reboot() qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.

Génère
`DeviceNotAvailableException`

redémarrer jusqu'au magasin en ligne

public void rebootUntilOnline (String reason)

Alternative à reboot() qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.

Paramètres
`reason`	`String`: motif de ce redémarrage ou `null` si aucun motif n'est spécifié.

Génère
`DeviceNotAvailableException`

redémarrer l'espace utilisateur

public void rebootUserspace ()

Redémarre uniquement une partie de l'espace utilisateur de l'appareil.

Bloque jusqu'à ce que l'appareil soit disponible.

AVERTISSEMENT. Le redémarrage de l'espace utilisateur est actuellement en cours de développement. Utilisez-le à vos propres risques.

Génère
`DeviceNotAvailableException`

redémarrer l'espaceUtilisateurJusqu'àEnligne

public void rebootUserspaceUntilOnline ()

Autre solution à rebootUserspace() ()} qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.

Génère
`DeviceNotAvailableException`

récupérer l'appareil

public boolean recoverDevice ()

Tentatives de récupération de la communication de l'appareil.

Renvoie
`boolean`	"True" en cas de tentative de récupération réussie, False si la récupération a été ignorée

Génère
`DeviceNotAvailableException`	si l'appareil n'est plus disponible

RegisterDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

Tous les IDeviceActionReceiver enregistrés seront avertis avant toute action sur l'appareil et après la fin de l'action sur l'appareil.

Paramètres
`deviceActionReceiver`	`IDeviceActionReceiver`: `IDeviceActionReceiver` qui sera enregistré.

réinstaller le système en lecture seule

public void remountSystemReadOnly ()

Rendez la partition système de l'appareil en lecture seule. Peut redémarrer l'appareil.

Génère
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Rendez la partition système de l'appareil accessible en écriture. Peut redémarrer l'appareil.

Génère
`DeviceNotAvailableException`

réinstallerVendorReadOnly

public void remountVendorReadOnly ()

Définissez la partition du fournisseur sur l'appareil en lecture seule. Peut redémarrer l'appareil.

Génère
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Rendez la partition du fournisseur accessible en écriture sur l'appareil. Peut redémarrer l'appareil.

Génère
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Supprimer l'administrateur de l'appareil indiqué pour l'utilisateur concerné et renvoyer true si l'opération réussit, ou false dans le cas contraire.

Paramètres
`componentName`	`String`: de l'administrateur de l'appareil à supprimer.
`userId`	`int`: de l'utilisateur dans lequel réside l'administrateur de l'appareil.

Renvoie
`boolean`	"True" en cas de réussite, sinon "false".

Génère
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.

Génère
`DeviceNotAvailableException`

Supprimer l'utilisateur

public boolean removeUser (int userId)

Supprimer un utilisateur donné de l'appareil

Paramètres
`userId`	`int`: de l'utilisateur à supprimer

Renvoie
`boolean`	"true" si nous avons réussi à supprimer l'utilisateur, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

réinitialiserContentProviderSetup

public void resetContentProviderSetup ()

Réinitialisez l'indicateur de configuration du fournisseur de contenu afin de le déclencher de nouveau.

exécuterInstrumentationTests

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

Méthode pratique permettant d'exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) avec un ou plusieurs écouteurs transmis en tant que paramètres.

Paramètres
`runner`	`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` qui exécute les tests.
`listeners`	`ITestLifeCycleReceiver`: le ou les écouteurs des résultats du test.

Renvoie
`boolean`	`true` si la commande de test est terminée. `false` en cas d'échec terminée, mais la récupération a réussi

Génère
`DeviceNotAvailableException`

exécuterInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Exécute des tests d'instrumentation et permet de récupérer l'appareil.

Si la connexion à l'appareil est perdue avant la fin de l'exécution du test et que la récupération réussit, toutes les écouteurs seront informés de testRunFailed et "false" est renvoyé. La commande test ne seront pas réexécutées. Les appelants peuvent réessayer, si nécessaire.

Si la connexion à l'appareil est perdue avant la fin du test et que la récupération échoue, toutes les écouteurs seront informés de testRunFailed, et une exception DeviceNotAvailableException sera générée.

Paramètres
`runner`	`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` qui exécute les tests.
`listeners`	: écouteurs des résultats du test

Renvoie
`boolean`	`true` si la commande de test est terminée. `false` en cas d'échec terminée en raison d'une exception de communication de l'appareil, mais récupération réussie

Génère
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

Identique à ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), mais exécute le test pour l'utilisateur donné.

Paramètres
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

Identique à ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), mais exécute le test pour un utilisateur donné.

Paramètres
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

Définir une configuration

public void setConfiguration (IConfiguration configuration)

Il injecte les IConfiguration en cours d'utilisation.

Paramètres
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Paramètres
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Définit la date sur l'appareil

Remarque: Pour définir la date sur l'appareil, vous devez être en mode root

Paramètres
`date`	`Date`: spécifie une date particulière. utilisera la date de l'hôte si `null`

Génère
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Définissez un composant d'administrateur de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné.

Paramètres
`componentName`	`String`: pour que l'administrateur de l'appareil soit le propriétaire de l'appareil.
`userId`	`int`: correspond à l'utilisateur dans lequel réside le propriétaire de l'appareil.

Renvoie
`boolean`	"True" en cas de réussite, sinon "false".

Génère
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Mettez à jour l'état de l'appareil.

Paramètres
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Pour l'émulateur, définissez SizeLimitedOutputStream pour consigner la sortie.

Paramètres
`output`	`SizeLimitedOutputStream`: pour consigner la sortie

setEmulatorProcess

public void setEmulatorProcess (Process p)

Définit Process lorsque cet appareil est un émulateur.

Paramètres
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Définissez l'option fastboot pour l'appareil. Doit être défini lorsque l'appareil est le premier alloué.

Paramètres
`fastbootEnabled`	`boolean`: indique si fastboot est disponible pour l'appareil.

setFastbootPath

public void setFastbootPath (String fastbootPath)

Définit le chemin d'accès au binaire fastboot à utiliser. Pour que les fonctions fastboot soient activées, isFastbootEnabled() doit toujours être défini sur "true".

Paramètres
`fastbootPath`	`String`

Définir l'appareil

public void setIDevice (IDevice newDevice)

Mettez à jour l'IDevice associé à cet ITestDevice.

Le nouvel IDevice doit faire référence au même appareil physique que la référence actuelle. Cette méthode est appelé si DCM a alloué un nouvel appareil

Paramètres
`newDevice`	`IDevice`: `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Définit le délai d'attente, en millisecondes, avant de lancer la capture logcat pour un appareil en ligne.

Paramètres
`delay`	`int`: délai en ms.

Définir les options

public void setOptions (TestDeviceOptions options)

Définir le TestDeviceOptions pour l'appareil

Paramètres
`options`	`TestDeviceOptions`

Définir une propriété

public boolean setProperty (String propKey, 
                String propValue)

Définit la valeur de propriété donnée sur l'appareil. La valeur de la racine adb est "true".

Paramètres
`propKey`	`String`: clé ciblée à définir.
`propValue`	`String`: valeur de la propriété à définir.

Renvoie
`boolean`	renvoie `True` si la commande setprop a abouti et la valeur "False" dans le cas contraire.

Génère
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Définissez les IDeviceRecovery à utiliser pour cet appareil. Doit être défini lorsque l'appareil est le premier alloué.

Paramètres
`recovery`	`IDeviceRecovery`: `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Définissez le mode de récupération à utiliser pour l'appareil.

Permet de contrôler la méthode de récupération à utiliser en cas de problème de communication sur l'appareil rencontrés. Nous vous recommandons de n'utiliser cette méthode qu'avec parcimonie lorsque cela est nécessaire (par exemple, lorsque le framework est en panne, etc.

Paramètres
`mode`	`ITestDevice.RecoveryMode`: indique si la récupération doit être disponible en ligne uniquement. doit être activé ou non.

Définir un paramètre

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

Voir setSetting(int, String, String, String) et effectué sur l'utilisateur système.

Paramètres
`namespace`	`String`
`key`	`String`
`value`	`String`

Génère
`DeviceNotAvailableException`

Définir un paramètre

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

Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné. Certains paramètres ne seront disponibles après un redémarrage. L'espace de noms doit être l'un des suivants: {"system", "secure", "global"}

Paramètres
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Génère
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Il injecte l'instance ITestLogger.

Paramètres
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer l'appareil.

Paramètres
`trackingSerial`	`String`

setUseFastbootEffacer

public void setUseFastbootErase (boolean useFastbootErase)

Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.

Paramètres
`useFastbootErase`	`boolean`: `true` si l'effacement rapide doit être utilisé ou `false` si le format fastboot doit être utilisé.

startLogcat

public void startLogcat ()

Commencez à capturer la sortie logcat de l'appareil en arrière-plan.

N'aura aucun effet si la sortie logcat est déjà en cours de capture. Les données peuvent être récupérées ultérieurement via getLogcat.

Lorsque l'appareil n'est plus utilisé, stopLogcat() doit être appelé.

Normalement, startLogcat() et stopLogcat() n'ont pas besoin d'être appelés lorsque dans un contexte d'appel TF, car le framework TF démarre et arrête Logcat.

utilisateurdémarrer

public boolean startUser (int userId)

Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. Si l'utilisateur est déjà exécutée en arrière-plan, cette méthode est une opération NOOP.

Paramètres
`userId`	`int`: de l'utilisateur pour qu'il démarre en arrière-plan

Renvoie
`boolean`	est défini sur "true" si l'utilisateur a démarré en arrière-plan.

Génère
`DeviceNotAvailableException`

utilisateurdémarrer

public boolean startUser (int userId, 
                boolean waitFlag)

Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. Si l'utilisateur est déjà exécutée en arrière-plan, cette méthode est une opération NOOP. Possibilité de fournir un indicateur supplémentaire à attendre l'opération à prendre en compte.

Paramètres
`userId`	`int`: de l'utilisateur pour qu'il démarre en arrière-plan
`waitFlag`	`boolean`: la commande attend que l'utilisateur soit démarré et déverrouillé.

Renvoie
`boolean`	est défini sur "true" si l'utilisateur a démarré en arrière-plan.

Génère
`DeviceNotAvailableException`

startVisibleBackgroundUser

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

Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui signifie que l'utilisateur pour lancer des activités sur cet affichage).

REMARQUE : Cette commande ne vérifie pas si l'utilisateur existe, si l'affichage est disponible, device supports such feature, etc.

Paramètres
`userId`	`int`: de l'utilisateur pour qu'il démarre en arrière-plan
`displayId`	`int`: afficher pour que l'utilisateur soit visible sur
`waitFlag`	`boolean`: la commande attend que l'utilisateur soit démarré et déverrouillé.

Renvoie
`boolean`	`true` si l'utilisateur a bien été démarré et visible en arrière-plan

Génère
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Fermez et supprimez la sortie de l'émulateur.

stopLogcat

public void stopLogcat ()

Arrêtez la capture de la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.

N'aura aucun effet si la sortie logcat n'est pas capturée.

utilisateur stop

public boolean stopUser (int userId)

Arrête un utilisateur donné. Si l'utilisateur est déjà arrêté, cette méthode est NOOP. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.

Paramètres
`userId`	`int`: de l'utilisateur à arrêter.

Renvoie
`boolean`	La valeur est définie sur "true" si l'utilisateur a bien été arrêté.

Génère
`DeviceNotAvailableException`

utilisateur stop

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

Arrêter un utilisateur donné. Possibilité de fournir des indicateurs supplémentaires pour attendre que l'opération prenne effet. et forcer l'arrêt de l'utilisateur. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.

Paramètres
`userId`	`int`: de l'utilisateur à arrêter.
`waitFlag`	`boolean`: la commande attend que l'utilisateur s'arrête.
`forceFlag`	`boolean`: force l'arrêt de l'utilisateur.

Renvoie
`boolean`	La valeur est définie sur "true" si l'utilisateur a bien été arrêté.

Génère
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Basculez l'appareil en mode adb-over-tcp.

Renvoie
`String`	Numéro de série du tcp ou `null` si l'appareil n'a pas pu être changé

Génère
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Basculez l'appareil en mode adb via USB.

Renvoie
`boolean`	`true` si le changement a réussi, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`

contacteur

public boolean switchUser (int userId)

Passez à un autre ID utilisateur avec un délai d'inactivité par défaut. switchUser(int, long).

Paramètres
`userId`	`int`

Renvoie
`boolean`	"True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false".

Génère
`DeviceNotAvailableException`

contacteur

public boolean switchUser (int userId, 
                long timeout)

Passez à un autre ID utilisateur avec le délai d'expiration fourni comme délai. Tentative de désactivation du verrouillage du clavier une fois la modification de l'utilisateur effectuée.

Paramètres
`userId`	`int`
`timeout`	`long`: attendre la valeur "false" avant de renvoyer la valeur "false" pour l'utilisateur switch-user.

Renvoie
`boolean`	"True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false".

Génère
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Synchronise de manière incrémentielle le contenu d'un répertoire de fichiers local sur l'appareil.

Il décide des fichiers à transférer en comparant les codes temporels des fichiers locaux avec ceux du fichier équivalents. "plus récents" uniquement ou inexistants seront transférés sur l’appareil. Par conséquent, doit être relativement petite si le fichier installé sur l'appareil est déjà à jour.

Les fichiers masqués (dont le nom commence par ".") sont ignorés.

Exemple d'utilisation: syncFiles("/tmp/files", "/sdcard") crée un répertoire /sdcard/files si il n'existe pas encore et il transfère le contenu de /tmp/files de manière récursive vers /sdcard/files.

Paramètres
`localFileDir`	`File`: répertoire de fichiers local contenant les fichiers à transférer de manière récursive.
`deviceFilePath`	`String`: racine du chemin d'accès absolu au fichier de destination à distance Tous les répertoires qu'il contient le chemin d'accès au fichier doit être lisible. Par exemple, transfert vers /data/local/tmp lorsqu'adb n'est pas racine échouera

Renvoie
`boolean`	`true` si les fichiers ont bien été synchronisés. `false` dans les autres cas.

Génère
`DeviceNotAvailableException`

TakeBugreport

public Bugreport takeBugreport ()

Créez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer. Valeur nulle en cas de problème. Le fichier référencé dans l'objet Bugreport doit être nettoyé via Bugreport.close().

Renvoie
`Bugreport`

désinstaller le package

public String uninstallPackage (String packageName)

Désinstaller un package Android de l'appareil

Paramètres
`packageName`	`String`: package Android à désinstaller

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`

désinstallerPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Désinstallez un package Android de l'appareil d'un utilisateur donné.

Paramètres
`packageName`	`String`: package Android à désinstaller
`userId`	`int`: ID utilisateur entier pour lequel désinstaller.

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`

déverrouiller l'appareil

public boolean unlockDevice ()

Déverrouille l'appareil s'il est chiffré.

Cette méthode peut redémarrer le framework, mais n'appellera pas postBootSetup(). Par conséquent, l'appareil risque de ne pas être entièrement prêt à être testé lorsque cette méthode sera renvoyée.

Renvoie
`boolean`	`true` en cas de réussite ou si l'appareil n'est pas chiffré.

Génère
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Désinstallez debugfs.

Génère
`DeviceNotAvailableException`

WaitForBootComplete

public boolean waitForBootComplete (long timeOut)

Bloque jusqu'à ce que l'indicateur de démarrage terminé de l'appareil soit défini.

Paramètres
`timeOut`	`long`: temps d'attente, exprimé en ms, pour que l'indicateur soit défini.

Renvoie
`boolean`	"true" si l'indicateur de démarrage terminé de l'appareil est défini dans le délai imparti

Génère
`DeviceNotAvailableException`

WaitForDeviceAvailable

public boolean waitForDeviceAvailable ()

Attend que l'appareil réponde et soit disponible pour des tests. Utilise le délai d'inactivité par défaut.

Renvoie
`boolean`	"True" si l'appareil est disponible, "False" si la récupération est désactivée et indisponible.

Génère
`DeviceNotAvailableException`

WaitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

Attend que l'appareil réponde et soit disponible pour des tests.

Paramètres
`waitTime`	`long`: temps d'attente en ms.

Renvoie
`boolean`	"True" si l'appareil est disponible, "False" si la récupération est désactivée et indisponible.

Génère
`DeviceNotAvailableException`

WaitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération.

Paramètres
`waitTime`	`long`

Renvoie
`boolean`	"True" si l'appareil est disponible, "False" s'il n'est pas disponible.

Génère
`DeviceNotAvailableException`

WaitForDeviceBootloader

public void waitForDeviceBootloader ()

Bloque jusqu'à ce que l'appareil soit visible en fastboot. Utiliser le délai avant expiration par défaut.

Génère
`DeviceNotAvailableException`

WaitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Blocs pour que l'appareil soit dans la récupération adb (notez qu'il ne s'agit pas IDeviceRecovery).

Paramètres
`waitTime`	`long`: temps d'attente en ms.

Renvoie
`boolean`	`true` si la récupération de l'appareil est lancée avant l'expiration du délai. `false` dans les autres cas

WaitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Blocs pour que l'appareil soit dans le téléchargement indépendant adb état

Paramètres
`waitTime`	`long`: temps d'attente en ms.

Renvoie
`boolean`	`true` si l'appareil démarre en téléchargement indépendant avant l'expiration du délai. `false` dans les autres cas

WaitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Blocages pour que l'appareil soit indisponible, c'est-à-dire absent d'adb

Paramètres
`waitTime`	`long`: temps d'attente en ms.

Renvoie
`boolean`	`true` si l'appareil n'est plus disponible avant l'expiration du délai. `false` dans les autres cas

WaitForDeviceOnline

public void waitForDeviceOnline ()

Bloque jusqu'à ce que l'appareil soit visible via adb. Utilise le délai d'inactivité par défaut

Notez que l'appareil ne répond pas nécessairement aux commandes une fois l'opération terminée. Utilisez waitForDeviceAvailable() à la place.

Génère
`DeviceNotAvailableException`

WaitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Bloque jusqu'à ce que l'appareil soit visible via adb.

Notez que l'appareil ne répond pas nécessairement aux commandes une fois l'opération terminée. Utilisez waitForDeviceAvailable() à la place.

Paramètres
`waitTime`	`long`: temps d'attente en ms.

Génère
`DeviceNotAvailableException`

WaitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

Attend que l'appareil réponde à une commande adb shell de base.

Paramètres
`waitTime`	`long`: temps d'attente en ms.

Renvoie
`boolean`	`true` si l'appareil devient réactif avant que `waitTime` ne se soit écoulé.

Méthodes protégées

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Paramètres
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Crée la commande OS pour la session de commande shell adb et les arguments donnés.

Paramètres
`command`	`String`
`forceExitStatusDetection`	`boolean`

Renvoie
`String[]`

checkApiLevelA par rapport à

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

Paramètres
`feature`	`String`
`strictMinLevel`	`int`

createRedémarrerDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

Créez un RebootDeviceAction à utiliser lors d'une action de redémarrage.

Paramètres
`rebootMode`	`NativeDevice.RebootMode`: mode de ce redémarrage.
`reason`	`String`: pour ce redémarrage.

Renvoie
`NativeDevice.RebootDeviceAction`	le `RebootDeviceAction` créé.

createRunUtil

protected IRunUtil createRunUtil ()

Renvoie
`IRunUtil`

doAdbRedémarrer

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Effectuez un redémarrage adb.

Paramètres
`rebootMode`	`NativeDevice.RebootMode`: mode de ce redémarrage.
`reason`	`String`: pour ce redémarrage.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Assurez-vous que les autorisations d'exécution sont prises en charge

protected void ensureRuntimePermissionSupported ()

Méthode d'assistance permettant de générer une exception si l'autorisation d'exécution n'est pas prise en charge

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

Renvoie
`int`

getLogger

protected ITestLogger getLogger ()

Renvoie
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Obtenez l'instance RunUtil à utiliser.

Renvoie
`IRunUtil`

Initialiser la connexion

protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

Paramètres
`info`	`IBuildInfo`
`attributes`	`MultiMap`

Génère
`DeviceNotAvailableException`
`TargetSetupError`

interneGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Récupère une propriété d'appareil, à partir du cache ddmlib par défaut, et en revenant à adb shell getprop" ou "fastboot getvar", selon que l'appareil est en Fastboot ou non.

Paramètres
`propName`	`String`: nom de la propriété de l'appareil renvoyé par "adb shell getprop"
`fastbootVar`	`String`: nom de la variable fastboot équivalente à interroger. si `null`, la requête fastboot ne sera pas tentée
`description`	`String`: description simple de la variable. La première lettre doit être en majuscule.

Renvoie
`String`	Chaîne (éventuellement `null` ou vide) contenant la valeur de la propriété donnée

Génère
`DeviceNotAvailableException`

isInRedémarrerCallback

protected boolean isInRebootCallback ()

Indique si des rappels de redémarrage sont en cours d'exécution ou non. Toutes les API publiques pour le redémarrage doit être désactivé si la valeur est "true".

Renvoie
`boolean`

isNewer (Plus récent)

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Renvoie true si le fichier local est plus récent que le fichier distant. IFileEntry étant à la minute près, le fichier est considéré comme plus récent, même si les heures sont égales.

Paramètres
`localFile`	`File`
`entry`	`IFileEntry`

Renvoie
`boolean`

VerifyRedémarrerEnded

protected void notifyRebootEnded ()

Notifie toutes les IDeviceActionReceiver de l'événement de fin de redémarrage.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

VerifyRedémarrerStarted

protected void notifyRebootStarted ()

Notifie toutes les IDeviceActionReceiver de l'événement de début de redémarrage.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performanceDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Effectue une action sur cet appareil. L'appareil tente de récupérer l'appareil et peut éventuellement relancer la commande si l'opération échoue.

Paramètres
`actionDescription`	`String`: brève description de l'action à effectuer. Utilisé pour la journalisation uniquement.
`action`	`NativeDevice.DeviceAction`: action à effectuer
`retryAttempts`	`int`: la nouvelle tentative tente d'effectuer l'action en cas d'échec, mais la récupération réussit.

Renvoie
`boolean`	`true` si l'action a bien été effectuée

Génère
`DeviceNotAvailableException`	si la tentative de récupération échoue ou si le nombre maximal de tentatives est atteint sans succès

postAdbRedémarrer

protected void postAdbReboot ()

Actions supplémentaires possibles après un redémarrage.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

configuration prePostBoot

protected void prePostBootSetup ()

Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

Paramètres
`remoteFilePath`	`String`
`localFile`	`File`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

régler l'horloge

protected void setClock (Clock clock)

Définissez l'instance Clock à utiliser.

Paramètres
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marque l'appareil TestDevice comme microdroid et définit son numéro client.

Paramètres
`process`	`Process`: processus de la VM Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Paramètres
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Exécute une commande fastboot simple avec des variables d'environnement et indique l'état du .

Paramètres
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

Renvoie
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Exécute une commande fastboot simple et indique l'état de la commande.

Paramètres
`timeout`	`long`
`fullCmd`	`String`

Renvoie
`CommandResult`

WaitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Attendez que l'appareil devienne indisponible (arrêtez de signaler à adb).

Paramètres
`operationDesc`	`String`: nom de l'opération en attente d'indisponibilité.
`time`	`long`: délai d'attente avant l'indisponibilité.

Renvoie
`boolean`	"True" si l'appareil est devenu indisponible.

Appareil natif

Résumé

Classes imbriquées

Constantes

Champs

Constructeurs publics

Méthodes publiques

Méthodes protégées

Constantes

ID_UTILISATEUR_NON_VALIDE

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Champs

CHEMIN_DEBUGFS

CARTE_SD

STOCKAGE_ÉMULÉ

Options mobiles

mStateMonitor

Constructeurs publics

Appareil natif

Méthodes publiques

batchPrefetchStartupBuildProps

CanSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

vérifier la connectivité

ClearErrorDialogs

ClearLastConnectedWifiNetwork

ClearLogcat

se connecter au réseauWi-Fi

se connecter au réseauWi-Fi

se connecter au réseauWi-Fi

se connecter au réseauWi-Fi

ConnectToWifiNetworkIfNeeded

ConnectToWifiNetworkIfNeeded

créerutilisateur

créerutilisateur

créerutilisateur

créerUtilisateurPasDeJeter

Supprimer le fichier

Supprimer le fichier

deregisterDeviceActionReceiver

appareilSoftRedémarré

deviceSoftRestartedSince

désactiverAdbRoot

désactiver la protection des touches

désactiver MoniteurRéseau

déconnecter du Wifi

doesFileExist

doesFileExist

tas de mémoire

enableAdbRoot

enableNetworkMonitor

exécuterAdbCommand

exécuterAdbCommand

exécuterAdbCommand

exécuterFastbootCommand

exécuterFastbootCommand

ExécuterLongFastbootCommand

ExécuterLongFastbootCommand

exécuterShellCommand

exécuterShellCommand

exécuterShellCommand

exécuterShellCommand

ExécuterShellV2Command

ExécuterShellV2Command

ExécuterShellV2Command

ExécuterShellV2Command

ExécuterShellV2Command

ExécuterShellV2Command

ExécuterShellV2Command

fastbootEffacerPartition

GetActiveApexes

getTous les paramètres

getAllocationState

getAndroidId

getAndroidIds

niveau getApi

getAppPackageInfo

getAppPackageInfos

getBasebandVersion