À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

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 pour les 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 s'exécutant dans une VM Cuttlefish distante.
RemoteAndroidDevice	Implémentation d'un `ITestDevice` pour un appareil Android full stack connecté via adb connect.
RemoteAndroidVirtualDevice	Étend le comportement de `RemoteAndroidDevice` pour un appareil Android à pile complète s'exécutant dans Google Compute Engine (GCE).

Implémentation par défaut d'un ITestDevice pour les appareils Android non full stack.

Résumé

Classes imbriquées
`class`	`NativeDevice.AdbAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` pour exécuter une commande OS "adb ....".
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` pour redémarrer un appareil.

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

Champs
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

Méthodes publiques
`void`	`batchPrefetchStartupBuildProps()` Micro-optimisation (environ 400 millisecondes) en préchargeant toutes les propriétés dont nous avons besoin au lieu d'appeler "adb getprop" pour chacune d'elles.
`boolean`	`canSwitchToHeadlessSystemUser()` Indique si le changement vers l'utilisateur SYSTEM headless est autorisé.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Vérifiez si une fonctionnalité est actuellement disponible pour un niveau de compatibilité minimal.
`boolean`	`checkConnectivity()` Vérifiez que l'appareil est connecté au réseau.
`boolean`	`clearErrorDialogs()` Tente de fermer toutes les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil.
`void`	`clearLastConnectedWifiNetwork()` Efface le dernier réseau Wi-Fi connecté.
`void`	`clearLogcat()` Supprime toutes les données logcat accumulées.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Se 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.f
`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 actuellement pas 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 actuellement pas connecté au réseau.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Créez un utilisateur avec un nom donné et les indicateurs fournis.
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Créez un utilisateur avec un nom donné et les indicateurs fournis.
`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'un appareil devient indisponible.
`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 le `IDeviceActionReceiver` enregistré.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Méthode d'assistance permettant de vérifier si l'appareil a été redémarré 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 été redémarré en mode logiciel depuis l'heure UTC depuis l'epoch de l'appareil et son `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Désactive adb root.
`void`	`disableKeyguard()` Tentatives de désactivation du keyguard.
`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)` Essayez de vider le tas depuis system_server.
`boolean`	`enableAdbRoot()` Active le 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 d'attente spécifié.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
`String`	`executeAdbCommand(String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, String... cmdArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'attente 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 adb shell et renvoie le résultat sous la forme d'un `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Exécute une commande adb shell, avec d'autres 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 adb shell, avec d'autres paramètres pour contrôler le comportement de la commande.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Exécute la commande adb shell donnée, en effectuant plusieurs tentatives si la commande échoue.
`CommandResult`	`executeShellV2Command(String cmd)` Méthode d'assistance qui exécute une commande adb shell et renvoie les résultats sous la forme d'un `CommandResult` correctement renseigné avec la sortie de l'état de la commande, stdout et stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Méthode d'assistance qui exécute une commande adb shell et renvoie les résultats sous la forme d'un `CommandResult` correctement renseigné avec la sortie de l'état de la commande et stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Méthode d'assistance qui exécute une commande adb shell et renvoie les résultats sous la forme d'un `CommandResult` correctement renseigné avec la sortie de l'état de la commande, stdout et stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande adb shell, avec d'autres paramètres pour contrôler le comportement de la commande.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Exécute une commande adb shell, avec d'autres 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 adb shell, avec d'autres 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 adb shell, avec d'autres 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ère les informations sur les APEX activés sur l'appareil.
`String`	`getAdbPath()` Renvoie le chemin d'accès au binaire adb utilisé.
	`getAllSettings(String namespace)` Renvoie les paires clé/valeur de l'espace de noms demandé.
`DeviceAllocationState`	`getAllocationState()` Renvoie l'état d'allocation actuel de l'appareil.
`String`	`getAndroidId(int userId)` Recherchez et renvoyez l'android-id associé à un userId. Renvoie la valeur "null" si aucun n'est trouvé.
	`getAndroidIds()` Créez une carte des ID Android trouvés 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érer les informations des packages installés sur l'appareil.
`String`	`getBasebandVersion()` Méthode pratique pour 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 et la raison du démarrage depuis la durée donnée depuis l'époque 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 depuis l'appareil.
`InputStreamSource`	`getBugreportz()` Récupère un bugreportz depuis l'appareil.
`String`	`getBuildAlias()` Récupérez l'alias de la version que l'appareil exécute actuellement.
`String`	`getBuildFlavor()` Récupérez la variante de compilation pour l'appareil.
`String`	`getBuildId()` Récupérez la version actuellement exécutée par 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 attribué, sinon renvoie le `DeviceDescriptor` actuel.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Renvoie un `DeviceDescriptor` mis en cache si l'appareil est attribué, sinon renvoie le `DeviceDescriptor` actuel.
`String[]`	`getChildren(String path)` Alternative à l'utilisation de `IFileEntry`, qui ne fonctionne parfois pas en raison des autorisations.
`AbstractConnection`	`getConnection()` La connexion actuelle associée à l'appareil.
`ContentProviderHandler`	`getContentProvider(int userId)` Renvoie `ContentProviderHandler` ou la valeur "null" si elle n'est pas disponible.
`DeviceFoldableState`	`getCurrentFoldableState()` Renvoie l'état de pliage actuel de l'appareil ou la valeur "null" en cas de problème.
`int`	`getCurrentUser()` Renvoie l'ID de l'utilisateur actuellement 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()` Renvoie un `DeviceDescriptor` à partir des informations sur l'appareil pour obtenir des informations à son sujet sans transmettre l'objet de l'appareil proprement dit.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Renvoie un `DeviceDescriptor` à partir des informations sur l'appareil pour obtenir des informations à son sujet sans transmettre l'objet de l'appareil proprement dit.
`TestDeviceState`	`getDeviceState()` Obtenez l'état de l'appareil.
`long`	`getDeviceTimeOffset(Date date)` Assistant permettant d'obtenir la différence de temps entre l'appareil et un `ERROR(/Date)` donné.
`InputStreamSource`	`getEmulatorOutput()` Obtenir le flux 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 pour obtenir un `FileEntry` à partir d'un chemin non racine.
	`getFoldableStates()` Renvoie la liste des états de pliage de l'appareil.
`IDevice`	`getIDevice()` Renvoie une référence au `IDevice` ddmlib associé.
	`getInstalledPackageNames()` Récupère les noms de 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 de l'appareil.
`String`	`getIpAddress()` Obtient l'adresse IP de l'appareil.
`KeyguardControllerState`	`getKeyguardState()` Renvoie un objet pour obtenir l'état actuel du keyguard ou la valeur "null" si ce n'est pas pris en charge.
`long`	`getLastExpectedRebootTimeMillis()` Renvoie la dernière fois que les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH, comme renvoyé par `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Obtenez le premier niveau d'API de l'appareil.
`InputStreamSource`	`getLogcat()` Récupère un flux d'instantanés des données logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Récupère un flux d'instantané des `maxBytes` dernières données logcat capturées.
`InputStreamSource`	`getLogcatDump()` Obtenez un dump du fichier logcat actuel pour l'appareil.
`InputStreamSource`	`getLogcatSince(long date)` Récupère un flux d'instantanés des données logcat capturées à partir de la date fournie.
`String`	`getMacAddress()` Renvoie l'adresse MAC de l'appareil ou la valeur "null" si la requête à l'appareil échoue.
`Integer`	`getMainUserId()` Renvoie l'ID utilisateur principal.
	`getMainlineModuleInfo()` Obtenez des informations sur les modules principaux installés sur l'appareil.
