INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Relance les commandes d'appareil pour une quantité configurable et fournit une interface de récupération d'appareil pour les appareils qui ne répondent pas.

Résumé

Constantes

int UNKNOWN_API_LEVEL

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

Méthodes publiques

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Vérifier si une fonctionnalité est actuellement compatible avec un niveau de compatibilité minimal.

abstract void clearLogcat()

Supprime toutes les données logcat accumulées.

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible, en comparant le serveur system_server actuel avec le ProcessInfo system_server précédent.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible depuis l'heure UTC depuis l'epoch de l'appareil et son ERROR(/TimeUnit).

abstract boolean disableAdbRoot()

Désactive la racine adb.

abstract boolean doesFileExist(String deviceFilePath)

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

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

abstract String executeAdbCommand(String... commandArgs)

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

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

Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'expiration 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'inactivité par défaut de deux minutes.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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

abstract String executeShellCommand(String command)

Méthode d'assistance qui exécute une commande shell adb et renvoie le résultat en tant que String.

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément CommandResult correctement renseigné avec le résultat de l'é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 davantage 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 davantage 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 davantage 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 davantage de paramètres pour contrôler le comportement de la commande.

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Obtenir le niveau d'API de l'appareil

abstract String getBasebandVersion()

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

abstract Integer getBattery()

Renvoie le niveau de batterie actuel d'un appareil, ou la valeur "null" si le niveau de batterie n'est pas disponible.

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Renvoie la valeur booléenne d'une propriété donnée.

abstract getBootHistory()

La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage.

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage depuis le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée.

abstract String getBootloaderVersion()

Méthode pratique permettant d'obtenir la version du bootloader de cet appareil.

abstract String getBuildAlias()

Récupérez l'alias de la compilation en cours d'exécution par l'appareil.

abstract String getBuildFlavor()

Récupérez le type de compilation pour l'appareil.

abstract String getBuildId()

Récupérez la version en cours d'exécution de l'appareil.

abstract String getBuildSigningKeys()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

Renvoie une valeur DeviceDescriptor mise en cache si l'appareil est alloué. Sinon, renvoie la valeur DeviceDescriptor actuelle.

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Renvoie une valeur DeviceDescriptor mise en cache si l'appareil est alloué. Sinon, renvoie la valeur DeviceDescriptor actuelle.

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Renvoie la connexion associée à l'appareil.

abstract String getDeviceClass()

Permet d'obtenir la classe de l'appareil.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations le concernant sans transmettre l'objet d'appareil réel.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations le concernant sans transmettre l'objet d'appareil réel.

abstract TestDeviceState getDeviceState()

Obtenez l'état de l'appareil.

abstract long getDeviceTimeOffset(Date date)

Outil d'aide pour obtenir le décalage horaire entre l'appareil et un ERROR(/Date) donné.

abstract InputStreamSource getEmulatorOutput()

Obtenir le flux de l'émulateur stdout et stderr

abstract long getExternalStoreFreeSpace()

Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la mémoire de stockage externe de l'appareil.

abstract String getFastbootProductType()

Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.

abstract String getFastbootProductVariant()

Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.

abstract String getFastbootSerialNumber()

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

abstract String getFastbootVariable(String variableName)

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

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

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

