Appareil natif

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

java.lang.Object
com.android.tradefed.device.NativeDevice


Implémentation par défaut d'un ITestDevice Appareils Android non full stack.

Résumé

Classes imbriquées

class NativeDevice.AdbAction

Une ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) pour l'exécution d'une commande 'adb ....' du système d'exploitation.

class NativeDevice.AdbShellAction

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) pour le redémarrage d'un appareil.

Constantes

int INVALID_USER_ID

Valeur renvoyée pour tout identifiant utilisateur invalide/introuvable : UserHandle a défini la valeur -10 000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

le nombre par défaut de nouvelles tentatives de commande à effectuer

Des champs

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Constructeurs publics

NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Crée un TestDevice .

Méthodes publiques

void batchPrefetchStartupBuildProps ()

Micro-optimisation (environ 400 millis) en prélevant tous les accessoires dont nous avons besoin plutôt que d'appeler « adb getprop » pour chacun.

boolean canSwitchToHeadlessSystemUser ()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans tête.

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.

boolean checkConnectivity ()

Vérifiez que l'appareil dispose d'une connectivité réseau.

boolean clearErrorDialogs ()

Essayez de fermer les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil.

void clearLastConnectedWifiNetwork ()

Efface le dernier réseau wifi connecté.

void clearLogcat ()

Supprime toutes les données logcat accumulées.

boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Se connecte à un réseau wifi.

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Se connecte à un réseau wifi.

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Se connecte à un réseau wifi.f

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Se connecte à un réseau wifi.

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

int createUser (String name, boolean guest, boolean ephemeral)

Créer un utilisateur avec un nom donné et les drapeaux fournis

int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)

Créer un utilisateur avec un nom donné et les drapeaux fournis

int createUser (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.

int createUserNoThrow (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.

void deleteFile (String deviceFilePath)

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

void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

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 .

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

boolean disableAdbRoot ()

Désactive la racine adb.

void disableKeyguard ()

Tente de désactiver le protège-clavier.

boolean disableNetworkMonitor ()

Désactive la surveillance du réseau sur l'appareil.

boolean disconnectFromWifi ()

Se déconnecte d'un réseau wifi.

boolean doesFileExist (String deviceFilePath, int userId)

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

boolean doesFileExist (String deviceFilePath)

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

File dumpHeap (String process, String devicePath)

Essayez de vider le tas du serveur_système.

boolean enableAdbRoot ()

Active la racine AdB.

boolean enableNetworkMonitor ()

Permet la surveillance du réseau sur l'appareil.

String executeAdbCommand (long timeout, String... cmdArgs)

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

String executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs)

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

String executeAdbCommand (String... cmdArgs)

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

CommandResult executeFastbootCommand (String... cmdArgs)

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.

CommandResult executeFastbootCommand (long timeout, String... cmdArgs)

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

CommandResult executeLongFastbootCommand (String... cmdArgs)

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

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs)

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.

String executeShellCommand (String command)

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

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.

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.

void executeShellCommand (String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command (String cmd)

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.

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

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

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

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

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

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

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

CommandResult fastbootWipePartition (String partition)

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

getActiveApexes ()

Récupérez les informations sur les APEX activés sur l’appareil.

getAllSettings (String namespace)

Renvoie les paires clé-valeur de l’espace de noms demandé.

DeviceAllocationState getAllocationState ()

Renvoie l'état d'allocation actuel de l'appareil

String getAndroidId (int userId)

Recherchez et renvoyez l'ID Android associé à un ID utilisateur, nul s'il n'est pas trouvé.

getAndroidIds ()

Créez une carte des identifiants Android trouvés correspondant aux identifiants utilisateur.

int getApiLevel ()

Obtenez le niveau API de l'appareil.

PackageInfo getAppPackageInfo (String packageName)

Récupérer des informations sur un package installé sur l'appareil.

getAppPackageInfos ()

Récupérer les informations des packages installés sur l'appareil.

String getBasebandVersion ()

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

Integer getBattery ()

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

boolean getBooleanProperty (String name, boolean defaultValue)

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

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.

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.

String getBootloaderVersion ()

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

InputStreamSource getBugreport ()

Récupère un rapport de bug de l'appareil.

InputStreamSource getBugreportz ()

Récupère un rapport de bug de l'appareil.

String getBuildAlias ()

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

String getBuildFlavor ()

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

String getBuildId ()

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

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)

DeviceDescriptor getCachedDeviceDescriptor ()

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

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

String[] getChildren (String path)

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

AbstractConnection getConnection ()

La connexion actuelle associée à l'appareil.

DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état pliable actuel de l'appareil ou null si des problèmes sont survenus.

int getCurrentUser ()

Renvoie l'identifiant de l'utilisateur actuel.

String getDeviceClass ()

Obtenez la classe de périphérique.

long getDeviceDate ()

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

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.

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.

TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

long getDeviceTimeOffset (Date date)

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

InputStreamSource getEmulatorOutput ()

Obtenez le flux de l'émulateur stdout et stderr

Process getEmulatorProcess ()

Renvoie le Process correspondant à cet émulateur.

final File getExecuteShellCommandLog ()

Le journal qui contient tous les journauxexecuteShellCommand executeShellCommand(String) .

long getExternalStoreFreeSpace ()

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

String getFastbootPath ()

Renvoie le chemin du binaire fastboot utilisé.

String getFastbootProductType ()

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

String getFastbootProductVariant ()

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

String getFastbootSerialNumber ()

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

String getFastbootVariable (String variableName)

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

String getFastbootVersion ()

Renvoie la chaîne de version du binaire fastboot utilisé.

IFileEntry getFileEntry (String path)

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

IFileEntry getFileEntry (FileListingService.FileEntry entry)

Aide non officielle pour obtenir un FileEntry à partir d'un chemin non root.

getFoldableStates ()

Renvoie la liste des états pliables sur l'appareil.

IDevice getIDevice ()

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

getInstalledPackageNames ()

Récupérez les noms des packages d’application présents sur l’appareil.

long getIntProperty (String name, long defaultValue)

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

String getIpAddress ()

Obtient l'adresse IP de l'appareil.

KeyguardControllerState getKeyguardState ()

Renvoie un objet pour obtenir l'état actuel du keyguard ou null s'il n'est pas pris en charge.

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

int getLaunchApiLevel ()

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

InputStreamSource getLogcat ()

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

InputStreamSource getLogcat (int maxBytes)

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

InputStreamSource getLogcatDump ()

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

InputStreamSource getLogcatSince (long date)

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

String getMacAddress ()

Renvoie l'adresse MAC de l'appareil, nulle s'il ne parvient pas à interroger l'appareil.

Integer getMainUserId ()

Renvoie l'identifiant de l'utilisateur principal.

getMainlineModuleInfo ()

Obtenez les informations sur les modules principaux installés sur l’appareil.

int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximum d’utilisateurs fonctionnant simultanément pris en charge.

int getMaxNumberOfUsersSupported ()

Obtenez le nombre maximum d'utilisateurs pris en charge.

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

Renvoie le IDeviceStateMonitor associé au périphérique.

String getMountPoint (String mountName)

Renvoie un point de montage.

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.

getMountPointInfo ()

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

TestDeviceOptions getOptions ()

Récupérez les options de test pour l’appareil.

long getPartitionFreeSpace (String partition)

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

Integer getPrimaryUserId ()

Renvoie l'identifiant de l'utilisateur principal.

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

String getProcessPid (String process)

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

String getProductType ()

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

String getProductVariant ()

Méthode pratique pour obtenir la variante de produit de cet appareil.

String getProperty (String name)

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

ITestDevice.RecoveryMode getRecoveryMode ()

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

InputStreamSource getScreenshot (String format)

Prend une capture d'écran de l'appareil.

InputStreamSource getScreenshot (long displayId)

Récupère une capture d'écran de l'appareil en fonction de l'identifiant d'affichage.

InputStreamSource getScreenshot (String format, boolean rescale)

Prend une capture d'écran de l'appareil.

InputStreamSource getScreenshot ()

Prend une capture d'écran de l'appareil.

String getSerialNumber ()

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

String getSetting (int userId, String namespace, String key)

Renvoie la valeur du paramètre demandé.

String getSetting (String namespace, String key)

Voir getSetting(int, String, String) et effectué sur l'utilisateur du système.

String getSimOperator ()

Renvoyez l'opérateur de la carte SIM ou null s'il n'est pas disponible ou si l'appareil n'est pas disponible.

String getSimState ()

Renvoie l'état de la carte SIM ou null si elle n'est pas disponible ou si l'appareil n'est pas disponible.

getTombstones ()

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

long getTotalMemory ()

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

getUninstallablePackageNames ()

Récupérez les noms des packages d’application qui peuvent être désinstallés.

boolean getUseFastbootErase ()

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

int getUserFlags (int userId)

Rechercher et renvoyer les drapeaux d'un utilisateur donné.

getUserInfos ()

Obtient la carte de useId vers UserInfo sur l’appareil.

int getUserSerialNumber (int userId)

Renvoie le numéro de série associé au userId s'il est trouvé, -10000 dans les autres cas.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Traitez le DeviceEvent donné.

Traitez le DeviceEvent, qui peut ou non faire passer ce périphérique vers un nouvel état d'allocation.

boolean hasFeature (String feature)

Vérifiez si une fonctionnalité est disponible sur un appareil.

String installPackage (File packageFile, boolean reinstall, String... extraArgs)

Installez un package Android sur l'appareil.

String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Installez un package Android sur l'appareil.

String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

Installez un package Android sur l'appareil pour un utilisateur donné.

