À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

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

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

Sous-classes directes connues

TestDevice

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

Sous-classes indirectes connues

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	Classe des appareils virtuels locaux exécutés sur l'hôte TradeFed.
ManagedRemoteDevice	Appareil exécuté dans une machine virtuelle que nous gérons à distance via une instance Tradefed dans la VM.
NestedRemoteDevice	Représentation de l'appareil exécuté dans une VM Cuttlefish distante.
RemoteAndroidDevice	Implémentation d'un `ITestDevice` pour un appareil Android à pile complète connecté via une connexion ADB.
RemoteAndroidVirtualDevice	Élargit le comportement de `RemoteAndroidDevice` pour un appareil Android à pile complète exécuté dans Google Compute Engine (GCE).

Implémentation par défaut d'une ITestDevice pour les appareils Android non complets.

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 ou introuvable: UserHandle a défini la valeur -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` Nombre par défaut de tentatives de nouvelle exécution de la commande

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 objet `TestDevice`.

Méthodes publiques
`void`	`batchPrefetchStartupBuildProps()` Micro-optimisation (environ 400 millisecondes) en préchargeant tous les composants dont nous avons besoin au lieu d'appeler "adb getprop" pour chacun d'eux.
`boolean`	`canSwitchToHeadlessSystemUser()` Indique si l'utilisateur système headless est autorisé à passer à l'utilisateur système headless.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Vérifiez si une fonctionnalité est actuellement compatible avec un niveau minimal.
`boolean`	`checkConnectivity()` Vérifiez que l'appareil dispose d'une connexion réseau.
`boolean`	`clearErrorDialogs()` Essayez de fermer les boîtes de dialogue d'erreur actuellement affichées dans l'interface utilisateur de l'appareil.
`void`	`clearLastConnectedWifiNetwork()` Supprime le dernier réseau Wi-Fi auquel l'appareil s'est connecté.
`void`	`clearLogcat()` Supprime toutes les données Logcat accumulées.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Se connecter à un réseau Wi-Fi
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Se connecter à un réseau Wi-Fi
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Se connecter à un réseau Wi-Fi
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Se connecter à 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 n'est pas actuellement connecté au réseau.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Variante de `connectToWifiNetwork(String, String)` qui ne se connecte que si l'appareil n'est pas actuellement connecté au 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 des indicateurs par défaut de 0.
`int`	`createUserNoThrow(String name)` Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Inspectez un appareil et renvoyez des informations détaillées lorsqu'il n'est plus disponible.
`void`	`deleteFile(String deviceFilePath, int userId)` Méthode d'assistance pour supprimer un fichier ou un répertoire sur l'appareil.
`void`	`deleteFile(String deviceFilePath)` Méthode d'assistance pour supprimer un fichier ou un répertoire sur l'appareil.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Supprime l'`IDeviceActionReceiver` enregistrée.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Méthode d'assistance permettant de vérifier si l'appareil a redémarré en mode logiciel en comparant le système_server actuel au système_server précédent `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Méthode d'assistance permettant de vérifier si l'appareil a redémarré en mode logiciel depuis l'heure UTC depuis l'epoch de l'appareil et de son `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Désactive l'accès root ADB.
`void`	`disableKeyguard()` Tentative de désactivation 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 existe sur l'appareil 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)` Tentative de vidage de la pile à partir de system_server.
`boolean`	`enableAdbRoot()` Active le mode root 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 avant 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 avant 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 avant expiration 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 la sortie sous forme de `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus 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 plus de paramètres pour contrôler le comportement de la commande.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Exécute la commande d'interface système adb donnée, en réessayant plusieurs fois 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 `CommandResult` correctement renseigné avec la sortie d'é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 `CommandResult` correctement renseigné avec la sortie d'état de la commande et stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Méthode d'assistance qui exécute une commande d'interface système adb et renvoie les résultats sous la forme d'un `CommandResult` correctement renseigné avec la sortie d'état de la commande, stdout et stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus 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 plus 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 plus 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 plus de paramètres pour contrôler le comportement de la commande.
`CommandResult`	`fastbootWipePartition(String partition)` Méthode d'assistance qui efface une partition pour 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()` Afficher l'état d'allocation actuel de l'appareil
`String`	`getAndroidId(int userId)` Recherchez et renvoyez l'android-id associé à un userId. Si aucun n'est trouvé, renvoyez la valeur "null".
	`getAndroidIds()` Créez une carte des ID Android correspondant aux ID utilisateur.
`int`	`getApiLevel()` Obtenez le niveau d'API de l'appareil.
`PackageInfo`	`getAppPackageInfo(String packageName)` Récupérez des informations sur un package installé sur l'appareil.
	`getAppPackageInfos()` Récupérez les informations sur les packages installés sur l'appareil.
`String`	`getBasebandVersion()` Méthode pratique permettant d'obtenir la version de 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 de la propriété donnée.
	`getBootHistory()` La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure et la raison du démarrage.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage depuis l'heure donnée depuis l'épokhe de l'appareil et l'unité de temps spécifiée.