`int`	`getMaxNumberOfRunningUsersSupported()` Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément.
`int`	`getMaxNumberOfUsersSupported()` Obtenez le nombre maximal d'utilisateurs acceptés.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Renvoie le `IDeviceStateMonitor` associé à l'appareil.
`String`	`getMountPoint(String mountName)` Renvoie un point de montage.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Renvoie un `MountPointInfo` correspondant au chemin du point de montage spécifié, ou `null` si ce chemin n'a rien de monté ou n'apparaît pas dans /proc/mounts en tant que point de montage.
	`getMountPointInfo()` Renvoie une version analysée des informations contenues dans /proc/mounts sur l'appareil.
`TestDeviceOptions`	`getOptions()` Récupérez les options de test pour l'appareil.
`long`	`getPartitionFreeSpace(String partition)` Méthode d'assistance permettant de déterminer la quantité d'espace libre 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" en cas de problème.
`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()` Obtenez le mode Récupération actuel utilisé pour l'appareil.
`InputStreamSource`	`getScreenshot(long displayId)` Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil.
`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 du système.
`String`	`getSimOperator()` Renvoie l'opérateur de la carte SIM ou la valeur "null" si l'opérateur n'est pas disponible ou si l'appareil n'est pas disponible.
`String`	`getSimState()` Renvoie l'état de la carte SIM ou la valeur "null" si elle n'est pas disponible ou si l'appareil n'est pas disponible.
	`getTombstones()` Récupérez et renvoyez la liste des fichiers fantômes des appareils.
`long`	`getTotalMemory()` Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne.
`String`	`getTrackingSerial()` Pour gérer l'appareil, récupérez le numéro de série utilisé pour le suivre.
	`getUninstallablePackageNames()` Récupère les noms de package des applications qui peuvent être désinstallées.
`boolean`	`getUseFastbootErase()` Indique s'il faut utiliser fastboot erase ou fastboot format pour effacer une partition sur l'appareil.
`int`	`getUserFlags(int userId)` Recherchez et renvoyez les indicateurs d'un utilisateur donné.
	`getUserInfos()` Récupère le mappage d'useId vers `UserInfo` sur l'appareil.
`int`	`getUserSerialNumber(int userId)` Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, ou -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'attribution.
`boolean`	`hasFeature(String feature)` Vérifiez 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)` Installez un package Android sur l'appareil.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Installez 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é.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` Installe les APK avec le mode incrémentiel.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Vérifier si la plate-forme sur l'appareil est compatible avec l'énumération des applications
`boolean`	`isBypassLowTargetSdkBlockSupported()` Vérifier si la plate-forme sur l'appareil permet de contourner le blocage des installations d'applications avec un SDK cible bas
`boolean`	`isDebugfsMounted()` Vérifiez si debugfs est monté.
`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 fastboot est disponible pour l'appareil.
`boolean`	`isHeadless()` Renvoie "true" si l'appareil est sans affichage (sans écran), "false" dans le cas contraire.
`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é au statut de non-administrateur.
`boolean`	`isMultiUserSupported()` Détermine si plusieurs utilisateurs sont acceptés.
`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 sur l'appareil est compatible avec l'octroi d'autorisations d'exécution
`boolean`	`isStateBootloaderOrFastbootd()` Renvoie "true" si l'appareil est en mode `TestDeviceState.FASTBOOT` ou `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Vérifiez si un utilisateur donné est en cours d'exécution.
`boolean`	`isUserSecondary(int userId)` Indique si l'utilisateur spécifié est un utilisateur secondaire 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 le démarrage visible des utilisateurs en arrière-plan dans `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Indique si l'appareil autorise le démarrage visible des utilisateurs en arrière-plan.
`boolean`	`isWifiEnabled()` Testez si le Wi-Fi est activé.
	`listDisplayIds()` Collectez la liste des ID d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Obtient 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 enregistre les 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 pour les reporters.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Consignez un message dans le logcat de l'appareil.