abstract long getIntProperty(String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Permet d'obtenir le premier niveau d'API lancé sur l'appareil.

abstract InputStreamSource getLogcat()

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

abstract InputStreamSource getLogcat(int maxBytes)

Récupère un flux d'instantanés de la dernière maxBytes de données logcat capturées.

abstract InputStreamSource getLogcatDump()

Obtenir un vidage du logcat actuel pour l'appareil

abstract InputStreamSource getLogcatSince(long date)

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

abstract String getMountPoint(String mountName)

Renvoie un point d'installation.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Renvoie un MountPointInfo correspondant au chemin d'accès du point de montage spécifié, ou null si ce chemin n'est installé sur aucun élément ou n'apparaît pas dans /proc/mounts en tant que point de montage.

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

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

abstract String getProductType()

Méthode pratique permettant d'obtenir le type de produit de cet appareil.

abstract String getProductVariant()

Méthode pratique permettant d'obtenir la variante du produit de cet appareil.

abstract String getProperty(String name)

Récupère la valeur de propriété donnée à partir de l'appareil.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

Méthode pratique permettant d'obtenir le numéro de série de cet appareil.

abstract getTombstones()

Récupérez et renvoyez la liste des tombstones 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()

Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.

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

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

abstract boolean isBypassLowTargetSdkBlockSupported()

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

abstract boolean isDebugfsMounted()

Vérifiez si debugfs est installé.

abstract boolean isDeviceEncrypted()

Indique si l'appareil est chiffré.

abstract boolean isDirectory(String deviceFilePath)

Renvoyez la valeur "True" si le chemin d'accès sur l'appareil est un répertoire, et la valeur "false" dans le cas contraire.

abstract boolean isEncryptionSupported()

Indique si l'appareil est compatible avec le chiffrement.

abstract boolean isExecutable(String fullPath)

Affiche la valeur "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, et la valeur "false" dans le cas contraire.

abstract boolean isHeadless()

Renvoie la valeur "true" si l'appareil est headless (aucun écran), sinon la valeur "false".

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

Renvoie la valeur "true" si l'appareil se trouve dans TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD.

abstract boolean logAnrs(ITestLogger logger)

Recueille et consigne les erreurs ANR de l'appareil.

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

Consigner un message dans le fichier logcat de l'appareil.

abstract void mountDebugfs()

Installation de debugfs

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

Suivez les instructions pour configurer l'appareil 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)

Des étapes supplémentaires pour un appareil spécifique nécessitaient un nettoyage qui sera exécuté une fois l'appel terminé.

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

Étapes supplémentaires pour une configuration spécifique à l'appareil qui sera exécutée sur l'appareil avant le processus d'appel.

abstract boolean pullDir(String deviceFilePath, File localDir)

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

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

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

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

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

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

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

abstract String pullFileContents(String remoteFilePath)

Récupère un fichier depuis l'appareil, puis renvoie son contenu.

abstract File pullFileFromExternal(String remoteFilePath)

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

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

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

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

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

abstract boolean pushDir(File localDir, String deviceFilePath)

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

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

Variante de pushFile(File, String) qui peut éventuellement envisager d'évaluer la nécessité pour le fournisseur de contenu.

abstract boolean pushFile(File localFile, String deviceFilePath)

Transférer un fichier sur l'appareil

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

Transférer un fichier sur l'appareil

abstract boolean pushString(String contents, String deviceFilePath)

Envoyer 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 la valeur reason donnée pour être conservée lors du redémarrage.

abstract void rebootIntoBootloader()

Redémarre l'appareil en mode bootloader.

abstract void rebootIntoFastbootd()

Redémarre l'appareil en mode fastbootd.

abstract void rebootIntoRecovery()

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

abstract void rebootIntoSideload(boolean autoReboot)

Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).

Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant

abstract void rebootIntoSideload()

Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).

Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

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

abstract void rebootUserspaceUntilOnline()

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

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

Définissez la partition du fournisseur sur l'appareil en lecture seule.

abstract void remountVendorWritable()

Rendez la partition du fournisseur accessible en écriture sur l'appareil.

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

Méthode pratique permettant d'exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) avec un ou plusieurs écouteurs transmis en tant que paramètres.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

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

Identique à ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), mais exécute le test pour l'utilisateur 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: Pour définir la date sur l'appareil, vous devez être en mode root

abstract void setOptions(TestDeviceOptions options)

Définir le TestDeviceOptions pour l'appareil

abstract boolean setProperty(String propKey, String propValue)

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

abstract void setRecovery(IDeviceRecovery recovery)

Définissez les IDeviceRecovery à utiliser pour cet appareil.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

abstract void setUseFastbootErase(boolean useFastbootErase)

Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.

abstract void startLogcat()

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

abstract void stopEmulatorOutput()

Fermez et supprimez la sortie de l'émulateur.

abstract void stopLogcat()

Arrêtez la capture de 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émentielle le contenu d'un répertoire de fichiers local sur l'appareil.

abstract boolean unlockDevice()

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

abstract void unmountDebugfs()

Désinstallez debugfs.

abstract boolean waitForBootComplete(long timeOut)

Bloque jusqu'à ce que l'indicateur de démarrage terminé de l'appareil soit défini.

abstract boolean waitForDeviceAvailable()

Attend que l'appareil réponde et soit disponible pour des tests.

abstract boolean waitForDeviceAvailable(long waitTime)

Attend que l'appareil réponde et soit disponible pour des tests.

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération.

abstract void waitForDeviceBootloader()

Bloque jusqu'à ce que l'appareil soit visible en fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

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

abstract boolean waitForDeviceInSideload(long waitTime)

Blocs pour que l'appareil soit à l'état "Téléchargement indépendant adb"

abstract boolean waitForDeviceNotAvailable(long waitTime)

Blocages pour que l'appareil soit indisponible, c'est-à-dire absent d'adb

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

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

Constantes

NIVEAU_API_INCONNUE

public static final int UNKNOWN_API_LEVEL

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

Valeur constante : -1 (0xffffffff)

Méthodes publiques

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Vérifier si une fonctionnalité est actuellement compatible avec un niveau de compatibilité minimal. Cette méthode prend en compte les fonctionnalités non publiées jusqu'à présent, avant que le niveau d'API ne soit augmenté.

Paramètres
strictMinLevel int: niveau minimal strict possible pour la fonctionnalité.

Renvoie
boolean "True" si le niveau est accepté. Sinon, cette valeur est "false".

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

ClearLogcat

public abstract void clearLogcat ()

Supprime toutes les données logcat accumulées.

Cela est utile pour vous assurer que ITestDevice#getLogcat() ne renvoie que les données de journal générées après un certain point (par exemple, après avoir flashé un nouveau build d'appareil).

Supprimer le fichier

public abstract void deleteFile (String deviceFilePath)

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

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

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

Supprimer le fichier

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: ID utilisateur à supprimer

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

appareilSoftRedémarré

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible, en comparant le serveur system_server actuel avec le ProcessInfo system_server précédent. Utilisez getProcessByName(String) pour obtenir ProcessInfo.

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

Renvoie
boolean true si l'appareil a redémarré de façon réversible

Génère
RuntimeException Si le problème de démarrage anormal de l'appareil
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible depuis l'heure UTC depuis l'epoch de l'appareil et son ERROR(/TimeUnit). Le terme "redémarrage à chaud" fait référence à "system_server" redémarré en dehors d'un redémarrage matériel de l'appareil (par exemple, un redémarrage demandé). L'utcEpochTime de l'appareil actuel dans Milliseccond peut être obtenu à l'aide de la méthode getDeviceDate().

Paramètres
utcEpochTime long: heure de l'appareil en secondes depuis l'epoch.

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

Renvoie
boolean true si l'appareil a redémarré de façon réversible

Génère
RuntimeException Si le problème de démarrage anormal de l'appareil
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 sera bloquée jusqu'à ce que l'appareil soit disponible.

Renvoie
boolean true si l'opération réussit.

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

DoFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

Renvoie
boolean true si l'opération réussit.

Génère
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'expiration spécifié.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode améliore la détection des défaillances et les performances.

Paramètres
timeout long: temps écoulé en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas, 0L pour l'absence de délai d'inactivité.

commandArgs String: commande adb et arguments à exécuter

Renvoie
String la commande stdout from. null si l'exécution de la commande a échoué.

Génère
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.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode améliore la détection des défaillances et les performances.

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

Renvoie
String la commande stdout from. null si l'exécution de la commande a échoué.

Génère
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'expiration spécifié.

Dans la mesure du possible, utilisez plutôt executeShellCommand(String), car cette méthode améliore la détection des défaillances et les performances.

Paramètres
timeout long: temps écoulé en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas, 0L pour l'absence de délai d'inactivité.

envMap : environnement à définir pour la commande

commandArgs String: commande adb et arguments à exécuter

Renvoie
String la commande stdout from. null si l'exécution de la commande a échoué.

Génère
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.

À utiliser lorsque l'appareil est déjà en mode fastboot.

Paramètres
timeout long: durée (en millisecondes) avant l'expiration de la commande.

commandArgs String: commande fastboot et arguments à exécuter

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

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

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

À utiliser lorsque l'appareil est déjà en mode fastboot.

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

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

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

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), mais utilise un délai d'inactivité plus long.

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

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

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

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), mais utilise un délai d'inactivité plus long.

Paramètres
envVarMap : variables d'environnement système exécutées par la commande fastboot

commandArgs String: commande fastboot et arguments à exécuter

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

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

exécuterShellCommand

public abstract String executeShellCommand (String command)

Méthode d'assistance qui exécute une commande shell adb et renvoie le résultat en tant que String.

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

Renvoie
String la sortie du shell

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

exécuterShellCommand

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

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

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

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

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

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions retryAttempts sont exécutées sans succès.

Génère
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 davantage de paramètres pour contrôler le comportement de la commande.

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

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

maxTimeoutForCommand long: délai maximal avant l'exécution de la commande (unité spécifiée dans timeUnit)

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

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions retryAttempts sont exécutées sans succès.

Génère
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 shell adb donnée, en effectuant plusieurs tentatives si la commande échoue.

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

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

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

Génère
DeviceNotAvailableException 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 la forme d'un élément CommandResult correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.

Paramètres
command String: commande à exécuter.

Renvoie
CommandResult Résultat dans CommandResult.

Génère
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 forme de CommandResult, correctement renseigné avec le résultat de l'état de la commande et stderr. stdout est dirigé vers le flux spécifié.

Paramètres
command String: commande à exécuter.

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

Renvoie
CommandResult Résultat dans CommandResult.

Génère
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 la forme d'un élément CommandResult correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.

Paramètres
command String: commande à exécuter.

pipeAsInput File: valeur ERROR(/File) qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle.

Renvoie
CommandResult Résultat dans CommandResult.

Génère
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 davantage de paramètres pour contrôler le comportement de la commande.

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

maxTimeoutForCommand long: délai maximal avant l'exécution de la commande (unité spécifiée dans timeUnit)

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions retryAttempts sont exécutées sans succès.

Renvoie
CommandResult

Génère
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 davantage de paramètres pour contrôler le comportement de la commande.

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

maxTimeoutForCommand long: délai maximal avant l'exécution de la commande (unité spécifiée dans timeUnit)

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

Renvoie
CommandResult

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

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 davantage de paramètres pour contrôler le comportement de la commande.

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