`String`	`getBootloaderVersion()` Méthode pratique pour obtenir la version du bootloader de cet appareil.
`InputStreamSource`	`getBugreport()` Récupère un rapport de bug à partir de l'appareil.
`InputStreamSource`	`getBugreportz()` Récupère un bugreportz à partir de l'appareil.
`String`	`getBuildAlias()` Récupérez l'alias de la version actuellement exécutée sur l'appareil.
`String`	`getBuildFlavor()` Récupérez la saveur de compilation de l'appareil.
`String`	`getBuildId()` Récupérez la version actuellement exécutée sur l'appareil.
`String`	`getBuildSigningKeys()` Renvoie le type de clé utilisé pour signer l'image de l'appareil En règle générale, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de version (contrôlées par les fabricants d'appareils individuels).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Renvoie un `DeviceDescriptor` mis en cache si l'appareil est alloué, sinon renvoie le `DeviceDescriptor` actuel.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Renvoie un `DeviceDescriptor` mis en cache si l'appareil est alloué, sinon renvoie le `DeviceDescriptor` actuel.
`String[]`	`getChildren(String path)` Alternative à l'utilisation de `IFileEntry`, qui ne fonctionne parfois pas en raison d'autorisations.
`AbstractConnection`	`getConnection()` Connexion actuelle associée à l'appareil.
`ContentProviderHandler`	`getContentProvider(int userId)` Renvoie `ContentProviderHandler` ou "null" s'il n'est pas disponible.
`DeviceFoldableState`	`getCurrentFoldableState()` Renvoie l'état actuel de l'appareil pliable ou la valeur "null" si des problèmes se sont produits.
`int`	`getCurrentUser()` Renvoie l'ID de l'utilisateur en cours d'exécution.
`String`	`getDeviceClass()` Obtenez 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 à son sujet sans transmettre l'objet de l'appareil.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Renvoyez un `DeviceDescriptor` à partir des informations de l'appareil pour obtenir des informations à son sujet sans transmettre l'objet de l'appareil.
`TestDeviceState`	`getDeviceState()` Obtenez l'état de l'appareil.
`long`	`getDeviceTimeOffset(Date date)` Fonction d'assistance permettant d'obtenir le décalage horaire entre l'appareil et un `ERROR(/Date)` donné.
`InputStreamSource`	`getEmulatorOutput()` Obtenir le flux de stdout et stderr de l'émulateur
`Process`	`getEmulatorProcess()` Renvoie 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 libre sur le stockage externe de l'appareil.
`String`	`getFastbootPath()` Renvoie le chemin d'accès du binaire fastboot utilisé.
`String`	`getFastbootProductType()` Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode Fastboot.
`String`	`getFastbootProductVariant()` Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est 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 la 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érez une référence à un fichier distant sur l'appareil.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Assistant non officiel permettant d'obtenir un `FileEntry` à partir d'un chemin d'accès autre que racine.
	`getFoldableStates()` Renvoie la liste des états de l'appareil pliable.
`IDevice`	`getIDevice()` Renvoie une référence à l'`IDevice` ddmlib 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()` Renvoie un objet pour obtenir l'état actuel du clavier de verrouillage ou la valeur "null" si cette fonctionnalité n'est pas prise en charge.
`long`	`getLastExpectedRebootTimeMillis()` Indique la dernière fois que les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH, comme indiqué par `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Obtenez le niveau d'API de l'appareil lors de son premier lancement.
`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 des `maxBytes` dernières données Logcat capturées.
`InputStreamSource`	`getLogcatDump()` Obtenez un dump 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 indiquée.
`String`	`getMacAddress()` Renvoie l'adresse MAC de l'appareil, "null" si la requête ne parvient pas à être effectuée à partir de l'appareil.
`Integer`	`getMainUserId()` Renvoie l'ID utilisateur principal.
	`getMainlineModuleInfo()` Obtenez les informations sur les modules principaux installés sur l'appareil.
`int`	`getMaxNumberOfRunningUsersSupported()` Obtenez le nombre maximal d'utilisateurs pouvant exécuter simultanément l'application.
`int`	`getMaxNumberOfUsersSupported()` Obtenez le nombre maximal d'utilisateurs acceptés.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Renvoie l'`IDeviceStateMonitor` associé à l'appareil.
`String`	`getMountPoint(String mountName)` Renvoie un point d'installation.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Renvoie un `MountPointInfo` correspondant au chemin d'accès au point d'installation spécifié, ou `null` si ce chemin n'est pas installé ou s'il n'apparaît pas dans /proc/mounts en tant que point d'installation.
	`getMountPointInfo()` Renvoie une version analysée des informations 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 l'espace disponible sur la partition de l'appareil.
`Integer`	`getPrimaryUserId()` Renvoie l'ID utilisateur principal.
`ProcessInfo`	`getProcessByName(String processName)` La méthode d'assistance exécute les commandes "pidof" et "stat", puis 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 si un problème est survenu.
`String`	`getProductType()` Méthode pratique pour obtenir le type de produit de cet appareil.
`String`	`getProductVariant()` Méthode pratique pour obtenir la variante de produit de cet appareil.
`String`	`getProperty(String name)` Récupérez la valeur de propriété donnée à partir de l'appareil.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Récupère le mode de récupération actuel utilisé pour l'appareil.
`InputStreamSource`	`getScreenshot(long displayId)` Capture une capture d'écran de l'appareil avec l'ID d'affichage donné.
`InputStreamSource`	`getScreenshot(String format)` Prend une capture d'écran de l'appareil.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Prend une capture d'écran de l'appareil.
`InputStreamSource`	`getScreenshot()` Prend une capture d'écran de l'appareil.
`String`	`getSerialNumber()` Méthode pratique pour 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()` Renvoie l'opérateur de la carte SIM ou "null" si celui-ci n'est pas disponible ou si l'appareil ne l'est pas.
`String`	`getSimState()` Renvoyez l'état de la carte SIM ou "null" si elle n'est pas disponible ou si l'appareil ne l'est pas.
	`getTombstones()` Récupérez et renvoyez la liste des tombstones des appareils.
`long`	`getTotalMemory()` Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne.
`String`	`getTrackingSerial()` Pour la gestion des appareils, obtenez le numéro de série utilisé pour suivre l'appareil.
	`getUninstallablePackageNames()` Récupérez les noms des packages d'application pouvant être désinstallés.
`boolean`	`getUseFastbootErase()` Indique si l'effacement ou le formatage fastboot doit être utilisé pour effacer une partition sur l'appareil.
`int`	`getUserFlags(int userId)` Recherchez et renvoyez les indicateurs d'un utilisateur donné.
	`getUserInfos()` Récupère la carte de l'identifiant d'utilisation vers `UserInfo` sur l'appareil.
`int`	`getUserSerialNumber(int userId)` Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, -10000 dans les autres cas.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Traitez l'événement DeviceEvent donné. Traitez l'événement 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
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` Initialisez la connexion à l'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)` Installez un package Android sur l'appareil pour un utilisateur donné.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installez un package Android sur l'appareil pour 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 des applications
`boolean`	`isBypassLowTargetSdkBlockSupported()` Vérifier si la plate-forme de l'appareil permet de contourner le blocage du SDK cible faible lors des installations d'applications
`boolean`	`isDebugfsMounted()` Vérifiez si les fichiers de débogage sont installés.
`boolean`	`isDeviceEncrypted()` Indique si l'appareil est chiffré.
`boolean`	`isDirectory(String path)` Renvoie "True" si le chemin d'accès sur l'appareil est un répertoire, ou "False" dans le cas contraire.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Indique si le chiffrement est pris en charge sur l'appareil.
`boolean`	`isExecutable(String fullPath)` Renvoie "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, ou "False" dans le cas contraire.
`boolean`	`isFastbootEnabled()` Indique si le mode Fastboot est disponible pour l'appareil.
`boolean`	`isHeadless()` Renvoie "true" si l'appareil est sans écran, sinon "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é en non-administrateur.
`boolean`	`isMultiUserSupported()` Détermine si la multi-utilisation est prise en charge.
`boolean`	`isPackageInstalled(String packageName, String userId)` Interrogez l'appareil pour un nom de package et un ID utilisateur donnés afin de vérifier s'il est actuellement installé ou non pour cet utilisateur.
`boolean`	`isPackageInstalled(String packageName)` Interrogez l'appareil pour un nom de package donné afin de vérifier s'il est actuellement installé ou non.
`boolean`	`isRuntimePermissionSupported()` Vérifier si la plate-forme de l'appareil est compatible avec l'octroi d'autorisations d'exécution
`boolean`	`isStateBootloaderOrFastbootd()` Renvoie "true" si l'appareil est dans `TestDeviceState.FASTBOOT` ou `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Vérifier si un utilisateur donné est en cours d'exécution
`boolean`	`isUserSecondary(int userId)` Indique si l'utilisateur spécifié est un utilisateur secondaire en fonction de 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 dans l'affichage donné.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Indique si l'appareil autorise les utilisateurs à être démarrés en arrière-plan dans `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Indique si l'appareil permet aux utilisateurs d'être démarrés en arrière-plan.
`boolean`	`isWifiEnabled()` Vérifiez si le Wi-Fi est activé.
	`listDisplayIds()` Collectez la liste des ID d'écran 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 sur l'appareil.
`boolean`	`logAnrs(ITestLogger logger)` Collecte et consigne les erreurs ANR de l'appareil.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer auprès des signalants.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Enregistrez un message dans le logcat de l'appareil.
`void`	`mountDebugfs()` Montez debugfs.
`void`	`nonBlockingReboot()` Envoie une commande pour redémarrer l'appareil et renvoie la commande une fois qu'elle est terminée et que l'appareil n'est plus visible par adb.
`void`	`postAdbRootAction()` Forcer si l'appareil nécessite des actions spécifiques après la racine adb et avant que l'appareil ne soit de nouveau en ligne.
`void`	`postAdbUnrootAction()` Forcer si l'appareil nécessite des actions spécifiques après la suppression de l'accès root par adb et avant que l'appareil ne soit de nouveau en ligne.
`void`	`postBootSetup()` Suivez les instructions pour configurer l'appareil pour les tests après chaque démarrage.
`void`	`postInvocationTearDown(Throwable exception)` Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui sera exécuté une fois l'appel terminé.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Étapes supplémentaires pour la configuration requise spécifique à l'appareil qui sera exécutée sur l'appareil avant le flux d'invocation.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Extrayez de manière récursive le contenu du répertoire de l'appareil.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrayez de manière récursive le contenu du répertoire de l'appareil.
`boolean`	`pullFile(String remoteFilePath, File localFile)` Récupère un fichier sur l'appareil.
`File`	`pullFile(String remoteFilePath, int userId)` Récupère un fichier sur l'appareil, le stocke dans un `ERROR(/File)` temporaire local et renvoie ce `File`.
`File`	`pullFile(String remoteFilePath)` Récupère un fichier sur l'appareil, le stocke dans un `ERROR(/File)` temporaire local et renvoie ce `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Récupère un fichier sur l'appareil.
`String`	`pullFileContents(String remoteFilePath)` Récupère un fichier sur l'appareil et renvoie son contenu.
`File`	`pullFileFromExternal(String remoteFilePath)` Méthode pratique permettant de récupérer un fichier à partir du 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 de manière récursive le contenu des répertoires vers l'appareil en excluant certains répertoires filtrés.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Transférez de manière récursive le contenu du répertoire vers l'appareil.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Transférez de manière récursive le contenu du répertoire vers l'appareil.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)` qui peut envisager d'évaluer le besoin du fournisseur de contenu.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Transférer un fichier vers l'appareil.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Transférer un fichier vers l'appareil.
`boolean`	`pushString(String contents, String remoteFilePath)` Transférer un fichier créé à partir d'une chaîne vers un appareil
`void`	`reboot(String reason)` Redémarre l'appareil en mode ADB avec `reason` donné pour être conservé 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 récupération adb.
`void`	`rebootIntoSideload()` Redémarre l'appareil en mode sideload adb (notez qu'il s'agit d'un mode spécial en mode récupération) Bloque jusqu'à ce que l'appareil passe en mode téléchargement parallèle
`void`	`rebootIntoSideload(boolean autoReboot)` Redémarre l'appareil en mode sideload adb (notez qu'il s'agit d'un mode spécial en mode récupération) Bloque jusqu'à ce que l'appareil passe en mode téléchargement parallèle
`void`	`rebootUntilOnline()` Alternative à `reboot()` qui ne bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`void`	`rebootUntilOnline(String reason)` Alternative à `reboot()` qui ne bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`void`	`rebootUserspace()` Redémarre uniquement la partie de l'espace utilisateur de l'appareil.
`void`	`rebootUserspaceUntilOnline()` Alternative à `rebootUserspace()` ()} qui ne bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`boolean`	`recoverDevice()` Tentative de récupération de la communication de l'appareil.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Enregistre un `IDeviceActionReceiver` pour cet appareil.
`void`	`remountSystemReadOnly()` Rendre la partition système de l'appareil en lecture seule.
`void`	`remountSystemWritable()` Rendre la partition système de l'appareil accessible en écriture
`void`	`remountVendorReadOnly()` Rendre la partition du fournisseur sur l'appareil en lecture seule.
`void`	`remountVendorWritable()` Rendre la partition du fournisseur sur l'appareil accessible en écriture.
`boolean`	`removeAdmin(String componentName, int userId)` Supprimez l'administrateur de l'appareil donné de l'utilisateur donné et renvoyez `true` si la suppression aboutit, sinon `false`.
`void`	`removeOwners()` Supprimez tous les propriétaires de profils d'appareil existants dans la mesure du possible.
`boolean`	`removeUser(int userId)` Supprimez un utilisateur donné de l'appareil.
`void`	`resetContentProviderSetup()` Réinitialisez l'indicateur de configuration du fournisseur de contenu pour le déclencher à nouveau.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Méthode pratique pour effectuer `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 fournit une récupération de 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)` Injecte le `IConfiguration` utilisé.
`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 root.
`boolean`	`setDeviceOwner(String componentName, int userId)` Définir un composant d'administration 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` sur la sortie du journal
`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 commencer la capture Logcat pour un appareil en ligne.
`void`	`setOptions(TestDeviceOptions options)` Définir le `TestDeviceOptions` de l'appareil
`boolean`	`setProperty(String propKey, String propValue)` Définit la valeur de la propriété donnée sur l'appareil.
`void`	`setRecovery(IDeviceRecovery recovery)` Définissez le `IDeviceRecovery` à utiliser pour cet appareil.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Définit le mode de récupération actuel à 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)` Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné.
`void`	`setTestLogger(ITestLogger testLogger)` Injecte l'instance `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer l'appareil.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Définissez si vous souhaitez utiliser l'effacement fastboot ou le formatage fastboot pour effacer une partition de l'appareil.
`void`	`startLogcat()` Commencez à capturer la sortie Logcat de l'appareil en arrière-plan.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Activez le mode d'échange de test.
`boolean`	`startUser(int userId)` Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.
`boolean`	`startUser(int userId, boolean waitFlag)` Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (c'est-à-dire, permettant à l'utilisateur de lancer des activités sur cet écran).
`void`	`stopEmulatorOutput()` Fermez et supprimez la sortie de l'émulateur.
`void`	`stopLogcat()` Arrêtez de capturer la sortie Logcat à partir de l'appareil et supprimez les données Logcat actuellement enregistrées.
`void`	`stopTradeInModeTesting()` Arrêtez les tests du mode d'échange.
`boolean`	`stopUser(int userId)` Arrête un utilisateur donné.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Arrêter un utilisateur donné.
`String`	`switchToAdbTcp()` Passer l'appareil en mode adb-over-tcp.
`boolean`	`switchToAdbUsb()` Mettez l'appareil en mode adb via USB.
`boolean`	`switchUser(int userId)` Passez à un autre userId avec un délai avant expiration par défaut.
`boolean`	`switchUser(int userId, long timeout)` Passez à un autre userId avec le délai avant expiration fourni comme échéance.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Synchronise de manière incrémentielle le contenu d'un répertoire de fichiers local avec l'appareil.
`Bugreport`	`takeBugreport()` Prend un rapport de bug et le renvoie dans un objet `Bugreport` pour le gérer.
`String`	`uninstallPackage(String packageName)` Désinstallez un package Android de l'appareil.
`String`	`uninstallPackageForUser(String packageName, int userId)` Désinstallez un package Android de l'appareil pour 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 de l'appareil soit défini.
`boolean`	`waitForDeviceAvailable()` Attend que l'appareil soit réactif et disponible pour les tests.
`boolean`	`waitForDeviceAvailable(long waitTime)` Attend que l'appareil soit réactif et disponible pour les 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 via Fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Empêche l'appareil d'être dans l'état "adb recovery" (notez que cela est distinct de `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Empêche l'appareil d'être dans l'état "Téléchargement parallèle adb"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Empêche l'appareil d'être disponible (par exemple, il n'est pas présent dans 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 de shell ADB de base.

Méthodes protégées
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Crée la commande de l'OS pour la session de commande shell adb et les arguments donnés.
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Créez un `RebootDeviceAction` à utiliser lors d'une action de redémarrage.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Effectuez un redémarrage ADB.
`void`	`ensureRuntimePermissionSupported()` Méthode d'assistance permettant de générer une exception si l'autorisation d'exécution n'est pas prise en charge
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Obtenez l'instance `RunUtil` à utiliser.
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Récupère une propriété de l'appareil à partir du cache ddmlib par défaut, et utilise "adb shell getprop" ou "fastboot getvar" selon que l'appareil est en mode Fastboot ou non.
`boolean`	`isInRebootCallback()` Indique si les rappels de redémarrage sont actuellement exécutés 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 tous les `IDeviceActionReceiver` de l'événement de fin du redémarrage.
`void`	`notifyRebootStarted()` Informe tous les `IDeviceActionReceiver` de l'événement de démarrage du 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 TestDevice comme microdroid et définit son CID.
`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êt des rapports à adb).

