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

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Sous-classes indirectes connues

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

IManagedTestDevice	Un ITestDevice dont le cycle de vie est géré.
ITestDevice	Fournit une API fiable et de niveau légèrement supérieur à un `IDevice` ddmlib .
LocalAndroidVirtualDeviceLocalAndroidVirtualDevice	La classe pour les périphériques virtuels locaux exécutés sur l'hôte TradeFed.
ManagedRemoteDeviceManagedRemoteDevice	Un appareil fonctionnant à l'intérieur d'une machine virtuelle que nous gérons à distance via une instance Tradefed à l'intérieur de la VM.
NativeDevice	Implémentation par défaut d'un `ITestDevice` Appareils Android non full stack.
NestedRemoteDevice	Représentation de l'appareil s'exécutant dans une machine virtuelle Cuttlefish distante.
DistantAndroidAppareil	Implémentation d'un `ITestDevice` pour un appareil Android full stack connecté via adb connect.
RemoteAndroidVirtualDevice	Étend le comportement `RemoteAndroidDevice` pour un appareil Android à pile complète exécuté dans Google Compute Engine (Gce).
Appareil de test	Implémentation d'un `ITestDevice` pour un appareil android full stack

Fournit une API fiable et de niveau légèrement supérieur à un IDevice ddmlib .

Retente les commandes de l'appareil pour un montant configurable et fournit une interface de récupération de l'appareil pour les appareils qui ne répondent pas.

Résumé

Constantes
`int`	`UNKNOWN_API_LEVEL` Valeur par défaut lorsque le niveau d'API ne peut pas être détecté