`void`	`mountDebugfs()` Installez debugfs.
`void`	`nonBlockingReboot()` Émet une commande pour redémarrer l'appareil et renvoie la commande lorsqu'elle est terminée et que l'appareil n'est plus visible par adb.
`void`	`postAdbRootAction()` Remplacez si l'appareil nécessite des actions spécifiques après adb root et avant qu'il ne soit de nouveau en ligne.
`void`	`postAdbUnrootAction()` Remplacez si l'appareil nécessite des actions spécifiques après la suppression de la racine 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 seront exécutées 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 seront exécutées 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 depuis l'appareil.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrayez de manière récursive le contenu du répertoire depuis 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 pour récupérer un fichier à partir de la mémoire de stockage externe de l'appareil, le stocker dans un `ERROR(/File)` temporaire local et renvoyer une référence à ce `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Transférer de manière récursive le contenu du répertoire vers l'appareil tout 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 éventuellement évaluer les besoins du fournisseur de contenu.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Transférez un fichier sur un appareil.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Transférez un fichier sur un 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 le `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 sous la récupération) Bloque jusqu'à ce que l'appareil passe en mode Sideload
`void`	`rebootIntoSideload(boolean autoReboot)` Redémarre l'appareil en mode sideload adb (notez qu'il s'agit d'un mode spécial sous la récupération) Bloque jusqu'à ce que l'appareil passe en mode Sideload
`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 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()` Tentatives de rétablissement de la communication avec l'appareil.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Enregistre un `IDeviceActionReceiver` pour cet appareil.
`void`	`remountSystemReadOnly()` Rendez la partition système de l'appareil en lecture seule.
`void`	`remountSystemWritable()` Rendez la partition système de l'appareil accessible en écriture.
`void`	`remountVendorReadOnly()` Rendez la partition du fournisseur en lecture seule sur l'appareil.
`void`	`remountVendorWritable()` Rendez la partition du fournisseur sur l'appareil accessible en écriture.
`boolean`	`removeAdmin(String componentName, int userId)` Supprime l'administrateur de l'appareil donné pour l'utilisateur donné et renvoie `true` en cas de succès, `false` sinon.
`void`	`removeOwners()` Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.
`boolean`	`removeUser(int userId)` Supprimez un utilisateur donné de l'appareil.
`void`	`resetContentProviderSetup()` Réinitialisez le signalement pour la configuration du fournisseur de contenu afin de 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 permet la 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 spécifié.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Identique à `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, mais exécute le test pour un utilisateur donné.
`void`	`setAdbPath(String adbPath)` Définit le chemin d'accès au binaire adb à utiliser.
`void`	`setConfiguration(IConfiguration configuration)` Injecte le `IConfiguration` en cours d'utilisation.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Définit la date sur l'appareil Remarque : La définition de la date sur l'appareil nécessite un accès root.
`boolean`	`setDeviceOwner(String componentName, int userId)` Définissez un composant d'administrateur de l'appareil comme 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 le `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 temps d'attente en millisecondes avant de commencer la capture logcat pour un appareil en ligne.
`void`	`setOptions(TestDeviceOptions options)` Définir le `TestDeviceOptions` pour l'appareil
`boolean`	`setProperty(String propKey, String propValue)` Définit la valeur de propriété donnée sur l'appareil.
`void`	`setRecovery(IDeviceRecovery recovery)` Définissez le `IDeviceRecovery` à utiliser pour cet appareil.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Définit le mode 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 du 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 gérer les appareils, suivez le numéro de série que nous utilisons pour faire référence à l'appareil.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Définissez si vous souhaitez utiliser fastboot erase ou fastboot format pour effacer une partition sur l'appareil.
`void`	`startLogcat()` Commencez à capturer la sortie logcat de l'appareil en arrière-plan.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Activez le mode reprise 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 en permettant à l'utilisateur de lancer des activités sur cet écran).
`void`	`stopEmulatorOutput()` Fermez et supprimez la sortie de l'émulateur.
`void`	`stopLogcat()` Arrête la capture de la sortie Logcat de l'appareil et supprime les données Logcat actuellement enregistrées.
`void`	`stopTradeInModeTesting()` Arrêtez de tester le mode Échange.
`boolean`	`stopUser(int userId)` Arrête un utilisateur donné.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Arrêtez un utilisateur donné.
`String`	`switchToAdbTcp()` Passez l'appareil en mode adb-over-tcp.
`boolean`	`switchToAdbUsb()` Passez l'appareil en mode adb sur USB.
`boolean`	`switchUser(int userId)` Passez à un autre userId avec un délai d'inactivité par défaut.
`boolean`	`switchUser(int userId, long timeout)` Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite.
`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()` Prenez un rapport de bug et renvoyez-le 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émontez 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.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` Bloque l'appareil pour qu'il soit en état "adb recovery" (notez que cet état est différent de `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocages pour que l'appareil soit en état "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` L'appareil est bloqué et n'est pas disponible (il est absent d'adb).
`void`	`waitForDeviceOnline()` Bloque jusqu'à ce que l'appareil soit visible via adb.
`void`	`waitForDeviceOnline(long waitTime)` Bloque jusqu'à ce que l'appareil soit visible via adb.
`boolean`	`waitForDeviceShell(long waitTime)` Attend que l'appareil réponde à une commande shell adb de base.

Méthodes protégées
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Crée la commande OS pour la session et les arguments de la commande adb shell donnée
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Créez un `RebootDeviceAction` à utiliser lors d'une action de redémarrage.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Effectuez un redémarrage adb.
`void`	`ensureRuntimePermissionSupported()` Méthode d'assistance pour générer une exception si l'autorisation d'exécution n'est pas acceptée
`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 revient à `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 en cours d'exécution ou non.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Renvoie `true` si le fichier local est plus récent que le fichier distant.
`void`	`notifyRebootEnded()` Avertit tous les `IDeviceActionReceiver` de l'événement de fin de redémarrage.
`void`	`notifyRebootStarted()` Avertit tous les `IDeviceActionReceiver` de l'événement de début de redémarrage.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Effectue une action sur cet appareil.
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` 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 le TestDevice comme microdroid et définit son CID.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Exécute une simple commande fastboot avec des variables d'environnement et indique l'état de la commande.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Exécute une simple commande fastboot et indique l'état de la commande.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Attendez que l'appareil devienne indisponible (arrêtez d'envoyer des rapports à adb).

Constantes

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Valeur de constante : "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

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

Valeur constante : -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valeur constante : 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

Valeur constante : 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Constant Value: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Valeur constante : "/storage/emulated/"

Champs

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructeurs publics

NativeDevice

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

Crée un 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 nul

Méthodes publiques

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Micro-optimisation (environ 400 ms) en préchargeant toutes les propriétés dont nous avons besoin au lieu d'appeler "adb getprop" pour chacune d'elles. En d'autres termes, il est tout aussi rapide de récupérer toutes les propriétés que d'en récupérer une seule. Des éléments tels que device.getApiLevel(), checkApiLevelAgainstNextRelease et getBuildAlias appellent tous `adb getprop` en interne. 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 simplement un peu plus tôt. Si l'appareil est en mode Recovery ou si d'autres erreurs se produisent lors de la récupération des propriétés, nous les ignorons.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Indique si le changement vers l'utilisateur SYSTEM headless est autorisé.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifiez si une fonctionnalité est actuellement disponible pour un niveau de compatibilité minimal. Cette méthode prend en compte les fonctionnalités non publiées avant l'augmentation du niveau d'API.

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

Renvoie
`boolean`	"True" si le niveau est pris en charge. Sinon renvoie "false".

Génère
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

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

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

Génère
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Tente de fermer toutes les boîtes de dialogue d'erreur actuellement affichées sur 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 ()

Efface le dernier réseau Wi-Fi connecté. Cette méthode doit être appelée au début 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 peut être utile si vous souhaitez vous assurer que ITestDevice.getLogcat() ne renvoie que les données de journaux générées après un certain point (par exemple, après le flashage d'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 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 tentera de la rétablir après chaque redémarrage jusqu'à ce que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() soit appelé.

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

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi a été é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 l'opération 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 Wi-Fi auquel se connecter
`wifiPsk`	`String` : phrase secrète PSK ou valeur nulle si non chiffrée

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

Génère
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecter à un réseau Wi-Fi

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

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi a été é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 Wi-Fi auquel se connecter
`wifiPsk`	`String` : phrase secrète PSK ou valeur nulle si non chiffrée
`scanSsid`	`boolean` : indique s'il faut rechercher le SSID masqué pour ce réseau.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi a été é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 actuellement pas connecté au réseau.

Paramètres
`scanSsid`	`boolean` : indique si le SSID masqué doit être recherché pour ce réseau.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi a été é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 actuellement pas connecté au réseau.

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

Génère
`DeviceNotAvailableException`

createUser

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

Créez un utilisateur avec un nom donné et les indicateurs fournis.

Paramètres
`name`	`String` : de l'utilisateur à créer sur l'appareil
`guest`	`boolean` : activer le flag utilisateur "--guest" lors de la création
`ephemeral`	`boolean` : activez le flag 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éez un utilisateur avec un nom donné et les indicateurs fournis.

Paramètres
`name`	`String` : de l'utilisateur à créer sur l'appareil
`guest`	`boolean` : activer le flag utilisateur "--guest" lors de la création
`ephemeral`	`boolean` : activez le flag utilisateur --ephemeral lors de la création.
`forTesting`	`boolean` : activez le flag 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 pour 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'un appareil devient indisponible.

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 d'accès absolu du fichier sur l'appareil.
`userId`	`int` : ID utilisateur à supprimer de

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 d'accès absolu du fichier sur l'appareil.

Génère
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

Paramètres
`deviceActionReceiver`	`IDeviceActionReceiver` : `IDeviceActionReceiver` à supprimer.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Méthode d'assistance permettant de vérifier si l'appareil a été redémarré 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 précédent `ProcessInfo`.

Renvoie
`boolean`	`true` si l'appareil a été redémarré par 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 été redémarré en mode logiciel depuis l'heure UTC depuis l'epoch de l'appareil et 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, un redémarrage demandé). L'utcEpochTime actuel de l'appareil en millisecondes peut être obtenu 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 le utcEpochTime donné.

Renvoie
`boolean`	`true` si l'appareil a été redémarré par logiciel

Génère
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Désactive adb root.

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

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

Génère
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Tentatives de désactivation du keyguard.

Attendez d'abord que la distribution d'entrée 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 parfois une condition de course. La commande est ensuite envoyée pour fermer le keyguard (fonctionne uniquement sur les keyguards 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 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` if disconnect failed.

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 d'accès absolu du fichier à vérifier sur l'appareil
`userId`	`int` : ID utilisateur pour lequel vérifier l'existence du fichier

Renvoie
`boolean`	`true` si le fichier existe, `false` sinon.

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 d'accès absolu du fichier à vérifier sur l'appareil

Renvoie
`boolean`	`true` si le fichier existe, `false` sinon.

Génère
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Essayez de vider le tas depuis system_server. Il incombe à l'appelant de nettoyer le fichier dumpé.

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

Renvoie
`File`	le `ERROR(/File)` contenant le rapport. Null si une erreur s'est produite.

Génère
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Active le root adb. Si le paramètre "enable-root" est défini sur "false", un message est consigné et la fonction renvoie une valeur sans activer la racine.

L'activation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode bloquera jusqu'à ce que l'appareil 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 d'attente spécifié.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode offre une meilleure détection des échecs et de meilleures performances.

Paramètres
`timeout`	`long` : délai en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas (0L pour aucune limite de temps).
`cmdArgs`	`String` : la commande adb et les arguments à exécuter

Renvoie
`String`	la sortie standard de la commande. `null` si la commande n'a pas pu être exécutée.

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 d'attente spécifié.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode offre une meilleure détection des échecs et de meilleures performances.

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

Renvoie
`String`	la sortie standard de la commande. `null` si la commande n'a pas pu être exécutée.

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, utilisez plutôt executeShellCommand(String), car cette méthode offre une meilleure détection des échecs et de meilleures performances.

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

Renvoie
`String`	la sortie standard de la commande. `null` si la commande n'a pas pu être exécutée.

Génère
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode offre une meilleure détection des échecs et de meilleures performances.

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

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

Génère
`DeviceNotAvailableException`

executeAdbV2Command

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

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

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode offre une meilleure détection des échecs et de meilleures performances.

Paramètres
`timeout`	`long` : délai en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas (0L pour aucune limite de temps).
`cmdArgs`	`String` : la commande adb et les arguments à exécuter

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

Génère
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... cmdArgs)

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

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode offre une meilleure détection des échecs et de meilleures performances.

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

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

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

Cette commande est censée être utilisée lorsque l'appareil est déjà en mode Fastboot.

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

Renvoie
`CommandResult`	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.

Cette commande est censée être utilisée lorsque l'appareil est déjà en mode Fastboot.

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

Renvoie
`CommandResult`	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'elle utilise un délai avant expiration plus long.

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

Renvoie
`CommandResult`	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'elle 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`	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 adb shell et renvoie le résultat sous la forme d'un String.

Paramètres
`command`	`String` : commande adb shell à 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 adb shell, avec d'autres paramètres pour contrôler le comportement de la commande.

Paramètres
`command`	`String` : commande adb shell à exécuter
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` vers lequel rediriger la sortie du shell.
`maxTimeToOutputShellResponse`	`long` : durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse. L'unité est spécifiée dans `timeUnit`.
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : nombre maximal de tentatives pour la commande en cas d'échec en raison d'une exception. DeviceNotResponsiveException sera générée si les `retryAttempts` ne sont pas exécutées correctement.

Génère
`DeviceNotAvailableException`

executeShellCommand

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

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

Paramètres
`command`	`String` : commande adb shell à exécuter
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` vers lequel rediriger la sortie du shell.
`maxTimeoutForCommand`	`long` : délai 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 produire aucune réponse. L'unité est spécifiée dans `timeUnit`.
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : nombre maximal de tentatives pour la commande en cas d'échec en raison d'une exception. DeviceNotResponsiveException sera générée si les `retryAttempts` ne sont pas exécutées correctement.

Génère
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Forme simplifiée de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) avec des valeurs par défaut.

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