Constantes

INVALID_USER_ID

public static final int INVALID_USER_ID

Valeur renvoyée pour tout ID utilisateur non valide ou 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

Nombre par défaut de tentatives de nouvelle exécution de la commande

Valeur constante : 2 (0x00000002)

Champs

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructeurs publics

NativeDevice

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

Crée un objet TestDevice.

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

Méthodes publiques

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Micro-optimisation (environ 400 millisecondes) en préchargeant toutes les propriétés dont nous avons besoin au lieu d'appeler "adb getprop" pour chacune d'elles. Autrement dit, il est tout aussi rapide d'extraire toutes les propriétés que d'en extraire une seule. Des éléments tels que device.getApiLevel(), checkApiLevelAgainstNextRelease et getBuildAlias appellent tous "adb getprop" sous le capot. Nous les récupérons en un seul appel et appelons NativeDevice.setProperty. Même si nous ne le faisons pas, NativeDevice appellera lui-même setProperty et mettra en cache le résultat pour les futurs appels. Nous le faisons juste un peu plus tôt. Si l'appareil est en mode récupération ou s'il existe d'autres erreurs lors de la récupération des composants, nous les ignorons simplement.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Indique si l'utilisateur système headless est autorisé à passer à l'utilisateur système headless.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifiez si une fonctionnalité est actuellement compatible avec un niveau minimal. Cette méthode prend en compte les fonctionnalités non publiées avant que le niveau d'API ne soit élevé.

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

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

Génère
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Vérifiez que l'appareil dispose d'une connexion réseau.

Renvoie
`boolean`	`true` si l'appareil dispose d'une connexion réseau opérationnelle, `false` sinon.

Génère
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Essayez de fermer les boîtes de dialogue d'erreur actuellement 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 été effacées. Sinon, `false`.

Génère
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Supprime le dernier réseau Wi-Fi auquel l'appareil s'est connecté. Cette méthode doit être appelée au démarrage d'une nouvelle invocation 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 lorsque vous souhaitez vous assurer que ITestDevice.getLogcat() ne renvoie que les données de journal produites après un certain point (par exemple, après avoir flashé une nouvelle version de l'appareil, etc.).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecter à un réseau Wi-Fi

Active le Wi-Fi et le bloque jusqu'à ce qu'une 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 rétablir après chaque redémarrage jusqu'à ce que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() soit appelé.

Paramètres
`wifiSsidToPsk`	: mappage des SSID Wi-Fi avec les mots de passe.
`scanSsid`	`boolean`: indique si des SSID masqués doivent être recherchés pour ce réseau.

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

Génère
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecter à un réseau Wi-Fi

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

Paramètres
`wifiSsid`	`String`: SSID du réseau Wi-Fi auquel se connecter
`wifiPsk`	`String`: phrase de passe PSK ou nulle si non chiffrée

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

Génère
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecter à un réseau Wi-Fi

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

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

Génère
`DeviceNotAvailableException`