Méthodes publiques
`abstract boolean`	`checkApiLevelAgainstNextRelease (int strictMinLevel)` Vérifiez si une fonctionnalité est actuellement prise en charge en fonction d'un niveau de prise en charge minimal.
`abstract void`	`clearLogcat ()` Supprime toutes les données logcat accumulées.
`abstract void`	`deleteFile (String deviceFilePath)` Méthode d'assistance pour supprimer un fichier ou un répertoire sur l'appareil.
`abstract boolean`	`deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)` Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur en comparant le system_server actuel avec le system_server précédent `ProcessInfo` .
`abstract boolean`	`deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)` Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur depuis l'heure UTC depuis l'époque de l'appareil et son `ERROR(/TimeUnit)` .
`abstract boolean`	`disableAdbRoot ()` Désactive la racine adb.
`abstract boolean`	`doesFileExist (String deviceFilePath)` Méthode d'assistance pour déterminer si le fichier sur l'appareil existe.
`abstract boolean`	`enableAdbRoot ()` Active la racine adb.
`abstract String`	`executeAdbCommand (long timeout, String... commandArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
`abstract String`	`executeAdbCommand (String... commandArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système.
`abstract String`	`executeAdbCommand (long timeout, envMap, String... commandArgs)` `executeAdbCommand (long timeout, envMap, String... commandArgs)` Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
`abstract CommandResult`	`executeFastbootCommand (long timeout, String... commandArgs)` Méthode d'assistance qui exécute une commande fastboot en tant que commande système.
`abstract CommandResult`	`executeFastbootCommand (String... commandArgs)` 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 2 minutes.
`abstract CommandResult`	`executeLongFastbootCommand (String... commandArgs)` Méthode d'assistance qui exécute une longue commande fastboot en tant que commande système.
`abstract CommandResult`	`executeLongFastbootCommand ( envVarMap, String... commandArgs)` `executeLongFastbootCommand ( envVarMap, String... commandArgs)` Méthode d'assistance qui exécute une longue commande fastboot en tant que commande système avec des variables d'environnement système.
`abstract String`	`executeShellCommand (String command)` Méthode d'assistance qui exécute une commande shell adb et renvoie la sortie sous la forme d'une `ERROR(/String)` .
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver)` Exécute la commande shell adb donnée, en réessayant plusieurs fois si la commande échoue.
`abstract CommandResult`	`executeShellV2Command (String command)` Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un `CommandResult` correctement rempli avec la sortie de l'état de la commande, stdout et stderr.
`abstract CommandResult`	`executeShellV2Command (String command, OutputStream pipeToOutput)` Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un `CommandResult` correctement rempli avec la sortie de l'état de la commande et stderr.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput)` Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un `CommandResult` correctement rempli avec la sortie d'état de la commande, stdout et stderr.
`abstract CommandResult`	`executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
`abstract CommandResult`	`executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)` Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
`abstract CommandResult`	`fastbootWipePartition (String partition)` Méthode d'assistance qui efface une partition pour le périphérique.
`abstract int`	`getApiLevel ()` Obtenez le niveau d'API de l'appareil.
`abstract String`	`getBasebandVersion ()` Méthode pratique pour obtenir la version bande de base (radio) de cet appareil.
`abstract Integer`	`getBattery ()` Renvoie le niveau de batterie actuel d'un appareil ou Null si le niveau de batterie n'est pas disponible.
`abstract boolean`	`getBooleanProperty (String name, boolean defaultValue)` Renvoie la valeur booléenne de la propriété donnée.
`abstract`	`getBootHistory ()` La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage.
`abstract`	`getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)` La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage depuis le temps donné depuis l'époque du périphérique et l'unité de temps spécifiée.
`abstract String`	`getBootloaderVersion ()` Méthode pratique pour obtenir la version bootloader de cet appareil.
`abstract String`	`getBuildAlias ()` Récupérez l'alias de la version que l'appareil exécute actuellement.
`abstract String`	`getBuildFlavor ()` Récupérez la saveur de construction pour le périphérique.
`abstract String`	`getBuildId ()` Récupérez la version que l'appareil exécute actuellement.
`abstract String`	`getBuildSigningKeys ()` Renvoie le type de clé utilisé pour signer l'image de l'appareil Généralement, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de libération (contrôlées par les fabricants d'appareils individuels)
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor ()` Renvoie un `DeviceDescriptor` mis en cache si le périphérique est alloué, sinon renvoie le `DeviceDescriptor` actuel.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor (boolean shortDescriptor)` Renvoie un `DeviceDescriptor` mis en cache si le périphérique est alloué, sinon renvoie le `DeviceDescriptor` actuel.
`abstract String[]`	`getChildren (String deviceFilePath)` Alternative à l'utilisation `IFileEntry` qui ne fonctionne parfois pas à cause des autorisations.
`abstract AbstractConnection`	`getConnection ()` Renvoie la connexion associée à l'appareil.
`abstract String`	`getDeviceClass ()` Obtenez la classe d'appareil.
`abstract long`	`getDeviceDate ()` Renvoie la date de l'appareil en millisecondes depuis l'époque.
`abstract DeviceDescriptor`	`getDeviceDescriptor ()` Renvoyez un `DeviceDescriptor` à partir des informations sur le périphérique pour obtenir des informations dessus sans passer l'objet périphérique réel.
`abstract DeviceDescriptor`	`getDeviceDescriptor (boolean shortDescriptor)` Renvoyez un `DeviceDescriptor` à partir des informations sur le périphérique pour obtenir des informations dessus sans passer l'objet périphérique réel.
`abstract TestDeviceState`	`getDeviceState ()` Obtenez l'état de l'appareil.
`abstract long`	`getDeviceTimeOffset (Date date)` Aide pour obtenir la différence de temps entre l'appareil et une `ERROR(/Date)` donnée.
`abstract InputStreamSource`	`getEmulatorOutput ()` Obtenez le flux de l'émulateur stdout et stderr
`abstract long`	`getExternalStoreFreeSpace ()` Méthode d'assistance pour déterminer la quantité d'espace libre sur le stockage externe de l'appareil.
`abstract String`	`getFastbootProductType ()` Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode de démarrage rapide.
`abstract String`	`getFastbootProductVariant ()` Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode de démarrage rapide.
`abstract String`	`getFastbootSerialNumber ()` Renvoie le numéro de série du mode de démarrage rapide.
`abstract String`	`getFastbootVariable (String variableName)` Récupérez la valeur de la variable fastboot donnée à partir du périphérique.
`abstract IFileEntry`	`getFileEntry (String path)` Récupérer une référence à un fichier distant sur l'appareil.
`abstract IDevice`	`getIDevice ()` Renvoie une référence à l' `IDevice` ddmlib associé .
`abstract long`	`getIntProperty (String name, long defaultValue)` Renvoie la valeur entière de la propriété donnée à partir du périphérique.
`abstract long`	`getLastExpectedRebootTimeMillis ()` Renvoie la dernière fois que les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH tel que renvoyé par `ERROR(/System#currentTimeMillis())` .
`abstract int`	`getLaunchApiLevel ()` Obtenez le premier niveau d'API lancé de l'appareil.
`abstract InputStreamSource`	`getLogcat ()` Saisit un flux d'instantané des données logcat.
`abstract InputStreamSource`	`getLogcat (int maxBytes)` Saisit un flux d'instantané des derniers `maxBytes` de données logcat capturées.
`abstract InputStreamSource`	`getLogcatDump ()` Obtenez un vidage du logcat actuel pour le périphérique.
`abstract InputStreamSource`	`getLogcatSince (long date)` Saisit un flux d'instantané des données logcat capturées à partir de la date fournie.
`abstract String`	`getMountPoint (String mountName)` Renvoie un point de montage.
`abstract 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.
`abstract`	`getMountPointInfo ()` Renvoie une version analysée des informations dans /proc/mounts sur le périphérique
`abstract long`	`getPartitionFreeSpace (String partition)` Méthode d'assistance pour déterminer la quantité d'espace libre sur la partition de l'appareil.
`abstract ProcessInfo`	`getProcessByName (String processName)` La méthode d'assistance exécute les commandes "pidof" et "stat" et renvoie l'objet `ProcessInfo` avec le PID et l'heure de début du processus donné.
`abstract String`	`getProcessPid (String process)` Renvoie le pid du service ou null si quelque chose s'est mal passé.
`abstract String`	`getProductType ()` Méthode pratique pour obtenir le type de produit de cet appareil.
`abstract String`	`getProductVariant ()` Méthode pratique pour obtenir la variante de produit de cet appareil.
`abstract String`	`getProperty (String name)` Récupérez la valeur de propriété donnée à partir de l'appareil.
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode ()` Obtenez le mode de récupération actuel utilisé pour l'appareil.
`abstract String`	`getSerialNumber ()` Méthode pratique pour obtenir le numéro de série de cet appareil.
`abstract`	`getTombstones ()` Récupérez et renvoyez la liste des pierres tombales des appareils.
`abstract long`	`getTotalMemory ()` Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne
`abstract boolean`	`getUseFastbootErase ()` Déterminez si vous souhaitez utiliser l'effacement de démarrage rapide ou le format de démarrage rapide pour effacer une partition sur l'appareil.
`abstract boolean`	`isAdbRoot ()`
`abstract boolean`	`isAdbTcp ()`
`abstract boolean`	`isAppEnumerationSupported ()` Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications
`abstract boolean`	`isBypassLowTargetSdkBlockSupported ()` Vérifiez si la plate-forme sur l'appareil prend en charge le contournement du bloc SDK cible faible lors des installations d'applications
`abstract boolean`	`isDeviceEncrypted ()` Renvoie si l'appareil est chiffré.
`abstract boolean`	`isDirectory (String deviceFilePath)` Renvoie True si le chemin sur le périphérique est un répertoire, false sinon.
`abstract boolean`	`isEncryptionSupported ()` Renvoie si le chiffrement est pris en charge sur l'appareil.
`abstract boolean`	`isExecutable (String fullPath)` Renvoie True si le chemin du fichier sur le périphérique est un fichier exécutable, false sinon.
`abstract boolean`	`isHeadless ()` Renvoie vrai si l'appareil est sans écran (pas d'écran), faux sinon.
`abstract boolean`	`isRuntimePermissionSupported ()` Vérifiez si la plate-forme sur l'appareil prend en charge l'octroi d'autorisations d'exécution
`abstract boolean`	`isStateBootloaderOrFastbootd ()` Renvoie true si le périphérique est dans `TestDeviceState#FASTBOOT` ou `TestDeviceState.FASTBOOTD` .
`abstract boolean`	`logAnrs ( ITestLogger logger)` Collecte et enregistre les ANR de l'appareil.
`abstract void`	`logOnDevice (String tag, Log.LogLevel level, String format, Object... args)` Enregistrez un message dans le logcat de l'appareil.
`abstract void`	`nonBlockingReboot ()` Émet une commande pour redémarrer l'appareil et revient une fois la commande terminée et lorsque l'appareil n'est plus visible pour adb.
`abstract void`	`postBootSetup ()` Exécutez les instructions pour configurer le périphérique afin de le tester après chaque démarrage.
`default void`	`postInvocationTearDown ()` Cette méthode est obsolète. Utilisez plutôt `postInvocationTearDown(Throwable)` .
`abstract void`	`postInvocationTearDown (Throwable invocationException)` Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui seront exécutés une fois l'invocation terminée.
`default 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'appel.
`abstract boolean`	`pullDir (String deviceFilePath, File localDir)` Extraction récursive du contenu du répertoire à partir de l'appareil.
`abstract File`	`pullFile (String remoteFilePath, int userId)` Récupère un fichier hors de l'appareil, le stocke dans un `ERROR(/File)` local temporaire et renvoie ce `File` .
`abstract File`	`pullFile (String remoteFilePath)` Récupère un fichier hors de l'appareil, le stocke dans un `ERROR(/File)` local temporaire et renvoie ce `File` .
`abstract boolean`	`pullFile (String remoteFilePath, File localFile)` Récupère un fichier hors de l'appareil.
`abstract boolean`	`pullFile (String remoteFilePath, File localFile, int userId)` Récupère un fichier hors de l'appareil.
`abstract String`	`pullFileContents (String remoteFilePath)` Récupère un fichier hors de l'appareil et renvoie le contenu.
`abstract File`	`pullFileFromExternal (String remoteFilePath)` Une méthode pratique pour récupérer un fichier à partir du stockage externe de l'appareil, le stocker dans un `ERROR(/File)` local temporaire et renvoyer une référence à ce `File` .
`abstract boolean`	`pushDir (File localDir, String deviceFilePath, excludedDirectories)` `pushDir (File localDir, String deviceFilePath, excludedDirectories)` Poussez récursivement le contenu des répertoires vers l'appareil tout en excluant certains répertoires filtrés.
`abstract boolean`	`pushDir (File localDir, String deviceFilePath)` Poussez récursivement le contenu du répertoire vers le périphérique.
`abstract boolean`	`pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)` qui peut éventuellement envisager d'évaluer le besoin du fournisseur de contenu.
`abstract boolean`	`pushFile (File localFile, String deviceFilePath)` Pousser un fichier vers l'appareil.
`abstract boolean`	`pushString (String contents, String deviceFilePath)` Pousser le fichier créé à partir d'une chaîne vers l'appareil
`abstract void`	`reboot ()` Redémarre l'appareil en mode adb.
`abstract void`	`reboot (String reason)` Redémarre l'appareil en mode adb avec une `reason` donnée de persister lors du redémarrage.
`abstract void`	`rebootIntoBootloader ()` Redémarre l'appareil en mode chargeur de démarrage.
`abstract void`	`rebootIntoFastbootd ()` Redémarre l'appareil en mode fastbootd.
`abstract void`	`rebootIntoRecovery ()` Redémarre l'appareil en mode de récupération adb.
`abstract void`	`rebootIntoSideload (boolean autoReboot)` Redémarre l'appareil en mode adb sideload (notez qu'il s'agit d'un mode spécial en cours de récupération) Bloque jusqu'à ce que l'appareil passe en mode chargement latéral
`abstract void`	`rebootIntoSideload ()` Redémarre l'appareil en mode adb sideload (notez qu'il s'agit d'un mode spécial en cours de récupération) Bloque jusqu'à ce que l'appareil passe en mode chargement latéral
`abstract void`	`rebootUntilOnline ()` Une alternative à `reboot()` qui ne bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`abstract void`	`rebootUntilOnline (String reason)` Une alternative à `reboot()` qui ne bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`abstract void`	`rebootUserspace ()` Redémarre uniquement la partie de l'espace utilisateur de l'appareil.
`abstract void`	`rebootUserspaceUntilOnline ()` Une alternative à `rebootUserspace()` ()} qui ne bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
`abstract void`	`remountSystemWritable ()` Rendez la partition système sur le périphérique accessible en écriture.
`abstract void`	`remountVendorWritable ()` Rendez la partition fournisseur sur le périphérique accessible en écriture.
`abstract boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Méthode pratique pour effectuer `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` avec un ou plusieurs écouteurs passés en paramètres.
`abstract boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` `runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` Exécute des tests d'instrumentation et fournit une récupération de périphérique.
`abstract boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` `runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` Identique à `ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` mais exécute le test pour l'utilisateur donné.
`abstract boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Identique à `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` mais exécute le test pour un utilisateur donné.
`abstract void`	`setDate (Date date)` Définit la date sur l'appareil Remarque : le réglage de la date sur l'appareil nécessite root
`abstract void`	`setOptions ( TestDeviceOptions options)` Définir les `TestDeviceOptions` pour le périphérique
`abstract boolean`	`setProperty (String propKey, String propValue)` Définit la valeur de propriété donnée sur le périphérique.
`abstract void`	`setRecovery ( IDeviceRecovery recovery)` Définissez `IDeviceRecovery` à utiliser pour cet appareil.
`abstract void`	`setRecoveryMode ( ITestDevice.RecoveryMode mode)` Définissez le mode de récupération actuel à utiliser pour l'appareil.
`abstract void`	`setUseFastbootErase (boolean useFastbootErase)` Définissez si vous souhaitez utiliser l'effacement de démarrage rapide ou le format de démarrage rapide pour effacer une partition sur l'appareil.
`abstract void`	`startLogcat ()` Commencez à capturer la sortie logcat de l'appareil en arrière-plan.
`abstract void`	`stopEmulatorOutput ()` Fermez et supprimez la sortie de l'émulateur.
`abstract void`	`stopLogcat ()` Arrêtez de capturer la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.
`abstract String`	`switchToAdbTcp ()` Basculez l'appareil en mode adb-over-tcp.
`abstract boolean`	`switchToAdbUsb ()` Basculez l'appareil en mode adb sur usb.
`abstract boolean`	`syncFiles (File localFileDir, String deviceFilePath)` Synchronise de manière incrémentielle le contenu d'un répertoire de fichiers local sur l'appareil.
`abstract boolean`	`unlockDevice ()` Déverrouille l'appareil si l'appareil est dans un état chiffré.
`abstract boolean`	`waitForBootComplete (long timeOut)` Bloque jusqu'à ce que l'indicateur de démarrage complet de l'appareil soit défini.
`abstract boolean`	`waitForDeviceAvailable ()` Attend que l'appareil soit réactif et disponible pour les tests.
`abstract boolean`	`waitForDeviceAvailable (long waitTime)` Attend que l'appareil soit réactif et disponible pour les tests.
`abstract boolean`	`waitForDeviceAvailableInRecoverPath (long waitTime)` Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération.
`abstract void`	`waitForDeviceBootloader ()` Bloque jusqu'à ce que l'appareil soit visible via fastboot.
`abstract boolean`	`waitForDeviceInRecovery (long waitTime)` Blocs pour que le périphérique soit dans l'état 'adb recovery' (notez que ceci est distinct de `IDeviceRecovery` ).
`abstract boolean`	`waitForDeviceInSideload (long waitTime)` Blocs pour que l'appareil soit dans l'état 'adb sideload'
`abstract boolean`	`waitForDeviceNotAvailable (long waitTime)` Blocs pour que l'appareil ne soit pas disponible, c'est-à-dire manquant dans adb
`abstract void`	`waitForDeviceOnline ()` Bloque jusqu'à ce que l'appareil soit visible via adb.
`abstract void`	`waitForDeviceOnline (long waitTime)` Bloque jusqu'à ce que l'appareil soit visible via adb.
`abstract boolean`	`waitForDeviceShell (long waitTime)` Attend que l'appareil réponde à une commande de base du shell adb.

Constantes

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valeur par défaut lorsque le niveau d'API ne peut pas être détecté

Valeur constante : -1 (0xffffffff)

Méthodes publiques

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifiez si une fonctionnalité est actuellement prise en charge en fonction d'un niveau de prise en charge minimal. Cette méthode prend en compte les fonctionnalités non encore publiées, avant que le niveau de l'API ne soit augmenté.

Paramètres
`strictMinLevel`	`int` : le niveau minimum strict possible qui prend en charge la fonctionnalité.

Retour
`boolean`	Vrai si le niveau est pris en charge. Faux sinon.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

clearLogcat

public abstract void clearLogcat ()

Supprime toutes les données logcat accumulées.

Ceci est utile dans les cas où vous voulez vous assurer que ITestDevice#getLogcat() ne renvoie que les données de journal produites après un certain point (comme après avoir flashé une nouvelle version de périphérique, etc.).

supprimer le fichier

public abstract void deleteFile (String deviceFilePath)

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

Paramètres
`deviceFilePath`	`String` : Le chemin absolu du fichier sur le périphérique.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur en comparant le system_server actuel avec le system_server précédent ProcessInfo . Utilisez getProcessByName(String) pour obtenir ProcessInfo .

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

Retour
`boolean`	`true` si l'appareil a redémarré en douceur

Lance
	si l'appareil a une raison de démarrage anormale
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur depuis l'heure UTC depuis l'époque de l'appareil et son ERROR(/TimeUnit) . Soft-Restart fait référence à system_server redémarré en dehors d'un redémarrage dur de l'appareil (par exemple : redémarrage demandé). Le périphérique actuel utcEpochTime en millisecondes peut être obtenu par la méthode getDeviceDate() .

Paramètres
`utcEpochTime`	`long` : le temps de l'appareil en seconde depuis l'époque.
`timeUnit`	`TimeUnit` : l'unité de temps `TimeUnit` pour le utcEpochTime donné.

Retour
`boolean`	`true` si l'appareil a redémarré en douceur

Lance
	si l'appareil a une raison de démarrage anormale
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

désactiverAdbRoot

public abstract boolean disableAdbRoot ()

Désactive la racine adb.

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

Retour
`boolean`	`true` en cas de succès.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

est-ce queFichierExiste

public abstract boolean doesFileExist (String deviceFilePath)

Méthode d'assistance pour déterminer si le fichier sur l'appareil existe.

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

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

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

activerAdbRoot

public abstract boolean enableAdbRoot ()

Active la racine adb. Si le paramètre "enable-root" est "false", enregistrera un message et reviendra sans activer root.

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.

Retour
`boolean`	`true` en cas de succès.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

exécuterAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

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

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

Retour
`String`	la sortie standard de la commande. `null` si la commande n'a pas pu s'exécuter.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

exécuterAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

Retour
`String`	la sortie standard de la commande. `null` si la commande n'a pas pu s'exécuter.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

exécuterAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

Retour
`String`	la sortie standard de la commande. `null` si la commande n'a pas pu s'exécuter.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

exécuterFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

Devrait être utilisé lorsque l'appareil est déjà en mode de démarrage rapide.

Paramètres
`timeout`	`long` : le temps en millisecondes avant l'expiration de la commande
`commandArgs`	`String` : la commande fastboot et les arguments à exécuter

Retour
`CommandResult`	le CommandResult contenant la sortie de la commande

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

exécuterFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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 2 minutes.

Devrait être utilisé lorsque l'appareil est déjà en mode de démarrage rapide.

Paramètres
`commandArgs`	`String` : la commande fastboot et les arguments à exécuter

Retour
`CommandResult`	le CommandResult contenant la sortie de la commande

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Identique à executeFastbootCommand(String) sauf qu'il utilise un délai d'attente plus long.

Paramètres
`commandArgs`	`String` : la commande fastboot et les arguments à exécuter

Retour
`CommandResult`	le CommandResult contenant la sortie de la commande

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

Méthode d'assistance qui exécute une longue commande fastboot en tant que commande système avec des variables d'environnement système.

Identique à executeFastbootCommand(String) sauf qu'il utilise un délai d'attente plus long.

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

Retour
`CommandResult`	le CommandResult contenant la sortie de la commande

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

Retour
`String`	la sortie du shell

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeShellCommand

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

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

Paramètres
`command`	`String` : la commande shell adb à exécuter
`receiver`	`IShellOutputReceiver` : le `IShellOutputReceiver` vers lequel diriger la sortie du shell.
`maxTimeToOutputShellResponse`	`long` : la durée maximale pendant laquelle la commande est autorisée à ne pas produire de réponse ; unité comme spécifié dans `timeUnit`
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : le nombre maximum de tentatives de commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si `retryAttempts` sont effectuées sans succès.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Voir également:

executeShellCommand

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

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

Paramètres
`command`	`String` : la commande shell adb à exécuter
`receiver`	`IShellOutputReceiver` : le `IShellOutputReceiver` vers lequel diriger la sortie du shell.
`maxTimeoutForCommand`	`long` : le délai d'attente maximal pour que la commande se termine ; unité comme spécifié dans `timeUnit`
`maxTimeToOutputShellResponse`	`long` : la durée maximale pendant laquelle la commande est autorisée à ne pas produire de réponse ; unité comme spécifié dans `timeUnit`
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : le nombre maximum de tentatives de commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si `retryAttempts` sont effectuées sans succès.

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Voir également:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Exécute la commande shell adb donnée, en réessayant plusieurs fois si la commande échoue.

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

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

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

Paramètres
`command`	`String` : La commande qui doit être exécutée.

Retour
`CommandResult`	Le résultat dans `CommandResult` .

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Paramètres
`command`	`String` : La commande qui doit être exécutée.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` où la sortie std sera redirigée, ou null.