Génère
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

Renvoie
`CommandResult`	Le résultat est en `CommandResult`.

Génère
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

Renvoie
`CommandResult`	Le résultat est en `CommandResult`.

Génère
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

Renvoie
`CommandResult`	Le résultat est en `CommandResult`.

Génère
`DeviceNotAvailableException`

executeShellV2Command

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

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

Paramètres
`cmd`	`String` : commande adb shell à exécuter
`maxTimeoutForCommand`	`long` : délai 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 pour la commande en cas d'échec en raison d'une exception. DeviceNotResponsiveException sera générée si les `retryAttempts` ne sont pas exécutées correctement.

Renvoie
`CommandResult`

Génère
`DeviceNotAvailableException`

executeShellV2Command

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

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

Paramètres
`cmd`	`String` : commande adb shell à exécuter
`maxTimeoutForCommand`	`long` : délai 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 adb shell, avec d'autres paramètres pour contrôler le comportement de la commande.

Paramètres
`cmd`	`String` : commande adb shell à exécuter
`pipeAsInput`	`File` : `ERROR(/File)` qui sera transmis en entrée à la commande, ou null.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` où la sortie standard sera redirigée, ou null.
`maxTimeoutForCommand`	`long` : délai 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 pour la commande en cas d'échec en raison d'une exception. DeviceNotResponsiveException sera générée si les `retryAttempts` ne sont pas exécutées correctement.

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 adb shell, avec d'autres paramètres pour contrôler le comportement de la commande.

Paramètres
`cmd`	`String` : commande adb shell à exécuter
`pipeAsInput`	`File` : `ERROR(/File)` qui sera transmis en entrée à la commande, ou null.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` où la sortie standard sera redirigée, ou null.
`pipeToError`	`OutputStream` : `ERROR(/OutputStream)` où l'erreur standard sera redirigée, ou null.
`maxTimeoutForCommand`	`long` : délai 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 pour la commande en cas d'échec en raison d'une exception. DeviceNotResponsiveException sera générée si les `retryAttempts` ne sont pas exécutées correctement.

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 défini sur true, la commande fastboot erase sera utilisée pour effacer la partition. L'appareil doit ensuite créer un système de fichiers au prochain démarrage. Sinon, le format fastboot est utilisé, ce qui crée un système de fichiers sur l'appareil.