connectToWifiNetwork

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

Se connecter à un réseau Wi-Fi

Paramètres
`wifiSsid`	`String`: SSID du réseau Wi-Fi auquel se connecter
`wifiPsk`	`String`: phrase de passe PSK ou nulle si non chiffrée
`scanSsid`	`boolean`: indique si le SSID masqué de ce réseau doit être recherché.

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

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 n'est pas actuellement connecté au réseau.

Paramètres
`scanSsid`	`boolean`: indique si vous devez rechercher un SSID masqué pour ce réseau.

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

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 n'est pas actuellement connecté au réseau.

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

Génère
`DeviceNotAvailableException`

createUser

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`: activez l'indicateur utilisateur --guest lors de la création.
`ephemeral`	`boolean`: activez l'indicateur utilisateur --ephemeral lors de la création.

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

Génère
`DeviceNotAvailableException`

createUser

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`: activez l'indicateur utilisateur --guest lors de la création.
`ephemeral`	`boolean`: activez l'indicateur utilisateur --ephemeral lors de la création.
`forTesting`	`boolean`: activez l'option de test --for-testing lors de la création.

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

Génère
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.

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

Renvoie
`int`	Entier correspondant à l'ID utilisateur créé

Génère
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.

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

Renvoie
`int`	Entier correspondant à l'ID utilisateur créé ou -1 en cas d'erreur.

Génère
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Inspectez un appareil et renvoyez des informations détaillées lorsqu'il n'est plus disponible.

Renvoie
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Méthode d'assistance pour 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 à partir duquel supprimer

Génère
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Méthode d'assistance pour 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 l'IDeviceActionReceiver enregistrée.

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré en mode logiciel en comparant le système_server actuel au système_server précédent ProcessInfo. Utilisez getProcessByName(String) pour obtenir ProcessInfo.

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

Renvoie
`boolean`	`true` si l'appareil a redémarré en mode logiciel

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é en mode logiciel depuis l'heure UTC depuis l'epoch de l'appareil et de son ERROR(/TimeUnit). Le redémarrage logiciel fait référence au redémarrage de system_server en dehors d'un redémarrage matériel de l'appareil (par exemple, redémarrage demandé). La valeur utcEpochTime actuelle de l'appareil en millisecondes peut être obtenue par 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'utcEpochTime donné.

Renvoie
`boolean`	`true` si l'appareil a redémarré en mode logiciel

Génère
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Désactive l'accès root ADB.

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

Renvoie
`boolean`	`true` en cas de réussite.

Génère
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Tentative de désactivation du clavier.

Attendez d'abord que la distribution des entrées soit prête. Cela se produit à peu près au même moment où l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework présente occasionnellement une condition de course. La commande est ensuite envoyée pour fermer le clavier de verrouillage (fonctionne uniquement sur les claviers non sécurisés).

Génère
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

Génère
`DeviceNotAvailableException`

disconnectFromWifi

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 déconnexion du réseau Wi-Fi a réussi. `false` si la déconnexion a échoué.

Génère
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Paramètres
`deviceFilePath`	`String`: chemin absolu du fichier sur l'appareil à vérifier
`userId`	`int`: ID utilisateur à l'aide duquel vérifier l'existence du fichier

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

Génère
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Génère
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tentative de vidage de la pile à 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 dumpheap.
`devicePath`	`String`: chemin d'accès sur l'appareil où placer le dump. Il doit s'agir d'un emplacement pour lequel les autorisations le permettent.

Renvoie
`File`	`ERROR(/File)` contenant le rapport. Valeur nulle si un problème est survenu.

Génère
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Active le mode root adb. Si le paramètre "enable-root" est défini sur "false", un message est consigné et renvoyé sans activer l'utilisateur racine.

L'activation de l'accès root adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode bloque l'appareil jusqu'à ce qu'il soit disponible.

Renvoie
`boolean`	`true` en cas de réussite.

Génère
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

Génère
`DeviceNotAvailableException`

executeAdbCommand

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 avant expiration spécifié.

Dans la mesure du possible, executeShellCommand(String) doit être utilisé à la place, car cette méthode offre une meilleure détection et des meilleures performances des défaillances.

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

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

Génère
`DeviceNotAvailableException`

executeAdbCommand

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 avant expiration spécifié.

Dans la mesure du possible, executeShellCommand(String) doit être utilisé à la place, car cette méthode offre une meilleure détection et des meilleures performances des défaillances.

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

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

Génère
`DeviceNotAvailableException`

executeAdbCommand

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, executeShellCommand(String) doit être utilisé à la place, car cette méthode offre une meilleure détection et des meilleures performances des défaillances.

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

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

Génère
`DeviceNotAvailableException`

executeFastbootCommand

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 avant expiration par défaut de deux minutes.

Doit être utilisé lorsque l'appareil est déjà en mode Fastboot.

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

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

Génère
`DeviceNotAvailableException`

executeFastbootCommand

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

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

Doit être utilisé lorsque l'appareil est déjà en mode Fastboot.

Paramètres
`timeout`	`long`: délai d'expiration de la commande, en millisecondes
`cmdArgs`	`String`: commande fastboot et arguments à exécuter

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

Génère
`DeviceNotAvailableException`

executeLongFastbootCommand

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), sauf qu'il utilise un délai avant expiration plus long.

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

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

Génère
`DeviceNotAvailableException`

executeLongFastbootCommand

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), sauf qu'il utilise un délai avant expiration plus long.

Paramètres
`envVarMap`	: variables d'environnement système avec lesquelles la commande fastboot s'exécute
`cmdArgs`	`String`: commande fastboot et arguments à exécuter

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

Génère
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

Méthode d'assistance qui exécute une commande shell adb et renvoie la sortie sous forme de String.

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

Renvoie
`String`	la sortie du shell

Génère
`DeviceNotAvailableException`

executeShellCommand

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

Exécute une commande shell adb, avec plus 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 pas générer de réponse. Unité spécifiée dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives de la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException est générée si les `retryAttempts` ne sont pas exécutées.

Génère
`DeviceNotAvailableException`

executeShellCommand

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

Exécute une commande shell adb, avec plus 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 avant expiration maximal pour 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 pas générer de réponse. Unité spécifiée dans `timeUnit`
`timeUnit`	`TimeUnit`: unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: nombre maximal de tentatives de la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException est générée si `retryAttempts` est exécuté sans succès.

Génère
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Exécute la commande d'interface système adb donnée, en réessayant plusieurs fois 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`

executeShellV2Command

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 CommandResult correctement renseigné avec la sortie d'état de la commande, stdout et stderr.

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

Renvoie
`CommandResult`	Résultat en `CommandResult`.

Génère
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Méthode d'assistance qui exécute une commande de shell adb et renvoie les résultats sous la forme d'un CommandResult correctement renseigné avec la sortie d'é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 standard sera redirigée, ou nulle.

Renvoie
`CommandResult`	Résultat en `CommandResult`.

Génère
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Méthode d'assistance qui exécute une commande d'interface système adb et renvoie les résultats sous la forme d'un CommandResult correctement renseigné avec la sortie d'état de la commande, stdout et stderr.

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

Renvoie
`CommandResult`	Résultat en `CommandResult`.

Génère
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

Si getUseFastbootErase() est true, la suppression Fastboot est utilisée pour effacer la partition. L'appareil doit ensuite créer un système de fichiers lors du prochain démarrage. Sinon, le format fastboot est utilisé, ce qui crée un nouveau système de fichiers sur l'appareil.

Doit être utilisé lorsque l'appareil est déjà en mode Fastboot.

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

Renvoie
`CommandResult`	le 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)` codes `ApexInfo` actuellement activés sur l'appareil

Génère
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

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

Paramètres
`namespace`	`String`: doit être défini sur {"system", "secure", "global"}

Renvoie
	la carte des paires clé-valeur. Valeur nulle si l'espace de noms n'est pas compatible.

Génère
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Afficher 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. Si aucun n'est trouvé, renvoyez la valeur "null".

Paramètres
`userId`	`int`

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Créez une carte des ID Android correspondant aux ID utilisateur. Il n'est pas garanti que chaque ID utilisateur trouvera un ID Android associé dans cette fonction. Par conséquent, certains ID utilisateur peuvent correspondre à "null".

Renvoie
	Carte des ID Android correspondants aux ID utilisateur.

Génère
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

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

Génère
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Récupérez 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érez les informations sur les packages installés sur l'appareil.

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

Génère
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Méthode pratique permettant d'obtenir la version de bande de base (radio) de cet appareil. L'obtention de la version radio est spécifique à l'appareil. Il est donc possible qu'elle ne renvoie pas les informations correctes pour tous les appareils. Cette méthode s'appuie sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Cette information n'est pas exacte pour certains appareils CDMA. La version renvoyée ici peut ne pas correspondre à celle indiquée par fastboot et ne pas renvoyer la version de la radio CDMA. Résumé : cette méthode ne renvoie une version exacte que 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 pas de radio ou la chaîne de version ne peut pas être lue)

Génère
`DeviceNotAvailableException`

getBattery

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 de la propriété donnée.

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

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

Génère
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure et la raison du démarrage.

Renvoie
	Carte de l'heure de démarrage (heure UTC en secondes depuis l'epoch) et de la raison du 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 l'heure de démarrage et la raison du démarrage depuis l'heure donnée depuis l'épokhe 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`: heure de l'appareil depuis l'epoch.