String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Installez un package Android sur l'appareil pour un utilisateur donné.

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

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

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.

boolean isDebugfsMounted ()

Vérifiez si debugfs est monté.

boolean isDeviceEncrypted ()

Renvoie si l'appareil est chiffré.

boolean isDirectory (String path)

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

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

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

boolean isExecutable (String fullPath)

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

boolean isFastbootEnabled ()

Renvoie si le démarrage rapide est disponible pour l'appareil.

boolean isHeadless ()

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

boolean isHeadlessSystemUserMode ()

Indique si l'appareil utilise le mode utilisateur du système sans tête.

boolean isMainUserPermanentAdmin ()

Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ou rétrogradé au statut non-administrateur.

boolean isMultiUserSupported ()

Détermine si le multi-utilisateur est pris en charge.

boolean isPackageInstalled (String packageName, String userId)

Interrogez l'appareil pour un nom de package donné et un identifiant d'utilisateur donné pour vérifier s'il est actuellement installé ou non pour cet utilisateur.

boolean isPackageInstalled (String packageName)

Recherchez sur l'appareil un nom de package donné pour vérifier s'il est actuellement installé ou non.

boolean isRuntimePermissionSupported ()

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

boolean isStateBootloaderOrFastbootd ()

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

boolean isUserRunning (int userId)

Vérifiez si un utilisateur donné est en cours d'exécution.

boolean isUserSecondary (int userId)

Renvoie si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.

boolean isUserVisible (int userId)

Vérifie si l'utilisateur donné est visible.

boolean isUserVisibleOnDisplay (int userId, int displayId)

Vérifie si l'utilisateur donné est visible dans l'affichage donné.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil autorise le démarrage des utilisateurs, visible en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

boolean isVisibleBackgroundUsersSupported ()

Indique si l'appareil autorise le démarrage des utilisateurs visibles en arrière-plan.

boolean isWifiEnabled ()

Testez si le wifi est activé.

listDisplayIds ()

Collectez la liste des identifiants d'affichage disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtient la liste des affichages pouvant être utilisés pour start a user visible in the background .

listUsers ()

Obtient la liste des utilisateurs sur l'appareil.

boolean logAnrs ( ITestLogger logger)

Collecte et enregistre les ANR de l'appareil.

boolean logBugreport (String dataName, ITestLogger listener)

Méthode d'assistance pour rédiger un rapport de bug et le consigner aux journalistes.

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

Enregistrez un message dans le logcat de l'appareil.

void mountDebugfs ()

Montez les débogages.

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.

void postAdbRootAction ()

Remplacez si l'appareil nécessite que certaines actions spécifiques soient entreprises après la racine adb et avant que l'appareil ne soit de nouveau en ligne.

void postAdbUnrootAction ()

Remplacez si l'appareil nécessite que certaines actions spécifiques soient entreprises après le déracinement d'adb et avant que l'appareil ne soit de nouveau en ligne.

void postBootSetup ()

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

void postInvocationTearDown (Throwable exception)

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

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.

boolean pullDir (String deviceFilePath, File localDir)

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

boolean pullFile (String remoteFilePath, File localFile)

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

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 .

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 .

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

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

String pullFileContents (String remoteFilePath)

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

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 .

boolean pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, 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.

boolean pushDir (File localFileDir, String deviceFilePath)

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

boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

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

boolean pushFile (File localFile, String remoteFilePath)

Transférez un fichier vers l'appareil.

boolean pushString (String contents, String remoteFilePath)

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

void reboot (String reason)

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

void reboot ()

Redémarre l'appareil en mode adb.

void rebootIntoBootloader ()

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

void rebootIntoFastbootd ()

Redémarre l'appareil en mode fastbootd.

void rebootIntoRecovery ()

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

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

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

void rebootUntilOnline ()

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

void rebootUntilOnline (String reason)

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

void rebootUserspace ()

Redémarre uniquement la partie espace utilisateur de l’appareil.

void rebootUserspaceUntilOnline ()

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

boolean recoverDevice ()

Tentatives de récupération de la communication de l'appareil.

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

void remountSystemReadOnly ()

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

void remountSystemWritable ()

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

void remountVendorReadOnly ()

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

void remountVendorWritable ()

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

boolean removeAdmin (String componentName, int userId)

Supprimez l'administrateur de l'appareil donné chez un utilisateur donné et renvoyez true en cas de succès, false sinon.

void removeOwners ()

Supprimez tous les propriétaires de profils d’appareil existants en faisant de votre mieux.

boolean removeUser (int userId)

Supprimer un utilisateur donné de l'appareil.

void resetContentProviderSetup ()

Réinitialisez l'indicateur de configuration du fournisseur de contenu afin de le déclencher à nouveau.

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.

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

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

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

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

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

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

void setConfiguration ( IConfiguration configuration)

Injecte la IConfiguration utilisée.

final void setConnectionAvdInfo ( GceAvdInfo avdInfo)
void setDate (Date date)

Définit la date sur l'appareil

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

boolean setDeviceOwner (String componentName, int userId)

Définissez un composant d'administration de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné.

void setDeviceState ( TestDeviceState deviceState)

Mettez à jour l'état de l'appareil.

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

Pour l'émulateur, définissez SizeLimitedOutputStream pour enregistrer la sortie

void setEmulatorProcess (Process p)

Définit le Process lorsque cet appareil est un émulateur.

void setFastbootEnabled (boolean fastbootEnabled)

Définissez l'option de démarrage rapide pour le périphérique.

void setFastbootPath (String fastbootPath)

Définit le chemin d'accès au binaire fastboot qui doit être utilisé.

void setIDevice (IDevice newDevice)

Mettez à jour l’IDevice associé à cet ITestDevice.

void setLogStartDelay (int delay)

Définit le temps d'attente en ms avant de démarrer la capture logcat pour un appareil en ligne.

void setOptions ( TestDeviceOptions options)

Définir les TestDeviceOptions pour l’appareil

boolean setProperty (String propKey, String propValue)

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

void setRecovery ( IDeviceRecovery recovery)

Définissez IDeviceRecovery à utiliser pour cet appareil.

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

void setSetting (String namespace, String key, String value)

Voir setSetting(int, String, String, String) et effectué sur l'utilisateur du système.

void setSetting (int userId, String namespace, String key, String value)

Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné.

void setTestLogger ( ITestLogger testLogger)

Injecte l'instance ITestLogger

void setUseFastbootErase (boolean useFastbootErase)

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

void startLogcat ()

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

boolean startUser (int userId)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.

boolean startUser (int userId, boolean waitFlag)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.

boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

Démarre un utilisateur donné en arrière-plan, visible dans l'affichage donné (c'est-à-dire, permettant à l'utilisateur de lancer des activités dans cet affichage).

void stopEmulatorOutput ()

Fermez et supprimez la sortie de l'émulateur.

void stopLogcat ()

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

boolean stopUser (int userId)

Arrête un utilisateur donné.

boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Arrêtez un utilisateur donné.

String switchToAdbTcp ()

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

boolean switchToAdbUsb ()

Basculez l'appareil en mode AdB via USB.

boolean switchUser (int userId)

Basculez vers un autre ID utilisateur avec un délai d'expiration par défaut.

boolean switchUser (int userId, long timeout)

Basculez vers un autre ID utilisateur avec le délai d'expiration fourni comme date limite.

boolean syncFiles (File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport ()

Prenez un rapport de bug et retournez-le dans un objet Bugreport pour le gérer.

String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

String uninstallPackageForUser (String packageName, int userId)

Désinstallez un package Android de l'appareil pour un utilisateur donné.

boolean unlockDevice ()

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

void unmountDebugfs ()

Démontez les débogages.

boolean waitForBootComplete (long timeOut)

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

boolean waitForDeviceAvailable ()

Attend que l'appareil soit réactif et disponible pour les tests.

boolean waitForDeviceAvailable (long waitTime)

Attend que l'appareil soit réactif et disponible pour les tests.

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

void waitForDeviceBootloader ()

Bloque jusqu'à ce que le périphérique soit visible via fastboot.

boolean waitForDeviceInRecovery (long waitTime)

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

boolean waitForDeviceInSideload (long waitTime)

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

boolean waitForDeviceNotAvailable (long waitTime)

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

void waitForDeviceOnline ()

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

void waitForDeviceOnline (long waitTime)

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

boolean waitForDeviceShell (long waitTime)

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

Méthodes protégées

void addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)

Construit la commande du système d'exploitation pour la session de commande shell adb donnée et les arguments

void checkApiLevelAgainst (String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason)

Créez un RebootDeviceAction à utiliser lors de l’exécution d’une action de redémarrage.

IRunUtil createRunUtil ()
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Effectuez un redémarrage adb.

void ensureRuntimePermissionSupported ()

méthode d'assistance pour lever une exception si l'autorisation d'exécution n'est pas prise en charge

int getApiLevelSafe ()
ITestLogger getLogger ()
IRunUtil getRunUtil ()

Obtenez l’instance RunUtil à utiliser.

void initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)
String internalGetProperty (String propName, String fastbootVar, String description)

Récupérez une propriété de périphérique, à partir du cache ddmlib par défaut, et revenez à « adb shell getprop » ou à « fastboot getvar » selon que le périphérique est en Fastboot ou non.

boolean isInRebootCallback ()

Indique si les rappels de redémarrage sont en cours d'exécution ou non.

boolean isNewer (File localFile, IFileEntry entry)

Renvoie true si le fichier local est plus récent que le fichier distant.

void notifyRebootEnded ()

Informe tous les IDeviceActionReceiver de l’événement de fin de redémarrage.

void notifyRebootStarted ()