Retour
`CommandResult`	Le résultat dans `CommandResult` .

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Paramètres
`command`	`String` : La commande qui doit être exécutée.
`pipeAsInput`	`File` : Une `ERROR(/File)` qui sera canalisée comme entrée de la commande, ou nulle.

Retour
`CommandResult`	Le résultat dans `CommandResult` .

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeShellV2Command

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

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

Paramètres
`command`	`String` : la commande shell adb à exécuter
`maxTimeoutForCommand`	`long` : le délai d'attente maximal pour que la commande se termine ; unité comme spécifié dans `timeUnit`
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : le nombre maximum de tentatives de commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si `retryAttempts` sont effectuées sans succès.

Retour
`CommandResult`

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Voir également:

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

Paramètres
`command`	`String` : la commande shell adb à exécuter
`maxTimeoutForCommand`	`long` : le délai d'attente maximal pour que la commande se termine ; unité comme spécifié dans `timeUnit`
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`

Retour
`CommandResult`

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Voir également:

executeShellV2Command

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

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

Paramètres
`command`	`String` : la commande shell adb à exécuter
`pipeAsInput`	`File` : Une `ERROR(/File)` qui sera canalisée comme entrée de la commande, ou null.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` où la sortie std sera redirigée, ou null.
`maxTimeoutForCommand`	`long` : le délai d'attente maximal pour que la commande se termine ; unité comme spécifié dans `timeUnit`
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : le nombre maximum de tentatives de commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si `retryAttempts` sont effectuées sans succès.