`timeUnit`	`TimeUnit`: unité de temps `TimeUnit`.

Renvoie
	Carte de l'heure de démarrage (heure UTC en secondes depuis l'epoch) et de la raison du démarrage

Génère
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Méthode pratique pour obtenir la version du bootloader de cet appareil.

Tentera de récupérer 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 à partir de l'appareil.

L'implémentation de cette fonctionnalité continuera de fonctionner sur un appareil sans carte SD (ou lorsque la carte SD n'est pas encore montée).

Renvoie
`InputStreamSource`	Un `InputStreamSource` qui générera le contenu du rapport de bug à la demande. En cas d'échec, `InputStreamSource` produit une `ERROR(/InputStream)` vide.

getBugreportz

public InputStreamSource getBugreportz ()

Récupère un bugreportz à partir de l'appareil. Le bugreport au format ZIP contient le bugreport principal et d'autres fichiers journaux utiles pour le débogage.

Compatible uniquement avec la version "adb" 1.0.36 ou supérieure

Renvoie
`InputStreamSource`	un `InputStreamSource` du fichier ZIP contenant le bugreportz, renvoyez null en cas d'échec.

getBuildAlias

public String getBuildAlias ()

Récupérez l'alias de la version actuellement exécutée sur 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 a l'alias de compilation JDQ39 et l'ID de compilation 573038.

Renvoie
`String`	l'alias de compilation ou l'ID de compilation si celui-ci n'a pas pu être récupéré

Génère
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Récupérez la saveur de compilation de l'appareil.

Renvoie
`String`	la saveur de compilation ou la valeur nulle si elle n'a pas pu être récupérée

Génère
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Récupérez la version actuellement exécutée sur l'appareil.

Renvoie
`String`	l'ID de build ou `IBuildInfo.UNKNOWN_BUILD_ID` si celui-ci n'a pas pu être récupéré

Génère
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

Génère
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Renvoie
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Paramètres
`shortDescriptor`	`boolean`: indique si le descripteur doit être limité aux informations minimales.

Renvoie
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

Alternative à l'utilisation de IFileEntry, qui ne fonctionne parfois pas en raison d'autorisations.

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

Renvoie
`String[]`	Tableau de chaînes 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 "null" s'il n'est pas 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 à utiliser pour initialiser le fournisseur de contenu.

Renvoie
`ContentProviderHandler`

Génère
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état actuel de l'appareil pliable ou la valeur "null" si des problèmes se sont produits.

Renvoie
`DeviceFoldableState`

Génère
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Renvoie l'ID de l'utilisateur en cours d'exécution. En cas d'erreur, renvoyez -10000.

Renvoie
`int`

Génère
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Obtenez 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 à son sujet sans transmettre l'objet de l'appareil.

Renvoie
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations à son sujet sans transmettre l'objet de l'appareil.

Paramètres
`shortDescriptor`	`boolean`: indique si le descripteur doit être limité aux informations minimales.

Renvoie
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Renvoie
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Fonction d'assistance permettant d'obtenir le décalage horaire entre l'appareil et un ERROR(/Date) donné. Utilisez l'heure 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 stdout et stderr de l'émulateur

Renvoie
`InputStreamSource`	sortie de l'émulateur

getEmulatorProcess

public Process getEmulatorProcess ()

Renvoie le Process correspondant à cet émulateur.

Renvoie
`Process`	`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 libre sur le stockage externe de l'appareil.

Renvoie
`long`	la quantité d'espace libre en Ko ;

Génère
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Renvoie le chemin d'accès du binaire fastboot utilisé. isFastbootEnabled() doit toujours être défini sur "True" pour que les fonctions Fastboot soient activées.

Renvoie
`String`

getFastbootProductType

public String getFastbootProductType ()

Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode Fastboot.

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

Renvoie
`String`	le nom du type de produit `String` ou `null` si celui-ci ne peut pas être déterminé

Génère
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode Fastboot.

Renvoie
`String`	le nom du type de produit `String` ou `null` si celui-ci 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 la 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érez une référence à un fichier distant sur l'appareil.

Paramètres
`path`	`String`: chemin d'accès au fichier à récupérer. Il peut s'agir d'un chemin absolu ou d'un chemin relatif à "/". (c'est-à-dire que les syntaxes "/system" et "system" sont acceptées)

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

Génère
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Assistant non officiel permettant d'obtenir un FileEntry à partir d'un chemin d'accès autre que racine. FIXME: refactorisez le système FileEntry pour qu'il soit disponible à partir de n'importe quel chemin d'accès. (même si vous n'êtes pas root).

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

Renvoie
`IFileEntry`	un FileEntryWrapper représentant le FileEntry.

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

getFoldableStates

public  getFoldableStates ()

Renvoie la liste des états de l'appareil pliable. Peut être obtenu avec "cmd device_state print-states".

Renvoie

Génère
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Renvoie une référence à l'IDevice ddmlib associé.

Un nouvel IDevice peut être alloué par DDMS chaque fois que l'appareil se déconnecte et se reconnecte à partir d'adb. Par conséquent, les appelants ne doivent pas conserver de référence à IDevice, car cette référence peut devenir obsolète.

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

Renvoie
	`ERROR(/Set)` des noms de packages `String` 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'a pas d'adresse IP

Génère
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Renvoie un objet pour obtenir l'état actuel du clavier de verrouillage ou la valeur "null" si cette fonctionnalité n'est pas prise en charge.

Renvoie
`KeyguardControllerState`	un `KeyguardControllerState` contenant un instantané de l'état du clavier de verrouillage et renvoyant la valeur "Null" si la requête du clavier de verrouillage n'est pas prise en charge.

Génère
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Indique la dernière fois que les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH, comme indiqué par System.currentTimeMillis().

Renvoie
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

Obtenez le niveau d'API de l'appareil lors de son premier lancement. La valeur par défaut est UNKNOWN_API_LEVEL.

Renvoie
`int`	Entier indiquant le premier niveau d'API lancé 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 Logcat est actuellement capturé en arrière-plan, renvoie jusqu'à TestDeviceOptions.getMaxLogcatDataSize() octets du contenu actuel de la capture Logcat en arrière-plan.

Sinon, renvoie 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 des maxBytes dernières données Logcat capturées.

Utile lorsque vous souhaitez capturer des instantanés fréquents des données logcat capturées sans encourir la pénalité d'espace disque potentiellement importante que représente l'obtention de l'intégralité de l'instantané getLogcat().

Paramètres
`maxBytes`	`int`: quantité maximale de données à renvoyer. Doit être une quantité qui peut tenir confortablement dans la mémoire

Renvoie
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

Inconvénient : rien n'est renvoyé si l'appareil n'est pas accessible.

Renvoie
`InputStreamSource`	un `InputStreamSource` des données Logcat. Un flux vide est renvoyé en cas d'échec de la capture des données Logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

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

Paramètres
`date`	`long`: au format millisecondes depuis l'epoch, indique le moment où commencer l'instantané jusqu'au moment présent. (obtenu avec "date +%s")

Renvoie
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Renvoie l'adresse MAC de l'appareil, "null" si la requête ne parvient pas à être effectuée à partir de l'appareil.

Renvoie
`String`

getMainUserId

public Integer getMainUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
`Integer`	l'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur nulle si aucun utilisateur principal n'est défini.

Génère
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

Renvoie
	`ERROR(/Set)` des modules principaux `String` actuellement installés sur l'appareil.

Génère
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximal d'utilisateurs pouvant exécuter simultanément l'application. La valeur par défaut est 0.

Renvoie
`int`	Entier indiquant le nombre d'utilisateurs exécutés simultanément

Génère
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Obtenez le nombre maximal d'utilisateurs acceptés. La valeur par défaut est 0.

Renvoie
`int`	un 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 nulle.

getMonitor

public IDeviceStateMonitor getMonitor ()

Renvoie l'IDeviceStateMonitor associé à l'appareil.

Renvoie
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Renvoie un point d'installation.

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

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

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Renvoie un MountPointInfo correspondant au chemin d'accès au point d'installation spécifié, ou null si ce chemin n'est pas installé ou s'il n'apparaît pas dans /proc/mounts en tant que point d'installation.

Paramètres
`mountpoint`	`String`

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

Génère
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

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

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

Génère
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

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

Renvoie
`TestDeviceOptions`	`TestDeviceOptions` liés à l'appareil testé.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

Paramètres
`partition`	`String`

Renvoie
`long`	la quantité d'espace libre en Ko ;

Génère
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
`Integer`	l'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur nulle si aucun utilisateur principal n'est défini.

Génère
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

La méthode d'assistance exécute les commandes "pidof" et "stat", puis renvoie l'objet ProcessInfo avec le PID et l'heure de début du processus donné.

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

Renvoie
`ProcessInfo`	ProcessInfo du nom de processus donné

Génère
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Renvoie le PID du service ou la valeur null si un problème est survenu.

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

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Méthode pratique pour obtenir le type de produit de cet appareil.

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

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

Génère
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Méthode pratique pour obtenir la variante de produit de cet appareil.

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

Renvoie
`String`	le nom de la variante de produit `String` ou `null` si celui-ci ne peut pas être déterminé

Génère
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Récupérez 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 ()

Récupère le mode de récupération actuel utilisé pour l'appareil.

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Capture une capture d'écran de l'appareil avec l'ID d'affichage donné. Le format est PNG.

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

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

Renvoie
`InputStreamSource`	une `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)