Cette commande est censée être utilisée lorsque l'appareil est déjà en mode Fastboot.

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

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

Génère
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Récupère les informations sur les APEX activés sur l'appareil.

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

Génère
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

Renvoie le chemin d'accès au binaire adb utilisé.

Renvoie
`String`

getAllSettings

public  getAllSettings (String namespace)

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

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

Renvoie
	Carte des paires clé/valeur. Valeur nulle si l'espace de noms n'est pas pris en charge.

Génère
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Renvoie 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. Renvoie la valeur "null" si aucun n'est trouvé.

Paramètres
`userId`	`int`

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Créez une carte des ID Android trouvés correspondant aux ID utilisateur. Cette fonction ne garantit pas que chaque ID utilisateur trouvera un ID Android associé. Par conséquent, certains ID utilisateur peuvent correspondre à la valeur nulle.

Renvoie
	Carte des ID Android correspondant 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`	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érer les informations des packages installés sur l'appareil.

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

Génère
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Méthode pratique pour 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 que les informations renvoyées ne soient pas 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 indiquée ici peut ne pas correspondre à celle signalée par fastboot et peut ne pas renvoyer la version de la radio CDMA. En résumé, cette méthode ne signale une version précise 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`, sinon.

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 et la raison du démarrage depuis la durée donnée depuis l'époque de l'appareil et l'unité de temps spécifiée. L'utcEpochTime actuel de l'appareil en millisecondes peut être obtenu par 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. (c'est-à-dire que 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` s'il est introuvable.

Génère
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

L'implémentation de cette fonctionnalité est garantie de continuer à 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ère le contenu du rapport de bug à la demande. En cas d'échec, `InputStreamSource` génère un `ERROR(/InputStream)` vide.

getBugreportz

public InputStreamSource getBugreportz ()

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

Uniquement compatible avec "adb version" > 1.0.36

Renvoie
`InputStreamSource`	`InputStreamSource` du fichier ZIP contenant les bugreportz. Renvoie la valeur "null" en cas d'échec.

getBuildAlias

public String getBuildAlias ()

Récupérez l'alias de la version que l'appareil exécute actuellement.

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

Renvoie
`String`	l'alias de build ou l'ID de build si l'alias n'a pas pu être récupéré.

Génère
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Récupérez la variante de compilation pour l'appareil.

Renvoie
`String`	la variante de build ou null si elle n'a pas pu être récupérée.

Génère
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

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

Renvoie
`String`	ID du build ou `IBuildInfo.UNKNOWN_BUILD_ID` s'il n'a pas pu être récupéré

Génère
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

En règle générale, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de version (contrôlé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 attribué, sinon renvoie le DeviceDescriptor actuel.

Renvoie
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Renvoie un DeviceDescriptor mis en cache si l'appareil est attribué, 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 des 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 ()

La connexion actuelle associée à l'appareil.

Renvoie
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

Le fournisseur de contenu peut être réutilisé s'il a été construit auparavant avec le même userId.

Paramètres
`userId`	`int` : ID utilisateur permettant d'initialiser le fournisseur de contenu.

Renvoie
`ContentProviderHandler`

Génère
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état de pliage actuel de l'appareil ou la valeur "null" en cas de problème.

Renvoie
`DeviceFoldableState`

Génère
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Renvoie l'ID de l'utilisateur actuellement 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 ()

Renvoie un DeviceDescriptor à partir des informations sur l'appareil pour obtenir des informations à son sujet sans transmettre l'objet de l'appareil proprement dit.

Renvoie
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoie un DeviceDescriptor à partir des informations sur l'appareil pour obtenir des informations à son sujet sans transmettre l'objet de l'appareil proprement dit.

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)

Assistant permettant d'obtenir la différence de temps entre l'appareil et un ERROR(/Date) donné. Utilisez le temps Unix en interne.

Paramètres
`date`	`Date`

Renvoie
`long`	la différence en millisecondes

Génère
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Obtenir le flux 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é. Nécessite toujours que isFastbootEnabled() soit 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 s'il est dans un état incorrect ou ne répond pas.

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

Génère
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

Méthode pratique 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` s'il ne peut pas être déterminé.

Génère
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

Renvoie
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Récupérez la valeur de 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 si quelque chose ne va pas.

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 à l'emplacement `path` donné est introuvable

Génère
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Assistant non officiel pour obtenir un FileEntry à partir d'un chemin non racine. FIXME: Refactor the FileEntry system to have it available from any path. (même non root).

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

Renvoie
`IFileEntry`	un FileEntryWrapper représentant FileEntry.

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

getFoldableStates

public  getFoldableStates ()

Renvoie la liste des états de pliage de l'appareil. Vous pouvez l'obtenir avec la commande "cmd device_state print-states".

Renvoie

Génère
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

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

Un nouveau IDevice peut être attribué par DDMS chaque fois que l'appareil se déconnecte et se reconnecte à partir d'adb. Les appelants ne doivent donc pas conserver de référence à IDevice, car cette référence peut devenir obsolète.

Renvoie
`IDevice`	le `IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Récupère les noms de packages d'application présents sur l'appareil.

Renvoie
	`ERROR(/Set)` noms de packages sur `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 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 ()