pipeAsInput File: valeur ERROR(/File) qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle.

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

maxTimeoutForCommand long: délai maximal avant l'exécution de la commande (unité spécifiée dans timeUnit)

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions retryAttempts sont exécutées sans succès.

Renvoie
CommandResult

Génère
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 davantage de paramètres pour contrôler le comportement de la commande.

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

pipeAsInput File: valeur ERROR(/File) qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle.

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

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

maxTimeoutForCommand long: délai maximal avant l'exécution de la commande (unité spécifiée dans timeUnit)

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de tentatives d'exécution de la commande si elle échoue en raison d'une exception. L'exception DeviceNotResponsiveException est levée si les actions retryAttempts sont exécutées sans succès.

Renvoie
CommandResult

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

fastbootEffacerPartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

À utiliser lorsque l'appareil est déjà en mode fastboot.

Paramètres
partition String: partition à effacer

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

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

niveau getApi

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

Méthode pratique permettant d'obtenir la version bande de base (radio) de cet appareil. L'obtention de la version radio est spécifique à chaque appareil. Par conséquent, il est possible qu'elle ne renvoie pas les bonnes informations pour tous les appareils. Cette méthode repose sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Cette valeur n'est pas exacte pour certains appareils CDMA. Il est possible que la version renvoyée ici ne corresponde pas à celle indiquée par fastboot et qu'elle ne renvoie pas toujours la version du signal radio CDMA. Résumé de cette méthode uniquement si la propriété gsm.version.baseband est identique à la version renvoyée par fastboot getvar version-baseband.

Renvoie
String la version de bande de base String ou null si elle ne peut pas être déterminée (l'appareil n'a aucune radio ou la chaîne de version ne peut pas être lue) ;

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

getBatterie

public abstract Integer getBattery ()

Renvoie le niveau de batterie actuel d'un appareil, ou la valeur "null" si le niveau de batterie n'est pas disponible.

Renvoie
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Renvoie la valeur booléenne d'une propriété donnée.

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

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

Renvoie
boolean true si la propriété présente la valeur "1", "y", "yes", "on" ou "true", false si la valeur de la propriété est "0", "n", "no", "off", "false" ou defaultValue dans le cas contraire.

Génère
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage.