Informe tous les IDeviceActionReceiver de l’événement de démarrage du redémarrage.

boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

Effectue une action sur cet appareil.

void postAdbReboot ()

Actions supplémentaires possibles pouvant être entreprises après un redémarrage.

void prePostBootSetup ()

Permet à chaque type de périphérique (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration post-démarrage spécifique.

boolean pullFileInternal (String remoteFilePath, File localFile)
void setClock (Clock clock)

Définissez l’instance Clock à utiliser.

void setMicrodroidProcess (Process process)

Marque le TestDevice comme microdroïde et définit son CID.

void setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions)
CommandResult simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)

Exécute une simple commande fastboot avec des variables d'environnement et signale l'état de la commande.

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

Exécute une simple commande fastboot et signale l'état de la commande.

boolean waitForDeviceNotAvailable (String operationDesc, long time)

Attendez de voir l'appareil devenir indisponible (arrêtez de signaler à adb).

Constantes

IDENTIFIANT INVALIDE

public static final int INVALID_USER_ID

Valeur renvoyée pour tout identifiant utilisateur invalide/introuvable : UserHandle a défini la valeur -10 000

Valeur constante : -10 000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valeur constante : 5 000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

le nombre par défaut de nouvelles tentatives de commande à effectuer

Valeur constante : 2 (0x00000002)

Des champs

DEBUGFS_PATH

public static final String DEBUGFS_PATH

CARTE SD

protected static final String SD_CARD

STOCKAGE_EMULÉ

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructeurs publics

Appareil natif

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Crée un TestDevice .

Paramètres
device IDevice : l' IDevice associé

stateMonitor IDeviceStateMonitor : le mécanisme IDeviceStateMonitor à utiliser

allocationMonitor IDeviceMonitor : le IDeviceMonitor pour informer des changements d'état d'allocation. Peut être nul

Méthodes publiques

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Micro-optimisation (environ 400 millis) en prélevant tous les accessoires dont nous avons besoin plutôt que d'appeler « adb getprop » pour chacun. c'est-à-dire qu'il est tout aussi rapide de récupérer toutes les propriétés que d'en récupérer une seule. Des éléments comme device.getApiLevel(), checkApiLevelAgainstNextRelease et getBuildAlias ​​appellent tous « adb getprop » sous le capot. Nous les récupérons en un seul appel et appelons NativeDevice.setProperty. Même si nous ne le faisons pas, NativeDevice appellera lui-même setProperty et mettra en cache le résultat pour les appels futurs. Nous le faisons juste un peu plus tôt. Si l'appareil est en cours de récupération ou s'il y a d'autres erreurs lors de la récupération des accessoires, nous les ignorons simplement.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans tête.

Retour
boolean

Jetés
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

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

checkConnectivité

public boolean checkConnectivity ()

Vérifiez que l'appareil dispose d'une connectivité réseau.

Retour
boolean true si l'appareil dispose d'une connexion réseau fonctionnelle, false dans le cas contraire.

Jetés
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

Essayez de fermer les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil.

Retour
boolean true si aucune boîte de dialogue n’était présente ou si les boîtes de dialogue ont été effacées avec succès. false sinon.

Jetés
DeviceNotAvailableException

clearLastConnectedWifiRéseau

public void clearLastConnectedWifiNetwork ()

Efface le dernier réseau wifi connecté. Celui-ci doit être appelé lors du démarrage d'une nouvelle invocation pour éviter de se connecter au réseau wifi utilisé lors du test précédent après le redémarrage de l'appareil.

effacerLogcat

public void clearLogcat ()

Supprime toutes les données logcat accumulées.

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

se connecterAuRéseauWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecte à un réseau wifi.

Active le wifi et bloque jusqu'à ce qu'une connexion réussie soit établie avec l'un des réseaux wifi indiqués dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance tentera de restaurer la connexion après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.

Paramètres
wifiSsidToPsk : Une carte des SSID wifi aux mots de passe.

scanSsid boolean : s'il faut rechercher les SSID cachés pour ce réseau.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException

se connecterAuRéseauWifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecte à un réseau wifi.

Active le Wi-Fi et le bloque jusqu'à ce qu'une connexion réussie soit établie au réseau Wi-Fi spécifié. Une fois la connexion établie, l'instance tentera de restaurer la connexion après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.

Paramètres
wifiSsid String : le SSID wifi auquel se connecter

wifiPsk String : phrase secrète PSK ou null si non chiffrée

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException

se connecterAuRéseauWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecte à un réseau wifi.

Active le wifi et bloque jusqu'à ce qu'une connexion réussie soit établie avec l'un des réseaux wifi indiqués dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance tentera de restaurer la connexion après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.f

Paramètres
wifiSsidToPsk : Une carte des SSID wifi aux mots de passe.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException

se connecterAuRéseauWifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Se connecte à un réseau wifi.

Active le Wi-Fi et le bloque jusqu'à ce qu'une connexion réussie soit établie au réseau Wi-Fi spécifié. Une fois la connexion établie, l'instance tentera de restaurer la connexion après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.

Paramètres
wifiSsid String : le SSID wifi auquel se connecter

wifiPsk String : phrase secrète PSK ou null si non chiffrée

scanSsid boolean : s'il faut rechercher le SSID caché pour ce réseau.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException

se connecter au réseau Wifi si nécessaire

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

Paramètres
scanSsid boolean : s'il faut rechercher le SSID caché pour ce réseau

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException

se connecter au réseau Wifi si nécessaire

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException

Créer un utilisateur

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Créer un utilisateur avec un nom donné et les drapeaux fournis

Paramètres
name String : de l'utilisateur à créer sur l'appareil

guest boolean : active le drapeau utilisateur --guest lors de la création

ephemeral boolean : active le drapeau utilisateur --ephemeral lors de la création

Retour
int identifiant de l'utilisateur créé

Jetés
DeviceNotAvailableException

Créer un utilisateur

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Créer un utilisateur avec un nom donné et les drapeaux fournis

Paramètres
name String : de l'utilisateur à créer sur l'appareil

guest boolean : active le drapeau utilisateur --guest lors de la création

ephemeral boolean : active le drapeau utilisateur --ephemeral lors de la création

forTesting boolean : active l'indicateur de test --for-testing lors de la création

Retour
int identifiant de l'utilisateur créé

Jetés
DeviceNotAvailableException

Créer un utilisateur

public int createUser (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.

Paramètres
name String : de l'utilisateur à créer sur l'appareil

Retour
int l'entier pour l'identifiant utilisateur créé

Jetés
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.

Paramètres
name String : de l'utilisateur à créer sur l'appareil

Retour
int l'entier pour l'ID utilisateur créé ou -1 pour l'erreur.

Jetés
DeviceNotAvailableException

supprimer le fichier

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

désenregistrerDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

Paramètres
deviceActionReceiver IDeviceActionReceiver : Un IDeviceActionReceiver qui sera supprimé.

périphériqueSoftRedémarré

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

périphériqueSoftRestartedDepuis

public 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 progressif 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
DeviceNotAvailableException

désactiverAdbRoot

public 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

désactiverKeyguard

public void disableKeyguard ()

Tente de désactiver le protège-clavier.

Attendez d'abord que la répartition des entrées soit prête, cela se produit à peu près au même moment où le périphérique signale BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework présente des conditions de concurrence occasionnelles. Ensuite, la commande est envoyée pour ignorer le keyguard (fonctionne uniquement sur les claviers non sécurisés)

Jetés
DeviceNotAvailableException

désactiverNetworkMonitor

public boolean disableNetworkMonitor ()

Désactive la surveillance du réseau sur l'appareil.

Retour
boolean true si la surveillance est désactivée avec succès. false s'il a échoué.

Jetés
DeviceNotAvailableException

déconnecter du Wifi

public boolean disconnectFromWifi ()

Se déconnecte d'un réseau wifi.

Supprime tous les réseaux de la liste des réseaux connus et désactive le wifi.

Retour
boolean true si la déconnexion du réseau wifi est réussie. false si la déconnexion a échoué.

Jetés
DeviceNotAvailableException

Est-ce queFichierExiste

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : l'identifiant utilisateur par rapport auquel vérifier l'existence du fichier

Retour
boolean true si le fichier existe, false sinon.

Jetés
DeviceNotAvailableException

Est-ce queFichierExiste

public 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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Essayez de vider le tas du serveur_système. Il est de la responsabilité de l'appelant de nettoyer le fichier sauvegardé.

Paramètres
process String : le nom du processus de périphérique sur lequel effectuer le dumpheap.

devicePath String : le chemin sur le périphérique où placer le dump. Il doit s'agir d'un emplacement où les autorisations le permettent.

Retour
File l' ERROR(/File) contenant le rapport. Nul si quelque chose échoue.

Jetés
DeviceNotAvailableException

activerAdbRoot

public 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

activerNetworkMonitor

public boolean enableNetworkMonitor ()

Permet la surveillance du réseau sur l'appareil.

Retour
boolean true si la surveillance est activée avec succès. false s'il a échoué.

Jetés
DeviceNotAvailableException

exécuterAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

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

cmdArgs 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

exécuterAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

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

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

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

envMap : environnement à définir pour la commande

cmdArgs 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

exécuterAdbCommand

public String executeAdbCommand (String... cmdArgs)

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
cmdArgs 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

exécuterFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

Jetés
DeviceNotAvailableException

exécuterFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

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

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

Jetés
DeviceNotAvailableException

exécuterLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

Identique executeFastbootCommand(String) sauf qu'il utilise un délai d'attente plus long.

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

Retour
CommandResult le CommandResult contenant la sortie de la commande

Jetés
DeviceNotAvailableException

ExecutelongfastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Méthode d'aide qui exécute une commande FastBoot en cours d'exécution en tant que commande système avec des variables d'environnement système.

Identique à executeFastbootCommand(String) Sauf utilise un délai d'attente plus long.

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

cmdArgs String : la commande FastBoot et les arguments à exécuter

Retour
CommandResult le commandrsult contenant la sortie de la commande

Jetés
DeviceNotAvailableException

ExecutellCommand

public String executeShellCommand (String command)

Méthode d'assistance qui exécute une commande shell ADB et renvoie la sortie en tant que String .

Paramètres
command String : la commande ADB Shell à exécuter

Retour
String la sortie du shell

Jetés
DeviceNotAvailableException

ExecutellCommand

public 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 ADB Shell à exécuter

receiver IShellOutputReceiver : L' IShellOutputReceiver pour diriger la sortie du shell vers.

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

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois pour réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsive Exception sera lancé si retryAttempts sont effectués sans succès.

Jetés
DeviceNotAvailableException

ExecutellCommand

public 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 ADB Shell à exécuter

receiver IShellOutputReceiver : L' IShellOutputReceiver pour diriger la sortie du shell vers.

maxTimeoutForCommand long : le délai maximum pour la commande à terminer; unité spécifiée dans timeUnit

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

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois pour réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsive Exception sera lancé si retryAttempts sont effectués sans succès.

Jetés
DeviceNotAvailableException

ExecutellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Exécute la commande Shell ADB donnée, 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 ADB Shell à exécuter

receiver IShellOutputReceiver : L' IShellOutputReceiver pour diriger la sortie du shell vers.

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd)