Obtient 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 keyguard ou la valeur "null" si ce n'est pas pris en charge.

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

Génère
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Renvoie
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

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

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

Renvoie
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

L'inconvénient est que rien ne sera 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 fournie. L'heure de l'appareil doit être utilisée getDeviceDate().

Paramètres
`date`	`long` : date de début de l'instantané jusqu'à aujourd'hui, en millisecondes depuis l'epoch. (peut être obtenu à l'aide de "date +%s")

Renvoie
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Renvoie l'adresse MAC de l'appareil ou la valeur "null" si la requête à l'appareil échoue.

Renvoie
`String`

getMainUserId

public Integer getMainUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
`Integer`	userId de l'utilisateur principal, le cas échéant, ou null si aucun utilisateur principal n'est défini.

Génère
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

Génère
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément. La valeur par défaut est 0.

Renvoie
`int`	Nombre 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`	Entier indiquant le nombre d'utilisateurs acceptés

Génère
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

Renvoie le IDeviceStateMonitor associé à l'appareil.

Renvoie
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Renvoie un point de montage.

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 de montage

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Renvoie un MountPointInfo correspondant au chemin du point de montage spécifié, ou null si ce chemin n'a rien de monté ou n'apparaît pas dans /proc/mounts en tant que point de montage.

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 contenues 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é à l'appareil testé.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Méthode d'assistance permettant de déterminer la quantité d'espace libre 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`	ID utilisateur de l'utilisateur principal, le cas échéant. La valeur est "null" 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 processName donné

Génère
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

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

Renvoie
`String`

Génère
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Méthode pratique 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 du produit `String` ou `null` s'il ne peut pas être déterminé.

Génère
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

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

Obtenez le mode Récupération actuel utilisé pour l'appareil.

Renvoie
`ITestDevice.RecoveryMode`	Mode Récupération actuel utilisé pour l'appareil.

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil. Le format est PNG.

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

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

Renvoie
`InputStreamSource`	`InputStreamSource` de la capture d'écran au format `null` si la capture d'écran n'a pas réussi.

Génère
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Prend une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot(format) avec l'encodage JPEG pour une taille plus petite.

Paramètres
`format`	`String` : PNG, JPEG

Renvoie
`InputStreamSource`	`InputStreamSource` de la capture d'écran au format `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) avec l'encodage JPEG pour une taille plus petite.

Paramètres
`format`	`String` : PNG, JPEG
`rescale`	`boolean` : indique si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante.

Renvoie
`InputStreamSource`	`InputStreamSource` de la capture d'écran au format `null` si la capture d'écran n'a pas réussi.

Génère
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

Renvoie
`InputStreamSource`	`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. Null si introuvable.

Génère
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Voir getSetting(int, String, String) et effectué sur l'utilisateur du 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 la valeur "null" si l'opérateur n'est pas disponible ou si l'appareil n'est pas disponible.

Renvoie
`String`

getSimState

public String getSimState ()

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

Renvoie
`String`

getTombstones

public  getTombstones ()

Récupérez et renvoyez la liste des fichiers fantômes des appareils. Nécessite un accès root.

La méthode est basée sur le principe du meilleur effort. Par conséquent, si une pierre tombale ne peut pas être extraite pour une raison quelconque, elle manquera à la liste. Seul un DeviceNotAvailableException mettra fin à la méthode de manière anticipée.

Renvoie
	Liste des fichiers tombstone, vide si aucun fichier tombstone n'est présent.

Génère
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

Renvoie
`long`

getTrackingSerial

public String getTrackingSerial ()

Pour gérer l'appareil, récupérez le numéro de série utilisé pour le suivre.

Renvoie
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Récupère les noms de package des applications qui peuvent être désinstallées. Il est actuellement défini comme des packages non système et des packages système mis à jour.

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

Génère
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Indique s'il faut utiliser fastboot erase ou fastboot format pour effacer une partition sur l'appareil.

Renvoie
`boolean`	`true` si la commande fastboot erase sera utilisée ou `false` si la commande fastboot format sera utilisée.

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, ou -10000 dans les autres cas.

Génère
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Récupère le mappage d'useId vers UserInfo sur l'appareil. Génère DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.

Renvoie
	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é, ou -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é. L'appareil peut passer à un nouvel état. informera le IDeviceMonitor de toute transition d'état.

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

Paramètres
`event`	`DeviceEvent`

Renvoie
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Vérifiez si une fonctionnalité est disponible sur un appareil.

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

Renvoie
`boolean`	"True" si la fonctionnalité est trouvée, "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 pendant 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)

Installez un package Android sur l'appareil.

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

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de succès.

Génère
`DeviceNotAvailableException`

installPackage

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

Installez un package Android sur l'appareil.

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'autorisations 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` : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
`extraArgs`	`String` : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de succès.

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 installer.
`extraArgs`	`String` : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de succès.

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'autorisations 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` : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
`userId`	`int` : ID utilisateur entier pour lequel installer.
`extraArgs`	`String` : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de succès.

Génère
`DeviceNotAvailableException`

installPackageWithIncrementalMode

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

Installe les APK avec le mode incrémentiel.

Paramètres
`apkFiles`	`File` : fichiers APK à installer.
`extraArgs`	`String`
`userId`	`String`

Renvoie
`boolean`

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 sur l'appareil est compatible avec l'énumération des applications

Renvoie
`boolean`	"True" si l'énumération des applications est acceptée, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

Vérifier si la plate-forme sur l'appareil permet de contourner le blocage des installations d'applications avec un SDK cible bas

Renvoie
`boolean`	"True" si le blocage du SDK cible bas peut être contourné, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Vérifiez si debugfs est monté.

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

Génère
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Indique si l'appareil est chiffré.

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

Génère
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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 adb root 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 fastboot est disponible pour l'appareil.

Renvoie
`boolean`

isHeadless

public boolean isHeadless ()

Renvoie "true" si l'appareil est headless (sans écran), ou "false" dans le cas contraire.

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é au statut de non-administrateur.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Détermine si plusieurs utilisateurs sont acceptés.

Renvoie
`boolean`	"true" si le multi-utilisateur est pris 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 dont nous vérifions l'installation.
`userId`	`String` : ID de l'utilisateur pour lequel nous vérifions si le package est installé. Si la valeur est nulle, l'utilisateur principal zéro sera utilisé.

Renvoie
`boolean`	Valeur "true" si le package est signalé comme installé. Sinon renvoie "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`	Valeur "true" si le package est signalé comme installé. Sinon renvoie "false".

Génère
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

Renvoie
`boolean`	"True" si les autorisations d'exécution sont acceptées, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

Renvoie
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

Paramètres
`userId`	`int`

Renvoie
`boolean`	"True" si l'utilisateur court, "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 qui peut donc lancer des activités de lancement (généralement sur l'écran par défaut).

