INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Réessaye les commandes de périphérique pour un nombre configurable et fournit une interface de récupération de périphérique pour les périphériques qui ne répondent pas.

Résumé

Constantes

int UNKNOWN_API_LEVEL

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

Méthodes publiques

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifiez si une fonctionnalité est actuellement prise en charge ou non, compte tenu d'un niveau minimal pris en charge.

abstract void clearLogcat ()

Supprime toutes les données logcat accumulées.

abstract void deleteFile (String deviceFilePath)

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

abstract boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur en comparant le serveur système actuel avec le serveur système précédent ProcessInfo .

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur depuis l'heure UTC depuis l'époque de l'appareil et son ERROR(/TimeUnit) .

abstract boolean disableAdbRoot ()

Désactive la racine adb.

abstract boolean doesFileExist (String deviceFilePath)

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

abstract boolean enableAdbRoot ()

Active la racine AdB.

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

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

abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

abstract CommandResult executeFastbootCommand (String... commandArgs)

Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'expiration par défaut de 2 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) 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 shell adb et renvoie la sortie sous forme de String .

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

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

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

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

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command (String command)

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

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

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

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

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition (String partition)

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

abstract int getApiLevel ()

Obtenez le niveau API de l'appareil.

abstract String getBasebandVersion ()

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

abstract Integer getBattery ()

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

abstract boolean getBooleanProperty (String name, boolean defaultValue)

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

abstract getBootHistory ()

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

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage depuis l'heure indiquée depuis l'époque du périphérique et l'unité de temps spécifiée.

abstract String getBootloaderVersion ()

Méthode pratique pour obtenir la version du chargeur de démarrage de cet appareil.

abstract String getBuildAlias ()

Récupérez l’alias de la build que l’appareil exécute actuellement.

abstract String getBuildFlavor ()

Récupérez la version de build pour l’appareil.

abstract String getBuildId ()

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

abstract String getBuildSigningKeys ()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

abstract String[] getChildren (String deviceFilePath)

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

abstract AbstractConnection getConnection ()

Renvoie la connexion associée à l'appareil.

abstract String getDeviceClass ()

Obtenez la classe de périphérique.

abstract long getDeviceDate ()

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

abstract DeviceDescriptor getDeviceDescriptor ()

Renvoyez un DeviceDescriptor à partir des informations sur le périphérique pour obtenir des informations sur celui-ci sans transmettre l'objet périphérique réel.

abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations sur le périphérique pour obtenir des informations sur celui-ci sans transmettre l'objet périphérique réel.

abstract TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

abstract long getDeviceTimeOffset (Date date)

Aide pour obtenir le décalage horaire entre l'appareil et une ERROR(/Date) donnée.

abstract InputStreamSource getEmulatorOutput ()

Obtenez le flux de l'émulateur stdout et stderr

abstract long getExternalStoreFreeSpace ()

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

abstract String getFastbootProductType ()

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

abstract String getFastbootProductVariant ()

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

abstract String getFastbootSerialNumber ()

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

abstract String getFastbootVariable (String variableName)

Récupérez la valeur de la variable fastboot donnée sur le périphérique.

abstract IFileEntry getFileEntry (String path)

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

abstract IDevice getIDevice ()

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

abstract long getIntProperty (String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis ()

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

abstract int getLaunchApiLevel ()

Obtenez le premier niveau API lancé sur l'appareil.

abstract InputStreamSource getLogcat ()

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

abstract InputStreamSource getLogcat (int maxBytes)

Récupère un flux instantané des derniers maxBytes de données logcat capturées.

abstract InputStreamSource getLogcatDump ()

Obtenez un vidage du logcat actuel pour le périphérique.

abstract InputStreamSource getLogcatSince (long date)

Récupère un flux instantané de données logcat capturées à partir de la date fournie.

abstract String getMountPoint (String mountName)

Renvoie un point de montage.

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

abstract getMountPointInfo ()

Renvoie une version analysée des informations dans /proc/mounts sur le périphérique

abstract long getPartitionFreeSpace (String partition)

Méthode d'assistance pour déterminer la quantité d'espace libre sur la partition du périphérique.

abstract ProcessInfo getProcessByName (String processName)

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

abstract String getProcessPid (String process)

Renvoie le pid du service ou null 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 de récupération actuel utilisé pour l'appareil.

abstract String getSerialNumber ()

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

abstract getTombstones ()

Récupère et renvoie la liste des pierres tombales des appareils.

abstract long getTotalMemory ()

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

abstract boolean getUseFastbootErase ()

Déterminez si vous devez utiliser l'effacement fastboot ou le format fastboot pour effacer une partition sur l'appareil.

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

Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications

abstract boolean isBypassLowTargetSdkBlockSupported ()

Vérifiez si la plate-forme sur l'appareil prend en charge le contournement du bloc SDK à faible cible lors des installations d'applications.

abstract boolean isDebugfsMounted ()

Vérifiez si debugfs est monté.

abstract boolean isDeviceEncrypted ()

Renvoie si l'appareil est chiffré.

abstract boolean isDirectory (String deviceFilePath)

Renvoie True si le chemin sur le périphérique est un répertoire, false sinon.

abstract boolean isEncryptionSupported ()

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

abstract boolean isExecutable (String fullPath)

Renvoie True si le chemin du fichier sur le périphérique est un fichier exécutable, false sinon.

abstract boolean isHeadless ()

Renvoie true si l'appareil est sans tête (pas d'écran), false sinon.