Retour
`CommandResult`

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Voir également:

executeShellV2Command

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

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

Paramètres
`command`	`String` : la commande shell adb à exécuter
`pipeAsInput`	`File` : Une `ERROR(/File)` qui sera canalisée comme entrée de la commande, ou null.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` où la sortie std sera redirigée, ou null.
`pipeToError`	`OutputStream` : `ERROR(/OutputStream)` où l'erreur std sera redirigée, ou null.
`maxTimeoutForCommand`	`long` : le délai d'attente maximal pour que la commande se termine ; unité comme spécifié dans `timeUnit`
`timeUnit`	`TimeUnit` : unité pour `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : le nombre maximum de tentatives de commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si `retryAttempts` sont effectuées sans succès.

Retour
`CommandResult`

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Voir également:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Méthode d'assistance qui efface une partition pour le périphérique.

Si getUseFastbootErase() est true , alors l'effacement fastboot sera utilisé pour effacer la partition. L'appareil doit alors créer un système de fichiers au prochain démarrage de l'appareil. Sinon, le format fastboot est utilisé, ce qui créera un nouveau système de fichiers sur l'appareil.

Devrait être utilisé lorsque l'appareil est déjà en mode de démarrage rapide.

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

Retour
`CommandResult`	le CommandResult contenant la sortie de la commande

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getApiLevel