Méthode d'assistance qui exécute une commande shell ADB et renvoie les résultats en tant que CommandResult correctement rempli avec la sortie d'état de commande, Stdout et Stderr.

Paramètres
cmd String : la commande qui doit être exécutée.

Retour
CommandResult Le résultat dans CommandResult .

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Méthode d'assistance qui exécute une commande shell ADB et renvoie les résultats en tant que CommandResult correctement rempli avec la sortie d'état de commande et stderr. STDOUT est dirigé vers le flux spécifié.

Paramètres
cmd String : la commande qui doit être exécutée.

pipeToOutput OutputStream : ERROR(/OutputStream) où la sortie STD sera redirigée ou nul.

Retour
CommandResult Le résultat dans CommandResult .

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Méthode d'assistance qui exécute une commande shell ADB et renvoie les résultats en tant que CommandResult correctement rempli avec la sortie d'état de commande, Stdout et Stderr.

Paramètres
cmd String : la commande qui doit être exécutée.

pipeAsInput File : une ERROR(/File) qui sera conduite en entrée dans la commande, ou null.

Retour
CommandResult Le résultat dans CommandResult .

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd, 
                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
cmd String : la commande ADB Shell à exécuter

maxTimeoutForCommand long : le délai maximum pour la commande à terminer; unité spécifiée dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois pour réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsive Exception sera lancé si retryAttempts sont effectués sans succès.

Retour
CommandResult

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd, 
                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
cmd String : la commande ADB Shell à exécuter

maxTimeoutForCommand long : le délai maximum pour la commande à terminer; unité spécifiée dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

Retour
CommandResult

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd, 
                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
cmd String : la commande ADB Shell à exécuter

pipeAsInput File : une ERROR(/File) qui sera conduite en entrée dans la commande, ou null.

pipeToOutput OutputStream : ERROR(/OutputStream) où la sortie STD sera redirigée ou nul.

maxTimeoutForCommand long : le délai maximum pour la commande à terminer; unité spécifiée dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois pour réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsive Exception sera lancé si retryAttempts sont effectués sans succès.

Retour
CommandResult

Jetés
DeviceNotAvailableException

Executellv2Command

public CommandResult executeShellV2Command (String cmd, 
                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
cmd String : la commande ADB Shell à exécuter

pipeAsInput File : une ERROR(/File) qui sera conduite en entrée dans la commande, ou null.

pipeToOutput OutputStream : ERROR(/OutputStream) où la sortie STD sera redirigée ou nul.

pipeToError OutputStream : ERROR(/OutputStream) où l'erreur STD sera redirigée ou nul.

maxTimeoutForCommand long : le délai maximum pour la commande à terminer; unité spécifiée dans timeUnit

timeUnit TimeUnit : unité pour maxTimeToOutputShellResponse

retryAttempts int : le nombre maximum de fois pour réessayer la commande si elle échoue en raison d'une exception. DeviceNotResponsive Exception sera lancé si retryAttempts sont effectués sans succès.

Retour
CommandResult

Jetés
DeviceNotAvailableException

FastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

Si getUseFastbootErase() est true , alors l'effacement Fastboot sera utilisé pour effacer la partition. L'appareil doit ensuite créer un système de fichiers la prochaine fois que le périphérique bottiserait. 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 à essuyer

Retour
CommandResult le commandrsult contenant la sortie de la commande

Jetés
DeviceNotAvailableException

GetActivePexes

public  getActiveApexes ()

Reportez les informations sur les sommets activés sur l'appareil.

Retour
ERROR(/Set) d' ApexInfo actuellement activé sur l'appareil

Jetés
DeviceNotAvailableException

getAllsettings

public  getAllSettings (String namespace)

Renvoie des paires de valeurs de clé d'espace de noms demandé.

Paramètres
namespace String : doit être l'un des {"système", "sécurisé", "global"}

Retour
La carte des paires de valeurs de clé. Null si l'espace de noms n'est pas pris en charge.

Jetés
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Retourner l'état d'allocation actuel de l'appareil

Retour
DeviceAllocationState

getAndroidID

public String getAndroidId (int userId)

Trouvez et renvoyez l'Android-ID associé à un utilisateur, null, sinon trouvé.

Paramètres
userId int

Retour
String

Jetés
DeviceNotAvailableException

getAndroiddides

public  getAndroidIds ()

Créez une carte des ID Android trouvés des ID utilisateur correspondant. Il n'y a aucune assurance que chaque ID utilisateur trouvera un ID Android associé à cette fonction afin que certains ID utilisateur puissent correspondre à NULL.

Retour
Carte des ID Android trouvés correspondants aux ID utilisateur.

Jetés
DeviceNotAvailableException

getapilevel

public int getApiLevel ()

Obtenez le niveau de l'API de l'appareil. Par défaut vers UNKNOWN_API_LEVEL .

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

Jetés
DeviceNotAvailableException

GetAppackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Remplissez des informations sur un package installé sur l'appareil.

Paramètres
packageName String

Retour
PackageInfo le PackageInfo ou null si les informations ne pouvaient pas être récupérées

Jetés
DeviceNotAvailableException

GetAppackageInfos

public  getAppPackageInfos ()

Remplissez les informations des packages installés sur l'appareil.

Retour
ERROR(/List) de PackageInfo s installé sur l'appareil.

Jetés
DeviceNotAvailableException

getBaseBandVersion

public String getBasebandVersion ()

Méthode de commodité pour obtenir la version de bande de base (radio) de cet appareil. L'obtention de la version radio est spécifique à l'appareil, il peut donc ne pas renvoyer les informations correctes pour tous les appareils. Cette méthode repose sur la properte GSM.Version.Baseband pour renvoyer les informations de version correctes. Ce n'est pas exact pour certains appareils CDMA et la version renvoyée ici peut ne pas correspondre à la version rapportée par FastBoot et peut ne pas renvoyer la version de la radio CDMA. TL; DR Cette méthode ne rapporte pas la 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 bande de base String ou null si elle ne peut pas être déterminée (le périphérique n'a pas de radio ou de version de la chaîne ne peut pas être lue)

Jetés
DeviceNotAvailableException

GetBattery

public Integer getBattery ()

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

Retour
Integer

getbooleanproperty

public 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 pour retourner si la propriété est vide ou n'existe pas.

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

Jetés
DeviceNotAvailableException

getboothistory

public  getBootHistory ()

La méthode d'aide recueille la carte de l'historique de démarrage avec le temps de démarrage et la raison de démarrage.

Retour
Carte du temps de démarrage (temps UTC en deuxième depuis Epoch) et de la raison de démarrage

Jetés
DeviceNotAvailableException

getboothistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Paramètres
utcEpochTime long : l'heure de l'appareil depuis l'époque.

timeUnit TimeUnit : The Time Unit TimeUnit .

Retour
Carte du temps de démarrage (temps UTC en deuxième depuis Epoch) et de la raison de démarrage

Jetés
DeviceNotAvailableException

getbootloaderVersion

public String getBootloaderVersion ()

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

Tentera de récupérer la version Bootloader à partir de l'état actuel de l'appareil. (c'est-à-dire que si l'appareil est en mode Fastboot, il tentera de récupérer la version à partir de FastBoot)

Retour
String la version de chargeur String ou null si elle ne peut être trouvée

Jetés
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Récupère un BugReport à partir de l'appareil.