abstract boolean isRuntimePermissionSupported ()

Vérifiez si la plate-forme sur l'appareil prend en charge l'octroi d'autorisations d'exécution

abstract boolean isStateBootloaderOrFastbootd ()

Renvoie vrai si l'appareil est dans TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD .

abstract boolean logAnrs ( ITestLogger logger)

Collecte et enregistre les ANR de l'appareil.

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

Enregistrez un message dans le logcat de l'appareil.

abstract void mountDebugfs ()

Montez les débogages.

abstract void nonBlockingReboot ()

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

abstract void postBootSetup ()

Exécutez les instructions pour configurer le périphérique afin de le tester après chaque démarrage.

default void postInvocationTearDown ()

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

abstract void postInvocationTearDown (Throwable invocationException)

Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté 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 sera exécutée sur l’appareil avant le flux d’appel.

abstract boolean pullDir (String deviceFilePath, File localDir)

Extrayez de manière récursive le contenu du répertoire du périphérique.

abstract File pullFile (String remoteFilePath, int userId)

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

abstract File pullFile (String remoteFilePath)

Récupère un fichier hors de 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 hors du périphérique.

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

Récupère un fichier hors du périphérique.

abstract String pullFileContents (String remoteFilePath)

Récupère un fichier hors de l'appareil et renvoie le contenu.

abstract File pullFileFromExternal (String remoteFilePath)

Une méthode pratique pour récupérer un fichier du 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, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories)

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

Poussez 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 envisager d'évaluer le besoin du fournisseur de contenu.

abstract boolean pushFile (File localFile, String deviceFilePath)

Transférez un fichier vers l'appareil.

abstract boolean pushString (String contents, String deviceFilePath)

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

abstract void reboot ()

Redémarre l'appareil en mode adb.

abstract void reboot (String reason)

Redémarre l'appareil en mode adb avec une reason donnée de persister lors du redémarrage.

abstract void rebootIntoBootloader ()

Redémarre l'appareil en mode chargeur de démarrage.

abstract void rebootIntoFastbootd ()

Redémarre l'appareil en mode fastbootd.

abstract void rebootIntoRecovery ()

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

abstract void rebootIntoSideload (boolean autoReboot)

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

Bloque jusqu'à ce que l'appareil passe en mode chargement latéral

abstract void rebootIntoSideload ()

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

Bloque jusqu'à ce que l'appareil passe en mode chargement latéral

abstract void rebootUntilOnline ()

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

abstract void rebootUntilOnline (String reason)

Une alternative à reboot() qui bloque uniquement 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 ()

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

abstract void remountSystemReadOnly ()

Rendez la partition système sur le périphérique en lecture seule.

abstract void remountSystemWritable ()

Rendre la partition système du périphérique accessible en écriture.

abstract void remountVendorReadOnly ()

Rendez la partition du fournisseur sur le périphérique en lecture seule.

abstract void remountVendorWritable ()

Rendre la partition du fournisseur sur le périphérique accessible en écriture.

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

Méthode pratique pour exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) avec un ou plusieurs écouteurs passés en paramètres.

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

Exécute des tests d’instrumentation et assure la récupération des appareils.

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

Identique à ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) mais exécute le test pour l'utilisateur donné.

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

Identique à ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) mais exécute le test pour un utilisateur donné.

abstract void setDate (Date date)

Définit la date sur l'appareil

Remarque : le réglage de la date sur l'appareil nécessite root

abstract void setOptions ( TestDeviceOptions options)

Définir les TestDeviceOptions pour 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 IDeviceRecovery à utiliser pour cet appareil.

abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

abstract void setUseFastbootErase (boolean useFastbootErase)

Définissez s’il faut utiliser l’effacement fastboot ou le format fastboot pour effacer une partition sur l’appareil.

abstract void startLogcat ()

Commencez à capturer la sortie logcat du périphérique en arrière-plan.

abstract void stopEmulatorOutput ()

Fermez et supprimez la sortie de l'émulateur.

abstract void stopLogcat ()

Arrêtez de capturer la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.