Prend une capture d'écran de l'appareil. Nous vous recommandons d'utiliser getScreenshot(format) avec l'encodage JPEG pour une taille plus petite.

Paramètres
`format`	`String`: PNG, JPEG acceptés

Renvoie
`InputStreamSource`	une `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)

Prend une capture d'écran de l'appareil. Nous vous recommandons d'utiliser getScreenshot(String) à la place avec l'encodage JPEG pour une taille plus petite.

Paramètres
`format`	`String`: PNG, 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`	une `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 ()

Prend une capture d'écran de l'appareil.

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

Génère
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Méthode pratique pour obtenir le numéro de série de cet appareil.

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

getSetting

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

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

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

Renvoie
`String`	la valeur associée à l'espace de noms:clé d'un utilisateur. Valeur nulle si aucune valeur n'est trouvée.

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 ()

Renvoie l'opérateur de la carte SIM ou "null" si celui-ci n'est pas disponible ou si l'appareil ne l'est pas.

Renvoie
`String`

getSimState

public String getSimState ()

Renvoyez l'état de la carte SIM ou "null" si elle n'est pas disponible ou si l'appareil ne l'est pas.

Renvoie
`String`

getTombstones

public  getTombstones ()

Récupérez et renvoyez la liste des tombstones des appareils. Nécessite un accès root.

La méthode est du type "best-effort". Par conséquent, si une pierre tombale ne peut pas être extraite pour une raison quelconque, elle ne figurera pas dans la liste. Seul un DeviceNotAvailableException mettra fin à la méthode prématurément.

Renvoie
	Liste des fichiers de tombstone, vide si aucun tombstone n'est défini.

Génère
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

Renvoie
`long`

getTrackingSerial

public String getTrackingSerial ()

Pour la gestion des appareils, obtenez le numéro de série utilisé pour suivre l'appareil.

Renvoie
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Récupérez les noms des packages d'application pouvant être désinstallés. Il s'agit actuellement des packages non système et des packages système mis à jour.

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

Génère
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Indique si l'effacement ou le formatage fastboot doit être utilisé pour effacer une partition sur l'appareil.

Renvoie
`boolean`	`true` si l'effacement Fastboot est utilisé ou `false` si le formatage Fastboot est utilisé.

getUserFlags

public int getUserFlags (int userId)

Recherchez et renvoyez 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, le cas échéant, -10000 dans tous les autres cas.

Génère
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Récupère la carte de l'identifiant d'utilisation vers UserInfo sur l'appareil. Génère une exception DeviceRuntimeException si la sortie de l'appareil ne correspond pas aux attentes.

Renvoie
	la liste des objets UserInfo.

Génère
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Paramètres
`userId`	`int`

Renvoie
`int`

Génère
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Traitez l'événement DeviceEvent donné. Peut faire passer l'appareil à un nouvel état. Informe le IDeviceMonitor de toute transition d'état.

Traitez l'événement DeviceEvent, qui peut ou non faire passer cet appareil à un nouvel état d'allocation.

Paramètres
`event`	`DeviceEvent`

Renvoie
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

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

Paramètres
`feature`	`String`: le format doit être "feature:" ou "" directement.

Renvoie
`boolean`	"True" si l'élément géographique est trouvé, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

initializeConnection

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

Initialisez la connexion à l'appareil. Cette méthode est appelée par preInvocationSetup, mais dans de rares cas, elle peut devoir être appelée séparément lors de la création de la connexion lors de la configuration de l'appareil.

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

Génère
`DeviceNotAvailableException`
`TargetSetupError`

installPackage

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

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

Génère
`DeviceNotAvailableException`

installPackage

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

Installer un package Android sur l'appareil.

Remarque: Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

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

Renvoie
`String`	un `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)

Installez un package Android sur l'appareil pour 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 l'installation doit être effectuée.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `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)

Installez un package Android sur l'appareil pour un utilisateur donné.

Remarque: Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

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

Renvoie
`String`	un `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 des applications

Renvoie
`boolean`	"True" si l'énumération des applications est prise en charge, sinon "false"

Génère
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

Renvoie
`boolean`	"True" si le blocage du SDK cible faible est accepté, "false" dans le cas contraire

Génère
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Vérifiez si les fichiers de débogage sont installés.

Renvoie
`boolean`	`true` si les fichiers de débogage sont installés

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)

Renvoie "True" si le chemin d'accès sur l'appareil est un répertoire, ou "False" dans le cas contraire.

Paramètres
`path`	`String`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Renvoie
`boolean`	`true` si l'accès root adb doit être activé sur l'appareil

isEncryptionSupported

public boolean isEncryptionSupported ()

Indique si le chiffrement est pris en charge sur l'appareil.

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

Génère
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

Renvoie "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, ou "False" dans le cas contraire.

Paramètres
`fullPath`	`String`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Indique si le mode Fastboot est disponible pour l'appareil.

Renvoie
`boolean`

isHeadless

public boolean isHeadless ()

Renvoie "true" si l'appareil est sans écran, sinon "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é en non-administrateur.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Détermine si la multi-utilisation est prise en charge.

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

Génère
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

Paramètres
`packageName`	`String`: package que nous vérifions pour voir s'il est installé.
`userId`	`String`: ID de l'utilisateur pour lequel le package est installé. Si la valeur est nulle, l'utilisateur principal sera défini sur zéro.

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

Génère
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Interrogez l'appareil pour un nom de package donné afin de 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`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

Vérifier si la plate-forme de 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, ou "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

Renvoie "true" si l'appareil est dans TestDeviceState.FASTBOOT ou TestDeviceState.FASTBOOTD.

Renvoie
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

Paramètres
`userId`	`int`

Renvoie
`boolean`	"True" si l'utilisateur effectue une course, "false" dans tous les autres cas.

Génère
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Indique si l'utilisateur spécifié est un utilisateur secondaire en fonction de ses indicateurs.

Paramètres
`userId`	`int`

Renvoie
`boolean`	"true" si l'utilisateur est secondaire, "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 peut donc lancer des activités de lancement (généralement dans l'affichage 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 dans l'affichage donné.

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

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil autorise les utilisateurs à être démarrés en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Indique si l'appareil permet aux utilisateurs d'être démarrés 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 affirmer l'état du Wi-Fi avant les tests qui ne doivent pas s'exécuter avec le Wi-Fi, par exemple 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 ID d'écran disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".

Renvoie
	Liste des écrans. La valeur par défaut renvoie toujours l'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`

listUsers

public  listUsers ()

Récupère la liste des utilisateurs sur l'appareil. Génère une exception DeviceRuntimeException si la sortie de l'appareil ne correspond pas à vos attentes.

Renvoie
	la liste des ID utilisateur.

Génère
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Collecte et consigne les erreurs ANR de l'appareil.

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

Renvoie
`boolean`	"True" si la journalisation a réussi, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer auprès des signalants.

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

Renvoie
`boolean`	"True" si la journalisation a réussi, "false" dans le cas contraire.

logOnDevice

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

Enregistrez un message dans le logcat de l'appareil. Il s'agit d'un appel sécurisé qui ne génère pas d'exception, même en cas d'échec de la journalisation.

Paramètres
`tag`	`String`: balise sous laquelle nous enregistrons notre message dans le 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 ()