Paramètres
`userId`	`int`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil autorise le démarrage visible des utilisateurs 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 autorise le démarrage visible des utilisateurs en arrière-plan.

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Testez 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 être exécutés avec le Wi-Fi, par exemple les tests de données mobiles.

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

Génère
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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

Renvoie
	Liste des écrans. Default renvoie toujours l'affichage par défaut 0.

Génère
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtient 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 DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.

Renvoie
	Liste des ID utilisateur.

Génère
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Collecte et enregistre les ANR de l'appareil.

Paramètres
`logger`	`ITestLogger` : `ITestLogger` pour enregistrer les 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 pour les reporters.

Paramètres
`dataName`	`String` : nom sous lequel le rapport de bug sera signalé.
`listener`	`ITestLogger` : `ITestLogger` pour enregistrer 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)

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

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

mountDebugfs

public void mountDebugfs ()

Installez debugfs.

Génère
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

Émet une commande pour redémarrer l'appareil et renvoie la commande lorsqu'elle est terminée et que l'appareil n'est plus visible par adb.

Génère
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

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

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Remplacez si l'appareil nécessite des actions spécifiques après la suppression de 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 adb root 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 l'appareil complètement démarré/disponible

Dans des circonstances 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.

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

Génère
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

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

Étapes supplémentaires pour la configuration requise spécifique à l'appareil, qui seront exécutées 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'invocation

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 depuis l'appareil.

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

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 depuis l'appareil.

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

Renvoie
`boolean`	`true` si le fichier a bien été extrait. 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 d'accès absolu au fichier sur l'appareil.
`localFile`	`File` : fichier local dans lequel stocker le contenu. S'il n'est pas vide, son contenu sera remplacé.

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 d'accès absolu au fichier sur l'appareil.
`userId`	`int` : ID utilisateur à partir duquel extraire les données.

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 des problèmes liés au 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 d'accès absolu au fichier sur l'appareil.

Renvoie
`File`	`ERROR(/File)` contenant le contenu du fichier de l'appareil ou `null` si la copie a échoué pour une raison quelconque (y compris des problèmes liés au 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 d'accès absolu au fichier sur l'appareil.
`localFile`	`File` : fichier local dans lequel stocker le contenu. Si elle n'est pas vide, son contenu sera remplacé.
`userId`	`int` : ID utilisateur à partir duquel extraire les données.

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 d'accès absolu au fichier sur l'appareil.

Renvoie
`String`	`String` contenant le contenu du fichier de l'appareil ou `null` si la copie a échoué pour une raison quelconque (y compris des problèmes liés au système de fichiers hôte)

Génère
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

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

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

Renvoie
`File`	`ERROR(/File)` contenant le contenu du fichier de l'appareil ou `null` si la copie a échoué pour une raison quelconque (y compris des problèmes liés au système de fichiers hôte)

Génère
`DeviceNotAvailableException`

pushDir

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

Transférer de manière récursive le contenu du répertoire vers l'appareil tout en excluant certains répertoires filtrés.

Paramètres
`localFileDir`	`File` : répertoire local à transférer
`deviceFilePath`	`String` : chemin d'accès absolu du fichier 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 à transférer
`deviceFilePath`	`String` : chemin d'accès absolu du fichier 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 à transférer
`deviceFilePath`	`String` : chemin d'accès absolu du fichier de la destination distante
`userId`	`int` : ID utilisateur auquel envoyer la notification

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 éventuellement évaluer les besoins du fournisseur de contenu.

Paramètres
`localFile`	`File` : fichier local à transférer
`remoteFilePath`	`String` : chemin d'accès absolu du fichier de destination distant
`evaluateContentProviderNeeded`	`boolean` : indique s'il faut vérifier 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érez un fichier sur un appareil. Par défaut, un fournisseur de contenu est utilisé.

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

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érez un fichier sur un appareil. Par défaut, un fournisseur de contenu est utilisé.

Paramètres
`localFile`	`File` : fichier local à transférer
`remoteFilePath`	`String` : chemin d'accès absolu du fichier de destination distant
`userId`	`int` : l'ID utilisateur vers lequel envoyer la notification

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 à transférer
`remoteFilePath`	`String` : chemin d'accès absolu du fichier de destination distant

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

Génère
`DeviceNotAvailableException`

redémarrer

public void reboot (String reason)

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

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

Le motif du dernier redémarrage peut être obtenu 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 passe 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 sous la récupération)

Bloque jusqu'à ce que l'appareil passe en mode Sideload

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 sous la récupération)

Bloque jusqu'à ce que l'appareil passe en mode Sideload

Paramètres
`autoReboot`	`boolean` : indique si l'appareil doit redémarrer automatiquement après le transfert de fichiers.

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 espace utilisateur de l'appareil.

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

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

Génère
`DeviceNotAvailableException`

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

Tentatives de rétablissement de la communication avec l'appareil.

Renvoie
`boolean`	"True" si la récupération a été tentée et a réussi, "False" si elle 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 recevront une notification avant le début et après la fin d'une action sur un appareil.

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

remountSystemReadOnly

public void remountSystemReadOnly ()

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

Génère
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

Génère
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

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

Génère
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

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

Supprime l'administrateur de l'appareil donné pour l'utilisateur donné et renvoie true en cas de succès, false sinon.

Paramètres
`componentName`	`String` : administrateur de l'appareil à supprimer.
`userId`	`int` : de l'utilisateur auquel appartient l'administrateur de l'appareil.

Renvoie
`boolean`	"True" si l'opération a réussi, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.

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 l'utilisateur a bien été supprimé, "false" dans le cas contraire.

Génère
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Réinitialisez le flag 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` : écouteur(s) de résultats de test

Renvoie
`boolean`	`true` si la commande de test est terminée. `false` si elle n'a pas pu se terminer, 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 permet la 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 réussit, tous les écouteurs seront informés de l'échec de testRun et la valeur "false" sera 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 seront informés de l'échec de l'exécution du test et une exception DeviceNotAvailableException sera générée.

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

Renvoie
`boolean`	`true` si la commande de test est terminée. `false` si l'opération a échoué en raison d'une exception de communication avec 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 spécifié.

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`

setAdbPath

public void setAdbPath (String adbPath)

Définit le chemin d'accès au binaire adb à utiliser.

Paramètres
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration en cours d'utilisation.

Paramètres
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Paramètres
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Définit la date sur l'appareil

Remarque : La définition de la date sur l'appareil nécessite un accès root.

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

Génère
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