Renvoie
Carte du temps de démarrage (temps UTC en seconde depuis l'epoch) et du motif de démarrage

Génère
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage depuis le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée. La valeur utcEpochTime actuelle de l'appareil en millisecondes peut être obtenue à l'aide de la méthode getDeviceDate().

Paramètres
utcEpochTime long: durée de l'appareil depuis l'epoch.

timeUnit TimeUnit: unité de temps TimeUnit.

Renvoie
Carte du temps de démarrage (temps UTC en seconde depuis l'epoch) et du motif de démarrage

Génère
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Méthode pratique permettant d'obtenir la version du bootloader de cet appareil.

Tentative de récupération de la version du bootloader à partir de l'état actuel de l'appareil. (par exemple, si l'appareil est en mode fastboot, il tentera de récupérer la version à partir de fastboot).

Renvoie
String La version du bootloader String ou null si elle est introuvable

Génère
DeviceNotAvailableException 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 compilation en cours d'exécution par l'appareil.

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

Renvoie
String l'alias de build ou passer à l'ID de build s'il n'a pas pu être récupéré

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

getBuildFlavor

public abstract String getBuildFlavor ()

Récupérez le type de compilation pour l'appareil.

Renvoie
String le type de compilation ou la valeur "null" si elle n'a pas pu être récupérée ;

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

getBuildId

public abstract String getBuildId ()

Récupérez la version en cours d'exécution de l'appareil.

Renvoie
String L'ID de la compilation ou IBuildInfo#UNKNOWN_BUILD_ID s'il n'a pas pu être récupéré

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

Renvoie
String Clé de signature si trouvée, valeur null dans le cas contraire.

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Renvoie une valeur DeviceDescriptor mise en cache si l'appareil est alloué. Sinon, renvoie la valeur DeviceDescriptor actuelle.

Renvoie
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Renvoie une valeur DeviceDescriptor mise en cache si l'appareil est alloué. Sinon, renvoie la valeur DeviceDescriptor actuelle.

Paramètres
shortDescriptor boolean: indique s'il faut limiter ou non le descripteur à un minimum d'informations.

Renvoie
DeviceDescriptor

Enfants

public abstract String[] getChildren (String deviceFilePath)

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

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

Renvoie
String[] Tableau de chaîne contenant tous les fichiers d'un chemin d'accès sur l'appareil.

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

getConnection

public abstract AbstractConnection getConnection ()

Renvoie la connexion associée à l'appareil.

Renvoie
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Permet d'obtenir la classe de l'appareil.

Renvoie
String la classe d'appareil String.

getDeviceDate

public abstract long getDeviceDate ()

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

Renvoie
long la date de l'appareil au format epoch.

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations le concernant sans transmettre l'objet d'appareil réel.

Renvoie
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations le concernant sans transmettre l'objet d'appareil réel.

Paramètres
shortDescriptor boolean: indique s'il faut limiter ou non le descripteur à un minimum d'informations.

Renvoie
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Renvoie
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Outil d'aide pour obtenir le décalage horaire entre l'appareil et un ERROR(/Date) donné. Utilisez l'epoch en interne.

Paramètres
date Date

Renvoie
long la différence en millisecondes

Génère
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Obtenir le flux de l'émulateur stdout et stderr

Renvoie
InputStreamSource sortie de l'émulateur

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la mémoire de stockage externe de l'appareil.

Renvoie
long quantité d'espace disponible en Ko

Génère
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 permettant d'obtenir le type de produit de cet appareil en mode fastboot.

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

Renvoie
String Nom du type de produit String ou null s'il ne peut pas être déterminé

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.

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

Renvoie
String Nom du type de produit String ou null s'il ne peut pas être déterminé

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

Renvoie
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

Paramètres
variableName String: nom de la variable.

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

Génère
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

Renvoie
IFileEntry IFileEntry ou null si le fichier path indiqué est introuvable

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

getIDevice

public abstract IDevice getIDevice ()

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

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

Renvoie
IDevice l'/le/la IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

Génère
DeviceNotAvailableException

getLastExpectRestartTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Renvoie
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

Renvoie
int Nombre entier indiquant le premier niveau d'API de l'appareil

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

getLogcat

public abstract InputStreamSource getLogcat ()

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

Fonctionne dans deux modes:

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

    Renvoie
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Récupère un flux d'instantanés de la dernière maxBytes de données logcat capturées.

    Utile pour les cas où vous souhaitez capturer des instantanés fréquents des données logcat capturées sans subir la perte d'espace disque potentiellement importante liée à l'obtention de l'instantané getLogcat() complet.

    Paramètres
    maxBytes int: quantité maximale de données à renvoyer. Il doit s'agir d'une quantité pouvant tenir facilement en mémoire

    Renvoie
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

    L'inconvénient est que rien n'est renvoyé si l'appareil n'est pas accessible.

    Renvoie
    InputStreamSource une InputStreamSource des données logcat. Un flux vide est renvoyé si la capture des données logcat échoue.

    getLogcatLogcat

    public abstract InputStreamSource getLogcatSince (long date)

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

    Paramètres
    date long: en millisecondes depuis le format epoch du démarrage de l'instantané jusqu'à présent. (peut être obtenu en utilisant "date +%s")

    Renvoie
    InputStreamSource

    GetMountPoint

    public abstract String getMountPoint (String mountName)

    Renvoie un point d'installation.

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

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

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

    Renvoie
    String le point d'installation ou null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Renvoie un MountPointInfo correspondant au chemin d'accès du point de montage spécifié, ou null si ce chemin n'est installé sur aucun élément ou n'apparaît pas dans /proc/mounts en tant que point de montage.

    Paramètres
    mountpoint String

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

    Génère
    DeviceNotAvailableException

    Voir aussi :

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

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

    Génère
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Paramètres
    partition String

    Renvoie
    long quantité d'espace disponible en Ko

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

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

    Paramètres
    processName String: nom du processus (String).

    Renvoie
    ProcessInfo ProcessInfo associé au nom processName donné

    Génère
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

    Renvoie
    String

    Génère
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Méthode pratique permettant d'obtenir le type de produit de cet appareil.

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

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

    Génère
    DeviceNotAvailableException Si la connexion à 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 permettant d'obtenir la variante du produit de cet appareil.

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

    Renvoie
    String Nom de la variante du produit String ou null s'il ne peut pas être déterminé

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

    getProperty

    public abstract String getProperty (String name)

    Récupère la valeur de propriété donnée à partir de l'appareil.

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

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

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

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getSerialNumber

    public abstract String getSerialNumber ()

    Méthode pratique permettant d'obtenir le numéro de série de cet appareil.

    Renvoie
    String le numéro de série String

    getTombstones

    public abstract  getTombstones ()

    Récupérez et renvoyez la liste des tombstones des appareils. Racine requise.

    est la meilleure méthode. Si un tombstone ne parvient pas à être extrait pour une raison quelconque, il sera absent de la liste. Seul un DeviceNotAvailableException met fin à la méthode plus tôt que prévu.

    Renvoie
    Liste de fichiers tombstone, vide s'il n'y en a pas.

    Génère
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Renvoie
    long

    getUseFastbootEffacer

    public abstract boolean getUseFastbootErase ()

    Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.

    Renvoie
    boolean true si l'effacement rapide est utilisé ou false si le format Fastboot est utilisé.

    IsAdbRoot

    public abstract boolean isAdbRoot ()

    Renvoie
    boolean true si l'appareil dispose actuellement d'une racine adb, ou false dans le cas contraire.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Renvoie
    boolean true si l'appareil est connecté à adb-over-tcp, false dans le cas contraire.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

    Renvoie
    boolean "True" si l'énumération d'applications est compatible, "false" dans le cas contraire

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

    isBypassLowTargetSdkBlockCompatible

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

    Renvoie
    boolean "True" si le bloc du SDK cible à faible valeur de contournement est accepté, ou "false" dans le cas contraire

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

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Vérifiez si debugfs est installé.

    Renvoie
    boolean true si debugfs est installé

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

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Indique si l'appareil est chiffré.

    Renvoie
    boolean true si l'appareil est chiffré

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

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Renvoyez la valeur "True" si le chemin d'accès sur l'appareil est un répertoire, et la valeur "false" dans le cas contraire.

    Paramètres
    deviceFilePath String

    Renvoie
    boolean

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

    isEncryptionCompatible

    public abstract boolean isEncryptionSupported ()

    Indique si l'appareil est compatible avec le chiffrement.

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

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

    isExecutable (isExecutable)

    public abstract boolean isExecutable (String fullPath)

    Affiche la valeur "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, et la valeur "false" dans le cas contraire.

    Paramètres
    fullPath String

    Renvoie
    boolean

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

    IsHeadless

    public abstract boolean isHeadless ()

    Renvoie la valeur "true" si l'appareil est headless (aucun écran), sinon la valeur "false".

    Renvoie
    boolean

    Génère
    DeviceNotAvailableException

    isRuntimePermissionCompatible

    public abstract boolean isRuntimePermissionSupported ()

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

    Renvoie
    boolean "True" si les autorisations d'exécution sont prises en charge, et "false" dans le cas contraire.

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

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Renvoie la valeur "true" si l'appareil se trouve dans TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD.

    Renvoie
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Recueille et consigne les erreurs ANR de l'appareil.

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

    Renvoie
    boolean La valeur est "true" si la journalisation a réussi, ou "false" dans le cas contraire.

    Génère
    DeviceNotAvailableException

    ouverture de session sur l'appareil

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

    Consigner un message dans le fichier logcat de l'appareil. Il s'agit d'un appel sécurisé qui ne sera pas généré même en cas d'échec de la journalisation.

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

    level Log.LogLevel: niveau de débogage du message dans Logcat.

    format String: format du message.

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

    MountDebugfs

    public abstract void mountDebugfs ()

    Installation de debugfs

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

    nonBlocageRedémarrer

    public abstract void nonBlockingReboot ()

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

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

    postBootSetup

    public abstract void postBootSetup ()

    Suivez les instructions pour configurer l'appareil afin de le tester après chaque démarrage.

    Doit être appelé une fois l'appareil entièrement démarré/disponible

    En temps normal, 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.

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

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

    Des étapes supplémentaires pour un appareil spécifique nécessitaient un nettoyage qui sera exécuté une fois l'appel terminé.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Des étapes supplémentaires pour un appareil spécifique nécessitaient un nettoyage qui sera exécuté une fois l'appel terminé.

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

    PreInvocationSetup

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

    Étapes supplémentaires pour une configuration spécifique à l'appareil qui sera exécutée sur l'appareil avant le processus d'appel.

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

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

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

    Fonction pull Dir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

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

    Paramètres
    deviceFilePath String: chemin d'accès absolu au fichier de la source distante

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

    Renvoie
    boolean true si le fichier a bien été extrait. false dans les autres cas.

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

    Fonction pull Dir

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

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

    Paramètres
    deviceFilePath String: chemin d'accès absolu au fichier de la source distante

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

    userId int: ID utilisateur à partir duquel effectuer l'extraction.

    Renvoie
    boolean true si le fichier a bien été extrait. false dans les autres cas.

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

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: ID utilisateur à partir duquel effectuer l'extraction.

    Renvoie
    File Un élément ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si la copie a échoué pour une raison quelconque (y compris en cas de problème avec le système de fichiers hôte)

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

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

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

    Renvoie
    File Un élément ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si la copie a échoué pour une raison quelconque (y compris en cas de problème avec le système de fichiers hôte)

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

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

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

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

    localFile File: fichier local dans lequel stocker le contenu. Si cette valeur n'est pas vide, le contenu est remplacé.

    Renvoie
    boolean true si le fichier a bien été récupéré. false dans les autres cas.

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

    pullFile

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

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

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

    localFile File: fichier local dans lequel stocker le contenu. Si cette valeur n'est pas vide, le contenu est remplacé.

    userId int: ID utilisateur à partir duquel effectuer l'extraction.

    Renvoie
    boolean true si le fichier a bien été récupéré. false dans les autres cas.

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

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Récupère un fichier depuis l'appareil, puis renvoie son contenu.

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

    Renvoie
    String Un élément String contenant le contenu du fichier de l'appareil, ou null si la copie a échoué pour une raison quelconque (y compris en cas de problème avec le système de fichiers hôte)

    Génère
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

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

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

    Renvoie
    File Un élément ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si la copie a échoué pour une raison quelconque (y compris en cas de problème avec le système de fichiers hôte)

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

    Rép. push

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

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

    Paramètres
    localDir File: répertoire local à transférer

    deviceFilePath String: chemin d'accès absolu au fichier de la destination distante

    userId int: ID utilisateur vers lequel transférer le contenu

    Renvoie
    boolean true si le fichier a bien été transféré. false dans les autres cas.

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

    Rép. push

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

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

    Paramètres
    localDir File: répertoire local à transférer

    deviceFilePath String: chemin d'accès absolu au fichier de la destination distante

    excludedDirectories : ensemble de noms de répertoires exclus à ne pas transférer.

    Renvoie
    boolean true si le fichier a bien été transféré. false dans les autres cas.

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

    Rép. push

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

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

    Paramètres
    localDir File: répertoire local à transférer

    deviceFilePath String: chemin d'accès absolu au fichier de la destination distante

    Renvoie
    boolean true si le fichier a bien été transféré. false dans les autres cas.

    Génère
    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 la nécessité pour le fournisseur de contenu.

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

    deviceFilePath String: chemin d'accès absolu au fichier de destination à distance

    evaluateContentProviderNeeded boolean: indique si nous avons besoin du fournisseur de contenu.

    Renvoie
    boolean true si le fichier a bien été transféré. false dans les autres cas.

    Génère
    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érer un fichier sur l'appareil Utilisation par défaut d'un fournisseur de contenu.

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

    deviceFilePath String: chemin d'accès absolu au fichier de destination à distance

    Renvoie
    boolean true si le fichier a bien été transféré. false dans les autres cas.

    Génère
    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, 
                    int userId)

    Transférer un fichier sur l'appareil Utilisation par défaut d'un fournisseur de contenu.

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

    deviceFilePath String: chemin d'accès absolu au fichier de destination à distance

    userId int: ID utilisateur vers lequel envoyer le transfert

    Renvoie
    boolean true si le fichier a bien été transféré. false dans les autres cas.

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

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

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

    deviceFilePath String: chemin d'accès absolu au fichier de destination à distance

    Renvoie
    boolean true si la chaîne a bien été transmise. false dans les autres cas.

    Génère
    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.

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

    redémarrer

    public abstract void reboot (String reason)

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

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

    Vous pouvez obtenir le motif du dernier redémarrage en interrogeant la propriété sys.boot.reason.

    Paramètres
    reason String: motif de ce redémarrage ou null si aucun motif n'est spécifié.

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

    redémarrer le bootloader dans le bootloader

    public abstract void rebootIntoBootloader ()

    Redémarre l'appareil en mode bootloader.

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

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

    redémarrer

    public abstract void rebootIntoFastbootd ()

    Redémarre l'appareil en mode fastbootd.

    Blocages jusqu'à ce que l'appareil soit en mode fastbootd

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

    redémarrer votre navigateur

    public abstract void rebootIntoRecovery ()

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

    Blocages tant que l'appareil n'entre pas dans le processus de récupération

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

    redémarrer le chargement latéral

    public abstract void rebootIntoSideload (boolean autoReboot)

    Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).

    Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant

    Paramètres
    autoReboot boolean: indique si l'appareil doit être redémarré automatiquement après un téléchargement indépendant.

    Génère
    DeviceNotAvailableException Si l'appareil n'est pas en téléchargement indépendant après le redémarrage

    redémarrer le chargement latéral

    public abstract void rebootIntoSideload ()

    Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).

    Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant

    Génère
    DeviceNotAvailableException Si l'appareil n'est pas en téléchargement indépendant après le redémarrage

    redémarrer jusqu'au magasin en ligne

    public abstract void rebootUntilOnline ()

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

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

    redémarrer jusqu'au magasin en ligne

    public abstract void rebootUntilOnline (String reason)

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

    Paramètres
    reason String: motif de ce redémarrage ou null si aucun motif n'est spécifié.

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

    Voir aussi :

    redémarrer l'espace utilisateur

    public abstract void rebootUserspace ()

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

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

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

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

    redémarrer l'espaceUtilisateurJusqu'àEnligne

    public abstract void rebootUserspaceUntilOnline ()

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

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

    réinstaller le système en lecture seule

    public abstract void remountSystemReadOnly ()

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

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

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

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

    réinstallerVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Définissez la partition du fournisseur sur l'appareil en lecture seule. Peut redémarrer l'appareil.

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

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

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

    exécuterInstrumentationTests

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

    Méthode pratique permettant d'exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) avec un ou plusieurs écouteurs transmis en tant que paramètres.

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

    listeners ITestLifeCycleReceiver: le ou les écouteurs des résultats du test.

    Renvoie
    boolean true si la commande de test est terminée. false si l'exécution a échoué, mais que la récupération a réussi.

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée (échec de l'exécution de la commande de test et de la récupération, par exemple).

    exécuterInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

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

    Si la connexion à l'appareil est perdue avant la fin de l'exécution du test et que la récupération échoue, tous les écouteurs sont informés de testRunFailed, et une exception DeviceNotAvailableException est générée.

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

    listeners : écouteurs des résultats du test

    Renvoie
    boolean true si la commande de test est terminée. false si l'opération a échoué en raison d'une exception de communication de l'appareil, mais que la récupération a réussi

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée (échec de l'exécution de la commande de test et de la récupération, par exemple).

    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

    Renvoie
    boolean

    Génère
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Paramètres
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Renvoie
    boolean

    Génère
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Définit la date sur l'appareil

    Remarque: Pour définir la date sur l'appareil, vous devez être en mode root

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

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

    Définir les options

    public abstract void setOptions (TestDeviceOptions options)

    Définir le TestDeviceOptions pour l'appareil

    Paramètres
    options TestDeviceOptions

    Définir une propriété

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Définit la valeur de propriété donnée sur l'appareil. La valeur de la racine adb est "true".

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

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

    Renvoie
    boolean renvoie True si la commande setprop a abouti et la valeur "False" dans le cas contraire.

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

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Définissez les IDeviceRecovery à utiliser pour cet appareil. Doit être défini lors de la première allocation de l'appareil.

    Paramètres
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Permet de contrôler la méthode de récupération à utiliser en cas de problème de communication avec l'appareil. Nous vous recommandons de n'utiliser cette méthode qu'avec parcimonie en cas de besoin (par exemple, lorsque le framework est indisponible, etc.).

    Paramètres
    mode ITestDevice.RecoveryMode: indique si le mode de récupération doit être activé ou non.

    setUseFastbootEffacer

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.

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

    startLogcat

    public abstract void startLogcat ()

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

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

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

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Fermez et supprimez la sortie de l'émulateur.

    stopLogcat

    public abstract void stopLogcat ()

    Arrêtez la capture de 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.

    Renvoie
    String Numéro de série du tcp ou null si l'appareil n'a pas pu être changé

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

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Basculez l'appareil en mode adb via USB.

    Renvoie
    boolean true si le changement a réussi, false dans le cas contraire.

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

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Décide les fichiers à transférer en comparant les horodatages des fichiers locaux avec leurs équivalents distants. Seuls les fichiers "nouveaux" ou inexistants seront transférés vers l'appareil. La surcharge devrait donc être relativement faible si les fichiers définis sur l'appareil sont déjà à jour.

    Les fichiers masqués (dont le nom commence par ".") sont ignorés.

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

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

    deviceFilePath String: racine du chemin d'accès absolu au fichier de destination à distance Tous les répertoires de ce chemin de fichier doivent être lisibles. C'est-à-dire que le fait de transférer vers /data/local/tmp lorsque adb n'est pas la racine échouera.

    Renvoie
    boolean true si les fichiers ont bien été synchronisés. false dans les autres cas.

    Génère
    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 s'il est chiffré.

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

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

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

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Désinstallez debugfs.

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

    WaitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Bloque jusqu'à ce que l'indicateur de démarrage terminé de l'appareil soit défini.

    Paramètres
    timeOut long: temps d'attente, exprimé en ms, pour que l'indicateur soit défini.

    Renvoie
    boolean "true" si l'indicateur de démarrage terminé de l'appareil est défini dans le délai avant expiration

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

    WaitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Attend que l'appareil réponde et soit disponible pour des tests. Utilise le délai d'inactivité par défaut.

    Renvoie
    boolean "True" si l'appareil est disponible, "False" si la récupération est désactivée et indisponible.

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

    WaitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Attend que l'appareil réponde et soit disponible pour des tests.

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

    Renvoie
    boolean "True" si l'appareil est disponible, "False" si la récupération est désactivée et indisponible.

    Génère
    DeviceNotAvailableException si l'appareil ne répond toujours pas après l'expiration 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

    Renvoie
    boolean "True" si l'appareil est disponible, "False" s'il n'est pas disponible.

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

    WaitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

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

    WaitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

    Renvoie
    boolean true si la récupération de l'appareil est lancée avant l'expiration du délai. false dans les autres cas

    WaitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocs pour que l'appareil soit à l'état "Téléchargement indépendant adb"

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

    Renvoie
    boolean true si l'appareil démarre en téléchargement indépendant avant l'expiration du délai. false dans les autres cas

    WaitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocages pour que l'appareil soit indisponible, c'est-à-dire absent d'adb

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

    Renvoie
    boolean true si l'appareil n'est plus disponible avant l'expiration du délai. false dans les autres cas

    WaitForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

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

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être ré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 l'opération terminée. Utilisez plutôt waitForDeviceAvailable().

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

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

    WaitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

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

    Renvoie
    boolean true si l'appareil devient réactif avant que waitTime ne se soit écoulé.