public abstract int getApiLevel ()

Obtenez le niveau d'API de l'appareil. Par défaut, UNKNOWN_API_LEVEL .

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

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBasebandVersion

public abstract String getBasebandVersion ()

Méthode pratique pour obtenir la version bande de base (radio) de cet appareil. L'obtention de la version radio est spécifique à l'appareil, il se peut donc qu'elle ne renvoie pas les informations correctes pour tous les appareils. Cette méthode s'appuie sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Ceci n'est pas exact pour certains périphériques CDMA et la version renvoyée ici peut ne pas correspondre à la version signalée par fastboot et peut ne pas renvoyer la version pour la radio CDMA. TL; DR cette méthode ne signale la version exacte que si la propriété gsm.version.baseband est identique à la version renvoyée par fastboot getvar version-baseband .

Retour
`String`	la version de bande de base `ERROR(/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)

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

getBattery

public abstract Integer getBattery ()

Renvoie le niveau de batterie actuel d'un appareil ou Null si le niveau de batterie n'est pas disponible.

Retour
`Integer`

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Renvoie la valeur booléenne de la propriété donnée.

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

Retour
`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.

Lance
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

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

Retour
	Carte du temps de démarrage (heure UTC en seconde depuis l'époque) et raison du démarrage

Lance
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage depuis le temps donné depuis l'époque du périphérique et l'unité de temps spécifiée. Le périphérique actuel utcEpochTime en millisecondes peut être obtenu par la méthode getDeviceDate() .

Paramètres
`utcEpochTime`	`long` : le temps de l'appareil depuis Epoch.
`timeUnit`	`TimeUnit` : l'unité de temps `TimeUnit` .

Retour
	Carte du temps de démarrage (heure UTC en seconde depuis l'époque) et raison du démarrage

Lance
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

Tentera de récupérer la version du chargeur de démarrage à 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 du fastboot)

Retour
`String`	la version du bootloader `ERROR(/String)` ou `null` s'il est introuvable

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getBuildAlias

public abstract String getBuildAlias ()

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

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

Retour
`String`	l'alias de build ou revenir à l'identifiant de build s'il n'a pas pu être récupéré

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildFlavor

public abstract String getBuildFlavor ()

Récupérez la saveur de construction pour le périphérique.

Retour
`String`	la saveur de construction ou null si elle n'a pas pu être récupérée

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildId

public abstract String getBuildId ()

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

Retour
`String`	l'ID de build ou `IBuildInfo#UNKNOWN_BUILD_ID` s'il n'a pas pu être récupéré

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

Généralement, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de libération (contrôlées par les fabricants d'appareils individuels)

Retour
`String`	La clé de signature si elle est trouvée, null sinon.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Renvoie un DeviceDescriptor mis en cache si le périphérique est alloué, sinon renvoie le DeviceDescriptor actuel.

Retour
`DeviceDescriptor`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Renvoie un DeviceDescriptor mis en cache si le périphérique est alloué, sinon renvoie le DeviceDescriptor actuel.

Paramètres
`shortDescriptor`	`boolean` : s'il faut ou non limiter le descripteur au strict minimum d'informations

Retour
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

Alternative à l'utilisation IFileEntry qui ne fonctionne parfois pas à cause des autorisations.

Paramètres
`deviceFilePath`	`String` : est le chemin sur l'appareil où faire la recherche

Retour
`String[]`	Tableau de chaînes contenant tous les fichiers dans un chemin sur l'appareil.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getConnection

public abstract AbstractConnection getConnection ()

Renvoie la connexion associée à l'appareil.

Retour
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

Obtenez la classe d'appareil.

Retour
`String`	la classe d'appareil `ERROR(/String)` .

getDeviceDate

public abstract long getDeviceDate ()

Renvoie la date de l'appareil en millisecondes depuis l'époque.

Retour
`long`	la date de l'appareil au format d'époque.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceDescriptorgetDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Renvoyez un DeviceDescriptor à partir des informations sur le périphérique pour obtenir des informations dessus sans passer l'objet périphérique réel.

Retour
`DeviceDescriptor`

getDeviceDescriptorgetDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations sur le périphérique pour obtenir des informations dessus sans passer l'objet périphérique réel.

Paramètres
`shortDescriptor`	`boolean` : s'il faut ou non limiter le descripteur au strict minimum d'informations

Retour
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Retour
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Aide pour obtenir la différence de temps entre l'appareil et une ERROR(/Date) donnée. Utilisez l'heure Epoch en interne.

Paramètres
`date`	`Date`

Retour
`long`	la différence en millisecondes

Lance
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Obtenez le flux de l'émulateur stdout et stderr

Retour
`InputStreamSource`	sortie de l'émulateur

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Méthode d'assistance pour déterminer la quantité d'espace libre sur le stockage externe de l'appareil.

Retour
`long`	la quantité d'espace libre en Ko

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

Retour
`String`	le nom du type de produit `ERROR(/String)` ou `null` s'il ne peut pas être déterminé

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

Retour
`String`	le nom du type de produit `ERROR(/String)` ou `null` s'il ne peut pas être déterminé

Lance
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Renvoie le numéro de série du mode de démarrage rapide.

Retour
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Récupérez la valeur de la variable fastboot donnée à partir du périphérique.

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

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

Lance
	UnsupportedOperationExceptionUnsupportedOperationExceptionUnsupportedOperationExceptionUnsupportedOperationExceptionUnsupportedOperationException
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

Paramètres
`path`	`String` : le chemin du fichier à récupérer. Peut être un chemin absolu ou un chemin relatif à '/'. (c'est-à-dire que les syntaxes "/system" et "system" sont prises en charge)

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

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIDevice

public abstract IDevice getIDevice ()

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

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

Retour
`IDevice`	l' `IDevice`

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Renvoie la valeur entière de la propriété donnée à partir du périphérique.

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

Retour
`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.

Lance
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Retour
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Obtenez le premier niveau d'API lancé de l'appareil. Par défaut, UNKNOWN_API_LEVEL .

Retour
`int`	un entier indiquant le premier niveau d'API lancé de l'appareil

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getLogcat

public abstract InputStreamSource getLogcat ()

Saisit un flux d'instantané des données logcat.

Fonctionne en deux modes :

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

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

Retour
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Saisit un flux d'instantané des derniers maxBytes de données logcat capturées.

Utile dans les cas où vous souhaitez capturer des instantanés fréquents des données logcat capturées sans encourir la pénalité d'espace disque potentiellement importante liée à l'obtention de l'intégralité de l'instantané getLogcat() .

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

Retour
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Get a dump of the current logcat for device. Unlike getLogcat() , this method will always return a static dump of the logcat.

Has the disadvantage that nothing will be returned if device is not reachable.

Retour
`InputStreamSource`	a `InputStreamSource` of the logcat data. An empty stream is returned if fail to capture logcat data.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate() .

Paramètres
`date`	`long` : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s')

Retour
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

Returns a mount point.

Queries the device directly if the cached info in IDevice is not available.

TODO: move this behavior to IDevice#getMountPoint(String)

Paramètres
`mountName`	`String` : the name of the mount point

Retour
`String`	the mount point or `null`

Voir également:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

Paramètres
`mountpoint`	`String`

Retour
`ITestDevice.MountPointInfo`	A `ERROR(/List)` of `MountPointInfo` containing the information in "/proc/mounts"

Lance
`DeviceNotAvailableException`

Voir également:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

Returns a parsed version of the information in /proc/mounts on the device

Retour
	A `ERROR(/List)` of `MountPointInfo` containing the information in "/proc/mounts"

Lance
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

Helper method to determine amount of free space on device partition.

Paramètres
`partition`	`String`

Retour
`long`	the amount of free space in KB

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

Paramètres
`processName`	`String` : the proces name String.

Retour
`ProcessInfo`	ProcessInfo of given processName

Lance
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

Returns the pid of the service or null if something went wrong.

Paramètres
`process`	`String` : The proces name String.

Retour
`String`

Lance
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

Convenience method to get the product type of this device.

This method will work if device is in either adb or fastboot mode.

Retour
`String`	the `ERROR(/String)` product type name. Will not be null

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered, or if product type can not be determined

getProductVariant

public abstract String getProductVariant ()

Convenience method to get the product variant of this device.

This method will work if device is in either adb or fastboot mode.

Retour
`String`	the `ERROR(/String)` product variant name or `null` if it cannot be determined

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

getProperty

public abstract String getProperty (String name)

Retrieve the given property value from the device.

Paramètres
`name`	`String` : the property name

Retour
`String`	the property value or `null` if it does not exist

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Get the current recovery mode used for the device.

Retour
`ITestDevice.RecoveryMode`	the current recovery mode used for the device.

getSerialNumber

public abstract String getSerialNumber ()

Convenience method to get serial number of this device.

Retour
`String`	the `ERROR(/String)` serial number

getTombstones

public abstract  getTombstones ()

Fetch and return the list of tombstones from the devices. Requires root.

method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

Retour
	A list of tombstone files, empty if no tombstone.

Lance
`DeviceNotAvailableException`

Voir également:

Tombstones documentation

getTotalMemory

public abstract long getTotalMemory ()

Returns total physical memory size in bytes or -1 in case of internal error

Retour
`long`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

Retour
`boolean`	`true` if fastboot erase will be used or `false` if fastboot format will be used.

Voir également:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

Retour
`boolean`	`true` if device currently has adb root, `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

isAdbTcp

public abstract boolean isAdbTcp ()

Retour
`boolean`	`true` if device is connected to adb-over-tcp, `false` otherwise.

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Check whether platform on device supports app enumeration

Retour
`boolean`	True if app enumeration is supported, false otherwise

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Check whether platform on device supports bypassing low target sdk block on app installs

Retour
`boolean`	True if bypass low target sdk block is supported, false otherwise

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Returns if the device is encrypted.

Retour
`boolean`	`true` if the device is encrypted.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Return True if the path on the device is a directory, false otherwise.

Paramètres
`deviceFilePath`	`String`

Retour
`boolean`

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Returns if encryption is supported on the device.

Retour
`boolean`	`true` if the device supports encryption.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isExecutable

public abstract boolean isExecutable (String fullPath)

Returns True if the file path on the device is an executable file, false otherwise.

Paramètres
`fullPath`	`String`

Retour
`boolean`

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isHeadless

public abstract boolean isHeadless ()

Return true if the device is headless (no screen), false otherwise.

Retour
`boolean`

Lance
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Check whether platform on device supports runtime permission granting

Retour
`boolean`	True if runtime permission are supported, false otherwise.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

Retour
`boolean`

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Collects and log ANRs from the device.

Paramètres
`logger`	`ITestLogger` : an `ITestLogger` to log the ANRs.

Retour
`boolean`	True if the logging was successful, false otherwise.

Lance
`DeviceNotAvailableException`

logOnDevice

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

Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

Paramètres
`tag`	`String` : The tag under which we log our message in the logcat.
`level`	`Log.LogLevel` : The debug level of the message in the logcat.
`format`	`String` : The message format.
`args`	`Object` : the args to be replaced via String.format().

nonBlockingReboot

public abstract void nonBlockingReboot ()

Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public abstract void postBootSetup ()

Perform instructions to configure device for testing that after every boot.

Should be called after device is fully booted/available

In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

postInvocationTearDown

public void postInvocationTearDown ()

This method is deprecated.
Use postInvocationTearDown(Throwable) instead.

Extra steps for device specific required clean up that will be executed after the invocation is done.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Extra steps for device specific required clean up that will be executed after the invocation is done.

Paramètres
`invocationException`	`Throwable` : if any, the final exception raised by the invocation failure.

preInvocationSetup

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

Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

Paramètres
`info`	`IBuildInfo` : The `IBuildInfo` of the device.
`attributes`	`MultiMap` : The attributes stored in the invocation context

Lance
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Recursively pull directory contents from device.

Paramètres
`deviceFilePath`	`String` : the absolute file path of the remote source
`localDir`	`File` : the local directory to pull files into

Retour
`boolean`	`true` if file was pulled successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

Paramètres
`remoteFilePath`	`String` : the absolute path to file on device.
`userId`	`int` : The user id to pull from

Retour
`File`	A `ERROR(/File)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pullFile

public abstract File pullFile (String remoteFilePath)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

Paramètres
`remoteFilePath`	`String` : the absolute path to file on device.

Retour
`File`	A `ERROR(/File)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Retrieves a file off device.

Paramètres
`remoteFilePath`	`String` : the absolute path to file on device.
`localFile`	`File` : the local file to store contents in. If non-empty, contents will be replaced.

Retour
`boolean`	`true` if file was retrieved successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pullFile

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

Retrieves a file off device.

Paramètres
`remoteFilePath`	`String` : the absolute path to file on device.
`localFile`	`File` : the local file to store contents in. If non-empty, contents will be replaced.
`userId`	`int` : The user id to pull from

Retour
`boolean`	`true` if file was retrieved successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

Retrieves a file off device, and returns the contents.

Paramètres
`remoteFilePath`	`String` : the absolute path to file on device.

Retour
`String`	A `ERROR(/String)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

Lance
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

Paramètres
`remoteFilePath`	`String` : the path to file on device, relative to the device's external storage mountpoint

Retour
`File`	A `ERROR(/File)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

Recursively push directory contents to device while excluding some directories that are filtered.

Paramètres
`localDir`	`File` : the local directory to push
`deviceFilePath`	`String` : the absolute file path of the remote destination
`excludedDirectories`	: Set of excluded directories names that shouldn't be pushed.

Retour
`boolean`	`true` if file was pushed successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Recursively push directory contents to device.

Paramètres
`localDir`	`File` : the local directory to push
`deviceFilePath`	`String` : the absolute file path of the remote destination

Retour
`boolean`	`true` if file was pushed successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

Paramètres
`localFile`	`File` : the local file to push
`deviceFilePath`	`String` : the remote destination absolute file path
`evaluateContentProviderNeeded`	`boolean` : whether to check if we need the content provider

Retour
`boolean`	`true` if file was pushed successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Push a file to device. By default using a content provider.

Paramètres
`localFile`	`File` : the local file to push
`deviceFilePath`	`String` : the remote destination absolute file path

Retour
`boolean`	`true` if file was pushed successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Push file created from a string to device

Paramètres
`contents`	`String` : the contents of the file to push
`deviceFilePath`	`String` : the remote destination absolute file path

Retour
`boolean`	`true` if string was pushed successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

reboot

public abstract void reboot ()

Reboots the device into adb mode.

Blocks until device becomes available.

Lance
`DeviceNotAvailableException`	if device is not available after reboot

reboot

public abstract void reboot (String reason)

Reboots the device into adb mode with given reason to be persisted across reboot.

Blocks until device becomes available.

Last reboot reason can be obtained by querying sys.boot.reason propety.

Paramètres
`reason`	`String` : a reason for this reboot, or `null` if no reason is specified.

Lance
`DeviceNotAvailableException`	if device is not available after reboot

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Reboots the device into bootloader mode.

Blocks until device is in bootloader mode.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Reboots the device into fastbootd mode.

Blocks until device is in fastbootd mode.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

Reboots the device into adb recovery mode.

Blocks until device enters recovery

Lance
`DeviceNotAvailableException`	if device is not available after reboot

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

Paramètres
`autoReboot`	`boolean` : whether to automatically reboot the device after sideload

Lance
`DeviceNotAvailableException`	if device is not in sideload after reboot

rebootIntoSideload

public abstract void rebootIntoSideload ()

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

Lance
`DeviceNotAvailableException`	if device is not in sideload after reboot

rebootUntilOnline

public abstract void rebootUntilOnline ()

An alternate to reboot() that only blocks until device is online ie visible to adb.

Lance
`DeviceNotAvailableException`	if device is not available after reboot

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

An alternate to reboot() that only blocks until device is online ie visible to adb.

Paramètres
`reason`	`String` : a reason for this reboot, or `null` if no reason is specified.

Lance
`DeviceNotAvailableException`	if device is not available after reboot

Voir également:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

Reboots only userspace part of device.

Blocks until device becomes available.

WARNING. Userspace reboot is currently under active development, use it on your own risk.

Lance
`DeviceNotAvailableException`	if device is not available after reboot

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

Lance
`DeviceNotAvailableException`	if device is not available after reboot

remountSystemWritable

public abstract void remountSystemWritable ()

Make the system partition on the device writable. May reboot the device.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorWritable

public abstract void remountVendorWritable ()

Make the vendor partition on the device writable. May reboot the device.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

runInstrumentationTests

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

Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

Paramètres
`runner`	`IRemoteAndroidTestRunner` : the `IRemoteAndroidTestRunner` which runs the tests
`listeners`	`ITestLifeCycleReceiver` : the test result listener(s)

Retour
`boolean`	`true` if test command completed. `false` if it failed to complete, but recovery succeeded

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Runs instrumentation tests, and provides device recovery.

If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

Paramètres
`runner`	`IRemoteAndroidTestRunner` : the `IRemoteAndroidTestRunner` which runs the tests
`listeners`	: the test result listeners

Retour
`boolean`	`true` if test command completed. `false` if it failed to complete due to device communication exception, but recovery succeeded

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

runInstrumentationTestsAsUser

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

Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

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

Retour
`boolean`

Lance
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

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

Retour
`boolean`

Lance
`DeviceNotAvailableException`

setDate

public abstract void setDate (Date date)

Sets the date on device

Note: setting date on device requires root

Paramètres
`date`	`Date` : specify a particular date; will use host date if `null`

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setOptions

public abstract void setOptions (TestDeviceOptions options)

Set the TestDeviceOptions for the device

Paramètres
`options`	`TestDeviceOptions`

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Sets the given property value on the device. Requires adb root is true.

Paramètres
`propKey`	`String` : The key targeted to be set.
`propValue`	`String` : The property value to be set.

Retour
`boolean`	returns `True` if the setprop command was successful, False otherwise.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Set the current recovery mode to use for the device.

Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

Paramètres
`mode`	`ITestDevice.RecoveryMode` : whether 'recover till online only' mode should be on or not.

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

Paramètres
`useFastbootErase`	`boolean` : `true` if fastboot erase should be used or `false` if fastboot format should be used.

Voir également:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

Start capturing logcat output from device in the background.

Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

When the device is no longer in use, stopLogcat() must be called.

startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Close and delete the emulator output.

stopLogcat

public abstract void stopLogcat ()

Stop capturing logcat output from device, and discard currently saved logcat data.

Will have no effect if logcat output is not being captured.

switchToAdbTcp

public abstract String switchToAdbTcp ()

Switch device to adb-over-tcp mode.

Retour
`String`	the tcp serial number or `null` if device could not be switched

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Switch device to adb over usb mode.

Retour
`boolean`	`true` if switch was successful, `false` otherwise.

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Incrementally syncs the contents of a local file directory to device.

Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

Hidden files (with names starting with ".") will be ignored.

Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

Paramètres
`localFileDir`	`File` : the local file directory containing files to recursively push.
`deviceFilePath`	`String` : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

Retour
`boolean`	`true` if files were synced successfully. `false` otherwise.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

unlockDevice

public abstract boolean unlockDevice ()

Unlocks the device if the device is in an encrypted state.

This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

Retour
`boolean`	`true` if successful or if the device is unencrypted.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.
	if encryption is not supported on the device.

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Blocks until the device's boot complete flag is set.

Paramètres
`timeOut`	`long` : time in msecs to wait for the flag to be set

Retour
`boolean`	true if device's boot complete flag is set within the timeout

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

Waits for the device to be responsive and available for testing. Uses default timeout.

Retour
`boolean`	True if device is available, False if recovery is disabled and unavailable.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

Waits for the device to be responsive and available for testing.

Paramètres
`waitTime`	`long` : the time in ms to wait

Retour
`boolean`	True if device is available, False if recovery is disabled and unavailable.

Lance
`DeviceNotAvailableException`	if device is still unresponsive after waitTime expires.

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Waits for the device to be responsive and available without considering recovery path.

Paramètres
`waitTime`	`long`

Retour
`boolean`	True if device is available, False if unavailable.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

Blocks until device is visible via fastboot. Use default timeout.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

Paramètres
`waitTime`	`long` : the time in ms to wait

Retour
`boolean`	`true` if device boots into recovery before time expires. `false` otherwise

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blocks for the device to be in the 'adb sideload' state

Paramètres
`waitTime`	`long` : the time in ms to wait

Retour
`boolean`	`true` if device boots into sideload before time expires. `false` otherwise

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Blocks for the device to be not available ie missing from adb

Paramètres
`waitTime`	`long` : the time in ms to wait

Retour
`boolean`	`true` if device becomes not available before time expires. `false` otherwise

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Blocks until device is visible via adb. Uses default timeout

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

Blocks until device is visible via adb.

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

Paramètres
`waitTime`	`long` : the time in ms to wait

Lance
`DeviceNotAvailableException`	if connection with device is lost and cannot be recovered.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Waits for device to be responsive to a basic adb shell command.

Paramètres
`waitTime`	`long` : the time in ms to wait

Retour
`boolean`	`true` if device becomes responsive before `waitTime` elapses.