Montez debugfs.

Génère
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

Envoie une commande pour redémarrer l'appareil et renvoie la commande une fois qu'elle est terminée et que l'appareil n'est plus visible par adb.

Génère
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Forcer si l'appareil nécessite des actions spécifiques après la racine adb et avant que l'appareil ne soit de nouveau en ligne. L'implémentation par défaut n'inclut aucune action supplémentaire. Il n'est pas garanti que l'accès root adb soit activé à ce stade.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Forcer si l'appareil nécessite des actions spécifiques après la suppression de l'accès root par adb et avant que l'appareil ne soit de nouveau en ligne. L'implémentation par défaut n'inclut aucune action supplémentaire. Il n'est pas garanti que l'accès root adb soit désactivé à ce stade.

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

postBootSetup

public void postBootSetup ()

Suivez les instructions pour configurer l'appareil pour les tests après chaque démarrage.

Doit être appelé une fois que l'appareil est complètement démarré/disponible

Dans des conditions normales, 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.

Il peut être nécessaire de l'appeler lorsque l'appareil redémarre en raison d'autres événements (par exemple, lorsque la commande de mise à jour Fastboot est terminée).

Génère
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui sera exécuté une fois l'appel terminé.

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

preInvocationSetup

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

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

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

Génère
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

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

Extrayez de manière récursive le contenu du répertoire de l'appareil.

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

Renvoie
`boolean`	`true` si le fichier a bien été extrait. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Extrayez de manière récursive le contenu du répertoire de l'appareil.

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

Renvoie
`boolean`	`true` si le fichier a bien été extrait. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

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

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil.
`localFile`	`File`: fichier local dans lequel stocker le contenu. Si ce champ n'est pas vide, les contenus seront remplacés.

Renvoie
`boolean`	`true` si le fichier a bien été récupéré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Récupère un fichier sur l'appareil, le stocke dans un ERROR(/File) temporaire local et renvoie ce File.

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

Renvoie
`File`	Un `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 sur l'appareil, le stocke dans un ERROR(/File) temporaire local et renvoie ce File.

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

Renvoie
`File`	Un `ERROR(/File)` contenant le contenu du fichier de l'appareil, ou `null` si 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 sur l'appareil.

Paramètres
`remoteFilePath`	`String`: chemin absolu vers le fichier sur l'appareil.
`localFile`	`File`: fichier local dans lequel stocker le contenu. Si ce champ n'est pas vide, les contenus seront remplacés.
`userId`	`int`: ID utilisateur à extraire

Renvoie
`boolean`	`true` si le fichier a bien été récupéré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Récupère un fichier sur l'appareil et renvoie son contenu.

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

Renvoie
`String`	Un `String` contenant le contenu du fichier de l'appareil, ou `null` si 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 à partir du 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 `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`

pushDir

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

Transférez de manière récursive le contenu des répertoires vers l'appareil en excluant certains répertoires filtrés.

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

Renvoie
`boolean`	`true` si le fichier a bien été transféré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

Renvoie
`boolean`	`true` si le fichier a bien été transféré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pushDir

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

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

Paramètres
`localFileDir`	`File`: répertoire local à transmettre
`deviceFilePath`	`String`: chemin d'accès absolu de la destination distante
`userId`	`int`: ID utilisateur à transmettre

Renvoie
`boolean`	`true` si le fichier a bien été transféré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pushFile

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

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

Paramètres
`localFile`	`File`: fichier local à pousser
`remoteFilePath`	`String`: chemin d'accès absolu de la destination distante
`evaluateContentProviderNeeded`	`boolean`: indique si nous avons besoin du fournisseur de contenu.

Renvoie
`boolean`	`true` si le fichier a bien été transféré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Transférer un fichier vers l'appareil. Par défaut, à l'aide d'un fournisseur de contenu.

Paramètres
`localFile`	`File`: fichier local à pousser
`remoteFilePath`	`String`: chemin d'accès absolu de la destination distante

Renvoie
`boolean`	`true` si le fichier a bien été transféré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pushFile

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

Transférer un fichier vers l'appareil. Par défaut, à l'aide d'un fournisseur de contenu.

Paramètres
`localFile`	`File`: fichier local à pousser
`remoteFilePath`	`String`: chemin d'accès absolu de la destination distante
`userId`	`int`: ID utilisateur à transmettre

Renvoie
`boolean`	`true` si le fichier a bien été transféré. Sinon, `false`.

Génère
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Transférer un fichier créé à partir d'une chaîne vers un appareil

Paramètres
`contents`	`String`: contenu du fichier à pousser
`remoteFilePath`	`String`: chemin d'accès absolu de la destination distante

Renvoie
`boolean`	`true` si la chaîne a bien été transmise. Sinon, `false`.

Génère
`DeviceNotAvailableException`

redémarrer

public void reboot (String reason)

Redémarre l'appareil en mode ADB avec reason donné pour être conservé 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`

rebootIntoBootloader

public void rebootIntoBootloader ()

Redémarre l'appareil en mode bootloader.

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

Génère
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Redémarre l'appareil en mode fastbootd.

Bloque jusqu'à ce que l'appareil soit en mode fastbootd.

Génère
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

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

Bloque jusqu'à ce que l'appareil entre en mode récupération

Génère
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

Redémarre l'appareil en mode sideload adb (notez qu'il s'agit d'un mode spécial en mode récupération)

Bloque jusqu'à ce que l'appareil passe en mode téléchargement parallèle

Génère
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Redémarre l'appareil en mode sideload adb (notez qu'il s'agit d'un mode spécial en mode récupération)

Bloque jusqu'à ce que l'appareil passe en mode téléchargement parallèle

Paramètres
`autoReboot`	`boolean`: indique si l'appareil doit redémarrer automatiquement après le téléchargement latéral.

Génère
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

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

Génère
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

Alternative à reboot() qui ne 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`

rebootUserspace

public void rebootUserspace ()

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

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

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

Génère
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

Génère
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

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

Renvoie
`boolean`	"True" si la récupération a été tentée et 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 informés avant le début d'une action de l'appareil et après la fin de l'action de l'appareil.

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

remountSystemReadOnly

public void remountSystemReadOnly ()

Rendre la partition système de l'appareil en lecture seule. L'appareil peut redémarrer.

Génère
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Rendre la partition système de l'appareil accessible en écriture L'appareil peut redémarrer.

Génère
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Rendre la partition du fournisseur sur l'appareil en lecture seule. L'appareil peut redémarrer.

Génère
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Rendre la partition du fournisseur sur l'appareil accessible en écriture. L'appareil peut redémarrer.

Génère
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Supprimez l'administrateur de l'appareil donné de l'utilisateur donné et renvoyez true si la suppression aboutit, sinon false.

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

Renvoie
`boolean`	"True" si la requête a réussi, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Supprimez tous les propriétaires de profils d'appareil existants dans la mesure du possible.

Génère
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Supprimez un utilisateur donné de l'appareil.

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

Renvoie
`boolean`	"true" si la suppression de l'utilisateur a réussi, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

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

runInstrumentationTests

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

Méthode pratique pour effectuer 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`: l'écouteur ou les écouteurs des résultats du test

Renvoie
`boolean`	`true` si la commande de test est terminée. `false` si l'opération n'a pas abouti, mais que la récupération a réussi

Génère
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Exécute des tests d'instrumentation et fournit une récupération de l'appareil.

Si la connexion avec l'appareil est perdue avant la fin de l'exécution du test et que la récupération aboutit, tous les écouteurs sont informés de testRunFailed et la valeur "false" est renvoyée. La commande de test ne sera pas réexécutée. Il appartient aux appelants de réessayer si nécessaire.

Si la connexion avec 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 DeviceNotAvailableException est généré.

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 n'a pas pu être terminée 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`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration utilisé.

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 root.

Paramètres
`date`	`Date`: spécifiez une date spécifique. La date de l'hôte sera utilisée si `null`.

Génère
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

Paramètres
`componentName`	`String`: de l'administrateur de l'appareil en tant que propriétaire de l'appareil.
`userId`	`int`: pays de l'utilisateur dans lequel le propriétaire de l'appareil réside.

Renvoie
`boolean`	"True" si la requête a réussi, "false" dans le cas contraire.

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 sur la sortie du journal

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

setEmulatorProcess

public void setEmulatorProcess (Process p)

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

Paramètres
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Définissez l'option fastboot pour l'appareil. Doit être défini lorsque l'appareil est alloué pour la première fois.

Paramètres
`fastbootEnabled`	`boolean`: indique si Fastboot est disponible pour l'appareil ou non

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

Paramètres
`fastbootPath`	`String`

setIDevice

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 DDMS a alloué un nouvel IDevice.

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