abstract String switchToAdbTcp ()

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

abstract boolean switchToAdbUsb ()

Basculez l'appareil en mode AdB via USB.

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

Synchronise de manière incrémentale le contenu d'un répertoire de fichiers local sur l'appareil.

abstract boolean unlockDevice ()

Déverrouille l'appareil si l'appareil est dans un état crypté.

abstract void unmountDebugfs ()

Démontez les débogages.

abstract boolean waitForBootComplete (long timeOut)

Bloque jusqu'à ce que l'indicateur de démarrage terminé du périphérique 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 le périphérique soit visible via fastboot.

abstract boolean waitForDeviceInRecovery (long waitTime)

Bloque pour que l'appareil soit dans l'état « adb recovery » (notez que cela est distinct de IDeviceRecovery ).

abstract boolean waitForDeviceInSideload (long waitTime)

Bloque pour que l'appareil soit dans l'état « adb sideload »

abstract boolean waitForDeviceNotAvailable (long waitTime)

Blocs pour que l'appareil ne soit pas disponible, c'est-à-dire manquant dans adb

abstract void waitForDeviceOnline ()

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

abstract void waitForDeviceOnline (long waitTime)

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

abstract boolean waitForDeviceShell (long waitTime)

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

Constantes

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

Valeur constante : -1 (0xffffffff)

Méthodes publiques

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifiez si une fonctionnalité est actuellement prise en charge ou non, compte tenu d'un niveau minimal pris en charge. Cette méthode prend en compte les fonctionnalités inédites, avant que le niveau de l'API ne soit augmenté.

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

effacerLogcat

public abstract void clearLogcat ()

Supprime toutes les données logcat accumulées.

Ceci est utile dans les cas où vous souhaitez vous assurer que ITestDevice#getLogcat() renvoie uniquement les données de journal produites après un certain point (par exemple après le flashage d'une nouvelle version de périphérique, etc.).

supprimer le fichier

public abstract void deleteFile (String deviceFilePath)

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

Paramètres
deviceFilePath String : Le chemin absolu du fichier sur l’appareil.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

périphériqueSoftRedémarré

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Jetés
RuntimeException si le périphérique a une raison de démarrage anormale
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

périphériqueSoftRestartedDepuis

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Paramètres
utcEpochTime long : le temps de l'appareil en secondes depuis l'époque.

timeUnit TimeUnit : l'unité de temps TimeUnit pour le utcEpochTime donné.

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

Jetés
RuntimeException si le périphérique a une raison de démarrage anormale
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

désactiverAdbRoot

public abstract boolean disableAdbRoot ()

Désactive la racine adb.

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

Retour
boolean true en cas de succès.

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

Est-ce queFichierExiste

public abstract boolean doesFileExist (String deviceFilePath)

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

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

Retour
boolean true si le fichier existe, false sinon.

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

activerAdbRoot

public abstract boolean enableAdbRoot ()

Active la racine AdB. Si le paramètre "enable-root" est "false", un message sera enregistré et renvoyé sans activer root.

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

Retour
boolean true en cas de succès.

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

exécuterAdbCommand

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

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

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

Paramètres
timeout long : le temps en millisecondes avant que l'appareil soit considéré comme ne répondant pas, 0L pour aucun délai d'attente

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

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

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

exécuterAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

exécuterAdbCommand

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

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

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

Paramètres
timeout long : le temps en millisecondes avant que l'appareil soit considéré comme ne répondant pas, 0L pour aucun délai d'attente

envMap : environnement à définir pour la commande

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

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

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

exécuterFastbootCommand

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

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

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

Paramètres
timeout long : le temps en millisecondes avant l'expiration de la commande

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

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

exécuterFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'expiration par défaut de 2 minutes.

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

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

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

exécuterLongFastbootCommand

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'il utilise un délai d'attente plus long.

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

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

exécuterLongFastbootCommand

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'il utilise un délai d'attente plus long.

Paramètres
envVarMap : les variables d'environnement système avec lesquelles la commande fastboot s'exécute

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

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

exécuterShellCommand

public abstract String executeShellCommand (String command)

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

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

Retour
String la sortie du shell

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

exécuterShellCommand

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

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

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

receiver IShellOutputReceiver : le IShellOutputReceiver vers lequel diriger la sortie du shell.

maxTimeToOutputShellResponse long : la durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse ; unité comme spécifié dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès.

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

exécuterShellCommand

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

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

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

receiver IShellOutputReceiver : le IShellOutputReceiver vers lequel diriger la sortie du shell.

maxTimeoutForCommand long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit

maxTimeToOutputShellResponse long : la durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse ; unité comme spécifié dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès.

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

exécuterShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

receiver IShellOutputReceiver : le IShellOutputReceiver vers lequel diriger la sortie du shell.

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

exécuterShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

Retour
CommandResult Le résultat dans CommandResult .

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

exécuterShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

pipeToOutput OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou null.

Retour
CommandResult Le résultat dans CommandResult .

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

exécuterShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

pipeAsInput File : Une ERROR(/File) qui sera redirigée comme entrée de la commande, ou null.

Retour
CommandResult Le résultat dans CommandResult .

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

exécuterShellV2Command

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

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

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

maxTimeoutForCommand long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès.

Retour
CommandResult

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

exécuterShellV2Command

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

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

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

maxTimeoutForCommand long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

Retour
CommandResult

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

exécuterShellV2Command

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

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

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

pipeAsInput File : Une ERROR(/File) qui sera redirigée comme entrée de la commande, ou null.

pipeToOutput OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou null.

maxTimeoutForCommand long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès.

Retour
CommandResult

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

exécuterShellV2Command

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

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

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

pipeAsInput File : Une ERROR(/File) qui sera redirigée comme entrée de la commande, ou null.

pipeToOutput OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou null.

pipeToError OutputStream : ERROR(/OutputStream) où l'erreur std sera redirigée, ou null.

maxTimeoutForCommand long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès.

Retour
CommandResult

Jetés
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 du périphérique.

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

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

Paramètres
partition String : la partition à effacer

Retour
CommandResult le CommandResult contenant la sortie de la commande

Jetés
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 API de l'appareil. La valeur par défaut est UNKNOWN_API_LEVEL .

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

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

Retour
String la version de la 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)

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

obtenirBatterie

public abstract Integer getBattery ()

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

Retour
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

Paramètres
name String : le nom de la propriété

defaultValue boolean : valeur par défaut à renvoyer si la propriété est vide ou n'existe pas.

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

Jetés
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Jetés
DeviceNotAvailableException

getBootHistoryDepuis

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Paramètres
utcEpochTime long : le temps de l'appareil depuis Epoch.

timeUnit TimeUnit : l'unité de temps TimeUnit .

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

Jetés
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Méthode pratique pour obtenir la version du chargeur de démarrage de cet appareil.

Tentera de récupérer la version du chargeur de démarrage à partir de l'état actuel de l'appareil. (c'est-à-dire que si l'appareil est en mode fastboot, il tentera de récupérer la version à partir de fastboot)

Retour
String la version du chargeur de démarrage String ou null si elle est introuvable

Jetés
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 build que l’appareil exécute actuellement.

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Récupérez la version de build pour l’appareil.

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Retour
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Retour
DeviceDescriptor

obtenir des enfants

public abstract String[] getChildren (String deviceFilePath)

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

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

Retour
String[] Tableau de chaîne contenant tous les fichiers dans un chemin sur le périphérique.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirConnexion

public abstract AbstractConnection getConnection ()

Renvoie la connexion associée à l'appareil.

Retour
AbstractConnection

obtenirDeviceClass

public abstract String getDeviceClass ()

Obtenez la classe de périphérique.

Retour
String la classe de périphérique String .

getDeviceDate

public abstract long getDeviceDate ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Renvoyez un DeviceDescriptor à partir des informations sur le périphérique pour obtenir des informations sur celui-ci sans transmettre l'objet périphérique réel.

Retour
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations sur le périphérique pour obtenir des informations sur celui-ci sans transmettre l'objet périphérique réel.

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

Retour
DeviceDescriptor

obtenirDeviceState

public abstract TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Retour
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Aide pour obtenir le décalage horaire entre l'appareil et une ERROR(/Date) donnée. Utilisez l’heure Epoch en interne.

Paramètres
date Date

Retour
long la différence en millisecondes

Jetés
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Obtenez le flux de l'émulateur stdout et stderr

Retour
InputStreamSource sortie de l'émulateur

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Retour
long la quantité d'espace libre en Ko

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

Retour
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Récupérez la valeur de la variable fastboot donnée sur le périphérique.

Paramètres
variableName String : le nom de la variable

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

Jetés
Exception d'opération non prise en charge
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirIDevice

public abstract IDevice getIDevice ()

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

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

Retour
IDevice l' IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

Paramètres
name String : le nom de la propriété

defaultValue long : valeur par défaut à renvoyer si la propriété est vide ou n'existe pas.

Retour
long la valeur de la propriété ou defaultValue si la propriété est vide, n'existe pas ou n'a pas de valeur entière.

Jetés
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Retour
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

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