Paramètres
`componentName`	`String` : de l'administrateur de l'appareil au propriétaire de l'appareil.
`userId`	`int` : de l'utilisateur avec lequel le propriétaire de l'appareil vit.

Renvoie
`boolean`	"True" si l'opération 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 le 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 attribué 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. Nécessite toujours que isFastbootEnabled() soit 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 sera appelée si DDMS a attribué un nouvel IDevice.

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

setLogStartDelay

public void setLogStartDelay (int delay)

Définit le temps 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 pour l'appareil

Paramètres
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Définit la valeur de propriété donnée sur l'appareil. Nécessite que la racine adb soit définie sur "true".

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

Renvoie
`boolean`	renvoie `True` si la commande setprop a réussi, sinon renvoie "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 attribué pour la première fois.

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

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Définit le mode 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 avec un appareil. Il est recommandé de n'utiliser cette méthode que rarement, 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érer uniquement jusqu'à la dernière sauvegarde en ligne" 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 du 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 gérer les appareils, suivez le numéro de série que nous utilisons pour faire référence à l'appareil.

Paramètres
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Définissez si vous souhaitez utiliser fastboot erase ou fastboot format pour effacer une partition sur l'appareil.

Paramètres
`useFastbootErase`	`boolean` : `true` si fastboot erase doit être utilisé ou `false` si fastboot format doit être utilisé.

startLogcat

public void startLogcat ()

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

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

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

Il n'est normalement pas nécessaire d'appeler startLogcat() et stopLogcat() dans un contexte d'invocation TF, car le framework TF démarrera et arrêtera logcat.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

Activez le mode reprise test. Les données de l'appareil seront effacées et il redémarrera.

Paramètres
`timeoutMs`	`int`

Renvoie
`boolean`	"True" si l'opération 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 NOOP.

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 NOOP. Il est possible 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 en permettant à l'utilisateur de lancer des activités sur cet écran).

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

Paramètres
`userId`	`int` : de l'utilisateur à démarrer en arrière-plan
`displayId`	`int` : écran sur lequel l'utilisateur est visible au début
`waitFlag`	`boolean` : la commande attendra que l'utilisateur soit démarré et déverrouillé.

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

Génère
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Fermez et supprimez la sortie de l'émulateur.

stopLogcat

public void stopLogcat ()

Arrête la capture de la sortie Logcat de l'appareil et supprime les données Logcat actuellement enregistrées.

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

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Arrêtez de tester le mode É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 NOOP. Impossible d'arrêter l'utilisateur actuel et l'utilisateur 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êtez un utilisateur donné. Il est possible de fournir des indicateurs supplémentaires pour attendre que l'opération prenne effet et forcer la résiliation de l'utilisateur. Impossible d'arrêter l'utilisateur actuel et l'utilisateur système.

Paramètres
`userId`	`int` : de l'utilisateur à arrêter.
`waitFlag`	`boolean` : la commande attendra jusqu'à ce que l'utilisateur soit arrêté.
`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 ()

Passez 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 changé

Génère
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Passez l'appareil en mode adb sur 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 d'inactivité 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 renvoie "false".

Génère
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite. Tentative de désactivation du keyguard après le changement d'utilisateur réussi.

Paramètres
`userId`	`int`
`timeout`	`long` : délai d'attente avant de renvoyer la valeur "false" en cas d'échec du changement d'utilisateur.

Renvoie
`boolean`	"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Sinon renvoie "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 avec ceux de leurs équivalents distants. Seuls les fichiers "plus récents" ou inexistants seront transférés sur l'appareil. Les frais généraux devraient donc être relativement faibles si l'ensemble de fichiers sur l'appareil est déjà à jour.

Les fichiers cachés (dont le nom commence par ".") seront ignorés.

Exemple d'utilisation : syncFiles("/tmp/files", "/sdcard") crée un répertoire /sdcard/files s'il n'existe pas déjà, puis 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 à transférer de manière récursive.
`deviceFilePath`	`String` : chemin d'accès absolu à la racine du fichier de destination distant. Tous les répertoires de ce chemin d'accès au fichier doivent être lisibles. Par exemple, l'envoi à /data/local/tmp lorsque adb n'est pas root échouera.

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

Génère
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Prenez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer. Renvoie la valeur null en cas de problème. Les fichiers référencés dans l'objet Bugreport doivent être nettoyés via Bugreport.close().

Renvoie
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

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

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de succès.

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` : le package Android à désinstaller
`userId`	`int` : ID utilisateur entier pour lequel désinstaller l'application.

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de succès.

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'appellera pas postBootSetup(). Par conséquent, il est possible que l'appareil ne soit pas entièrement prêt à être testé lorsque cette méthode renvoie une réponse.

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

Génère
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Démontez 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 pour que l'indicateur soit défini

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

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" s'il ne l'est pas.

Génère
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Génère
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

Génère
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Bloque l'appareil pour qu'il soit en état "adb recovery" (notez que cet état est différent de IDeviceRecovery).

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

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Blocages pour que l'appareil soit en état "adb sideload"

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)

L'appareil est bloqué et n'est pas disponible (il est absent d'adb).

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

Renvoie
`boolean`	`true` si l'appareil devient indisponible 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épond pas nécessairement aux commandes une fois l'opération terminée. Utilisez plutôt waitForDeviceAvailable().

Génère
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

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

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

Génère
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

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

Renvoie
`boolean`	`true` si l'appareil redevient 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 OS pour la session et les arguments de la commande adb shell donnée

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 pour générer une exception si l'autorisation d'exécution n'est pas acceptée

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 revient à `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 tel que renvoyé par "adb shell getprop"
`fastbootVar`	`String` : nom de la variable fastboot équivalente à interroger. Si `null`, la requête fastboot ne sera pas tentée
`description`	`String` : description simple de la variable. La première lettre doit être en majuscule.

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

Génère
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

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

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

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

Renvoie
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

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

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

notifyRebootStarted

protected void notifyRebootStarted ()

Avertit tous les IDeviceActionReceiver de l'événement de début de 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. Tentatives de récupération de l'appareil et, éventuellement, nouvelle tentative d'exécution de la commande en cas d'échec de l'action.

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

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

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

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

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

Paramètres
`rebootMode`	`NativeDevice.RebootMode`

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 le 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 simple commande fastboot 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 simple commande fastboot et indique l'état de la commande.

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

Renvoie
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Attendez que l'appareil devienne indisponible (arrêtez d'envoyer des rapports à adb).

Paramètres
`operationDesc`	`String` : nom de l'opération en attente de disponibilité.
`time`	`long` : délai d'attente avant que l'état "Indisponible" ne soit défini.

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

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

Champs

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

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId