INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Fournit une API fiable et de niveau légèrement supérieur à un ddmlib IDevice
.
Résumé
Constantes | |
---|---|
int | UNKNOWN_API_LEVEL Valeur par défaut lorsque le niveau API ne peut pas être détecté |
Méthodes publiques | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Vérifiez si une fonctionnalité est actuellement prise en charge ou non, compte tenu d'un niveau minimal pris en charge. |
abstract void | clearLogcat () Supprime toutes les données logcat accumulées. |
abstract void | deleteFile (String deviceFilePath) Méthode d'assistance pour supprimer un fichier ou un répertoire sur l'appareil. |
abstract boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur en comparant le serveur système actuel avec le serveur système précédent |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur depuis l'heure UTC depuis l'époque de l'appareil et son |
abstract boolean | disableAdbRoot () Désactive la racine adb. |
abstract boolean | doesFileExist (String deviceFilePath) Méthode d'assistance pour déterminer si le fichier sur l'appareil existe. |
abstract boolean | enableAdbRoot () Active la racine AdB. |
abstract String | executeAdbCommand (long timeout, String... commandArgs) Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié. |
abstract String | executeAdbCommand (String... commandArgs) Méthode d'assistance qui exécute une commande adb en tant que commande système. |
abstract String | executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs) Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié. |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) Méthode d'assistance qui exécute une commande fastboot en tant que commande système. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'expiration par défaut de 2 minutes. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système. |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système avec des variables d'environnement système. |
abstract String | executeShellCommand (String command) Méthode d'assistance qui exécute une commande shell adb et renvoie la sortie sous forme de |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) Exécute la commande adb shell donnée, en réessayant plusieurs fois si la commande échoue. |
abstract CommandResult | executeShellV2Command (String command) Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous forme de |
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 |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous forme de |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande. |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande. |
abstract CommandResult | fastbootWipePartition (String partition) Méthode d'assistance qui efface une partition du périphérique. |
abstract int | getApiLevel () Obtenez le niveau API de l'appareil. |
abstract String | getBasebandVersion () Méthode pratique pour obtenir la version bande de base (radio) de cet appareil. |
abstract Integer | getBattery () Renvoie le niveau actuel de la batterie d'un appareil ou Null si le niveau de la batterie n'est pas disponible. |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) Renvoie la valeur booléenne de la propriété donnée. |
abstract | getBootHistory () La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage. |
abstract | getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage depuis l'heure indiquée depuis l'époque du périphérique et l'unité de temps spécifiée. |
abstract String | getBootloaderVersion () Méthode pratique pour obtenir la version du chargeur de démarrage de cet appareil. |
abstract String | getBuildAlias () Récupérez l’alias de la build que l’appareil exécute actuellement. |
abstract String | getBuildFlavor () Récupérez la version de build pour l’appareil. |
abstract String | getBuildId () Récupérez la version que l’appareil exécute actuellement. |
abstract String | getBuildSigningKeys () Renvoie le type de clé utilisé pour signer l'image de l'appareil Généralement, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de libération (contrôlées par les fabricants d'appareils individuels) |
abstract DeviceDescriptor | getCachedDeviceDescriptor () Renvoie un |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Renvoie un |
abstract String[] | getChildren (String deviceFilePath) Alternative à l'utilisation |
abstract AbstractConnection | getConnection () Renvoie la connexion associée à l'appareil. |
abstract String | getDeviceClass () Obtenez la classe de périphérique. |
abstract long | getDeviceDate () Renvoie la date de l'appareil en millisecondes depuis l'époque. |
abstract DeviceDescriptor | getDeviceDescriptor () Renvoyez un |
abstract DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Renvoyez un |
abstract TestDeviceState | getDeviceState () Obtenez l'état de l'appareil. |
abstract long | getDeviceTimeOffset (Date date) Aide pour obtenir le décalage horaire entre l'appareil et une |
abstract InputStreamSource | getEmulatorOutput () Obtenez le flux de l'émulateur stdout et stderr |
abstract long | getExternalStoreFreeSpace () Méthode d'assistance pour déterminer la quantité d'espace libre sur le stockage externe de l'appareil. |
abstract String | getFastbootProductType () Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode de démarrage rapide. |
abstract String | getFastbootProductVariant () Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode de démarrage rapide. |
abstract String | getFastbootSerialNumber () Renvoie le numéro de série du mode fastboot. |
abstract String | getFastbootVariable (String variableName) Récupérez la valeur de la variable fastboot donnée sur le périphérique. |
abstract IFileEntry | getFileEntry (String path) Récupérer une référence à un fichier distant sur l'appareil. |
abstract IDevice | getIDevice () Renvoie une référence au ddmlib |
abstract long | getIntProperty (String name, long defaultValue) Renvoie la valeur entière de la propriété donnée à partir du périphérique. |
abstract long | getLastExpectedRebootTimeMillis () Renvoie la dernière fois que les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH, tel que renvoyé par |
abstract int | getLaunchApiLevel () Obtenez le premier niveau API lancé sur l'appareil. |
abstract InputStreamSource | getLogcat () Récupère un flux instantané des données logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) Récupère un flux instantané des derniers |
abstract InputStreamSource | getLogcatDump () Obtenez un vidage du logcat actuel pour le périphérique. |
abstract InputStreamSource | getLogcatSince (long date) Récupère un flux instantané de données logcat capturées à partir de la date fournie. |
abstract String | getMountPoint (String mountName) Renvoie un point de montage. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Renvoie un |
abstract | getMountPointInfo () Renvoie une version analysée des informations dans /proc/mounts sur le périphérique |
abstract long | getPartitionFreeSpace (String partition) Méthode d'assistance pour déterminer la quantité d'espace libre sur la partition du périphérique. |
abstract ProcessInfo | getProcessByName (String processName) La méthode d'assistance exécute les commandes "pidof" et "stat" et renvoie l'objet |
abstract String | getProcessPid (String process) Renvoie le pid du service ou null en cas de problème. |
abstract String | getProductType () Méthode pratique pour obtenir le type de produit de cet appareil. |
abstract String | getProductVariant () Méthode pratique pour obtenir la variante de produit de cet appareil. |
abstract String | getProperty (String name) Récupérez la valeur de propriété donnée à partir de l’appareil. |
abstract ITestDevice.RecoveryMode | getRecoveryMode () Obtenez le mode de récupération actuel utilisé pour l'appareil. |
abstract String | getSerialNumber () Méthode pratique pour obtenir le numéro de série de cet appareil. |
abstract | getTombstones () Récupère et renvoie la liste des pierres tombales des appareils. |
abstract long | getTotalMemory () Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne |
abstract boolean | getUseFastbootErase () Déterminez si vous devez utiliser l'effacement fastboot ou le format fastboot pour effacer une partition sur l'appareil. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications |
abstract boolean | isBypassLowTargetSdkBlockSupported () Vérifiez si la plate-forme sur l'appareil prend en charge le contournement du bloc SDK à faible cible lors des installations d'applications. |
abstract boolean | isDebugfsMounted () Vérifiez si debugfs est monté. |
abstract boolean | isDeviceEncrypted () Renvoie si l'appareil est chiffré. |
abstract boolean | isDirectory (String deviceFilePath) Renvoie True si le chemin sur le périphérique est un répertoire, false sinon. |
abstract boolean | isEncryptionSupported () Renvoie si le chiffrement est pris en charge sur l'appareil. |
abstract boolean | isExecutable (String fullPath) Renvoie True si le chemin du fichier sur le périphérique est un fichier exécutable, false sinon. |
abstract boolean | isHeadless () Renvoie true si l'appareil est sans tête (pas d'écran), false sinon. |
abstract boolean | isRuntimePermissionSupported () Vérifiez si la plate-forme sur l'appareil prend en charge l'octroi d'autorisations d'exécution |
abstract boolean | isStateBootloaderOrFastbootd () Renvoie vrai si l'appareil est dans |
abstract boolean | logAnrs ( ITestLogger logger) Collecte et enregistre les ANR de l'appareil. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Enregistrez un message dans le logcat de l'appareil. |
abstract void | mountDebugfs () Montez les débogages. |
abstract void | nonBlockingReboot () Émet une commande pour redémarrer l'appareil et revient une fois la commande terminée et lorsque l'appareil n'est plus visible pour adb. |
abstract void | postBootSetup () Exécutez les instructions pour configurer le périphérique afin de le tester après chaque démarrage. |
default void | postInvocationTearDown () Cette méthode est obsolète. Utilisez plutôt |
abstract void | postInvocationTearDown (Throwable invocationException) Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté une fois l'appel terminé. |
default void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Étapes supplémentaires pour la configuration requise spécifique à l’appareil qui sera exécutée sur l’appareil avant le flux d’appel. |
abstract boolean | pullDir (String deviceFilePath, File localDir) Extrayez de manière récursive le contenu du répertoire du périphérique. |
abstract File | pullFile (String remoteFilePath, int userId) Récupère un fichier hors de l'appareil, le stocke dans un |
abstract File | pullFile (String remoteFilePath) Récupère un fichier hors de l'appareil, le stocke dans un |
abstract boolean | pullFile (String remoteFilePath, File localFile) Récupère un fichier hors du périphérique. |
abstract boolean | pullFile (String remoteFilePath, File localFile, int userId) Récupère un fichier hors du périphérique. |
abstract String | pullFileContents (String remoteFilePath) Récupère un fichier hors de l'appareil et renvoie le contenu. |
abstract File | pullFileFromExternal (String remoteFilePath) Une méthode pratique pour récupérer un fichier du stockage externe de l'appareil, le stocker dans un |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) Poussez de manière récursive le contenu du répertoire vers l'appareil tout en excluant certains répertoires filtrés. |
abstract boolean | pushDir (File localDir, String deviceFilePath) Poussez de manière récursive le contenu du répertoire vers l’appareil. |
abstract boolean | pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Variante de |
abstract boolean | pushFile (File localFile, String deviceFilePath) Transférez un fichier vers l'appareil. |
abstract boolean | pushString (String contents, String deviceFilePath) Transférer le fichier créé à partir d'une chaîne vers l'appareil |
abstract void | reboot () Redémarre l'appareil en mode adb. |
abstract void | reboot (String reason) Redémarre l'appareil en mode adb avec une |
abstract void | rebootIntoBootloader () Redémarre l'appareil en mode chargeur de démarrage. |
abstract void | rebootIntoFastbootd () Redémarre l'appareil en mode fastbootd. |
abstract void | rebootIntoRecovery () Redémarre l'appareil en mode de récupération Adb. |
abstract void | rebootIntoSideload (boolean autoReboot) Redémarre l'appareil en mode adb sideload (notez qu'il s'agit d'un mode spécial en cours de récupération) Bloque jusqu'à ce que l'appareil passe en mode chargement latéral |
abstract void | rebootIntoSideload () Redémarre l'appareil en mode adb sideload (notez qu'il s'agit d'un mode spécial en cours de récupération) Bloque jusqu'à ce que l'appareil passe en mode chargement latéral |
abstract void | rebootUntilOnline () Une alternative à |
abstract void | rebootUntilOnline (String reason) Une alternative à |
abstract void | rebootUserspace () Redémarre uniquement la partie espace utilisateur de l'appareil. |
abstract void | rebootUserspaceUntilOnline () Une alternative à |
abstract void | remountSystemReadOnly () Rendez la partition système sur le périphérique en lecture seule. |
abstract void | remountSystemWritable () Rendre la partition système du périphérique accessible en écriture. |
abstract void | remountVendorReadOnly () Rendez la partition du fournisseur sur le périphérique en lecture seule. |
abstract void | remountVendorWritable () Rendre la partition du fournisseur sur le périphérique accessible en écriture. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Méthode pratique pour exécuter |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Exécute des tests d’instrumentation et assure la récupération des appareils. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Identique à |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Identique à |
abstract void | setDate (Date date) Définit la date sur l'appareil Remarque : le réglage de la date sur l'appareil nécessite root |
abstract void | setOptions ( TestDeviceOptions options) Définir les |
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 |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Définissez le mode de récupération actuel à utiliser pour l'appareil. |
abstract void | setUseFastbootErase (boolean useFastbootErase) Définissez s’il faut utiliser l’effacement fastboot ou le format fastboot pour effacer une partition sur l’appareil. |
abstract void | startLogcat () Commencez à capturer la sortie logcat du périphérique en arrière-plan. |
abstract void | stopEmulatorOutput () Fermez et supprimez la sortie de l'émulateur. |
abstract void | stopLogcat () Arrêtez de capturer la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées. |
abstract String | switchToAdbTcp () Basculez l'appareil en mode adb-over-tcp. |
abstract boolean | switchToAdbUsb () Basculez l'appareil en mode AdB via USB. |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) Synchronise de manière incrémentale le contenu d'un répertoire de fichiers local sur l'appareil. |
abstract boolean | unlockDevice () Déverrouille l'appareil si l'appareil est dans un état crypté. |
abstract void | unmountDebugfs () Démontez les débogages. |
abstract boolean | waitForBootComplete (long timeOut) Bloque jusqu'à ce que l'indicateur de démarrage terminé du périphérique soit défini. |
abstract boolean | waitForDeviceAvailable () Attend que l'appareil soit réactif et disponible pour les tests. |
abstract boolean | waitForDeviceAvailable (long waitTime) Attend que l'appareil soit réactif et disponible pour les tests. |
abstract boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération. |
abstract void | waitForDeviceBootloader () Bloque jusqu'à ce que le périphérique soit visible via fastboot. |
abstract boolean | waitForDeviceInRecovery (long waitTime) Bloque pour que l'appareil soit dans l'état « adb recovery » (notez que cela est distinct de |
abstract boolean | waitForDeviceInSideload (long waitTime) Bloque pour que l'appareil soit dans l'état « adb sideload » |
abstract boolean | waitForDeviceNotAvailable (long waitTime) Blocs pour que l'appareil ne soit pas disponible, c'est-à-dire manquant dans adb |
abstract void | waitForDeviceOnline () Bloque jusqu'à ce que l'appareil soit visible via adb. |
abstract void | waitForDeviceOnline (long waitTime) Bloque jusqu'à ce que l'appareil soit visible via adb. |
abstract boolean | waitForDeviceShell (long waitTime) Attend que l'appareil réponde à une commande de base du shell adb. |
Constantes
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Valeur par défaut lorsque le niveau API ne peut pas être détecté
Valeur constante : -1 (0xffffffff)
Méthodes publiques
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Vérifiez si une fonctionnalité est actuellement prise en charge ou non, compte tenu d'un niveau minimal pris en charge. Cette méthode prend en compte les fonctionnalités inédites, avant que le niveau de l'API ne soit augmenté.
Paramètres | |
---|---|
strictMinLevel | int : Le niveau minimum strict possible qui prend en charge la fonctionnalité. |
Retour | |
---|---|
boolean | Vrai si le niveau est pris en charge. Faux sinon. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
effacerLogcat
public abstract void clearLogcat ()
Supprime toutes les données logcat accumulées.
Ceci est utile dans les cas où vous souhaitez vous assurer queITestDevice#getLogcat()
renvoie uniquement les données de journal produites après un certain point (par exemple après le flashage d'une nouvelle version de périphérique, etc.). supprimer le fichier
public abstract void deleteFile (String deviceFilePath)
Méthode d'assistance pour supprimer un fichier ou un répertoire sur l'appareil.
Paramètres | |
---|---|
deviceFilePath | String : Le chemin absolu du fichier sur l’appareil. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
périphériqueSoftRedémarré
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur en comparant le serveur système actuel avec le serveur système précédent ProcessInfo
. Utilisez getProcessByName(String)
pour obtenir ProcessInfo
.
Paramètres | |
---|---|
prevSystemServerProcess | ProcessInfo : le processus system_server précédent ProcessInfo . |
Retour | |
---|---|
boolean | true si l'appareil a redémarré en douceur |
Jetés | |
---|---|
RuntimeException | si le périphérique a une raison de démarrage anormale |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
périphériqueSoftRestartedDepuis
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Méthode d'assistance pour vérifier si l'appareil a redémarré en douceur depuis l'heure UTC depuis l'époque de l'appareil et son ERROR(/TimeUnit)
. Le redémarrage logiciel fait référence au serveur_système redémarré en dehors d'un redémarrage dur de l'appareil (par exemple : redémarrage demandé). Le périphérique actuel utcEpochTime en Milliseccond peut être obtenu par la méthode getDeviceDate()
.
Paramètres | |
---|---|
utcEpochTime | long : le temps de l'appareil en secondes depuis l'époque. |
timeUnit | TimeUnit : l'unité de temps TimeUnit pour le utcEpochTime donné. |
Retour | |
---|---|
boolean | true si l'appareil a redémarré en douceur |
Jetés | |
---|---|
RuntimeException | si le périphérique a une raison de démarrage anormale |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
désactiverAdbRoot
public abstract boolean disableAdbRoot ()
Désactive la racine adb.
La désactivation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode se bloquera jusqu'à ce que l'appareil soit disponible.Retour | |
---|---|
boolean | true en cas de succès. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Est-ce queFichierExiste
public abstract boolean doesFileExist (String deviceFilePath)
Méthode d'assistance pour déterminer si le fichier sur l'appareil existe.
Paramètres | |
---|---|
deviceFilePath | String : le chemin absolu du fichier sur l'appareil à vérifier |
Retour | |
---|---|
boolean | true si le fichier existe, false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
activerAdbRoot
public abstract boolean enableAdbRoot ()
Active la racine AdB. Si le paramètre "enable-root" est "false", un message sera enregistré et renvoyé sans activer root.
L'activation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode se bloquera jusqu'à ce que l'appareil soit disponible.Retour | |
---|---|
boolean | true en cas de succès. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
executeShellCommand(String)
doit être utilisé à la place dans la mesure du possible, car cette méthode offre une meilleure détection des pannes et de meilleures performances.
Paramètres | |
---|---|
timeout | long : le temps en millisecondes avant que l'appareil soit considéré comme ne répondant pas, 0L pour aucun délai d'attente |
commandArgs | String : la commande adb et les arguments à exécuter |
Retour | |
---|---|
String | la sortie standard de la commande. null si la commande n’a pas pu s’exécuter. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Méthode d'assistance qui exécute une commande adb en tant que commande système.
executeShellCommand(String)
doit être utilisé à la place dans la mesure du possible, car cette méthode offre une meilleure détection des pannes et de meilleures performances.Paramètres | |
---|---|
commandArgs | String : la commande adb et les arguments à exécuter |
Retour | |
---|---|
String | la sortie standard de la commande. null si la commande n’a pas pu s’exécuter. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'attente spécifié.
executeShellCommand(String)
doit être utilisé à la place dans la mesure du possible, car cette méthode offre une meilleure détection des pannes et de meilleures performances.
Paramètres | |
---|---|
timeout | long : le temps en millisecondes avant que l'appareil soit considéré comme ne répondant pas, 0L pour aucun délai d'attente |
envMap | |
commandArgs | String : la commande adb et les arguments à exécuter |
Retour | |
---|---|
String | la sortie standard de la commande. null si la commande n’a pas pu s’exécuter. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterFastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Méthode d'assistance qui exécute une commande fastboot en tant que commande système.
Devrait être utilisé lorsque l'appareil est déjà en mode fastboot.Paramètres | |
---|---|
timeout | long : le temps en millisecondes avant l'expiration de la commande |
commandArgs | String : la commande fastboot et les arguments à exécuter |
Retour | |
---|---|
CommandResult | le CommandResult contenant la sortie de la commande |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterFastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Méthode d'assistance qui exécute une commande fastboot en tant que commande système avec un délai d'expiration par défaut de 2 minutes.
Devrait être utilisé lorsque l'appareil est déjà en mode fastboot.
Paramètres | |
---|---|
commandArgs | String : la commande fastboot et les arguments à exécuter |
Retour | |
---|---|
CommandResult | le CommandResult contenant la sortie de la commande |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système.
IdentiqueexecuteFastbootCommand(String)
sauf qu'il utilise un délai d'attente plus long.Paramètres | |
---|---|
commandArgs | String : la commande fastboot et les arguments à exécuter |
Retour | |
---|---|
CommandResult | le CommandResult contenant la sortie de la commande |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système avec des variables d'environnement système.
Identique executeFastbootCommand(String)
sauf qu'il utilise un délai d'attente plus long.
Paramètres | |
---|---|
envVarMap | |
commandArgs | String : la commande fastboot et les arguments à exécuter |
Retour | |
---|---|
CommandResult | le CommandResult contenant la sortie de la commande |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterShellCommand
public abstract String executeShellCommand (String command)
Méthode d'assistance qui exécute une commande shell adb et renvoie la sortie sous forme de String
.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
Retour | |
---|---|
String | la sortie du shell |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
receiver | IShellOutputReceiver : le IShellOutputReceiver vers lequel diriger la sortie du shell. |
maxTimeToOutputShellResponse | long : la durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse ; unité comme spécifié dans timeUnit |
timeUnit | TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts | int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Voir également:
exécuterShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
receiver | IShellOutputReceiver : le IShellOutputReceiver vers lequel diriger la sortie du shell. |
maxTimeoutForCommand | long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit |
maxTimeToOutputShellResponse | long : la durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse ; unité comme spécifié dans timeUnit |
timeUnit | TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts | int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Voir également:
exécuterShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
Exécute la commande adb shell donnée, en réessayant plusieurs fois si la commande échoue.
Une forme plus simple d'executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
avec des valeurs par défaut.Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
receiver | IShellOutputReceiver : le IShellOutputReceiver vers lequel diriger la sortie du shell. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command)
Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous forme de CommandResult
correctement renseigné avec la sortie d'état de la commande, stdout et stderr.
Paramètres | |
---|---|
command | String : La commande qui doit être exécutée. |
Retour | |
---|---|
CommandResult | Le résultat dans CommandResult . |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un CommandResult
correctement renseigné avec la sortie d'état de la commande et stderr. stdout est dirigé vers le flux spécifié.
Paramètres | |
---|---|
command | String : La commande qui doit être exécutée. |
pipeToOutput | OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou null. |
Retour | |
---|---|
CommandResult | Le résultat dans CommandResult . |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous forme de CommandResult
correctement renseigné avec la sortie d'état de la commande, stdout et stderr.
Paramètres | |
---|---|
command | String : La commande qui doit être exécutée. |
pipeAsInput | File : Une ERROR(/File) qui sera redirigée comme entrée de la commande, ou null. |
Retour | |
---|---|
CommandResult | Le résultat dans CommandResult . |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
maxTimeoutForCommand | long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit |
timeUnit | TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts | int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès. |
Retour | |
---|---|
CommandResult |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Voir également:
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
maxTimeoutForCommand | long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit |
timeUnit | TimeUnit : unité pour maxTimeToOutputShellResponse |
Retour | |
---|---|
CommandResult |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Voir également:
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
pipeAsInput | File : Une ERROR(/File) qui sera redirigée comme entrée de la commande, ou null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou null. |
maxTimeoutForCommand | long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit |
timeUnit | TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts | int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès. |
Retour | |
---|---|
CommandResult |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Voir également:
exécuterShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec plus de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command | String : la commande shell adb à exécuter |
pipeAsInput | File : Une ERROR(/File) qui sera redirigée comme entrée de la commande, ou null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou null. |
pipeToError | OutputStream : ERROR(/OutputStream) où l'erreur std sera redirigée, ou null. |
maxTimeoutForCommand | long : le délai d'attente maximum pour que la commande se termine ; unité comme spécifié dans timeUnit |
timeUnit | TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts | int : le nombre maximum de fois où réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsiveException sera levée si retryAttempts sont effectuées sans succès. |
Retour | |
---|---|
CommandResult |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
Voir également:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Méthode d'assistance qui efface une partition du périphérique.
SigetUseFastbootErase()
est true
, alors l'effacement fastboot sera utilisé pour effacer la partition. L'appareil doit ensuite créer un système de fichiers au prochain démarrage de l'appareil. Sinon, le format fastboot est utilisé, ce qui créera un nouveau système de fichiers sur l'appareil. Devrait être utilisé lorsque l'appareil est déjà en mode fastboot.Paramètres | |
---|---|
partition | String : la partition à effacer |
Retour | |
---|---|
CommandResult | le CommandResult contenant la sortie de la commande |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
getApiLevel
public abstract int getApiLevel ()
Obtenez le niveau API de l'appareil. La valeur par défaut est UNKNOWN_API_LEVEL
.
Retour | |
---|---|
int | un entier indiquant le niveau API de l'appareil |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Méthode pratique pour obtenir la version bande de base (radio) de cet appareil. L'obtention de la version radio est spécifique à l'appareil, elle peut donc ne pas renvoyer les informations correctes pour tous les appareils. Cette méthode s'appuie sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes. Ceci n'est pas exact pour certains appareils CDMA et la version renvoyée ici peut ne pas correspondre à la version signalée par fastboot et peut ne pas renvoyer la version de la radio CDMA. TL;DR, cette méthode ne signale une version précise que si la propriété gsm.version.baseband est la même que la version renvoyée par fastboot getvar version-baseband
.
Retour | |
---|---|
String | la version de la bande de base String ou null si elle ne peut pas être déterminée (l'appareil n'a pas de radio ou la chaîne de version ne peut pas être lue) |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
obtenirBatterie
public abstract Integer getBattery ()
Renvoie le niveau actuel de la batterie d'un appareil ou Null si le niveau de la batterie n'est pas disponible.
Retour | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
Renvoie la valeur booléenne de la propriété donnée.
Paramètres | |
---|---|
name | String : le nom de la propriété |
defaultValue | boolean : valeur par défaut à renvoyer si la propriété est vide ou n'existe pas. |
Retour | |
---|---|
boolean | true si la propriété a la valeur "1" , "y" , "yes" , "on" ou "true" , false si la propriété a la valeur de "0" , "n" , "no" , "off" , "false" , ou defaultValue sinon. |
Jetés | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage.
Retour | |
---|---|
Carte du temps de démarrage (heure UTC en seconde depuis Epoch) et raison du démarrage |
Jetés | |
---|---|
DeviceNotAvailableException |
getBootHistoryDepuis
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
La méthode d'assistance collecte la carte de l'historique de démarrage avec l'heure de démarrage et la raison du démarrage depuis l'heure indiquée depuis l'époque du périphérique et l'unité de temps spécifiée. Le périphérique actuel utcEpochTime en milliseconde peut être obtenu par la méthode getDeviceDate()
.
Paramètres | |
---|---|
utcEpochTime | long : le temps de l'appareil depuis Epoch. |
timeUnit | TimeUnit : l'unité de temps TimeUnit . |
Retour | |
---|---|
Carte du temps de démarrage (heure UTC en seconde depuis Epoch) et raison du démarrage |
Jetés | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Méthode pratique pour obtenir la version du chargeur de démarrage de cet appareil.
Tentera de récupérer la version du chargeur de démarrage à partir de l'état actuel de l'appareil. (c'est-à-dire que si l'appareil est en mode fastboot, il tentera de récupérer la version à partir de fastboot)Retour | |
---|---|
String | la version du chargeur de démarrage String ou null si elle est introuvable |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
getBuildAlias
public abstract String getBuildAlias ()
Récupérez l’alias de la build que l’appareil exécute actuellement.
L'alias de build est généralement une chaîne plus lisible que l'identifiant de build (généralement un nombre pour les builds Nexus). Par exemple, la version finale d'Android 4.2 porte l'alias de build JDQ39 et l'ID de build 573038.
Retour | |
---|---|
String | l'alias de build ou revenez à l'identifiant de build s'il n'a pas pu être récupéré |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Récupérez la version de build pour l’appareil.
Retour | |
---|---|
String | la version de construction ou null si elle n'a pas pu être récupérée |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Récupérez la version que l’appareil exécute actuellement.
Retour | |
---|---|
String | l'identifiant de build ou IBuildInfo#UNKNOWN_BUILD_ID s'il n'a pas pu être récupéré |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Renvoie le type de clé utilisé pour signer l'image de l'appareil
Généralement, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de libération (contrôlées par les fabricants d'appareils individuels)
Retour | |
---|---|
String | La clé de signature si elle est trouvée, nulle sinon. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Renvoie un DeviceDescriptor
mis en cache si le périphérique est alloué, sinon renvoie le DeviceDescriptor
actuel.
Retour | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Renvoie un DeviceDescriptor
mis en cache si le périphérique est alloué, sinon renvoie le DeviceDescriptor
actuel.
Paramètres | |
---|---|
shortDescriptor | boolean : s'il faut ou non limiter le descripteur au strict minimum d'informations |
Retour | |
---|---|
DeviceDescriptor |
obtenir des enfants
public abstract String[] getChildren (String deviceFilePath)
Alternative à l'utilisation IFileEntry
qui ne fonctionne parfois pas en raison des autorisations.
Paramètres | |
---|---|
deviceFilePath | String : est le chemin sur l'appareil où effectuer la recherche |
Retour | |
---|---|
String[] | Tableau de chaîne contenant tous les fichiers dans un chemin sur le périphérique. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
obtenirConnexion
public abstract AbstractConnection getConnection ()
Renvoie la connexion associée à l'appareil.
Retour | |
---|---|
AbstractConnection |
obtenirDeviceClass
public abstract String getDeviceClass ()
Obtenez la classe de périphérique.
Retour | |
---|---|
String | la classe de périphérique String . |
getDeviceDate
public abstract long getDeviceDate ()
Renvoie la date de l'appareil en millisecondes depuis l'époque.
Retour | |
---|---|
long | la date de l'appareil au format époque. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Renvoyez un DeviceDescriptor
à partir des informations sur le périphérique pour obtenir des informations sur celui-ci sans transmettre l'objet périphérique réel.
Retour | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Renvoyez un DeviceDescriptor
à partir des informations sur le périphérique pour obtenir des informations sur celui-ci sans transmettre l'objet périphérique réel.
Paramètres | |
---|---|
shortDescriptor | boolean : s'il faut ou non limiter le descripteur au strict minimum d'informations |
Retour | |
---|---|
DeviceDescriptor |
obtenirDeviceState
public abstract TestDeviceState getDeviceState ()
Obtenez l'état de l'appareil.
Retour | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Aide pour obtenir le décalage horaire entre l'appareil et une ERROR(/Date)
donnée. Utilisez l’heure Epoch en interne.
Paramètres | |
---|---|
date | Date |
Retour | |
---|---|
long | la différence en millisecondes |
Jetés | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Obtenez le flux de l'émulateur stdout et stderr
Retour | |
---|---|
InputStreamSource | sortie de l'émulateur |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Méthode d'assistance pour déterminer la quantité d'espace libre sur le stockage externe de l'appareil.
Retour | |
---|---|
long | la quantité d'espace libre en Ko |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
getFastbootProductType
public abstract String getFastbootProductType ()
Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode de démarrage rapide.
Cette méthode ne doit être utilisée que si le périphérique doit être en mode fastboot. C'est une variante un peu plus sûre que la méthode génériquegetProductType()
dans ce cas, car ITestDevice saura récupérer le périphérique en fastboot si le périphérique est dans un état incorrect ou ne répond pas.Retour | |
---|---|
String | le nom du type de produit String ou null s'il ne peut pas être déterminé |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Méthode pratique pour obtenir le type de produit de cet appareil lorsqu'il est en mode de démarrage rapide.
Cette méthode ne doit être utilisée que si le périphérique doit être en mode fastboot. C'est une variante un peu plus sûre que la méthode génériquegetProductType()
dans ce cas, car ITestDevice saura récupérer le périphérique en fastboot si le périphérique est dans un état incorrect ou ne répond pas.Retour | |
---|---|
String | le nom du type de produit String ou null s'il ne peut pas être déterminé |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
Renvoie le numéro de série du mode fastboot.
Retour | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Récupérez la valeur de la variable fastboot donnée sur le périphérique.
Paramètres | |
---|---|
variableName | String : le nom de la variable |
Retour | |
---|---|
String | la valeur de la propriété ou null si elle n'existe pas |
Jetés | |
---|---|
| Exception d'opération non prise en charge |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Récupérer une référence à un fichier distant sur l'appareil.
Paramètres | |
---|---|
path | String : le chemin du fichier à récupérer. Peut être un chemin absolu ou un chemin relatif à « / ». (c'est-à-dire que les syntaxes "/system" et "system" sont prises en charge) |
Retour | |
---|---|
IFileEntry | IFileEntry ou null si le fichier au path donné est introuvable |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
obtenirIDevice
public abstract IDevice getIDevice ()
Renvoie une référence au ddmlib IDevice
associé.
IDevice
peut être alloué par DDMS à chaque fois que l'appareil se déconnecte et se reconnecte d'adb. Ainsi, les appelants ne doivent pas conserver de référence à IDevice
, car cette référence peut devenir obsolète.Retour | |
---|---|
IDevice | l' IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
Renvoie la valeur entière de la propriété donnée à partir du périphérique.
Paramètres | |
---|---|
name | String : le nom de la propriété |
defaultValue | long : valeur par défaut à renvoyer si la propriété est vide ou n'existe pas. |
Retour | |
---|---|
long | la valeur de la propriété ou defaultValue si la propriété est vide, n'existe pas ou n'a pas de valeur entière. |
Jetés | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Renvoie la dernière fois que les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH, tel que renvoyé par System.currentTimeMillis()
.
Retour | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Obtenez le premier niveau API lancé sur l'appareil. La valeur par défaut est UNKNOWN_API_LEVEL
.
Retour | |
---|---|
int | un nombre entier indiquant le premier niveau d'API lancé de l'appareil |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Récupère un flux instantané des données logcat.
Fonctionne en deux modes :
TestDeviceOptions.getMaxLogcatDataSize()
octets du contenu actuel de la capture logcat en arrière-planRetour | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Récupère un flux instantané des derniers maxBytes
de données logcat capturées.
Utile dans les cas où vous souhaitez capturer des instantanés fréquents des données logcat capturées sans encourir la pénalité d'espace disque potentiellement importante liée à l'obtention de l'intégralité de l'instantané getLogcat()
.
Paramètres | |
---|---|
maxBytes | int : la quantité maximale de données à renvoyer. Doit être un montant qui peut facilement tenir dans la mémoire |
Retour | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Obtenez un vidage du logcat actuel pour le périphérique. Contrairement à getLogcat()
, cette méthode renverra toujours un vidage statique du logcat.
Présente l'inconvénient que rien ne sera renvoyé si l'appareil n'est pas accessible.
Retour | |
---|---|
InputStreamSource | un InputStreamSource des données logcat. Un flux vide est renvoyé en cas d'échec de la capture des données logcat. |
getLogcatDepuis
public abstract InputStreamSource getLogcatSince (long date)
Récupère un flux instantané de données logcat capturées à partir de la date fournie. L'heure sur l'appareil doit être utilisée getDeviceDate()
.
Paramètres | |
---|---|
date | long : en millisecondes depuis le format d'époque indiquant quand démarrer l'instantané jusqu'à présent. (peut être obtenu en utilisant 'date +%s') |
Retour | |
---|---|
InputStreamSource |
obtenirMountPoint
public abstract String getMountPoint (String mountName)
Renvoie un point de montage.
Interroge directement l'appareil si les informations mises en cache dansIDevice
ne sont pas disponibles. À FAIRE : déplacer ce comportement vers IDevice#getMountPoint(String)
Paramètres | |
---|---|
mountName | String : le nom du point de montage |
Retour | |
---|---|
String | le point de montage ou null |
Voir également:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Renvoie un MountPointInfo
correspondant au chemin du point de montage spécifié, ou null
si ce chemin n'a rien de monté ou n'apparaît pas dans /proc/mounts en tant que point de montage.
Paramètres | |
---|---|
mountpoint | String |
Retour | |
---|---|
ITestDevice.MountPointInfo | Une ERROR(/List) de MountPointInfo contenant les informations dans "/proc/mounts" |
Jetés | |
---|---|
DeviceNotAvailableException |
Voir également:
getMountPointInfo
public abstractgetMountPointInfo ()
Renvoie une version analysée des informations dans /proc/mounts sur le périphérique
Retour | |
---|---|
Une ERROR(/List) de MountPointInfo contenant les informations dans "/proc/mounts" |
Jetés | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Méthode d'assistance pour déterminer la quantité d'espace libre sur la partition du périphérique.
Paramètres | |
---|---|
partition | String |
Retour | |
---|---|
long | la quantité d'espace libre en Ko |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
La méthode d'assistance exécute les commandes "pidof" et "stat" et renvoie l'objet ProcessInfo
avec le PID et l'heure de début du processus donné.
Paramètres | |
---|---|
processName | String : le nom du processus String. |
Retour | |
---|---|
ProcessInfo | ProcessInfo du processName donné |
Jetés | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Renvoie le pid du service ou null en cas de problème.
Paramètres | |
---|---|
process | String : Le nom du processus String. |
Retour | |
---|---|
String |
Jetés | |
---|---|
DeviceNotAvailableException |
obtenirType de produit
public abstract String getProductType ()
Méthode pratique pour obtenir le type de produit de cet appareil.
Cette méthode fonctionnera si l'appareil est en mode adb ou fastboot.Retour | |
---|---|
String | le nom du type de produit String . Ne sera pas nul |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée, ou si le type de produit ne peut pas être déterminé |
getProductVariant
public abstract String getProductVariant ()
Méthode pratique pour obtenir la variante de produit de cet appareil.
Cette méthode fonctionnera si l'appareil est en mode adb ou fastboot.Retour | |
---|---|
String | le nom de la variante du produit String ou null s'il ne peut pas être déterminé |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
obtenirPropriété
public abstract String getProperty (String name)
Récupérez la valeur de propriété donnée à partir de l’appareil.
Paramètres | |
---|---|
name | String : le nom de la propriété |
Retour | |
---|---|
String | la valeur de la propriété ou null si elle n'existe pas |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Obtenez le mode de récupération actuel utilisé pour l'appareil.
Retour | |
---|---|
ITestDevice.RecoveryMode | le mode de récupération actuel utilisé pour l'appareil. |
obtenir le numéro de série
public abstract String getSerialNumber ()
Méthode pratique pour obtenir le numéro de série de cet appareil.
Retour | |
---|---|
String | le numéro de série String |
obtenir des pierres tombales
public abstractgetTombstones ()
Récupère et renvoie la liste des pierres tombales des appareils. Nécessite racine.
La méthode est la meilleure possible, donc si une pierre tombale ne parvient pas à être extraite pour une raison quelconque, elle sera absente de la liste. Seule une DeviceNotAvailableException
mettra fin à la méthode plus tôt.
Retour | |
---|---|
Une liste de fichiers tombstone, vide s'il n'y en a pas. |
Jetés | |
---|---|
DeviceNotAvailableException |
Voir également:
getTotalMemory
public abstract long getTotalMemory ()
Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne
Retour | |
---|---|
long |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Déterminez si vous devez utiliser l'effacement fastboot ou le format fastboot pour effacer une partition sur l'appareil.
Retour | |
---|---|
boolean | true si l'effacement fastboot sera utilisé ou false si le format fastboot sera utilisé. |
Voir également:
estAdbRoot
public abstract boolean isAdbRoot ()
Retour | |
---|---|
boolean | true si l'appareil a actuellement une racine adb, false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
isAdbTcp
public abstract boolean isAdbTcp ()
Retour | |
---|---|
boolean | true si l'appareil est connecté à adb-over-tcp, false sinon. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications
Retour | |
---|---|
boolean | Vrai si l'énumération des applications est prise en charge, faux sinon |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Vérifiez si la plate-forme sur l'appareil prend en charge le contournement du bloc SDK à faible cible lors des installations d'applications.
Retour | |
---|---|
boolean | Vrai si le bloc SDK contourner la cible basse est pris en charge, faux sinon |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
Vérifiez si debugfs est monté.
Retour | |
---|---|
boolean | true si debugfs est monté |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Renvoie si l'appareil est chiffré.
Retour | |
---|---|
boolean | true si l'appareil est chiffré. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
estRépertoire
public abstract boolean isDirectory (String deviceFilePath)
Renvoie True si le chemin sur le périphérique est un répertoire, false sinon.
Paramètres | |
---|---|
deviceFilePath | String |
Retour | |
---|---|
boolean |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Renvoie si le chiffrement est pris en charge sur l'appareil.
Retour | |
---|---|
boolean | true si l'appareil prend en charge le cryptage. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
estExécutable
public abstract boolean isExecutable (String fullPath)
Renvoie True si le chemin du fichier sur le périphérique est un fichier exécutable, false sinon.
Paramètres | |
---|---|
fullPath | String |
Retour | |
---|---|
boolean |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
est sans tête
public abstract boolean isHeadless ()
Renvoie true si l'appareil est sans tête (pas d'écran), false sinon.
Retour | |
---|---|
boolean |
Jetés | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Vérifiez si la plate-forme sur l'appareil prend en charge l'octroi d'autorisations d'exécution
Retour | |
---|---|
boolean | True si les autorisations d'exécution sont prises en charge, false sinon. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Renvoie vrai si l'appareil est dans TestDeviceState#FASTBOOT
ou TestDeviceState.FASTBOOTD
.
Retour | |
---|---|
boolean |
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Collecte et enregistre les ANR de l'appareil.
Paramètres | |
---|---|
logger | ITestLogger : un ITestLogger pour journaliser les ANR. |
Retour | |
---|---|
boolean | Vrai si la journalisation a réussi, faux dans le cas contraire. |
Jetés | |
---|---|
DeviceNotAvailableException |
connexion sur périphérique
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Enregistrez un message dans le logcat de l'appareil. Il s'agit d'un appel sécurisé qui ne sera pas lancé même si la journalisation échoue.
Paramètres | |
---|---|
tag | String : La balise sous laquelle nous enregistrons notre message dans le logcat. |
level | Log.LogLevel : Le niveau de débogage du message dans le logcat. |
format | String : Le format du message. |
args | Object : les arguments à remplacer via String.format(). |
mountDebugfs
public abstract void mountDebugfs ()
Montez les débogages.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Émet une commande pour redémarrer l'appareil et revient une fois la commande terminée et lorsque l'appareil n'est plus visible pour adb.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Exécutez les instructions pour configurer le périphérique afin de le tester après chaque démarrage.
Doit être appelé une fois que l'appareil est entièrement démarré/disponible Dans des circonstances normales, cette méthode n'a pas besoin d'être appelée explicitement, car les implémentations doivent effectuer ces étapes automatiquement lors d'un redémarrage. Il peut être nécessaire de l'appeler lorsque l'appareil redémarre en raison d'autres événements (par exemple, lorsqu'une commande de mise à jour fastboot est terminée)Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
postInvocationTearDown
public void postInvocationTearDown ()
Cette méthode est obsolète.
Utilisez plutôt postInvocationTearDown(Throwable)
.
Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté une fois l'appel terminé.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté une fois l'appel terminé.
Paramètres | |
---|---|
invocationException | Throwable : le cas échéant, l'exception finale déclenchée par l'échec de l'invocation. |
préInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Étapes supplémentaires pour la configuration requise spécifique à l’appareil qui sera exécutée sur l’appareil avant le flux d’appel.
Paramètres | |
---|---|
info | IBuildInfo : l' IBuildInfo de l'appareil. |
attributes | MultiMap : Les attributs stockés dans le contexte d'invocation |
Jetés | |
---|---|
| com.android.tradefed.targetprep.TargetSetupError |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Extrayez de manière récursive le contenu du répertoire du périphérique.
Paramètres | |
---|---|
deviceFilePath | String : le chemin de fichier absolu de la source distante |
localDir | File : le répertoire local dans lequel extraire les fichiers |
Retour | |
---|---|
boolean | true si le fichier a été extrait avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pullFichier
public abstract File pullFile (String remoteFilePath, int userId)
Récupère un fichier hors de l'appareil, le stocke dans un ERROR(/File)
temporaire local et renvoie ce File
.
Paramètres | |
---|---|
remoteFilePath | String : le chemin absolu du fichier sur l'appareil. |
userId | int : l'identifiant de l'utilisateur à partir duquel extraire |
Retour | |
---|---|
File | Une ERROR(/File) contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pullFichier
public abstract File pullFile (String remoteFilePath)
Récupère un fichier hors de l'appareil, le stocke dans un ERROR(/File)
temporaire local et renvoie ce File
.
Paramètres | |
---|---|
remoteFilePath | String : le chemin absolu du fichier sur l'appareil. |
Retour | |
---|---|
File | Une ERROR(/File) contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pullFichier
public abstract boolean pullFile (String remoteFilePath, File localFile)
Récupère un fichier hors du périphérique.
Paramètres | |
---|---|
remoteFilePath | String : le chemin absolu du fichier sur l'appareil. |
localFile | File : le fichier local dans lequel stocker le contenu. S'il n'est pas vide, le contenu sera remplacé. |
Retour | |
---|---|
boolean | true si le fichier a été récupéré avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pullFichier
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Récupère un fichier hors du périphérique.
Paramètres | |
---|---|
remoteFilePath | String : le chemin absolu du fichier sur l'appareil. |
localFile | File : le fichier local dans lequel stocker le contenu. S'il n'est pas vide, le contenu sera remplacé. |
userId | int : l'identifiant de l'utilisateur à partir duquel extraire |
Retour | |
---|---|
boolean | true si le fichier a été récupéré avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Récupère un fichier hors de l'appareil et renvoie le contenu.
Paramètres | |
---|---|
remoteFilePath | String : le chemin absolu du fichier sur l'appareil. |
Retour | |
---|---|
String | Une String contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Jetés | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
Une méthode pratique pour récupérer un fichier du stockage externe de l'appareil, le stocker dans un ERROR(/File)
temporaire local et renvoyer une référence à ce File
.
Paramètres | |
---|---|
remoteFilePath | String : le chemin d'accès au fichier sur l'appareil, par rapport au point de montage de stockage externe de l'appareil |
Retour | |
---|---|
File | Une ERROR(/File) contenant le contenu du fichier de périphérique, ou null si la copie a échoué pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Poussez de manière récursive le contenu du répertoire vers l'appareil tout en excluant certains répertoires filtrés.
Paramètres | |
---|---|
localDir | File : le répertoire local à pousser |
deviceFilePath | String : le chemin absolu du fichier de la destination distante |
excludedDirectories |
Retour | |
---|---|
boolean | true si le fichier a été poussé avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Poussez de manière récursive le contenu du répertoire vers l’appareil.
Paramètres | |
---|---|
localDir | File : le répertoire local à pousser |
deviceFilePath | String : le chemin absolu du fichier de la destination distante |
Retour | |
---|---|
boolean | true si le fichier a été poussé avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
fichier push
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variante de pushFile(File, String)
qui peut éventuellement envisager d'évaluer le besoin du fournisseur de contenu.
Paramètres | |
---|---|
localFile | File : le fichier local à pousser |
deviceFilePath | String : le chemin absolu du fichier de destination distante |
evaluateContentProviderNeeded | boolean : faut-il vérifier si nous avons besoin du fournisseur de contenu |
Retour | |
---|---|
boolean | true si le fichier a été poussé avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
fichier push
public abstract boolean pushFile (File localFile, String deviceFilePath)
Transférez un fichier vers l'appareil. Par défaut, en utilisant un fournisseur de contenu.
Paramètres | |
---|---|
localFile | File : le fichier local à pousser |
deviceFilePath | String : le chemin absolu du fichier de destination distante |
Retour | |
---|---|
boolean | true si le fichier a été poussé avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
chaîne push
public abstract boolean pushString (String contents, String deviceFilePath)
Transférer le fichier créé à partir d'une chaîne vers l'appareil
Paramètres | |
---|---|
contents | String : le contenu du fichier à pousser |
deviceFilePath | String : le chemin absolu du fichier de destination distante |
Retour | |
---|---|
boolean | true si la chaîne a été poussée avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
redémarrer
public abstract void reboot ()
Redémarre l'appareil en mode adb.
Bloque jusqu'à ce que l'appareil soit disponible.Jetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
redémarrer
public abstract void reboot (String reason)
Redémarre l'appareil en mode adb avec une reason
donnée de persister lors du redémarrage.
Bloque jusqu'à ce que l'appareil soit disponible.
La raison du dernier redémarrage peut être obtenue en interrogeant la propriété sys.boot.reason
.
Paramètres | |
---|---|
reason | String : une raison pour ce redémarrage, ou null si aucune raison n'est précisée. |
Jetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
rebootIntoBootloader
public abstract void rebootIntoBootloader ()
Redémarre l'appareil en mode chargeur de démarrage.
Bloque jusqu'à ce que l'appareil soit en mode chargeur de démarrage.Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
rebootIntoFastbootd
public abstract void rebootIntoFastbootd ()
Redémarre l'appareil en mode fastbootd.
Bloque jusqu'à ce que l'appareil soit en mode fastbootd.
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
rebootIntoRecovery
public abstract void rebootIntoRecovery ()
Redémarre l'appareil en mode de récupération Adb.
Bloque jusqu'à ce que l'appareil entre en récupérationJetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
rebootIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Redémarre l'appareil en mode adb sideload (notez qu'il s'agit d'un mode spécial en cours de récupération)
Bloque jusqu'à ce que l'appareil passe en mode chargement latéral
Paramètres | |
---|---|
autoReboot | boolean : s'il faut redémarrer automatiquement l'appareil après le chargement latéral |
Jetés | |
---|---|
DeviceNotAvailableException | si l'appareil n'est pas en chargement latéral après le redémarrage |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Redémarre l'appareil en mode adb sideload (notez qu'il s'agit d'un mode spécial en cours de récupération)
Bloque jusqu'à ce que l'appareil passe en mode chargement latéral
Jetés | |
---|---|
DeviceNotAvailableException | si l'appareil n'est pas en chargement latéral après le redémarrage |
redémarrer jusqu'à la ligne
public abstract void rebootUntilOnline ()
Une alternative à reboot()
qui bloque uniquement jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
Jetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
redémarrer jusqu'à la ligne
public abstract void rebootUntilOnline (String reason)
Une alternative à reboot()
qui bloque uniquement jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
Paramètres | |
---|---|
reason | String : une raison pour ce redémarrage, ou null si aucune raison n'est précisée. |
Jetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
Voir également:
rebootEspace utilisateur
public abstract void rebootUserspace ()
Redémarre uniquement la partie espace utilisateur de l'appareil.
Bloque jusqu'à ce que l'appareil soit disponible.
AVERTISSEMENT. Le redémarrage de l'espace utilisateur est actuellement en développement actif, utilisez-le à vos propres risques.
Jetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
Une alternative à rebootUserspace()
()} qui bloque uniquement jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
Jetés | |
---|---|
DeviceNotAvailableException | si le périphérique n'est pas disponible après le redémarrage |
remonterSystemReadOnly
public abstract void remountSystemReadOnly ()
Rendez la partition système sur le périphérique en lecture seule. Peut redémarrer l'appareil.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remonter le système en écriture
public abstract void remountSystemWritable ()
Rendre la partition système du périphérique accessible en écriture. Peut redémarrer l'appareil.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remonterVendorReadOnly
public abstract void remountVendorReadOnly ()
Rendez la partition du fournisseur sur le périphérique en lecture seule. Peut redémarrer l'appareil.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remonterVendorWritable
public abstract void remountVendorWritable ()
Rendre la partition du fournisseur sur le périphérique accessible en écriture. Peut redémarrer l'appareil.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
exécuterInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Méthode pratique pour exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
avec un ou plusieurs écouteurs passés en paramètres.
Paramètres | |
---|---|
runner | IRemoteAndroidTestRunner : le IRemoteAndroidTestRunner qui exécute les tests |
listeners | ITestLifeCycleReceiver : le ou les auditeurs des résultats de test |
Retour | |
---|---|
boolean | true si la commande de test est terminée. false si l'opération n'a pas abouti, mais que la récupération a réussi |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. c'est-à-dire que la commande de test n'a pas pu se terminer et que la récupération a échoué. |
exécuterInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Exécute des tests d’instrumentation et assure la récupération des appareils.
Si la connexion avec l'appareil est perdue avant la fin du test et que la récupération réussit, tous les auditeurs seront informés de testRunFailed et « false » sera renvoyé. La commande de test ne sera pas réexécutée. Il appartient aux appelants de réessayer si nécessaire.
Si la connexion avec l'appareil est perdue avant la fin du test et que la récupération échoue, tous les écouteurs seront informés de testRunFailed et DeviceNotAvailableException sera levée.
Paramètres | |
---|---|
runner | IRemoteAndroidTestRunner : le IRemoteAndroidTestRunner qui exécute les tests |
listeners |
Retour | |
---|---|
boolean | true si la commande de test est terminée. false s'il n'a pas abouti en raison d'une exception de communication avec le périphérique, mais que la récupération a réussi |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. c'est-à-dire que la commande de test n'a pas pu se terminer et que la récupération a échoué. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Identique à ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
mais exécute le test pour l'utilisateur donné.
Paramètres | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Retour | |
---|---|
boolean |
Jetés | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Identique à ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
mais exécute le test pour un utilisateur donné.
Paramètres | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Retour | |
---|---|
boolean |
Jetés | |
---|---|
DeviceNotAvailableException |
régler la date
public abstract void setDate (Date date)
Définit la date sur l'appareil
Remarque : le réglage de la date sur l'appareil nécessite root
Paramètres | |
---|---|
date | Date : précisez une date particulière ; utilisera la date de l'hôte si null |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
définirOptions
public abstract void setOptions (TestDeviceOptions options)
Définir les TestDeviceOptions
pour l’appareil
Paramètres | |
---|---|
options | TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Définit la valeur de propriété donnée sur l'appareil. Nécessite que la racine adb soit vraie.
Paramètres | |
---|---|
propKey | String : La clé ciblée à définir. |
propValue | String : La valeur de la propriété à définir. |
Retour | |
---|---|
boolean | renvoie True si la commande setprop a réussi, False sinon. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Définissez IDeviceRecovery
à utiliser pour cet appareil. Doit être défini lors de la première allocation du périphérique.
Paramètres | |
---|---|
recovery | IDeviceRecovery : le IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Définissez le mode de récupération actuel à utiliser pour l'appareil.
Utilisé pour contrôler la méthode de récupération à utiliser lorsqu'un problème de communication avec l'appareil est rencontré. Il est recommandé de n'utiliser cette méthode qu'avec parcimonie en cas de besoin (par exemple, lorsque le framework est en panne, etc.Paramètres | |
---|---|
mode | ITestDevice.RecoveryMode : indique si le mode « récupération jusqu'en ligne uniquement » doit être activé ou non. |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Définissez s’il faut utiliser l’effacement fastboot ou le format fastboot pour effacer une partition sur l’appareil.
Paramètres | |
---|---|
useFastbootErase | boolean : true si l'effacement fastboot doit être utilisé ou false si le format fastboot doit être utilisé. |
Voir également:
démarrerLogcat
public abstract void startLogcat ()
Commencez à capturer la sortie logcat du périphérique en arrière-plan.
N'aura aucun effet si la sortie logcat est déjà capturée. Les données peuvent être récupérées ultérieurement via getLogcat. Lorsque l'appareil n'est plus utilisé,stopLogcat()
doit être appelé. startLogcat()
et stopLogcat()
n'ont normalement pas besoin d'être appelés dans un contexte d'invocation TF, car le framework TF démarrera et arrêtera logcat. stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Fermez et supprimez la sortie de l'émulateur.
arrêterLogcat
public abstract void stopLogcat ()
Arrêtez de capturer la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.
N'aura aucun effet si la sortie logcat n'est pas capturée.switchToAdbTcp
public abstract String switchToAdbTcp ()
Basculez l'appareil en mode adb-over-tcp.
Retour | |
---|---|
String | le numéro de série TCP ou null si l'appareil n'a pas pu être commuté |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Basculez l'appareil en mode AdB via USB.
Retour | |
---|---|
boolean | true si le changement a réussi, false sinon. |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
fichiers de synchronisation
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Synchronise de manière incrémentale le contenu d'un répertoire de fichiers local sur l'appareil.
Décide quels fichiers pousser en comparant les horodatages des fichiers locaux avec leurs équivalents distants. Seuls les fichiers « plus récents » ou inexistants seront transférés vers l'appareil. Ainsi, la surcharge devrait être relativement faible si le fichier défini sur l'appareil est déjà à jour. Les fichiers cachés (dont les noms commencent par ".") seront ignorés. Exemple d'utilisation : syncFiles("/tmp/files", "/sdcard") créera un répertoire /sdcard/files s'il n'existe pas déjà et poussera de manière récursive le contenu de /tmp/files vers /sdcard/files.Paramètres | |
---|---|
localFileDir | File : le répertoire de fichiers local contenant les fichiers à pousser de manière récursive. |
deviceFilePath | String : racine du chemin absolu du fichier de destination distante. Tous les répertoires de ce chemin de fichier doivent être lisibles. c'est-à-dire que pousser vers /data/local/tmp lorsque adb n'est pas root échouera |
Retour | |
---|---|
boolean | true si les fichiers ont été synchronisés avec succès. false sinon. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
déverrouiller l'appareil
public abstract boolean unlockDevice ()
Déverrouille l'appareil si l'appareil est dans un état crypté.
Cette méthode peut redémarrer le framework mais n'appellera paspostBootSetup()
. Par conséquent, l’appareil n’est peut-être pas entièrement prêt à être testé lorsque cette méthode revient.Retour | |
---|---|
boolean | true en cas de succès ou si l'appareil n'est pas chiffré. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
UnsupportedOperationException | si le cryptage n'est pas pris en charge sur l'appareil. |
démonterDebugfs
public abstract void unmountDebugfs ()
Démontez les débogages.
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
attendre le démarrage complet
public abstract boolean waitForBootComplete (long timeOut)
Bloque jusqu'à ce que l'indicateur de démarrage terminé du périphérique soit défini.
Paramètres | |
---|---|
timeOut | long : temps d'attente en msec pour que le drapeau soit défini |
Retour | |
---|---|
boolean | vrai si l'indicateur de démarrage terminé du périphérique est défini dans le délai d'attente |
Jetés | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
Attend que l'appareil soit réactif et disponible pour les tests. Utilise le délai d'expiration par défaut.
Retour | |
---|---|
boolean | True si le périphérique est disponible, False si la récupération est désactivée et indisponible. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable (long waitTime)
Attend que l'appareil soit réactif et disponible pour les tests.
Paramètres | |
---|---|
waitTime | long : le temps d'attente en ms |
Retour | |
---|---|
boolean | True si le périphérique est disponible, False si la récupération est désactivée et indisponible. |
Jetés | |
---|---|
DeviceNotAvailableException | si l'appareil ne répond toujours pas après l'expiration du délai d'attente. |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération.
Paramètres | |
---|---|
waitTime | long |
Retour | |
---|---|
boolean | Vrai si l'appareil est disponible, Faux s'il n'est pas disponible. |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
waitForDeviceBootloader
public abstract void waitForDeviceBootloader ()
Bloque jusqu'à ce que le périphérique soit visible via fastboot. Utilisez le délai d'expiration par défaut.
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Bloque pour que l'appareil soit dans l'état « adb recovery » (notez que cela est distinct de IDeviceRecovery
).
Paramètres | |
---|---|
waitTime | long : le temps d'attente en ms |
Retour | |
---|---|
boolean | true si le périphérique démarre en mode récupération avant l'expiration du délai. false sinon |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Bloque pour que l'appareil soit dans l'état « adb sideload »
Paramètres | |
---|---|
waitTime | long : le temps d'attente en ms |
Retour | |
---|---|
boolean | true si l’appareil démarre en chargement latéral avant l’expiration du délai. false sinon |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocs pour que l'appareil ne soit pas disponible, c'est-à-dire manquant dans adb
Paramètres | |
---|---|
waitTime | long : le temps d'attente en ms |
Retour | |
---|---|
boolean | true si l’appareil n’est plus disponible avant l’expiration du délai. false sinon |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Bloque jusqu'à ce que l'appareil soit visible via adb. Utilise le délai d'attente par défaut
Notez que l'appareil ne répond pas nécessairement aux commandes une fois terminées. Utilisez plutôtwaitForDeviceAvailable()
.Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Bloque jusqu'à ce que l'appareil soit visible via adb.
Notez que l'appareil ne répond pas nécessairement aux commandes une fois terminées. Utilisez plutôtwaitForDeviceAvailable()
.Paramètres | |
---|---|
waitTime | long : le temps d'attente en ms |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec l'appareil est perdue et ne peut pas être récupérée. |
attendreDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Attend que l'appareil réponde à une commande de base du shell adb.
Paramètres | |
---|---|
waitTime | long : le temps d'attente en ms |
Retour | |
---|---|
boolean | true si l’appareil devient réactif avant que waitTime ne s’écoule. |