setLogStartDelay

public void setLogStartDelay (int delay)

Définit le délai d'attente (en millisecondes) avant de commencer la capture Logcat pour un appareil en ligne.

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

setOptions

public void setOptions (TestDeviceOptions options)

Définir le TestDeviceOptions de l'appareil

Paramètres
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Définit la valeur de la propriété donnée sur l'appareil. Nécessite que l'accès racine adb soit défini sur "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 réussi, sinon "False".

Génère
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Définissez le IDeviceRecovery à utiliser pour cet appareil. Doit être défini lorsque l'appareil est alloué pour la première fois.

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

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

Permet de contrôler la méthode de récupération à utiliser en cas de problème de communication de l'appareil. Il est recommandé de n'utiliser cette méthode que de manière limitée lorsque cela est nécessaire (par exemple, lorsque le framework est en panne, etc.

Paramètres
`mode`	`ITestDevice.RecoveryMode`: indique si le mode "Récupération jusqu'à la connexion uniquement" doit être activé ou non.

setSetting

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`

setSetting

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

Ajoutez 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)

Injecte l'instance ITestLogger

Paramètres
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

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

Paramètres
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Définissez si vous souhaitez utiliser l'effacement fastboot ou le formatage fastboot pour effacer une partition de l'appareil.

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

startLogcat

public void startLogcat ()

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

N'a aucun effet si la sortie Logcat est déjà capturée. Les données peuvent être récupérées ultérieurement via getLogcat.

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

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

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

Activez le mode d'échange de test. L'appareil sera effacé et redémarrera.

Paramètres
`timeoutMs`	`int`

Renvoie
`boolean`	"True" si la requête a réussi, "false" dans le cas contraire

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

startUser

public boolean startUser (int userId)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est une opération sans effet.

Paramètres
`userId`	`int`: de l'utilisateur à démarrer en arrière-plan

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

Génère
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est une opération sans effet. Possibilité de fournir un indicateur supplémentaire pour attendre que l'opération prenne effet.

Paramètres
`userId`	`int`: de l'utilisateur à démarrer en arrière-plan
`waitFlag`	`boolean`: la commande attendra que l'utilisateur soit démarré et déverrouillé.

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

Génère
`DeviceNotAvailableException`

startVisibleBackgroundUser

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

Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (c'est-à-dire, permettant à l'utilisateur de lancer des activités sur cet écran).

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

Paramètres
`userId`	`int`: de l'utilisateur à démarrer en arrière-plan
`displayId`	`int`: écran à partir duquel l'utilisateur peut voir l'affichage
`waitFlag`	`boolean`: la commande attendra que l'utilisateur soit démarré et déverrouillé.

Renvoie
`boolean`	`true` si l'utilisateur a bien été démarré 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 de capturer la sortie Logcat à partir de l'appareil et supprimez les données Logcat actuellement enregistrées.

N'a aucun effet si la sortie Logcat n'est pas capturée.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Arrêtez les tests du mode d'échange.

Génère
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

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

Renvoie
`boolean`	"true" si l'utilisateur a bien été arrêté.

Génère
`DeviceNotAvailableException`

stopUser

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 la fermeture de l'utilisateur. Impossible d'arrêter l'utilisateur actuel et le système.

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

Renvoie
`boolean`	"true" si l'utilisateur a bien été arrêté.

Génère
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

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

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

Génère
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

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

switchUser

public boolean switchUser (int userId)

Passez à un autre userId avec un délai avant expiration par défaut. switchUser(int, long).

Paramètres
`userId`	`int`

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

Génère
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Passez à un autre userId avec le délai avant expiration fourni comme échéance. Tentative de désactivation du verrouillage des touches une fois le changement d'utilisateur effectué.

Paramètres
`userId`	`int`
`timeout`	`long`: pour attendre avant de renvoyer la valeur "false" en cas d'échec de la modification de l'utilisateur.

Renvoie
`boolean`	"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. 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 avec l'appareil.

Détermine les fichiers à transférer en comparant les codes temporels des fichiers locaux à leurs équivalents distants. Seuls les fichiers "plus récents" ou inexistants seront transférés vers l'appareil. Par conséquent, les frais généraux devraient être relativement faibles si le fichier défini sur l'appareil est déjà à jour.

Les fichiers caché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 de manière récursive le contenu de /tmp/files vers /sdcard/files.

Paramètres
`localFileDir`	`File`: répertoire de fichiers local contenant les fichiers à pousser de manière récursive.
`deviceFilePath`	`String`: racine du chemin d'accès absolu du fichier de destination distant. Tous les répertoires de ce chemin de fichier doivent être lisibles. Par exemple, l'envoi vers /data/local/tmp lorsque adb n'est pas racine échouera.

Renvoie
`boolean`	`true` si les fichiers ont bien été synchronisés. Sinon, `false`.

Génère
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Prend un rapport de bug et le renvoie dans un objet Bugreport pour le gérer. Renvoie 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`

uninstallPackage

public String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

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

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

Génère
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

Génère
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

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

Cette méthode peut redémarrer le framework, mais n'appelle pas postBootSetup(). Par conséquent, l'appareil peut ne pas être entièrement prêt à être testé lorsque cette méthode renvoie une valeur.

Renvoie
`boolean`	`true` si l'opération réussit 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 de l'appareil soit défini.

Paramètres
`timeOut`	`long`: délai d'attente en millisecondes avant que l'indicateur ne 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 soit réactif et disponible pour les tests. Utilise le délai avant expiration 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 soit réactif et disponible pour les 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" si ce n'est pas le cas.

Génère
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Génère
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Empêche l'appareil d'être dans l'état "adb recovery" (notez que cela est distinct de IDeviceRecovery).

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

Renvoie
`boolean`	`true` si l'appareil démarre en mode récupération avant l'expiration du délai. Sinon `false`.

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Empêche l'appareil d'être dans l'état "Téléchargement parallèle adb"

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

Renvoie
`boolean`	`true` si l'appareil démarre en mode téléchargement indépendant avant l'expiration du délai. Sinon `false`.

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Empêche l'appareil d'être disponible (par exemple, il n'est pas présent dans 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. Sinon `false`.

waitForDeviceOnline

public void waitForDeviceOnline ()

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

Notez que l'appareil ne répondra pas nécessairement aux commandes une fois la tâche 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épondra pas nécessairement aux commandes une fois la tâche 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 de shell ADB de base.

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

Renvoie
`boolean`	`true` si l'appareil devient réactif avant l'expiration de `waitTime`.

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 de l'OS pour la session de commande shell adb et les arguments donnés.

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

Renvoie
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

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

createRebootDeviceAction

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`

doAdbReboot

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`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

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

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

getApiLevelSafe

protected int getApiLevelSafe ()

Renvoie
`int`

getLogger

protected ITestLogger getLogger ()

Renvoie
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Obtenez l'instance RunUtil à utiliser.

Renvoie
`IRunUtil`

internalGetProperty

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

Récupère une propriété de l'appareil à partir du cache ddmlib par défaut, et utilise "adb shell getprop" ou "fastboot getvar" selon que l'appareil est en mode 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`, la requête fastboot ne sera pas tentée.
`description`	`String`: description simple de la variable. La première lettre doit être en majuscule.

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

Génère
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Indique si les rappels de redémarrage sont actuellement exécutés ou non. Si cette valeur est définie sur "true", toutes les API publiques de redémarrage doivent être désactivées.

Renvoie
`boolean`

isNewer

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, en cas d'heures égales, le fichier sera considéré comme plus récent.

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

Renvoie
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

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

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

notifyRebootStarted

protected void notifyRebootStarted ()

Informe tous les IDeviceActionReceiver de l'événement de démarrage du redémarrage.

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

performDeviceAction

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

Effectue une action sur cet appareil. Tentative de récupération de l'appareil et, éventuellement, de nouvelle tentative de 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 d'action est effectuée en cas d'échec, mais la récupération réussit.

Renvoie
`boolean`	`true` si l'action a réussi

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

postAdbReboot

protected void postAdbReboot ()

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

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

prePostBootSetup

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`

setClock

protected void setClock (Clock clock)

Définissez l'instance Clock à utiliser.

Paramètres
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marque TestDevice comme microdroid et définit son CID.

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êt des rapports à adb).

Paramètres
`operationDesc`	`String`: nom de l'opération en attente d'indisponibilité.
`time`	`long`: temps d'attente avant que l'état "indisponible" ne s'affiche.

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

NativeDevice

Résumé

Classes imbriquées

Constantes

Champs

Constructeurs publics

Méthodes publiques

Méthodes protégées

Constantes

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Champs

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

mStateMonitor

Constructeurs publics

NativeDevice

Méthodes publiques

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos