INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Réessaie les commandes de l'appareil pour une durée 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 disponible pour un niveau de compatibilité 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 void deleteFile(String deviceFilePath, int userId)

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

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

abstract 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).

abstract boolean disableAdbRoot()

Désactive adb root.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Active le root 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)

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 executeAdbV2Command(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 executeAdbV2Command(String... commandArgs)

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

abstract CommandResult executeAdbV2Command(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 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 deux minutes.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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.

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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.

abstract CommandResult executeShellV2Command(String command, 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.

abstract CommandResult executeShellV2Command(String command, 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.

abstract CommandResult executeShellV2Command(String command, 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.

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

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

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Obtenez le niveau d'API de l'appareil.

abstract String getBasebandVersion()

Méthode pratique pour obtenir la version de bande de base (radio) de cet appareil.

abstract Integer getBattery()

Renvoie le niveau de batterie actuel d'un appareil ou la valeur 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 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 et la raison du démarrage depuis l'heure donnée depuis l'époque de l'appareil et l'unité de temps spécifiée.

abstract String getBootloaderVersion()

Méthode pratique pour obtenir la version du 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 variante de compilation pour l'appareil.

abstract String getBuildId()

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

abstract 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).

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Renvoie la connexion associée à l'appareil.

abstract String getDeviceClass()

Obtenez la classe de l'appareil.

abstract long getDeviceDate()

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

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

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

abstract TestDeviceState getDeviceState()

Obtenez l'état de l'appareil.

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

Obtenir le flux stdout et stderr de l'émulateur

abstract long getExternalStoreFreeSpace()

Méthode d'assistance permettant de 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 Fastboot.

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

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

abstract String getFastbootVariable(String variableName)

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

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

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

abstract long getIntProperty(String name, long defaultValue)

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

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

abstract int getLaunchApiLevel()

Obtenez le premier niveau d'API de l'appareil.

abstract InputStreamSource getLogcat()

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

abstract InputStreamSource getLogcat(int maxBytes)

Récupère un flux d'instantané des maxBytes dernières données logcat capturées.

abstract InputStreamSource getLogcatDump()

Obtenez un dump du fichier logcat actuel pour l'appareil.

abstract InputStreamSource getLogcatSince(long date)

Récupère un flux d'instantanés 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 contenues dans /proc/mounts sur l'appareil.

abstract long getPartitionFreeSpace(String partition)

Méthode d'assistance permettant de 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", puis 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 la valeur "null" en cas de problème.

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 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 marqueurs de suppression des appareils.

abstract long getTotalMemory()

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

default String getTrackingSerial()

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

abstract boolean getUseFastbootErase()

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

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

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

abstract 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

abstract boolean isDebugfsMounted()

Vérifiez si debugfs est monté.

abstract boolean isDeviceEncrypted()

Indique si l'appareil est chiffré.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

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

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

abstract boolean isHeadless()

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

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

Renvoie "true" si l'appareil est en mode 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)

Consignez un message dans le logcat de l'appareil.

abstract void mountDebugfs()

Installez debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

Suivez les instructions pour configurer l'appareil pour les tests 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ées une fois l'appel terminé.

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'invocation.

abstract boolean pullDir(String deviceFilePath, File localDir)

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

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

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

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

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

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

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

abstract String pullFileContents(String remoteFilePath)

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

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

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

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

abstract boolean pushDir(File localDir, 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.

abstract boolean pushDir(File localDir, String deviceFilePath)

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

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

Variante de pushFile(File, String) qui peut éventuellement évaluer les besoins du fournisseur de contenu.

abstract boolean pushFile(File localFile, String deviceFilePath)

Transférez un fichier sur un appareil.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Transférez un fichier sur un appareil.

abstract boolean pushString(String contents, String deviceFilePath)

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

abstract void reboot()

Redémarre l'appareil en mode adb.

abstract void reboot(String reason)

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

abstract void rebootIntoBootloader()

Redémarre l'appareil en mode bootloader.

abstract void rebootIntoFastbootd()

Redémarre l'appareil en mode fastbootd.

abstract void rebootIntoRecovery()

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

abstract 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

abstract 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

abstract void rebootUntilOnline()

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)

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

abstract void rebootUserspaceUntilOnline()

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

abstract void remountSystemReadOnly()

Rendez la partition système de l'appareil en lecture seule.

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

Rendez la partition du fournisseur en lecture seule sur l'appareil.

abstract void remountVendorWritable()

Rendez la partition du fournisseur sur l'appareil 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 transmis en tant que paramètres.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

abstract 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é.

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 : La définition de la date sur l'appareil nécessite un accès root.

abstract void setOptions(TestDeviceOptions options)

Définir le TestDeviceOptions pour l'appareil

abstract boolean setProperty(String propKey, String propValue)

Définit la valeur de propriété donnée sur l'appareil.

abstract void setRecovery(IDeviceRecovery recovery)

Définissez le IDeviceRecovery à utiliser pour cet appareil.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

abstract void setUseFastbootErase(boolean useFastbootErase)

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

abstract void startLogcat()

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

abstract boolean startTradeInModeTesting(int timeoutMs)

Activez le mode reprise test.

abstract void stopEmulatorOutput()

Fermez et supprimez la sortie de l'émulateur.

abstract void stopLogcat()

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

abstract void stopTradeInModeTesting()

Arrêtez de tester le mode Trade-in.

abstract String switchToAdbTcp()

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

abstract boolean switchToAdbUsb()

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

abstract boolean unlockDevice()

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

abstract void unmountDebugfs()

Démontez debugfs.

abstract boolean waitForBootComplete(long timeOut)

Bloque jusqu'à ce que l'indicateur de démarrage 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)

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

abstract boolean waitForDeviceInSideload(long waitTime)

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

abstract boolean waitForDeviceNotAvailable(long waitTime)

L'appareil est bloqué et n'est pas disponible (il est absent d'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 shell adb de base.

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 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract 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.).

deleteFile

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

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

deleteFile

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract 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
RuntimeException si l'appareil a un motif de démarrage anormal.
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract 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
RuntimeException si l'appareil a un motif de démarrage anormal.
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

doesFileExist

public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

enableAdbRoot

public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeAdbCommand

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

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

commandArgs 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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
commandArgs 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

executeAdbCommand

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

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

commandArgs 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (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é.

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

commandArgs String : la commande adb et les arguments à exécuter

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

Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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
commandArgs String : la commande adb et les arguments à exécuter

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

Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (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é.

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

commandArgs String : la commande adb et les arguments à exécuter

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

Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

executeFastbootCommand

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

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.

commandArgs String : commande fastboot et arguments à exécuter

Renvoie
CommandResult CommandResult contenant le résultat de la commande

Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

executeFastbootCommand

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

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

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

Renvoie
CommandResult CommandResult contenant le résultat de la commande

Génère
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 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
commandArgs String : commande fastboot et arguments à exécuter

Renvoie
CommandResult CommandResult contenant le résultat de la commande

Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

executeLongFastbootCommand

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

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

commandArgs String : commande fastboot et arguments à exécuter

Renvoie
CommandResult CommandResult contenant le résultat de la commande

Génère
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 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 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 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 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 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 avant expiration maximal pour l'exécution de la commande. L'unité est 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 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)

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 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 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
command String : commande à exécuter.

Renvoie
CommandResult Le résultat est en CommandResult.

Génère
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 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. stdout est dirigé vers le flux spécifié.

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

Paramètres
command 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 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)

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

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 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, 
                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
command 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 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, 
                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
command 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

fastbootWipePartition

public abstract 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 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. La valeur par défaut est UNKNOWN_API_LEVEL.

Renvoie
int Entier indiquant le niveau d'API de l'appareil

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

getBasebandVersion

public abstract 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 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 la valeur Null si le niveau de batterie n'est pas disponible.

Renvoie
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 : 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 abstract  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 abstract  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 l'heure 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 abstract 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 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 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Renvoie
DeviceDescriptor

getCachedDeviceDescriptor

public abstract 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 abstract String[] getChildren (String deviceFilePath)

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

Paramètres
deviceFilePath 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Renvoie la connexion associée à l'appareil.

Renvoie
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Obtenez la classe de l'appareil.

Renvoie
String la classe d'appareil String.

getDeviceDate

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract 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 abstract 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 abstract TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Renvoie
TestDeviceState

getDeviceTimeOffset

public abstract 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 abstract InputStreamSource getEmulatorOutput ()

Obtenir le flux stdout et stderr de l'émulateur

Renvoie
InputStreamSource sortie de l'émulateur

getExternalStoreFreeSpace

public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

getFastbootProductType

public abstract 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 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 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 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 Fastboot.

Renvoie
String

getFastbootVariable

public abstract 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
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract 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

getIntProperty

public abstract 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

getLastExpectedRebootTimeMillis

public abstract 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 abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract 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 abstract 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 abstract 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 abstract 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

    getMountPoint

    public abstract 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 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.

    Paramètres
    mountpoint String

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

    Génère
    DeviceNotAvailableException

    Voir aussi :

    getMountPointInfo

    public abstract  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

    getPartitionFreeSpace

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    getProcessByName

    public abstract 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 abstract 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 abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée, ou si le type de produit ne peut pas être déterminé.

    getProductVariant

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    getProperty

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract 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.

    getSerialNumber

    public abstract 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

    getTombstones

    public abstract  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 abstract 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

    getUseFastbootErase

    public abstract 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.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Renvoie
    boolean true si l'appareil dispose actuellement d'un accès root adb, false dans le cas contraire.

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Renvoie
    boolean true si l'appareil est connecté à adb-over-tcp, false sinon.

    isAppEnumerationSupported

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Vérifiez si debugfs est monté.

    Renvoie
    boolean true si debugfs est installé

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

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Indique si l'appareil est chiffré.

    Renvoie
    boolean true si l'appareil est chiffré.

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Paramètres
    deviceFilePath String

    Renvoie
    boolean

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

    isEncryptionSupported

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

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

    Renvoie
    boolean

    Génère
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Renvoie
    boolean

    logAnrs

    public abstract 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

    logOnDevice

    public abstract 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 abstract void mountDebugfs ()

    Installez debugfs.

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

    nonBlockingReboot

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    postInvocationTearDown

    public void postInvocationTearDown ()

    Cette méthode est obsolète.
    Utilisez plutôt postInvocationTearDown(Throwable).

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

    Paramètres
    invocationException 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
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    pullDir

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pullFile

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pullFile

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pullFile

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pullFile

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pullFileContents

    public abstract 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 abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                    int userId)

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

    Paramètres
    localDir 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    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
    localDir 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

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

    Paramètres
    localDir 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    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

    deviceFilePath 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Transférez un fichier sur un appareil. Par défaut, un fournisseur de contenu est utilisé.

    Paramètres
    localFile File : fichier local à transférer

    deviceFilePath 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    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

    deviceFilePath 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

    Paramètres
    contents String : contenu du fichier à transférer

    deviceFilePath 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    redémarrer

    public abstract void reboot ()

    Redémarre l'appareil en mode adb.

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

    Génère
    DeviceNotAvailableException si l'appareil n'est pas disponible après le redémarrage ;

    redémarrer

    public abstract 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 si l'appareil n'est pas disponible après le redémarrage ;

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Redémarre l'appareil en mode bootloader.

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

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Redémarre l'appareil en mode fastbootd.

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

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    rebootIntoRecovery

    public abstract 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 si l'appareil n'est pas disponible après le redémarrage ;

    rebootIntoSideload

    public abstract 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 si l'appareil n'est pas en mode Sideload après le redémarrage ;

    rebootIntoSideload

    public abstract 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 si l'appareil n'est pas en mode Sideload après le redémarrage ;

    rebootUntilOnline

    public abstract 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 si l'appareil n'est pas disponible après le redémarrage ;

    rebootUntilOnline

    public abstract 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 si l'appareil n'est pas disponible après le redémarrage ;

    Voir aussi :

    rebootUserspace

    public abstract 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 si l'appareil n'est pas disponible après le redémarrage ;

    rebootUserspaceUntilOnline

    public abstract 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 si l'appareil n'est pas disponible après le redémarrage ;

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

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

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

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

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

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

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

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

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

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

    runInstrumentationTests

    public 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 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée (par exemple, si la commande de test n'a pas pu être exécutée et que la récupération a échoué).

    runInstrumentationTests

    public abstract 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 testRun 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée (par exemple, si la commande de test n'a pas pu être exécutée et que la récupération a échoué).

    runInstrumentationTestsAsUser

    public abstract 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 abstract 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

    setDate

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Définir le TestDeviceOptions pour l'appareil

    Paramètres
    options TestDeviceOptions

    setProperty

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract 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 abstract 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.

    setTrackingSerial

    public abstract 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 abstract 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 abstract 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 abstract 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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Fermez et supprimez la sortie de l'émulateur.

    stopLogcat

    public abstract 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 abstract void stopTradeInModeTesting ()

    Arrêtez de tester le mode Trade In. L'appareil va redémarrer.

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

    switchToAdbTcp

    public abstract 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 éteint

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

    switchToAdbUsb

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    unlockDevice

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
    UnsupportedOperationException si le chiffrement n'est pas compatible avec l'appareil.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Démontez debugfs.

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

    waitForBootComplete

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    waitForDeviceAvailable

    public abstract 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 si l'appareil ne répond toujours pas après l'expiration de waitTime.

    waitForDeviceAvailableInRecoverPath

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    waitForDeviceBootloader

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Bloque l'appareil pour qu'il soit dans l'é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 abstract boolean waitForDeviceInSideload (long waitTime)

    Bloque l'appareil pour qu'il 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 abstract 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 abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    waitForDeviceOnline

    public abstract 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 si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

    waitForDeviceShell

    public abstract 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.