Fonctionne en deux modes :

  • Si le logcat est actuellement capturé en arrière-plan, renverra jusqu'à TestDeviceOptions.getMaxLogcatDataSize() octets du contenu actuel de la capture logcat en arrière-plan
  • Sinon, renverra un vidage statique des données logcat si l'appareil répond actuellement

    Retour
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Récupère un flux instantané des derniers maxBytes de données logcat capturées.

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

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

    Retour
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Obtenez un vidage du logcat actuel pour le périphérique. Contrairement à getLogcat() , cette méthode renverra toujours un vidage statique du logcat.

    Présente l'inconvénient que rien ne sera renvoyé si l'appareil n'est pas accessible.

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

    getLogcatDepuis

    public abstract InputStreamSource getLogcatSince (long date)

    Récupère un flux instantané de données logcat capturées à partir de la date fournie. L'heure sur l'appareil doit être utilisée getDeviceDate() .

    Paramètres
    date long : en millisecondes depuis le format d'époque indiquant quand démarrer l'instantané jusqu'à présent. (peut être obtenu en utilisant 'date +%s')

    Retour
    InputStreamSource

    obtenirMountPoint

    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 : le nom du point de montage

    Retour
    String le point de montage 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

    Retour
    ITestDevice.MountPointInfo Une ERROR(/List) de MountPointInfo contenant les informations dans "/proc/mounts"

    Jetés
    DeviceNotAvailableException

    Voir également:

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Renvoie une version analysée des informations dans /proc/mounts sur le périphérique

    Retour
    Une ERROR(/List) de MountPointInfo contenant les informations dans "/proc/mounts"

    Jetés
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Méthode d'assistance pour déterminer la quantité d'espace libre sur la partition du périphérique.

    Paramètres
    partition String

    Retour
    long la quantité d'espace libre en Ko

    Jetés
    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" et renvoie l'objet ProcessInfo avec le PID et l'heure de début du processus donné.

    Paramètres
    processName String : le nom du processus String.

    Retour
    ProcessInfo ProcessInfo du processName donné

    Jetés
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Renvoie le pid du service ou null en cas de problème.

    Paramètres
    process String : Le nom du processus String.

    Retour
    String

    Jetés
    DeviceNotAvailableException

    obtenirType de produit

    public abstract String getProductType ()

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

    Cette méthode fonctionnera si l'appareil est en mode adb ou fastboot.

    Retour
    String le nom du type de produit String . Ne sera pas nul

    Jetés
    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 fonctionnera si l'appareil est en mode adb ou fastboot.

    Retour
    String le nom de la variante du produit String ou null s'il ne peut pas être déterminé

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

    obtenirPropriété

    public abstract String getProperty (String name)

    Récupérez la valeur de propriété donnée à partir de l’appareil.

    Paramètres
    name String : le nom de la propriété

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

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    obtenir le numéro de série

    public abstract String getSerialNumber ()

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

    Retour
    String le numéro de série String

    obtenir des pierres tombales

    public abstract  getTombstones ()

    Récupère et renvoie la liste des pierres tombales des appareils. Nécessite racine.

    La méthode est la meilleure possible, donc si une pierre tombale ne parvient pas à être extraite pour une raison quelconque, elle sera absente de la liste. Seule une DeviceNotAvailableException mettra fin à la méthode plus tôt.

    Retour
    Une liste de fichiers tombstone, vide s'il n'y en a pas.

    Jetés
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Retour
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Déterminez si vous devez utiliser l'effacement fastboot ou le format fastboot pour effacer une partition sur l'appareil.

    Retour
    boolean true si l'effacement fastboot sera utilisé ou false si le format fastboot sera utilisé.

    estAdbRoot

    public abstract boolean isAdbRoot ()

    Retour
    boolean true si l'appareil a actuellement une racine adb, false sinon.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

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

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications

    Retour
    boolean Vrai si l'énumération des applications est prise en charge, faux sinon

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Vérifiez si la plate-forme sur l'appareil prend en charge le contournement du bloc SDK à faible cible lors des installations d'applications.

    Retour
    boolean Vrai si le bloc SDK contourner la cible basse est pris en charge, faux sinon

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Vérifiez si debugfs est monté.

    Retour
    boolean true si debugfs est monté

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Renvoie si l'appareil est chiffré.

    Retour
    boolean true si l'appareil est chiffré.

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

    estRépertoire

    public abstract boolean isDirectory (String deviceFilePath)

    Renvoie True si le chemin sur le périphérique est un répertoire, false sinon.

    Paramètres
    deviceFilePath String

    Retour
    boolean

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

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

    Retour
    boolean true si l'appareil prend en charge le cryptage.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    estExécutable

    public abstract boolean isExecutable (String fullPath)

    Renvoie True si le chemin du fichier sur le périphérique est un fichier exécutable, false sinon.

    Paramètres
    fullPath String

    Retour
    boolean

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    est sans tête

    public abstract boolean isHeadless ()

    Renvoie true si l'appareil est sans tête (pas d'écran), false sinon.

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Vérifiez si la plate-forme sur l'appareil prend en charge l'octroi d'autorisations d'exécution

    Retour
    boolean True si les autorisations d'exécution sont prises en charge, false sinon.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Renvoie vrai si l'appareil est dans TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD .

    Retour
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Collecte et enregistre les ANR de l'appareil.

    Paramètres
    logger ITestLogger : un ITestLogger pour journaliser les ANR.

    Retour
    boolean Vrai si la journalisation a réussi, faux dans le cas contraire.

    Jetés
    DeviceNotAvailableException

    connexion sur périphérique

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

    Enregistrez un message dans le logcat de l'appareil. Il s'agit d'un appel sécurisé qui ne sera pas lancé même si la journalisation échoue.

    Paramètres
    tag String : La balise sous laquelle nous enregistrons notre message dans le logcat.

    level Log.LogLevel : Le niveau de débogage du message dans le logcat.

    format String : Le format du message.

    args Object : les arguments à remplacer via String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Montez les débogages.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

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

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Exécutez les instructions pour configurer le périphérique afin de le tester après chaque démarrage.

    Doit être appelé une fois que l'appareil est entièrement 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.

    Il peut être nécessaire de 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)

    Jetés
    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 au périphérique qui sera exécuté une fois l'appel terminé.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté une fois l'appel terminé.

    Paramètres
    invocationException Throwable : le cas échéant, l'exception finale déclenchée par l'échec de l'invocation.

    préInvocationSetup

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

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

    Paramètres
    info IBuildInfo : l' IBuildInfo de l'appareil.

    attributes MultiMap : Les attributs stockés dans le contexte d'invocation

    Jetés
    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 du périphérique.

    Paramètres
    deviceFilePath String : le chemin de fichier absolu de la source distante

    localDir File : le répertoire local dans lequel extraire les fichiers

    Retour
    boolean true si le fichier a été extrait avec succès. false sinon.

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

    pullFichier

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int : l'identifiant de l'utilisateur à partir duquel extraire

    Retour
    File Une ERROR(/File) contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

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

    pullFichier

    public abstract File pullFile (String remoteFilePath)

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

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

    Retour
    File Une ERROR(/File) contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

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

    pullFichier

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Récupère un fichier hors du périphérique.

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

    localFile File : le fichier local dans lequel stocker le contenu. S'il n'est pas vide, le contenu sera remplacé.

    Retour
    boolean true si le fichier a été récupéré avec succès. false sinon.

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

    pullFichier

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

    Récupère un fichier hors du périphérique.

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

    localFile File : le fichier local dans lequel stocker le contenu. S'il n'est pas vide, le contenu sera remplacé.

    userId int : l'identifiant de l'utilisateur à partir duquel extraire

    Retour
    boolean true si le fichier a été récupéré avec succès. false sinon.

    Jetés
    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 hors de l'appareil et renvoie le contenu.

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

    Retour
    String Une String contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

    Jetés
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Une méthode pratique pour récupérer un fichier du 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 : le chemin d'accès au fichier sur l'appareil, par rapport au point de montage de stockage externe de l'appareil

    Retour
    File Une ERROR(/File) contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

    Jetés
    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)

    Poussez 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 : le répertoire local à pousser

    deviceFilePath String : le chemin absolu du fichier de la destination distante

    excludedDirectories : Ensemble de noms de répertoires exclus qui ne doivent pas être poussés.

    Retour
    boolean true si le fichier a été poussé avec succès. false sinon.

    Jetés
    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)

    Poussez de manière récursive le contenu du répertoire vers l’appareil.

    Paramètres
    localDir File : le répertoire local à pousser

    deviceFilePath String : le chemin absolu du fichier de la destination distante

    Retour
    boolean true si le fichier a été poussé avec succès. false sinon.

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

    fichier push

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

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

    Paramètres
    localFile File : le fichier local à pousser

    deviceFilePath String : le chemin absolu du fichier de destination distante

    evaluateContentProviderNeeded boolean : faut-il vérifier si nous avons besoin du fournisseur de contenu

    Retour
    boolean true si le fichier a été poussé avec succès. false sinon.

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

    fichier push

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Transférez un fichier vers l'appareil. Par défaut, en utilisant un fournisseur de contenu.

    Paramètres
    localFile File : le fichier local à pousser

    deviceFilePath String : le chemin absolu du fichier de destination distante

    Retour
    boolean true si le fichier a été poussé avec succès. false sinon.

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

    chaîne push

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

    Paramètres
    contents String : le contenu du fichier à pousser

    deviceFilePath String : le chemin absolu du fichier de destination distante

    Retour
    boolean true si la chaîne a été poussée avec succès. false sinon.

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

    redémarrer

    public abstract void reboot ()

    Redémarre l'appareil en mode adb.

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

    Jetés
    DeviceNotAvailableException si le périphérique 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 une reason donnée de persister lors du redémarrage.

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

    La raison du dernier redémarrage peut être obtenue en interrogeant la propriété sys.boot.reason .

    Paramètres
    reason String : une raison pour ce redémarrage, ou null si aucune raison n'est précisée.

    Jetés
    DeviceNotAvailableException si le périphérique n'est pas disponible après le redémarrage

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Redémarre l'appareil en mode chargeur de démarrage.

    Bloque jusqu'à ce que l'appareil soit en mode chargeur de démarrage.

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

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Redémarre l'appareil en mode fastbootd.

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

    Jetés
    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 de récupération Adb.

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

    Jetés
    DeviceNotAvailableException si le périphérique n'est pas disponible après le redémarrage

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

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

    Bloque jusqu'à ce que l'appareil passe en mode chargement latéral

    Paramètres
    autoReboot boolean : s'il faut redémarrer automatiquement l'appareil après le chargement latéral

    Jetés
    DeviceNotAvailableException si l'appareil n'est pas en chargement latéral après le redémarrage

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

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

    Bloque jusqu'à ce que l'appareil passe en mode chargement latéral

    Jetés
    DeviceNotAvailableException si l'appareil n'est pas en chargement latéral après le redémarrage

    redémarrer jusqu'à la ligne

    public abstract void rebootUntilOnline ()

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

    Jetés
    DeviceNotAvailableException si le périphérique n'est pas disponible après le redémarrage

    redémarrer jusqu'à la ligne

    public abstract void rebootUntilOnline (String reason)

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

    Paramètres
    reason String : une raison pour ce redémarrage, ou null si aucune raison n'est précisée.

    Jetés
    DeviceNotAvailableException si le périphérique n'est pas disponible après le redémarrage

    Voir également:

    rebootEspace utilisateur

    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 développement actif, utilisez-le à vos propres risques.

    Jetés
    DeviceNotAvailableException si le périphérique n'est pas disponible après le redémarrage

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

    Jetés
    DeviceNotAvailableException si le périphérique n'est pas disponible après le redémarrage

    remonterSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Rendez la partition système sur le périphérique en lecture seule. Peut redémarrer l'appareil.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remonter le système en écriture

    public abstract void remountSystemWritable ()

    Rendre la partition système du périphérique accessible en écriture. Peut redémarrer l'appareil.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remonterVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Rendez la partition du fournisseur sur le périphérique en lecture seule. Peut redémarrer l'appareil.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remonterVendorWritable

    public abstract void remountVendorWritable ()

    Rendre la partition du fournisseur sur le périphérique accessible en écriture. Peut redémarrer l'appareil.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    exécuterInstrumentationTests

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

    Méthode pratique pour exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) avec un ou plusieurs écouteurs passés en paramètres.

    Paramètres
    runner IRemoteAndroidTestRunner : le IRemoteAndroidTestRunner qui exécute les tests

    listeners ITestLifeCycleReceiver : le ou les auditeurs des résultats de test

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

    Jetés
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée. c'est-à-dire que la commande de test n'a pas pu se terminer et que la récupération a échoué.

    exécuterInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Exécute des tests d’instrumentation et assure la récupération des appareils.

    Si la connexion avec l'appareil est perdue avant la fin du test et que la récupération réussit, tous les auditeurs seront informés de testRunFailed et « false » sera renvoyé. 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 du test et que la récupération échoue, tous les écouteurs seront informés de testRunFailed et DeviceNotAvailableException sera levée.

    Paramètres
    runner IRemoteAndroidTestRunner : le IRemoteAndroidTestRunner qui exécute les tests

    listeners : les auditeurs du résultat du test

    Retour
    boolean true si la commande de test est terminée. false s'il n'a pas abouti en raison d'une exception de communication avec le périphérique, mais que la récupération a réussi

    Jetés
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée. c'est-à-dire que la commande de test n'a pas pu se terminer 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 donné.

    Paramètres
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Retour
    boolean

    Jetés
    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

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    régler la date

    public abstract void setDate (Date date)

    Définit la date sur l'appareil

    Remarque : le réglage de la date sur l'appareil nécessite root

    Paramètres
    date Date : précisez une date particulière ; utilisera la date de l'hôte si null

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    définirOptions

    public abstract void setOptions (TestDeviceOptions options)

    Définir les 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 vraie.

    Paramètres
    propKey String : La clé ciblée à définir.

    propValue String : La valeur de la propriété à définir.

    Retour
    boolean renvoie True si la commande setprop a réussi, False sinon.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Définissez IDeviceRecovery à utiliser pour cet appareil. Doit être défini lors de la première allocation du périphérique.

    Paramètres
    recovery IDeviceRecovery : le IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Utilisé pour contrôler la méthode de récupération à utiliser lorsqu'un problème de communication avec l'appareil est rencontré. Il est recommandé de n'utiliser cette méthode qu'avec parcimonie en cas de besoin (par exemple, lorsque le framework est en panne, etc.

    Paramètres
    mode ITestDevice.RecoveryMode : indique si le mode « récupération jusqu'en ligne uniquement » doit être activé ou non.

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Définissez s’il faut utiliser l’effacement fastboot ou le format fastboot pour effacer une partition sur l’appareil.

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

    démarrerLogcat

    public abstract void startLogcat ()

    Commencez à capturer la sortie logcat du périphérique en arrière-plan.

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

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

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Fermez et supprimez la sortie de l'émulateur.

    arrêterLogcat

    public abstract void stopLogcat ()

    Arrêtez de capturer la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.

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

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

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

    Retour
    String le numéro de série TCP ou null si l'appareil n'a pas pu être commuté

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Basculez l'appareil en mode AdB via USB.

    Retour
    boolean true si le changement a réussi, false sinon.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    fichiers de synchronisation

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Synchronise de manière incrémentale le contenu d'un répertoire de fichiers local sur l'appareil.

    Décide quels fichiers pousser en comparant les horodatages des fichiers locaux avec leurs équivalents distants. Seuls les fichiers « plus récents » ou inexistants seront transférés vers l'appareil. Ainsi, la surcharge devrait être relativement faible si le fichier défini sur l'appareil est déjà à jour.

    Les fichiers cachés (dont les noms commencent par ".") seront ignorés.

    Exemple d'utilisation : syncFiles("/tmp/files", "/sdcard") créera un répertoire /sdcard/files s'il n'existe pas déjà et poussera de manière récursive le contenu de /tmp/files vers /sdcard/files.

    Paramètres
    localFileDir File : le répertoire de fichiers local contenant les fichiers à pousser de manière récursive.

    deviceFilePath String : racine du chemin absolu du fichier de destination distante. Tous les répertoires de ce chemin de fichier doivent être lisibles. c'est-à-dire que pousser vers /data/local/tmp lorsque adb n'est pas root échouera

    Retour
    boolean true si les fichiers ont été synchronisés avec succès. false sinon.

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

    déverrouiller l'appareil

    public abstract boolean unlockDevice ()

    Déverrouille l'appareil si l'appareil est dans un état crypté.

    Cette méthode peut redémarrer le framework mais n'appellera pas postBootSetup() . Par conséquent, l’appareil n’est peut-être pas entièrement prêt à être testé lorsque cette méthode revient.

    Retour
    boolean true en cas de succès ou si l'appareil n'est pas chiffré.

    Jetés
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
    UnsupportedOperationException si le cryptage n'est pas pris en charge sur l'appareil.

    démonterDebugfs

    public abstract void unmountDebugfs ()

    Démontez les débogages.

    Jetés
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    attendre le démarrage complet

    public abstract boolean waitForBootComplete (long timeOut)

    Bloque jusqu'à ce que l'indicateur de démarrage terminé du périphérique soit défini.

    Paramètres
    timeOut long : temps d'attente en msec pour que le drapeau soit défini

    Retour
    boolean vrai si l'indicateur de démarrage terminé du périphérique est défini dans le délai d'attente

    Jetés
    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 d'expiration par défaut.

    Retour
    boolean True si le périphérique est disponible, False si la récupération est désactivée et indisponible.

    Jetés
    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 : le temps d'attente en ms

    Retour
    boolean True si le périphérique est disponible, False si la récupération est désactivée et indisponible.

    Jetés
    DeviceNotAvailableException si l'appareil ne répond toujours pas après l'expiration du délai d'attente.

    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

    Retour
    boolean Vrai si l'appareil est disponible, Faux s'il n'est pas disponible.

    Jetés
    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 le périphérique soit visible via fastboot. Utilisez le délai d'expiration par défaut.

    Jetés
    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 pour que l'appareil soit dans l'état « adb recovery » (notez que cela est distinct de IDeviceRecovery ).

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

    Retour
    boolean true si le périphérique démarre en mode récupération avant l'expiration du délai. false sinon

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Bloque pour que l'appareil soit dans l'état « adb sideload »

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

    Retour
    boolean true si l’appareil démarre en chargement latéral avant l’expiration du délai. false sinon

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocs pour que l'appareil ne soit pas disponible, c'est-à-dire manquant dans adb

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

    Retour
    boolean true si l’appareil n’est plus disponible avant l’expiration du délai. false sinon

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

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

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

    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 terminées. Utilisez plutôt waitForDeviceAvailable() .

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

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

    attendreDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

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

    Retour
    boolean true si l’appareil devient réactif avant que waitTime ne s’écoule.