La mise en œuvre de ceci est garantie de continuer à travailler sur un appareil sans CARD (ou où la carte SD n'est pas encore montée).

Retour
InputStreamSource Un InputStreamSource qui produira le contenu de BugReport à la demande. En cas de défaillance, l' InputStreamSource produira une ERROR(/InputStream) .

getBugreportz

public InputStreamSource getBugreportz ()

Récupère un bugReportz à partir de l'appareil. Zip Format BugReport contient le principal bugReport et d'autres fichiers journaux utiles pour le débogage.

Prise en charge uniquement pour la «version ADB»> 1.0.36

Retour
InputStreamSource Une InputStreamSource du fichier zip contenant le bugReportz, renvoyez NULL en cas de défaillance.

getBuildalias

public String getBuildAlias ()

Récupérez l'alias de la construction que l'appareil est actuellement en cours d'exécution.

Build Alias ​​est généralement une chaîne plus lisible que l'ID de build (généralement un nombre pour les versions Nexus). Par exemple, la version finale Android 4.2 a construit un alias JDQ39 et Build ID 573038

Retour
String l'alias de construction ou retomber pour construire ID s'il ne pouvait pas être récupéré

Jetés
DeviceNotAvailableException

getBuildflavor

public String getBuildFlavor ()

Récupérez la saveur de construction de l'appareil.

Retour
String la saveur de construction ou null s'il ne pouvait pas être récupéré

Jetés
DeviceNotAvailableException

getBuildid

public String getBuildId ()

Récupérer la construction que l'appareil est en cours d'exécution.

Retour
String L'ID de construction ou IBuildInfo#UNKNOWN_BUILD_ID s'il ne pouvait pas être récupéré

Jetés
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

Retour
String La clé de signature si elle est trouvée, nul autrement.

Jetés
DeviceNotAvailableException

getCachedDevicedEscriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Retour
DeviceDescriptor

getCachedDevicedEscriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Paramètres
shortDescriptor boolean : s'il faut limiter ou non le descripteur à des informations minimales nues

Retour
DeviceDescriptor

getchildren

public String[] getChildren (String path)

Alternative à l'utilisation IFileEntry qui ne fonctionnera parfois pas à cause des autorisations.

Paramètres
path String : le chemin sur l'appareil est-il où faire la recherche

Retour
String[] Tableau de chaîne contenant tout le fichier dans un chemin d'accès sur l'appareil.

Jetés
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

La connexion actuelle associée à l'appareil.

Retour
AbstractConnection

getcurrentfollableState

public DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état pliable actuel de l'appareil ou null si certains problèmes se sont produits.

Retour
DeviceFoldableState

Jetés
DeviceNotAvailableException

GetCurrentUser

public int getCurrentUser ()

Renvoie l'ID de l'utilisateur actuel en cours d'exécution. En cas d'erreur, renvoyez -10000.

Retour
int

Jetés
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Obtenez la classe d'appareil.

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

getDevicedate

public long getDeviceDate ()

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

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

Jetés
DeviceNotAvailableException

getDevicedEscriptor

public DeviceDescriptor getDeviceDescriptor ()

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations dessus sans passer l'objet de périphérique réel.

Retour
DeviceDescriptor

getDevicedEscriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Renvoyez un DeviceDescriptor à partir des informations de l'appareil pour obtenir des informations dessus sans passer l'objet de périphérique réel.

Paramètres
shortDescriptor boolean : s'il faut limiter ou non le descripteur à des informations minimales nues

Retour
DeviceDescriptor

getdevicestate

public TestDeviceState getDeviceState ()

Obtenez l'état de l'appareil.

Retour
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Aide pour obtenir le décalage horaire entre l'appareil et une ERROR(/Date) . Utilisez le temps d'épochage en interne.

Paramètres
date Date

Retour
long la différence en millisecondes

Jetés
DeviceNotAvailableException

getEMulatOutput

public InputStreamSource getEmulatorOutput ()

Obtenez le flux de l'émulateur Stdout et Stderr

Retour
InputStreamSource sortie de l'émulateur

GetEmulatorProcess

public Process getEmulatorProcess ()

Renvoyez le Process correspondant à cet émulateur.

Retour
Process le Process ou null

getExecuSelllCommandlog

public final File getExecuteShellCommandLog ()

Le journal qui contient tous les journaux executeShellCommand(String) .

Retour
File

getExternalstorefreespace

public 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 dans KB

Jetés
DeviceNotAvailableException

getfastbootpath

public String getFastbootPath ()

Renvoie le chemin du binaire Fastboot utilisé. Il faut toujours que isFastbootEnabled() soit vrai, pour que les fonctions FastBoot activent.

Retour
String

getfastbootproductype

public String getFastbootProductType ()

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

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

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

Jetés
DeviceNotAvailableException

getfastbootproductvariant

public String getFastbootProductVariant ()

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

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

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

Jetés
DeviceNotAvailableException

getfastbootserialnumber

public String getFastbootSerialNumber ()

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

Retour
String

getfastbootvariable

public String getFastbootVariable (String variableName)

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

Paramètres
variableName String : le nom de la variable

Retour
String la valeur de la propriété ou null s'il n'existe pas

Jetés
DeviceNotAvailableException

getfastbootversion

public String getFastbootVersion ()

Renvoie la chaîne de version du binaire FastBoot utilisé. Ou null si quelque chose ne va pas.

Retour
String

getFileEntry

public IFileEntry getFileEntry (String path)

Récupérez 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 ou un chemin absolu par rapport à '/'. (c'est-à-dire que la syntaxe "/ système" et "système" est prise en charge)

Retour
IFileEntry Le fichier IFileEntry ou null si un path donné ne peut être trouvé

Jetés
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Aide non officielle pour obtenir un FileEntry à partir d'un chemin non racinaire. FixMe: Refactor le système FileEntry pour le faire disponible à partir de n'importe quel chemin. (même non racine).

Paramètres
entry FileListingService.FileEntry : un FileEntry n'est pas nécessairement roote comme DDMLIB l'exige.

Retour
IFileEntry un fichier de fichier Représentant le fichier.

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

getfollableStates

public  getFoldableStates ()

Renvoie la liste des états pliables sur l'appareil. Peut être obtenu avec "CMD Device_State Print-States".

Retour

Jetés
DeviceNotAvailableException

getidevice

public IDevice getIDevice ()

Renvoie une référence à l' IDevice DDMLIB associé.

Un nouvel IDevice peut être alloué par DDMS chaque fois que l'appareil se déconnecte et se reconnecte de la BAD. Ainsi, les appelants ne doivent pas garder une référence à l' IDevice , car cette référence peut devenir périmée.

Retour
IDevice l' IDevice

GetInstalledPackagenmes

public  getInstalledPackageNames ()

Reportez les noms des packages d'application présents sur l'appareil.

Retour
ERROR(/Set) des noms de packages String actuellement installés sur l'appareil.

Jetés
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

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

defaultValue long : valeur par défaut pour retourner 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

getipaddress

public String getIpAddress ()

Obtient l'adresse IP de l'appareil.

Retour
String L'adresse IP de l'appareil, ou null si l'appareil n'a pas d'adresse IP

Jetés
DeviceNotAvailableException

getkeyguardstate

public KeyguardControllerState getKeyguardState ()

Renvoyez un objet pour obtenir l'état actuel du KeyGuard ou Null s'il n'est pas pris en charge.

Retour
KeyguardControllerState Un KeyguardControllerState contenant un instantané de l'état du KeyGuard et renvoie Null si la requête KeyGuard n'est pas prise en charge.

Jetés
DeviceNotAvailableException

getLastexpectionBoottimemillis

public long getLastExpectedRebootTimeMillis ()

Renvoie la dernière fois que les API commercialisées ont déclenché un redémarrage en millisecondes depuis l'époque comme retourné par System.currentTimeMillis() .

Retour
long

getlaunchapilevel

public int getLaunchApiLevel ()

Obtenez le premier niveau API lancé de l'appareil. Par défaut vers UNKNOWN_API_LEVEL .

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

Jetés
DeviceNotAvailableException

getlogcat

public InputStreamSource getLogcat ()

Saisissez un flux instantané des données LOGCAT.

Fonctionne en deux modes:

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

    Retour
    InputStreamSource

  • getlogcat

    public InputStreamSource getLogcat (int maxBytes)

    Saisissez un flux instantané des derniers maxBytes des données logcat capturées.

    Utile pour les cas où vous souhaitez capturer des instantanés fréquents des données LogCAT capturées sans encourir la pénalité d'espace disque potentiellement gros pour obtenir l'intégralité d'instantané getLogcat() .

    Paramètres
    maxBytes int : La quantité maximale de données à retourner. Devrait être une quantité qui peut s'adapter confortablement dans la mémoire

    Retour
    InputStreamSource

    getlogcatdump

    public InputStreamSource getLogcatDump ()

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

    A l'inconvénient que rien ne sera retourné si l'appareil n'est pas accessible.

    Retour
    InputStreamSource une InputStreamSource des données LOGCAT. Un flux vide est renvoyé en cas de ne pas capturer les données logcat.

    getlogcatsince

    public InputStreamSource getLogcatSince (long date)

    Saisissez un flux instantané de données LOGCAT capturées commençant la date fournie. L'heure sur l'appareil doit être utilisée getDeviceDate() .

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

    Retour
    InputStreamSource

    getmacaddress

    public String getMacAddress ()

    Renvoie l'adresse MAC de l'appareil, null s'il ne parvient pas à interroger à partir de l'appareil.

    Retour
    String

    getmainUserrid

    public Integer getMainUserId ()

    Renvoie l'ID utilisateur principal.

    Retour
    Integer L'utilisateur de l'utilisateur principal s'il y en a un, et null s'il n'y a pas d'utilisateur principal.

    Jetés
    DeviceNotAvailableException

    getMainlineModuleinfo

    public  getMainlineModuleInfo ()

    Obtenez les informations sur les modules de ligne principale installés sur l'appareil.

    Retour
    ERROR(/Set) des modules de ligne principale String actuellement installés sur l'appareil.

    Jetés
    DeviceNotAvailableException

    getMaxNumberofrunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Obtenez le nombre maximal d'utilisateurs en cours d'exécution simultanément pris en charge. La valeur par défaut est 0.

    Retour
    int un entier indiquant le nombre d'utilisateurs en cours d'exécution simultanément

    Jetés
    DeviceNotAvailableException

    getMaxNumberofusersSupported

    public int getMaxNumberOfUsersSupported ()

    Obtenez le nombre maximum d'utilisateurs pris en charge. La valeur par défaut est 0.

    Retour
    int un entier indiquant le nombre d'utilisateurs pris en charge

    Jetés
    DeviceNotAvailableException

    getmicrodoidprocess

    public Process getMicrodroidProcess ()

    Retour
    Process Renvoie le processus de la machine virtuelle microroïde. Si TestDevice n'est pas une microdesque, renvoie NULL.

    getmonitor

    public IDeviceStateMonitor getMonitor ()

    Renvoyez l' IDeviceStateMonitor associé à l'appareil.

    Retour
    IDeviceStateMonitor

    getmountpoint

    public String getMountPoint (String mountName)

    Renvoie un point de montage.

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

    TODO: déplacez ce comportement sur IDevice#getMountPoint(String)

    Paramètres
    mountName String : le nom du point de montage

    Retour
    String le point de montage ou null

    getmountpointinfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Paramètres
    mountpoint String

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

    Jetés
    DeviceNotAvailableException

    getmountpointinfo

    public  getMountPointInfo ()

    Renvoie une version analysée des informations dans / proc / monte sur l'appareil

    Retour
    Une ERROR(/List) de MountPointInfo contenant les informations dans "/ Proc / Mount"

    Jetés
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Reportez les options de test pour l'appareil.

    Retour
    TestDeviceOptions TestDeviceOptions liées à l'appareil testé.

    getPartitionFreespace

    public long getPartitionFreeSpace (String partition)

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

    Paramètres
    partition String

    Retour
    long la quantité d'espace libre dans KB

    Jetés
    DeviceNotAvailableException

    getPrimaryUserrid

    public Integer getPrimaryUserId ()

    Renvoie l'ID utilisateur principal.

    Retour
    Integer L'utilisateur de l'utilisateur principal s'il y en a un, et null s'il n'y a pas d'utilisateur principal.

    Jetés
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

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

    Paramètres
    processName String : la chaîne de nom Proces.

    Retour
    ProcessInfo ProcessInfo de processName donné

    Jetés
    DeviceNotAvailableException

    getProcesspid

    public String getProcessPid (String process)

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

    Paramètres
    process String : la chaîne de nom Proces.

    Retour
    String

    Jetés
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

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

    Cette méthode fonctionnera si le périphérique est en mode ADB ou FastBoot.

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

    Jetés
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Méthode de commodité pour obtenir la variante de produit de cet appareil.

    Cette méthode fonctionnera si le périphérique est en mode ADB ou FastBoot.

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

    Jetés
    DeviceNotAvailableException

    Getproperty

    public 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 s'il n'existe pas

    Jetés
    DeviceNotAvailableException

    getRecoveryMode

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

    getScreenshot

    public InputStreamSource getScreenshot (String format)

    Achetez une capture d'écran de l'appareil. Recommandé d'utiliser GetScreenshot (format) à la place avec le codage JPEG pour une taille plus petite

    Paramètres
    format String : PNG pris en charge, JPEG

    Retour
    InputStreamSource Une InputStreamSource de la capture d'écran au format, ou null si la capture d'écran n'a pas réussi.

    Jetés
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

    Saisissez une capture d'écran à partir de l'appareil ID d'affichage donné. Le format est png.

    TODO: étendre les implémentations ci-dessus pour soutenir le «format» et la «rediffusion»

    Paramètres
    displayId long : L'ID d'affichage de l'écran pour obtenir une capture d'écran à partir de.

    Retour
    InputStreamSource Une InputStreamSource de la capture d'écran au format, ou null si la capture d'écran n'a pas réussi.

    Jetés
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Achetez une capture d'écran de l'appareil. Recommandé d'utiliser getScreenshot(String) à la place avec le codage JPEG pour une taille plus petite.

    Paramètres
    format String : PNG pris en charge, JPEG

    rescale boolean : Si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante

    Retour
    InputStreamSource Une InputStreamSource de la capture d'écran au format, ou null si la capture d'écran n'a pas réussi.

    Jetés
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Achetez une capture d'écran de l'appareil.

    Retour
    InputStreamSource Une InputStreamSource de la capture d'écran au format PNG, ou null si la capture d'écran n'a pas réussi.

    Jetés
    DeviceNotAvailableException

    getSerialnumber

    public String getSerialNumber ()

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

    Retour
    String le numéro de série String

    getsetting

    public String getSetting (int userId, 
                    String namespace, 
                    String key)

    Renvoie la valeur du paramètre demandé. L'espace de noms doit être l'un des: {"System", "Secure", "Global"}

    Paramètres
    userId int

    namespace String

    key String

    Retour
    String La valeur associée à l'espace de noms: clé d'un utilisateur. Null s'il n'est pas trouvé.

    Jetés
    DeviceNotAvailableException

    getsetting

    public String getSetting (String namespace, 
                    String key)

    Voir getSetting(int, String, String) et effectué sur l'utilisateur du système.

    Paramètres
    namespace String

    key String

    Retour
    String

    Jetés
    DeviceNotAvailableException

    getImOperator

    public String getSimOperator ()

    Renvoyez l'opérateur de carte SIM ou NULL s'il n'est pas disponible ou si l'appareil n'est pas disponible.

    Retour
    String

    getimstate

    public String getSimState ()

    Renvoyez l'état de la carte SIM ou NULL s'il n'est pas disponible ou que l'appareil n'est pas disponible.

    Retour
    String

    getTombstones

    public  getTombstones ()

    Récupérez et retournez la liste des pierres tombales des appareils. Nécessite de la racine.

    La méthode est la mieux en effet, donc si une pierre tombale ne parvient pas à être tirée pour quelque raison que ce soit, il manquera dans la liste. Seule une DeviceNotAvailableException finira tôt la méthode.

    Retour
    Une liste de fichiers de pierres tombales, vide si pas de pierre tombale.

    Jetés
    DeviceNotAvailableException

    gettotalmemory

    public long getTotalMemory ()

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

    Retour
    long

    getuninstallablepackagenames

    public  getUninstallablePackageNames ()

    Reportez les noms des packages d'application qui peuvent être désinstallés. Ceci est actuellement défini comme des packages non système et des packages système mis à jour.

    Retour
    ERROR(/Set) des noms de packages String non installables actuellement installés sur l'appareil.

    Jetés
    DeviceNotAvailableException

    getUsefastbooterase

    public boolean getUseFastbootErase ()

    Obtenez du format FastBoot Effacer ou FastBoot pour effacer une partition sur l'appareil.

    Retour
    boolean true si Fastboot Efface sera utilisé ou false si le format FastBoot sera utilisé.

    getUserFlags

    public int getUserFlags (int userId)

    Trouvez et renvoyez les drapeaux d'un utilisateur donné. Les drapeaux sont définis dans la classe "Android.Content.pm.UserInfo" dans le projet open source Android.

    Paramètres
    userId int

    Retour
    int Les drapeaux associés à l'utilisateur fourni si cela est trouvé, -10000 dans d'autres cas.

    Jetés
    DeviceNotAvailableException

    getuserinfos

    public  getUserInfos ()

    Obtient la carte d'UseID à UserInfo sur l'appareil. Jetera DeviceRuntimeException si la sortie de l'appareil n'est pas comme prévu.

    Retour
    La liste des objets UserInfo.

    Jetés
    DeviceNotAvailableException

    getUserSerialnumber

    public int getUserSerialNumber (int userId)

    Renvoyez le numéro de série associé à l'UserId si vous êtes trouvé, -10000 dans d'autres cas.

    Paramètres
    userId int

    Retour
    int

    Jetés
    DeviceNotAvailableException

    handleallocationevent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Traitez le device de tenue donné. Peut être transition vers un nouvel état. Informera l' IDeviceMonitor de toute transition d'État.

    Traitez le DeviceEvent, qui peut ou non passer à ce dispositif vers un nouvel état d'allocation.

    Paramètres
    event DeviceEvent

    Retour
    IManagedTestDevice.DeviceEventResponse

    hasteature

    public boolean hasFeature (String feature)

    Vérifiez si une fonctionnalité est disponible sur un appareil.

    Paramètres
    feature String : quel format doit être "la fonctionnalité: " ou " "directement.

    Retour
    boolean Vrai si la fonctionnalité est trouvée, fausse autrement.

    Jetés
    DeviceNotAvailableException

    installer le paquet

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    String... extraArgs)

    Installez un package Android sur l'appareil.

    Paramètres
    packageFile File : le fichier APK à installer

    reinstall boolean : true si une réinstallation doit être effectuée

    extraArgs String : Arguments supplémentaires facultatifs à passer. Voir «ADB Shell PM -H» pour les options disponibles.

    Retour
    String une String avec un code d'erreur, ou null si le succès.

    Jetés
    DeviceNotAvailableException

    installer le paquet

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    String... extraArgs)

    Installez un package Android sur l'appareil.

    Remarque: Seuls les cas d'utilisation qui nécessitent un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

    Paramètres
    packageFile File : le fichier APK à installer

    reinstall boolean : true si une réinstallation doit être effectuée

    grantPermissions boolean : si toutes les autorisations d'exécution doivent être accordées au moment de l'installation

    extraArgs String : Arguments supplémentaires facultatifs à passer. Voir «ADB Shell PM -H» pour les options disponibles.

    Retour
    String une String avec un code d'erreur, ou null si le succès.

    Jetés
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    int userId, 
                    String... extraArgs)

    Installez un package Android sur l'appareil pour un utilisateur donné.

    Paramètres
    packageFile File : le fichier APK à installer

    reinstall boolean : true si une réinstallation doit être effectuée

    userId int : L'ID utilisateur entier à installer.

    extraArgs String : Arguments supplémentaires facultatifs à passer. Voir «ADB Shell PM -H» pour les options disponibles.

    Retour
    String une String avec un code d'erreur, ou null si le succès.

    Jetés
    DeviceNotAvailableException

    installPackageForUser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    int userId, 
                    String... extraArgs)

    Installez un package Android sur l'appareil pour un utilisateur donné.

    Remarque: Seuls les cas d'utilisation qui nécessitent un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

    Paramètres
    packageFile File : le fichier APK à installer

    reinstall boolean : true si une réinstallation doit être effectuée

    grantPermissions boolean : si toutes les autorisations d'exécution doivent être accordées au moment de l'installation

    userId int : L'ID utilisateur entier à installer.

    extraArgs String : Arguments supplémentaires facultatifs à passer. Voir «ADB Shell PM -H» pour les options disponibles.

    Retour
    String une String avec un code d'erreur, ou null si le succès.

    Jetés
    DeviceNotAvailableException

    invaliderpropertycache

    public void invalidatePropertyCache ()

    isadbroot

    public boolean isAdbRoot ()

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    Isadbtcp

    public boolean isAdbTcp ()

    Retour
    boolean

    isappérations soutenues

    public boolean isAppEnumerationSupported ()

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

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

    Jetés
    DeviceNotAvailableException

    isByPasslowTargetsDkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Vérifiez si la plate-forme sur l'appareil prend en charge le contournement du bloc SDK cible bas sur les installations de l'application

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

    Jetés
    DeviceNotAvailableException

    isdebugfsmount

    public boolean isDebugfsMounted ()

    Vérifiez si Debugfs est monté.

    Retour
    boolean true si les débogues sont montées

    Jetés
    DeviceNotAvailableException

    IsdeviceCrypted

    public boolean isDeviceEncrypted ()

    Revient si l'appareil est crypté.

    Retour
    boolean true si l'appareil est crypté.

    Jetés
    DeviceNotAvailableException

    isdirectoire

    public boolean isDirectory (String path)

    Renvoie vrai si le chemin du dispositif est un répertoire, faux autrement.

    Paramètres
    path String

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    Isenableadbroot

    public boolean isEnableAdbRoot ()

    Retour
    boolean true si la racine ADB doit être activée sur l'appareil

    Isencryptions soupçonné

    public boolean isEncryptionSupported ()

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

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

    Jetés
    DeviceNotAvailableException

    est-ce que

    public boolean isExecutable (String fullPath)

    Renvoie True si le chemin du fichier sur l'appareil est un fichier exécutable, faux autrement.

    Paramètres
    fullPath String

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    isfastbooTenabled

    public boolean isFastbootEnabled ()

    Retour si FastBoot est disponible pour l'appareil.

    Retour
    boolean

    sans faille

    public boolean isHeadless ()

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

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    Isheadlessystemusemode

    public boolean isHeadlessSystemUserMode ()

    Renvoie si l'appareil utilise le mode utilisateur système sans tête.

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    IsmainUserpermanentAdmin

    public boolean isMainUserPermanentAdmin ()

    Renvoie si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ou rétrogradé en statut non-trajet.

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    ISMULTISERSEPPART

    public boolean isMultiUserSupported ()

    Détermine si le multi-utilisateur est pris en charge.

    Retour
    boolean vrai si le multi-utilisateur est pris en charge, faux sinon

    Jetés
    DeviceNotAvailableException

    IspackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Interrogez l'appareil pour un nom de package donné et l'ID utilisateur donné pour vérifier s'il est actuellement installé ou non pour cet utilisateur.

    Paramètres
    packageName String : le package que nous vérifions s'il est installé.

    userId String : L'ID utilisateur que nous vérifions le package est installé. Si NULL, l'utilisateur primaire zéro sera utilisé.

    Retour
    boolean Vrai si le package est signalé comme installé. Faux sinon.

    Jetés
    DeviceNotAvailableException

    IspackageInstalled

    public boolean isPackageInstalled (String packageName)

    Interrogez l'appareil pour un nom de package donné pour vérifier s'il est actuellement installé ou non.

    Paramètres
    packageName String

    Retour
    boolean Vrai si le package est signalé comme installé. Faux sinon.

    Jetés
    DeviceNotAvailableException

    IsruntimePermissions soupçonné

    public boolean isRuntimePermissionSupported ()

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

    Retour
    boolean Vrai si l'autorisation d'exécution est prise en charge, fausse autrement.

    Jetés
    DeviceNotAvailableException

    Isstatebootloaderorfastbootd

    public boolean isStateBootloaderOrFastbootd ()

    Renvoie True si le périphérique est dans TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD .

    Retour
    boolean

    iSuserrunning

    public boolean isUserRunning (int userId)

    Vérifiez si un utilisateur donné est en cours d'exécution.

    Paramètres
    userId int

    Retour
    boolean Vrai si l'utilisateur est en cours d'exécution, faux dans tous les autres cas.

    Jetés
    DeviceNotAvailableException

    Isusersecondary

    public boolean isUserSecondary (int userId)

    Renvoyez si l'utilisateur spécifié est un utilisateur secondaire en fonction de ses indicateurs.

    Paramètres
    userId int

    Retour
    boolean vrai si l'utilisateur est secondaire, faux sinon.

    Jetés
    DeviceNotAvailableException

    isUservisible

    public boolean isUserVisible (int userId)

    Vérifie si l'utilisateur donné est visible.

    Un utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et est donc capable de lancer des activités de lancement (généralement dans l'affichage par défaut).

    Paramètres
    userId int

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    iSUservisibleondisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    Vérifie si l'utilisateur donné est visible dans l'écran donné.

    Un utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et est donc en mesure de lancer des activités de lancement dans cet écran.

    Paramètres
    userId int

    displayId int

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    isvisiblebackgroundUsersondefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Renvoie si l'appareil permet aux utilisateurs d'être démarrés visibles en arrière-plan dans l' ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

    Si c'est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean) , en passant un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers() (qui devrait inclure ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    isvisiblebackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

    Renvoie si l'appareil permet aux utilisateurs d'être démarrés visibles en arrière-plan.

    Si c'est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean) , en passant un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers() .

    Retour
    boolean

    Jetés
    DeviceNotAvailableException

    iswifienabled

    public boolean isWifiEnabled ()

    Tester si le wifi est activé.

    Vérifie si le wifi est activé sur l'appareil. Utile pour affirmer le statut WiFi avant les tests qui ne devraient pas fonctionner avec le WiFi, par exemple les tests de données mobiles.

    Retour
    boolean true si le wifi est activé. false si désactivé

    Jetés
    DeviceNotAvailableException

    listDisplayids

    public  listDisplayIds ()

    Collectez la liste de l'ID d'affichage disponible sur l'appareil comme indiqué par "Dumpsys Surfaceflinger".

    Retour
    La liste des écrans. La valeur par défaut renvoie toujours l'affichage par défaut 0.

    Jetés
    DeviceNotAvailableException

    listDisplayidsForStartingVisibleBackBoungusers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    Obtient la liste des écrans qui peuvent être utilisés pour start a user visible in the background .

    Retour

    Jetés
    DeviceNotAvailableException

    listes

    public  listUsers ()

    Obtient la liste des utilisateurs sur l'appareil. Jetera DeviceRuntimeException si la sortie de l'appareil n'est pas comme prévu.

    Retour
    La liste des ID utilisateur.

    Jetés
    DeviceNotAvailableException

    Loganrs

    public boolean logAnrs (ITestLogger logger)

    Recueille et enregistre les anrs à partir de l'appareil.

    Paramètres
    logger ITestLogger : un ITestLogger pour enregistrer les anrs.

    Retour
    boolean Vrai si l'exploitation forestière a réussi, fausse autrement.

    Jetés
    DeviceNotAvailableException

    logbugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Méthode d'assistance pour prendre un BugReport et le connecter aux journalistes.

    Paramètres
    dataName String : Nom sous lequel le BugReport sera signalé.

    listener ITestLogger : un ITestLogger pour enregistrer le bugReport.

    Retour
    boolean Vrai si l'exploitation forestière a réussi, fausse autrement.

    logondevice

    public 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ûr qui ne lancera pas 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 de message.

    args Object : les args à remplacer via string.format ().

    montdebugfs

    public void mountDebugfs ()

    Mount Debugfs.

    Jetés
    DeviceNotAvailableException

    non-blockreboot

    public void nonBlockingReboot ()

    Issume une commande pour redémarrer le périphérique et revient sur la commande complète et lorsque le périphérique n'est plus visible à la BAD.

    Jetés
    DeviceNotAvailableException

    postadbrootaction

    public void postAdbRootAction ()

    Remplacez si l'appareil a besoin de certaines mesures spécifiques à prendre après la racine ADB et avant que l'appareil ne soit de retour en ligne. L'implémentation par défaut n'inclut aucune action d'addition. La racine ADB n'est pas garantie d'être activée à ce stade.

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

    postadbunrootaction

    public void postAdbUnrootAction ()

    Remplacez si l'appareil a besoin de certaines mesures spécifiques à prendre après un ADB Uniot et avant que l'appareil ne soit de retour en ligne. L'implémentation par défaut n'inclut aucune action supplémentaire. La racine ADB n'est pas garantie d'être désactivée à ce stade.

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

    postbootsetup

    public void postBootSetup ()

    Effectuez des instructions pour configurer le périphérique pour tester cela après chaque démarrage.

    Doit être appelé après que l'appareil soit entièrement démarré / disponible

    Dans des circonstances normales, cette méthode n'a pas besoin d'être appelé explicitement, car les implémentations doivent effectuer ces étapes automatiquement lors de l'exécution d'un redémarrage.

    Où il peut être appelé, c'est quand le redémarrage du périphérique en raison d'autres événements (par exemple, lorsqu'une commande de mise à jour Fastboot est terminée)

    Jetés
    DeviceNotAvailableException

    PostinvocationTeardown

    public void postInvocationTearDown (Throwable exception)

    Des étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui seront exécutés une fois l'invocation terminée.

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

    préinvocations

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

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

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

    Jetés
    DeviceNotAvailableException
    TargetSetupError

    pulldir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Tirez récursivement le contenu du répertoire de l'appareil.

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

    localDir File : le répertoire local pour extraire des fichiers dans

    Retour
    boolean true if file was pulled successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    Paramètres
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    Retour
    boolean true if file was retrieved successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Paramètres
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    Retour
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lancers
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Paramètres
    remoteFilePath String : the absolute path to file on device.

    Retour
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lancers
    DeviceNotAvailableException

    pullFile

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

    Retrieves a file off device.

    Paramètres
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    Retour
    boolean true if file was retrieved successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Paramètres
    remoteFilePath String : the absolute path to file on device.

    Retour
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lancers
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    Paramètres
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    Retour
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lancers
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    Paramètres
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    Retour
    boolean true if file was pushed successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Paramètres
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    Retour
    boolean true if file was pushed successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    Paramètres
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    Retour
    boolean true if file was pushed successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    Paramètres
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    Retour
    boolean true if file was pushed successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    Paramètres
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    Retour
    boolean true if string was pushed successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    redémarrer

    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    Paramètres
    reason String : a reason for this reboot, or null if no reason is specified.

    Lancers
    DeviceNotAvailableException

    redémarrer

    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Lancers
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Lancers
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Lancers
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Lancers
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Lancers
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Paramètres
    autoReboot boolean : whether to automatically reboot the device after sideload

    Lancers
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Jetés
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Paramètres
    reason String : a reason for this reboot, or null if no reason is specified.

    Lancers
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    AVERTISSEMENT. Userspace reboot is currently under active development, use it on your own risk.

    Lancers
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Lancers
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

    Retour
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    Lancers
    DeviceNotAvailableException if device is no longer available

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    Paramètres
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    Lancers
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Lancers
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    Lancers
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Lancers
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Remove given device admin in given user and return true if it is successful, false otherwise.

    Paramètres
    componentName String : of device admin to be removed.

    userId int : of user that the device admin lives in.

    Retour
    boolean True if it is successful, false otherwise.

    Lancers
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    Lancers
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Remove a given user from the device.

    Paramètres
    userId int : of the user to remove

    Retour
    boolean true if we were successful in removing the user, false otherwise.

    Lancers
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests

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

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    Paramètres
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    Retour
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Lancers
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    Paramètres
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    Retour
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Lancers
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    Paramètres
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Retour
    boolean

    Lancers
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    Paramètres
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Retour
    boolean

    Lancers
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Injects the IConfiguration in use.

    Paramètres
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Paramètres
    avdInfo GceAvdInfo

    régler la date

    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Paramètres
    date Date : specify a particular date; will use host date if null

    Jetés
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Set a device admin component as device owner in given user.

    Paramètres
    componentName String : of device admin to be device owner.

    userId int : of the user that the device owner lives in.

    Retour
    boolean True if it is successful, false otherwise.

    Lancers
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    Paramètres
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    Paramètres
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    Paramètres
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    Paramètres
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    Paramètres
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    Paramètres
    newDevice IDevice : the IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    Paramètres
    delay int : the delay in ms

    définirOptions

    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Paramètres
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    Paramètres
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    Retour
    boolean returns True if the setprop command was successful, False otherwise.

    Lancers
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    Paramètres
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    Paramètres
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting

    public void setSetting (String namespace, 
                    String key, 
                    String value)

    See setSetting(int, String, String, String) and performed on system user.

    Paramètres
    namespace String

    key String

    value String

    Lancers
    DeviceNotAvailableException

    setSetting

    public void setSetting (int userId, 
                    String namespace, 
                    String key, 
                    String value)

    Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

    Paramètres
    userId int

    namespace String

    key String

    value String

    Jetés
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    Paramètres
    testLogger ITestLogger

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    Paramètres
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startUser

    public boolean startUser (int userId)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

    Paramètres
    userId int : of the user to start in the background

    Retour
    boolean true if the user was successfully started in the background.

    Lancers
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

    Paramètres
    userId int : of the user to start in the background

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Retour
    boolean true if the user was successfully started in the background.

    Lancers
    DeviceNotAvailableException

    startVisibleBackgroundUser

    public boolean startVisibleBackgroundUser (int userId, 
                    int displayId, 
                    boolean waitFlag)

    Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

    NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

    Paramètres
    userId int : of the user to start in the background

    displayId int : display to start user visible on

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Retour
    boolean true if the user was successfully started visible in the background.

    Jetés
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopUser

    public boolean stopUser (int userId)

    Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

    Paramètres
    userId int : of the user to stop.

    Retour
    boolean true if the user was successfully stopped.

    Lancers
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId, 
                    boolean waitFlag, 
                    boolean forceFlag)

    Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

    Paramètres
    userId int : of the user to stop.

    waitFlag boolean : will make the command wait until user is stopped.

    forceFlag boolean : will force stop the user.

    Retour
    boolean true if the user was successfully stopped.

    Lancers
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    Retour
    String the tcp serial number or null if device could not be switched

    Lancers
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    Retour
    boolean true if switch was successful, false otherwise.

    Lancers
    DeviceNotAvailableException

    changer d'utilisateur

    public boolean switchUser (int userId)

    Switch to another userId with a default timeout. switchUser(int, long) .

    Paramètres
    userId int

    Retour
    boolean True if the new userId matches the userId provider. False otherwise.

    Jetés
    DeviceNotAvailableException

    changer d'utilisateur

    public boolean switchUser (int userId, 
                    long timeout)

    Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

    Paramètres
    userId int

    timeout long : to wait before returning false for switch-user failed.

    Retour
    boolean True if the new userId matches the userId provider. False otherwise.

    Lancers
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    Paramètres
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    Retour
    boolean true if files were synced successfully. false sinon.

    Lancers
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

    Retour
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    Paramètres
    packageName String : the Android package to uninstall

    Retour
    String a String with an error code, or null if success.

    Lancers
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    Paramètres
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

    Retour
    String a String with an error code, or null if success.

    Lancers
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    Retour
    boolean true if successful or if the device is unencrypted.

    Lancers
    DeviceNotAvailableException

    démonterDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    Lancers
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    Paramètres
    timeOut long : time in msecs to wait for the flag to be set

    Retour
    boolean true if device's boot complete flag is set within the timeout

    Lancers
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    Retour
    boolean True if device is available, False if recovery is disabled and unavailable.

    Lancers
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Paramètres
    waitTime long : the time in ms to wait

    Retour
    boolean True if device is available, False if recovery is disabled and unavailable.

    Lancers
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    Paramètres
    waitTime long

    Retour
    boolean True if device is available, False if unavailable.

    Lancers
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Lancers
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Paramètres
    waitTime long : the time in ms to wait

    Retour
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Paramètres
    waitTime long : the time in ms to wait

    Retour
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Paramètres
    waitTime long : the time in ms to wait

    Retour
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Lancers
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Paramètres
    waitTime long : the time in ms to wait

    Lancers
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Paramètres
    waitTime long : the time in ms to wait

    Retour
    boolean true if device becomes responsive before waitTime elapses.

    Méthodes protégées

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Paramètres
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Builds the OS command for the given adb shell command session and args

    Paramètres
    command String

    forceExitStatusDetection boolean

    Retour
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Paramètres
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Create a RebootDeviceAction to be used when performing a reboot action.

    Paramètres
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Retour
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil

    protected IRunUtil createRunUtil ()

    Retour
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Perform a adb reboot.

    Paramètres
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Lancers
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

    Lancers
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Retour
    int

    getLogger

    protected ITestLogger getLogger ()

    Retour
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    Retour
    IRunUtil

    initializeConnection

    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Paramètres
    info IBuildInfo

    attributes MultiMap

    Lancers
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    Paramètres
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    Retour
    String A string, possibly null or empty, containing the value of the given property

    Lancers
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    Retour
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    Paramètres
    localFile File

    entry IFileEntry

    Retour
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

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

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

    Lancers
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    Paramètres
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    Retour
    boolean true if action was performed successfully

    Lancers
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success

    postAdbReboot

    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

    Lancers
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

    Lancers
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Paramètres
    remoteFilePath String

    localFile File

    Retour
    boolean

    Lancers
    DeviceNotAvailableException

    Réglage de l'horloge

    protected void setClock (Clock clock)

    Set the Clock instance to use.

    Paramètres
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    Paramètres
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Paramètres
    deviceOptions

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Executes a simple fastboot command with environment variables and report the status of the command.

    Paramètres
    timeout long

    envVarMap

    fullCmd String

    Retour
    CommandResult

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Executes a simple fastboot command and report the status of the command.

    Paramètres
    timeout long

    fullCmd String

    Retour
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    Paramètres
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    Retour
    boolean True if device did become unavailable.