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

Appareil natif

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, 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	Appareil s'exécutant dans une machine virtuelle que nous gérons à distance via une instance Tradefed dans 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 s'exécutant dans 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 exécuter une commande d'OS "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 chacun d'eux.
`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 ne se connecte que si l'appareil ne dispose actuellement pas d'une connectivité réseau.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Variante de `connectToWifiNetwork(String, String)` qui ne se connecte que si l'appareil ne dispose actuellement pas d'une 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 indicateurs par défaut de 0.
`int`	`createUserNoThrow(String name)` Créez un utilisateur avec un nom donné et les indicateurs 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 de l'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 deux 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 des variables d'environnement système.
`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 la valeur 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 et le motif de démarrage depuis 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 libération (contrôlées par des fabricants d'appareils individuels).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Renvoie une valeur `DeviceDescriptor` mise en cache si l'appareil est alloué. Sinon, renvoie la valeur `DeviceDescriptor` actuelle.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Renvoie une valeur `DeviceDescriptor` mise en cache si l'appareil est alloué. Sinon, renvoie la valeur `DeviceDescriptor` actuelle.
`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 transmettre l'objet d'appareil réel.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Renvoyez un `DeviceDescriptor` à partir des informations de l'appareil pour obtenir des informations le concernant sans transmettre l'objet d'appareil réel.
`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, comme 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 du point de montage spécifié, ou `null` si ce chemin n'est installé sur aucun élément ou n'apparaît pas dans /proc/mounts en tant que 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 les commandes "pidof" et "stat", et renvoie l'objet `ProcessInfo` avec le PID et l'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.
	`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 à un nouvel état d'allocation.
`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()` Renvoyez 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 ne peut pas être supprimé ni rétrogradé vers un statut 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é 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()` Collectez 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 le consigner pour les reporters.
`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, puis l'affiche lorsque la commande est terminée et lorsque l'appareil n'est plus visible par adb.
`void`	`postAdbRootAction()` À remplacer si l'appareil nécessite des actions spécifiques après la racine adb et avant qu'il ne soit de nouveau en ligne.
`void`	`postAdbUnrootAction()` À remplacer si l'appareil nécessite des actions spécifiques après le retrait d'adb et avant qu'il ne soit de nouveau en ligne.
`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 appareil spécifique nécessitaient un nettoyage qui sera exécuté une fois l'appel 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 processus 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 et renvoie cet `File`.
`File`	`pullFile(String remoteFilePath)` Récupère un fichier depuis l'appareil, le stocke dans un `ERROR(/File)` temporaire local et renvoie cet `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, de le stocker dans un `ERROR(/File)` temporaire local et de 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és.
`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 la nécessité 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()` Alternative à `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`	`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)` Lance un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui permet à l'utilisateur de lancer des activités sur cet écran).
`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 à l'état "adb recovery" (notez qu'il est différent de `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocs pour que l'appareil soit à l'état "Téléchargement indépendant adb"
`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 pour 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, 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 de la commande.
`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 : 5 000 (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 chacun d'eux. 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 appellent tous "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 futurs appels. C'est ce que nous faisons un peu plus tôt. Si l'appareil est en cours de récupération ou si d'autres erreurs se produisent lors de la récupération des accessoires, nous les ignorons simplement.

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. Cette méthode prend en compte les fonctionnalités non publiées jusqu'à présent, 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 l'appareil dispose d'une connexion réseau opérationnelle, `false` en cas de connexion réseau.

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é. Cette méthode doit être appelée lors du démarrage d'un nouvel appel pour éviter de se 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 pour vous assurer que ITestDevice#getLogcat() ne renvoie que les données de journal générées après un certain point (par exemple, après avoir flashé un nouveau build d'appareil).

se connecter au réseauWi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecte à un réseau Wi-Fi.

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

Paramètres
`wifiSsidToPsk`	: mappage des SSID Wi-Fi aux 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` dans les autres cas

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 tente de la restaurer après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit 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` dans les autres cas

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 aux mots de passe.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` dans les autres cas

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` dans les autres cas

Génère
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

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

Variante de connectToWifiNetwork(String, String) qui ne se connecte que si l'appareil ne dispose actuellement pas d'une 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` dans les autres cas

Génère
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` dans les autres cas

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`	identifiant 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`	identifiant 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 indicateurs 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 indicateurs 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 de l'appareil et son ERROR(/TimeUnit). Le terme "redémarrage à chaud" fait référence à "system_server" redémarré en dehors d'un redémarrage matériel de l'appareil (par exemple, un redémarrage demandé). L'utcEpochTime de l'appareil actuel dans Milliseccond peut être obtenu à 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 sera bloquée jusqu'à ce que l'appareil soit 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 la distribution des entrées soit prête. Cela se produit à peu près au même moment lorsque l'appareil indique BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework présente une condition de concurrence occasionnelle. La commande est ensuite envoyée pour désactiver la protection du clavier (ne fonctionne que sur les éléments 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 a échoué.

Génère
`DeviceNotAvailableException`

DoFileExist

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`

DoFileExist

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 effectuer le vidage du 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 le paramètre "enable-root" est défini sur "false", un message est consigné et le résultat est renvoyé sans activer le mode root.

L'activation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode sera bloquée jusqu'à ce que l'appareil soit 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 cette méthode améliore 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 l'absence de délai d'inactivité.
`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 cette méthode améliore 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 l'absence de délai d'inactivité.
`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 cette méthode améliore 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 deux 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 des variables d'environnement système.

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ée à ne générer aucune réponse ; unité spécifiée dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions `retryAttempts` sont exécuté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ée dans `timeUnit`)
`maxTimeToOutputShellResponse`	`long`: durée maximale pendant laquelle la commande est autorisée à ne générer aucune réponse ; unité spécifiée dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions `retryAttempts` sont exécutées 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.

Forme plus simple de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) avec des 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)

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

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ée dans `timeUnit`)
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions `retryAttempts` sont exécutées 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ée 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ée dans `timeUnit`)
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions `retryAttempts` sont exécutées 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ée dans `timeUnit`)
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions `retryAttempts` sont exécutées 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 prochain démarrage. 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. Rien ne garantit que chaque ID utilisateur trouvera un ID Android associé à cette fonction. Par conséquent, certains ID utilisateur peuvent correspondre à la valeur "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. L'obtention de la version radio est spécifique à chaque appareil. Par conséquent, il est possible qu'elle ne renvoie pas les bonnes informations pour tous les appareils. Cette méthode repose sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Cette valeur n'est pas exacte pour certains appareils CDMA. Il est possible que la version renvoyée ici ne corresponde pas à celle indiquée par fastboot et qu'elle ne renvoie pas toujours la version du signal radio CDMA. Résumé de cette méthode uniquement si la propriété gsm.version.baseband est 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 aucune radio 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é présente la valeur `"1"`, `"y"`, `"yes"`, `"on"` ou `"true"`, `false` si la valeur de la propriété est `"0"`, `"n"`, `"no"`, `"off"`, `"false"` ou `defaultValue` dans le cas contraire.

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 et le motif de démarrage depuis le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée. La valeur utcEpochTime actuelle de l'appareil en millisecondes peut être obtenue à l'aide de 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. (par exemple, 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 sur lequel 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. En cas d'échec, `InputStreamSource` génère une `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 d'adb > 1.0.36

Renvoie
`InputStreamSource`	Une `InputStreamSource` du fichier ZIP contenant bugreportz, qui renvoie la valeur "null" 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 build est généralement une chaîne plus lisible que l'ID de build (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 à l'ID 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 libération (contrôlées 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 une valeur DeviceDescriptor mise en cache si l'appareil est alloué. Sinon, renvoie la valeur DeviceDescriptor actuelle.

Renvoie
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Renvoie une valeur DeviceDescriptor mise en cache si l'appareil est alloué. Sinon, renvoie la valeur DeviceDescriptor actuelle.

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

Renvoie
`DeviceDescriptor`

Enfants

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 transmettre l'objet d'appareil réel.

Renvoie
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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é. Utilisez 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. Dans ce cas, il s'agit d'une variante un peu plus sûre que la méthode générique getProductType(), car ITestDevice saura qu'il faut restaurer l'appareil en fastboot si l'état est incorrect ou s'il 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" en cas de problème.

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 à "/". (Les syntaxes "/system" et "system" sont toutes les deux acceptées.)

Renvoie
`IFileEntry`	`IFileEntry` ou `null` si le fichier `path` indiqué est introuvable

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. Correctif: Refactorisez le système 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".

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 DCM chaque fois que l'appareil se déconnecte et se reconnecte d'adb. Les appelants ne doivent donc pas conserver 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, 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 du verrouillage du clavier et qui renvoie la valeur "Null" si la requête de protection du clavier n'est pas compatible.

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, comme 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 en cours de capture en arrière-plan, cette fonction renvoie jusqu'à TestDeviceOptions.getMaxLogcatDataSize() octets du contenu actuel de la capture en arrière-plan.

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 perte d'espace disque potentiellement importante liée à l'obtention de l'instantané getLogcat() complet.

Paramètres
`maxBytes`	`int`: quantité maximale de données à renvoyer. Il doit s'agir d'une quantité pouvant tenir facilement en 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é si la capture des données logcat échoue.

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 de l'appareil doit être utilisée 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)` modules principaux sur `String` actuellement installés 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 la valeur "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 du point de montage spécifié, ou null si ce chemin n'est installé sur aucun élément ou n'apparaît pas dans /proc/mounts en tant que 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 les commandes "pidof" et "stat", et renvoie l'objet ProcessInfo avec le PID et l'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`	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 accepter les options "formater" 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 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 getScreenshot(String) à la place avec l'encodage JPEG pour réduire la taille.

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 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`	Un élément `InputStreamSource` de la capture d'écran au format PNG, ou `null` en cas d'échec de la capture d'écran.

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`	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. Si un tombstone ne parvient pas à être extrait pour une raison quelconque, il sera absent de la liste. Seul un DeviceNotAvailableException met fin à la méthode plus tôt que prévu.

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`

getDésinstallerablePackageNames

public  getUninstallablePackageNames ()

Récupérez les noms des packages d'application qui peuvent être désinstallés. Actuellement, il s'agit de packages non-système et de packages système mis à jour.

Renvoie
	`ERROR(/Set)` des noms de packages `String` pouvant être désinstallés actuellement installés sur l'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 utilisé.

getUserFlags

public int getUserFlags (int userId)

Rechercher et renvoyer les indicateurs d'un utilisateur donné Les indicateurs sont définis dans la classe "android.content.pm.UserInfo" du 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é. Peut faire passer l'appareil au nouvel état. Informer IDeviceMonitor de toute transition d'état.

Traiter DeviceEvent, qui peut ou non faire passer cet appareil à un nouvel état d'allocation.

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 doit correspondre directement à "feature:" ou "".

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. Consultez "adb shell pm -h" pour connaître les options disponibles.

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: Cette fonction n'est appelée que pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation.

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. Consultez "adb shell pm -h" pour connaître les options disponibles.

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. Consultez "adb shell pm -h" pour connaître les options disponibles.

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: Cette fonction n'est appelée que pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation.

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. Consultez "adb shell pm -h" pour connaître les options disponibles.

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 à faible valeur de contournement 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 ()

Renvoyez 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 ne peut pas être supprimé ni rétrogradé vers un statut 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é pour cet utilisateur.

Paramètres
`packageName`	`String`: le package dont nous vérifions s'il est installé.
`userId`	`String`: ID utilisateur pour lequel nous vérifions que le package est installé. Si la valeur est nulle, l'utilisateur principal zéro est 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 utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et qui peut donc lancer des activités (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 utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et qui peut donc lancer des activités sur cet écran.

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

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 devrait 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 les tests qui ne doivent pas s'exécuter avec le Wi-Fi, comme 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 ()

Collectez 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 renvoyée si le résultat 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`	La valeur est "true" si la journalisation a réussi, ou "false" dans le cas contraire.

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 le consigner pour les reporters.

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

Renvoie
`boolean`	La valeur est "true" si la journalisation a réussi, ou "false" dans le cas contraire.

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 en cas d'échec de la journalisation.

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`

nonBlocageRedémarrer

public void nonBlockingReboot ()

Émet une commande pour redémarrer l'appareil, puis l'affiche lorsque la commande est terminée et lorsque l'appareil n'est 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 qu'il ne soit de nouveau en ligne. 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 qu'il ne soit de nouveau en ligne. 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 temps normal, cette méthode n'a pas besoin d'être appelée explicitement, car les implémentations doivent effectuer ces étapes automatiquement lors d'un redémarrage.

Elle peut avoir besoin d'être appelée lorsque l'appareil redémarre en raison d'autres événements (par exemple, lorsqu'une commande de mise à jour fastboot est terminée).

Génère
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Des étapes supplémentaires pour un appareil spécifique nécessitaient un nettoyage qui sera exécuté une fois l'appel 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 processus 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 cette valeur n'est pas vide, le contenu est 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 et renvoie cet 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 élément `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si la copie a échoué pour une raison quelconque (y compris en cas de problème 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 et renvoie cet File.

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

Renvoie
`File`	Un élément `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si la copie a échoué pour une raison quelconque (y compris en cas de problème 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 cette valeur n'est pas vide, le contenu est 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 élément `String` contenant le contenu du fichier de l'appareil, ou `null` si la copie a échoué pour une raison quelconque (y compris en cas de problème 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, de le stocker dans un ERROR(/File) temporaire local et de renvoyer une référence à ce File.

Paramètres
`remoteFilePath`	`String`: chemin d'accès au fichier sur l'appareil, par rapport au point d'installation du stockage externe de l'appareil

Renvoie
`File`	Un élément `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si la copie a échoué pour une raison quelconque (y compris en cas de problème 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és.

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 la nécessité 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 ()

Alternative à 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 le début d'une action sur l'appareil et à la fin de cette action.

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` si l'exécution a échoué, mais que 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, tous les écouteurs sont informés de l'événement testRunFailed, et la valeur "false" est renvoyée. La commande de test ne sera pas réexécutée. Les appelants peuvent réessayer, si nécessaire.

Si la connexion à l'appareil est perdue avant la fin de l'exécution du test et que la récupération échoue, tous les écouteurs sont informés de testRunFailed, et une exception DeviceNotAvailableException est 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` si l'opération a échoué en raison d'une exception de communication de l'appareil, mais que la récupération a réussi

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. La date de l'hôte sera utilisée 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 lors de la première allocation de l'appareil.

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ée 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`: retard 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 lors de la première allocation de l'appareil.

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 avec l'appareil. Nous vous recommandons de n'utiliser cette méthode qu'avec parcimonie en cas de besoin (par exemple, lorsque le framework est indisponible, etc.).

Paramètres
`mode`	`ITestDevice.RecoveryMode`: indique si le mode de récupération 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 qu'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`

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 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 s'exécute déjà 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 s'exécute déjà en arrière-plan, cette méthode est une opération NOOP. Possibilité de fournir un indicateur supplémentaire pour attendre que l'opération prenne effet.

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)

Lance un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui permet à l'utilisateur de lancer des activités sur cet écran).

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`

changer d'utilisateur

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`

changer d'utilisateur

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.

Décide les fichiers à transférer en comparant les horodatages des fichiers locaux avec leurs équivalents distants. Seuls les fichiers "nouveaux" ou inexistants seront transférés vers l'appareil. La surcharge devrait donc être relativement faible si les fichiers définis sur l'appareil sont 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 s'il n'existe pas déjà, et transfère le contenu du fichier /tmp/files vers /sdcard/files de manière récursive.

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 de ce chemin de fichier doivent être lisibles. C'est-à-dire que le fait de transférer vers /data/local/tmp lorsque adb n'est pas la 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. Renvoyez la valeur "null" 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 peut ne pas être entièrement prêt à être testé lorsque cette méthode est 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 avant expiration

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 à l'état "adb recovery" (notez qu'il est différent de 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 à l'état "Téléchargement indépendant adb"

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 plutôt waitForDeviceAvailable().

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 plutôt waitForDeviceAvailable().

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 pour 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, 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 la valeur est `null`, aucune tentative de requête fastboot n'est effectué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 doivent être désactivées 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 précis à la minute près, le fichier sera considéré comme plus récent en cas d'heures é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 vous pouvez éventuellement relancer la commande si l'action échoue.

Paramètres
`actionDescription`	`String`: brève description de l'action à effectuer. Utilisé à des fins de 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 a échoué.

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 de la commande.

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

DoFileExist

DoFileExist

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