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 de l'appareil pour une quantité configurable et permet de récupérer l'appareil pour les appareils qui ne répondent pas.

Résumé

Constantes

int UNKNOWN_API_LEVEL

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

Méthodes publiques

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Vé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 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 2 minutes

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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

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 de démarrage et le motif du démarrage 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 version (contrôlé par des fabricants d'appareils individuels)

abstract DeviceDescriptor getCachedDeviceDescriptor()

Renvoie un DeviceDescriptor mis en cache si l'appareil est alloué. Sinon, renvoie le DeviceDescriptor en cours.

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Renvoie un DeviceDescriptor mis en cache si l'appareil est alloué. Sinon, renvoie le DeviceDescriptor en cours.

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 en transmettant l'objet réel de l'appareil.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

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 en tant que 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 au point de montage spécifié, ou null si ce chemin n'est pas installé ou n'apparaît pas dans /proc/mounts comme 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 la fonction "pidof" et "stat" et renvoie l'objet ProcessInfo avec PID et 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.

default String getTrackingSerial()

Pour gérer les appareils, récupérez le numéro de série utilisé pour le suivre.

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 et renvoie une commande terminée et 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 nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est 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 flux 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, puis l'affiche. File

abstract File pullFile(String remoteFilePath)

Récupère un fichier depuis l'appareil, le stocke dans un ERROR(/File) temporaire local, puis l'affiche. 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, en le stockant dans un ERROR(/File) temporaire local et renvoyer une référence à ce File.

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

Transférez 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ée.

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

Autre solution à 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 setTrackingSerial(String trackingSerial)

Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer 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 sur USB.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

Déverrouille l'appareil 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 dans la récupération adb (notez qu'il ne s'agit pas IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Blocs pour que l'appareil soit dans le téléchargement indépendant adb état

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. Ce prend en compte les fonctionnalités qui n'ont pas encore été publiées, 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 lorsque vous voulez vous assurer que ITestDevice#getLogcat() ne renvoie que des les données de journal générées après un certain point (par exemple, après le flash d'un nouveau build d'appareil, etc.).

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 appareil et son ERROR(/TimeUnit). Soft-Restart fait référence au système « system_server » redémarré en dehors d’un un redémarrage matériel de l'appareil (redémarrage demandé, par exemple) ; L'utcEpochTime de l'appareil actuel dans Vous pouvez obtenir Milliseccond à 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 bloque jusqu'à appareil est 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 être récupéré.

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 être récupéré.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Active la racine adb. Si la commande "enable-root" est défini sur "false", un message est consigné sans activer la racine.

L'activation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode bloque jusqu'à appareil est 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 être récupéré.

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 cela permet d'améliorer 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 aucun délai

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

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 cela permet d'améliorer 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 être récupéré.

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 cela permet d'améliorer 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 pas 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é.

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 être récupéré.

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 2 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 être récupéré.

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 être récupéré.

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 l'état système variables d'environnement.

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 être récupéré.

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 être récupéré.

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é à ne générer aucune réponse ; l'unité, comme indiqué dans timeUnit

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

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

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

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é dans timeUnit

maxTimeToOutputShellResponse long: durée maximale pendant laquelle la commande est autorisé à ne générer aucune réponse ; l'unité, comme indiqué dans timeUnit

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

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

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

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.

Une forme plus simple de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) avec 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 être récupéré.

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 être récupéré.

ExécuterShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément CommandResult correctement renseigné avec le résultat de l'état de la commande et la valeur 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 être récupéré.

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 être récupéré.

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é dans timeUnit

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont 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é.

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

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é dans timeUnit

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont 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é.

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é dans timeUnit

timeUnit TimeUnit: unité pour maxTimeToOutputShellResponse

retryAttempts int: nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont 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é.

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 démarrage suivant. 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 être récupéré.

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. Obtenir la version radio est spécifique à un appareil, et il est donc possible qu'elle ne renvoie pas les bonnes informations pour tous les appareils. Ce repose sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Cette valeur est inexacte pour certains appareils CDMA et peut ne pas correspondre à la version renvoyée ici. la version signalée par fastboot et peut ne pas renvoyer la version du signal radio CDMA. En résumé, cette méthode ne signale la version précise que si la propriété gsm.version.baseband est la identique à la version renvoyée par fastboot getvar version-baseband.

Renvoie
String la version de bande de base String ou null si elle ne peut pas être déterminée ; (l'appareil n'a pas d'option, 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ées.

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é a la valeur "1", "y", "yes", "on", ou "true", false si la propriété a la valeur "0", "n", "no", "off", "false" ou defaultValue sinon.

Génère
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

La méthode d'assistance collecte la carte de l'historique de démarrage avec 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 de démarrage et le motif du démarrage le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée. L'utcEpochTime de l'appareil actuel dans La milliseconde peut être obtenue par 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. (c'est-à-dire 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 être récupéré.

getBuildAlias

public abstract String getBuildAlias ()

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

L'alias de compilation est généralement une chaîne plus lisible que l'ID de compilation (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 à un ID de build. 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 version (contrôlé 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 un DeviceDescriptor mis en cache si l'appareil est alloué. Sinon, renvoie le DeviceDescriptor en cours.

Renvoie
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Renvoie un DeviceDescriptor mis en cache si l'appareil est alloué. Sinon, renvoie le DeviceDescriptor en cours.

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 en transmettant l'objet réel de l'appareil.

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 en transmettant l'objet réel de l'appareil.

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é. Utiliser 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 être récupéré.

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. C'est une variante un peu plus sûre que la méthode générique getProductType() dans ce cas, car ITestDevice saura qu'il doit récupérer l'appareil en fastboot si son état est incorrect ou s'il est 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 être récupéré.

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. C'est une variante un peu plus sûre que la méthode générique getProductType() dans ce cas, car ITestDevice saura qu'il doit récupérer l'appareil en fastboot si son état est incorrect ou s'il est 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 être récupéré.

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 à "/". (ex. : à la fois "/system" et "système" est compatible)

Renvoie
IFileEntry IFileEntry ou null si le fichier à l'path donné ne peut pas être trouvé

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 le service de gestion des données (DMS) chaque fois que l'appareil se déconnecte et se reconnecte à partir d'adb. Ainsi, les appelants ne doivent pas garder 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 ou 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 en tant que 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 actuellement capturé en arrière-plan, cette fonction renvoie jusqu'à TestDeviceOptions.getMaxLogcatDataSize() octets du contenu actuel de l'arrière-plan. capture logcat
  • 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 pénalité d'espace disque potentiellement importante que représente l'obtention de l'instantané getLogcat() complet.

    Paramètres
    maxBytes int: quantité maximale de données à renvoyer. Il doit s'agir d'un montant pouvant s'adaptent parfaitement à la 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é en cas d'échec. pour capturer les données logcat.

    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 du l'appareil doit être utilisé 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 au point de montage spécifié, ou null si ce chemin n'est pas installé ou n'apparaît pas dans /proc/mounts comme 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é.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    La méthode d'assistance exécute la fonction "pidof" et "stat" et renvoie l'objet ProcessInfo avec PID et 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 avec l'appareil est perdue et ne peut pas être récupéré 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 le nom de la variante du produit String ou null s'il ne peut pas être déterminé

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

    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.

    la méthode est la meilleure méthode. Ainsi, si une pierre tombale n'est pas extraite pour une raison quelconque, elle sera absents de la liste. Seul un DeviceNotAvailableException mettra fin à la méthode. plus tôt.

    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

    getTrackingSerial

    public String getTrackingSerial ()

    Pour gérer les appareils, récupérez le numéro de série utilisé pour le suivre.

    Renvoie
    String

    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 être utilisée.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

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

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Vérifier si la plate-forme 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 de contournement à faible valeur 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é.

    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

    isChiffrementCompatible

    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 si la journalisation échoue.

    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

    nonBlockingRedémarrer

    public abstract void nonBlockingReboot ()

    Émet une commande pour redémarrer l'appareil et renvoie une commande terminée et 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 règle générale, cette méthode n'a pas besoin d'être appelée explicitement, car les implémentations doivent effectuer ces étapes automatiquement lors d'un redémarrage.

    Il peut être nécessaire de l'appeler lorsque l'appareil redémarre en raison d'autres événements (par exemple, lorsqu'un fastboot update est terminée).

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

    Des étapes supplémentaires pour un nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est terminé.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Des étapes supplémentaires pour un nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est 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 flux 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é.

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

    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, puis l'affiche. 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 ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si le Échec de la copie pour une raison quelconque (y compris des problèmes 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é.

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

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

    Renvoie
    File Un ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si le Échec de la copie pour une raison quelconque (y compris des problèmes 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é.

    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 vous n'indiquez aucune valeur, le contenu sera 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é.

    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 vous n'indiquez aucune valeur, le contenu sera 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 être récupéré.

    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 String contenant le contenu du fichier de l'appareil, ou null si le Échec de la copie pour une raison quelconque (y compris des problèmes 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, en le stockant dans un ERROR(/File) temporaire local et renvoyer une référence à ce File.

    Paramètres
    remoteFilePath String: chemin d'accès au fichier sur l'appareil, par rapport à son espace de stockage externe Mountpoint

    Renvoie
    File Un ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si le Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte)

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

    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 être récupéré.

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

    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 être récupéré.

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

    fichier push

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

    Variante de pushFile(File, String), qui peut éventuellement envisager d'évaluer le besoin 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é.

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

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

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

    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 être récupéré.

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

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

    Autre solution à 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 en cas d'échec terminée, mais la récupération a réussi

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut être récupéré. Par exemple, la commande de test n'a pas abouti et la récupération a échoué.

    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, toutes les écouteurs seront informés de testRunFailed et "false" est renvoyé. La commande test ne seront pas réexécutées. Les appelants peuvent réessayer, si nécessaire.

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

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

    listeners : écouteurs des résultats du test

    Renvoie
    boolean true si la commande de test est terminée. false en cas d'échec terminée en raison d'une exception de communication de l'appareil, mais récupération réussie

    Génère
    DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré. Par exemple, la commande de test n'a pas abouti et la récupération a échoué.

    runInstrumentationTestsAsUser

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

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

    Paramètres
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    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. utilisera la date de l'hôte 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 lorsque l'appareil est le premier alloué.

    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 sur l'appareil rencontrés. Nous vous recommandons de n'utiliser cette méthode qu'avec parcimonie lorsque cela est nécessaire (par exemple, lorsque le framework est hors service, etc.

    Paramètres
    mode ITestDevice.RecoveryMode: indique si la récupération doit être disponible en ligne uniquement. doit être activé ou non.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer l'appareil.

    Paramètres
    trackingSerial String

    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 lorsque 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 codes temporels des fichiers locaux avec ceux des fichiers distants équivalents. 'plus récent' uniquement ou inexistants seront transférés sur l’appareil. Par conséquent, doit être relativement petite si le fichier installé sur l'appareil est 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 si il n'existe pas encore, et il transfère le contenu de /tmp/files de manière récursive vers /sdcard/files.

    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 qu'il contient le chemin d'accès au fichier doit être lisible. Par exemple, transfert vers /data/local/tmp lorsqu'adb n'est pas 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é.

    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 risque de ne pas être entièrement prêt à être testé lorsque cette méthode sera 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é.
    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é.

    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 être récupéré.

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

    WaitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocs pour que l'appareil soit dans la récupération adb (notez qu'il ne s'agit pas 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 dans le téléchargement indépendant adb état

    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 waitForDeviceAvailable() à la place.

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

    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 waitForDeviceAvailable() à la place.

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

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

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