Appareil natif
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
Implémentation par défaut d'un appareil Android ITestDevice
non full stack.
Résumé
Classes imbriquées | |
---|---|
class |
NativeDevice.AdbAction
|
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Constantes | |
---|---|
int |
INVALID_USER_ID
Valeur renvoyée pour tout ID utilisateur non valide/introuvable: UserHandle a défini la valeur -10000. |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
le nombre de tentatives d'exécution de la commande par défaut |
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 |
Méthodes publiques | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Micro-optimisation (environ 400 millisecondes) en préchargeant tous les accessoires dont nous avons besoin au lieu d'appeler "adb" getprop' pour chacune d'entre elles. |
boolean
|
canSwitchToHeadlessSystemUser()
Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Vérifier si une fonctionnalité est actuellement compatible avec un niveau de compatibilité minimal. |
boolean
|
checkConnectivity()
Vérifiez que l'appareil est connecté au réseau. |
boolean
|
clearErrorDialogs()
Essayez de fermer les boîtes de dialogue d'erreur affichées dans l'interface utilisateur de l'appareil. |
void
|
clearLastConnectedWifiNetwork()
Efface le dernier réseau Wi-Fi connecté. |
void
|
clearLogcat()
Supprime toutes les données logcat accumulées. |
boolean
|
connectToWifiNetwork(
Se connecte à un réseau Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Se connecte à un réseau Wi-Fi. |
boolean
|
connectToWifiNetwork(
Se connecte à un réseau Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Se connecte à un réseau Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Variante de |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Variante de |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Créer un utilisateur avec un nom donné et les options fournies |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Créer un utilisateur avec un nom donné et les options fournies |
int
|
createUser(String name)
Créez un utilisateur avec un nom donné et les indicateurs par défaut de 0. |
int
|
createUserNoThrow(String name)
Créez un utilisateur avec un nom donné et les indicateurs par défaut de 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil. |
void
|
deleteFile(String deviceFilePath)
Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Supprime le |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible en comparant le serveur system_server actuel avec
Le |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible depuis l'heure UTC depuis l'epoch
appareil et son |
boolean
|
disableAdbRoot()
Désactive la racine adb. |
void
|
disableKeyguard()
Tente de désactiver la protection du clavier. |
boolean
|
disableNetworkMonitor()
Désactive la surveillance du réseau sur l'appareil. |
boolean
|
disconnectFromWifi()
Se déconnecte d'un réseau Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Méthode d'assistance permettant de déterminer si un fichier sur l'appareil existe pour un utilisateur donné. |
boolean
|
doesFileExist(String deviceFilePath)
Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil. |
File
|
dumpHeap(String process, String devicePath)
Essayez de vider le tas de mémoire à partir de system_server. |
boolean
|
enableAdbRoot()
Active la racine adb. |
boolean
|
enableNetworkMonitor()
Active 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'expiration spécifié. |
String
|
executeAdbCommand(long timeout,
Méthode d'assistance qui exécute une commande adb en tant que commande système avec un délai d'expiration 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'inactivité 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(
Méthode d'assistance qui exécute une commande fastboot de longue durée en tant que commande système avec l'état système variables d'environnement. |
String
|
executeShellCommand(String command)
Méthode d'assistance qui exécute une commande shell adb et renvoie le résultat en tant que |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Exécute la commande shell adb donnée, en effectuant plusieurs tentatives 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 la forme d'un élément |
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 élément |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément |
CommandResult
|
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 de l'appareil. |
|
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()
Renvoyer l'état d'allocation actuel de l'appareil |
String
|
getAndroidId(int userId)
Recherchez et renvoyez l'android-id associé à un userId. La valeur "null" est absente si vous ne l'avez pas trouvé. |
|
getAndroidIds()
Créer une carte des identifiants Android trouvés pour les ID utilisateur correspondants. |
int
|
getApiLevel()
Obtenir le niveau d'API de l'appareil |
PackageInfo
|
getAppPackageInfo(String packageName)
Récupérer des informations sur un package installé sur l'appareil |
|
getAppPackageInfos()
Récupère des informations sur les packages installés sur l'appareil. |
String
|
getBasebandVersion()
Méthode pratique permettant d'obtenir la version bande de base (radio) de cet appareil. |
Integer
|
getBattery()
Renvoie le niveau de batterie actuel d'un appareil, ou la valeur "null" si le niveau de batterie n'est pas disponible. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Renvoie la valeur booléenne d'une propriété donnée. |
|
getBootHistory()
La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps de démarrage et le motif de démarrage le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée. |
String
|
getBootloaderVersion()
Méthode pratique permettant d'obtenir la version du bootloader 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 compilation en cours d'exécution par l'appareil. |
String
|
getBuildFlavor()
Récupérez le type de compilation pour l'appareil. |
String
|
getBuildId()
Récupérez la version en cours d'exécution de l'appareil. |
String
|
getBuildSigningKeys()
Renvoie le type de clé utilisé pour signer l'image de l'appareil En règle générale, les appareils Android peuvent être signés avec des clés de test (comme dans AOSP) ou des clés de version (contrôlé par des fabricants d'appareils individuels) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Renvoie un |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Renvoie un |
String[]
|
getChildren(String path)
Alternative à l'utilisation de |
AbstractConnection
|
getConnection()
Connexion actuelle associée à l'appareil. |
ContentProviderHandler
|
getContentProvider(int userId)
Renvoie |
DeviceFoldableState
|
getCurrentFoldableState()
Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème. |
int
|
getCurrentUser()
Renvoie l'identifiant de l'utilisateur actuel. |
String
|
getDeviceClass()
Permet d'obtenir la classe de l'appareil. |
long
|
getDeviceDate()
Renvoie la date de l'appareil en millisecondes depuis l'epoch. |
DeviceDescriptor
|
getDeviceDescriptor()
Renvoyez un |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Renvoyez un |
TestDeviceState
|
getDeviceState()
Obtenez l'état de l'appareil. |
long
|
getDeviceTimeOffset(Date date)
Outil d'aide pour obtenir le décalage horaire entre l'appareil et un |
InputStreamSource
|
getEmulatorOutput()
Obtenir le flux de l'émulateur stdout et stderr |
Process
|
getEmulatorProcess()
Renvoyez le |
final
File
|
getExecuteShellCommandLog()
Journal contenant tous les journaux |
long
|
getExternalStoreFreeSpace()
Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la mémoire de stockage externe de l'appareil. |
String
|
getFastbootPath()
Renvoie le chemin d'accès au binaire fastboot utilisé. |
String
|
getFastbootProductType()
Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot. |
String
|
getFastbootProductVariant()
Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot. |
String
|
getFastbootSerialNumber()
Renvoie le numéro de série du mode fastboot. |
String
|
getFastbootVariable(String variableName)
Récupérez la valeur de variable fastboot donnée à partir de l'appareil. |
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 un appareil |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Outil d'aide non officiel pour obtenir un |
|
getFoldableStates()
Renvoie la liste des états des appareils pliables sur l'appareil. |
IDevice
|
getIDevice()
Renvoie une référence au fichier ddmlib |
|
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 de l'appareil. |
String
|
getIpAddress()
Récupère l'adresse IP de l'appareil. |
KeyguardControllerState
|
getKeyguardState()
Renvoyez un objet pour obtenir l'état actuel du verrouillage du clavier ou la valeur "null" si cette fonctionnalité n'est pas disponible. |
long
|
getLastExpectedRebootTimeMillis()
Renvoie la dernière fois où les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH en tant que
renvoyé par |
int
|
getLaunchApiLevel()
Permet d'obtenir le premier niveau d'API lancé sur l'appareil. |
InputStreamSource
|
getLogcat()
Récupère un flux d'instantanés des données logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Récupère un flux d'instantanés de la dernière |
InputStreamSource
|
getLogcatDump()
Obtenir un vidage du logcat actuel pour l'appareil |
InputStreamSource
|
getLogcatSince(long date)
Récupère un flux d'instantanés des données logcat capturées à partir de la date fournie. |
String
|
getMacAddress()
Renvoie l'adresse MAC de l'appareil, qui est nulle si la requête échoue. |
Integer
|
getMainUserId()
Renvoie l'ID utilisateur principal. |
|
getMainlineModuleInfo()
Obtenez les informations sur les modules principaux installés sur l'appareil. |
int
|
getMaxNumberOfRunningUsersSupported()
Obtenir le nombre maximal d'utilisateurs pouvant s'exécuter simultanément |
int
|
getMaxNumberOfUsersSupported()
Obtenir le nombre maximal d'utilisateurs pris en charge |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Renvoie le |
String
|
getMountPoint(String mountName)
Renvoie un point d'installation. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Renvoie un |
|
getMountPointInfo()
Renvoie une version analysée des informations contenues dans /proc/mounts sur l'appareil. |
TestDeviceOptions
|
getOptions()
Récupérez les options de test pour l'appareil. |
long
|
getPartitionFreeSpace(String partition)
Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la partition de l'appareil. |
Integer
|
getPrimaryUserId()
Renvoie l'identifiant de l'utilisateur principal. |
ProcessInfo
|
getProcessByName(String processName)
La méthode d'assistance exécute la fonction "pidof" et "stat" et renvoie l'objet |
String
|
getProcessPid(String process)
Renvoie le pid du service ou la valeur "null" en cas de problème. |
String
|
getProductType()
Méthode pratique permettant d'obtenir le type de produit de cet appareil. |
String
|
getProductVariant()
Méthode pratique permettant d'obtenir la variante du produit de cet appareil. |
String
|
getProperty(String name)
Récupère la valeur de propriété donnée à partir de l'appareil. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Obtenez le mode de récupération actuellement utilisé pour l'appareil. |
InputStreamSource
|
getScreenshot(String format)
Permet de prendre une capture d'écran de l'appareil. |
InputStreamSource
|
getScreenshot(long displayId)
Récupère une capture d'écran de l'appareil correspondant à l'identifiant d'affichage. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Permet de prendre une capture d'écran de l'appareil. |
InputStreamSource
|
getScreenshot()
Permet de prendre une capture d'écran de l'appareil. |
String
|
getSerialNumber()
Méthode pratique permettant d'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 |
String
|
getSimOperator()
Renvoyez l'opérateur de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible. |
String
|
getSimState()
Renvoyez l'état de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible. |
|
getTombstones()
Récupérez et renvoyez la liste des tombstones des appareils. |
long
|
getTotalMemory()
Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne. |
String
|
getTrackingSerial()
Pour gérer les appareils, récupérez le numéro de série utilisé pour le suivre. |
|
getUninstallablePackageNames()
Récupérez les noms des packages d'application qui peuvent être désinstallés. |
boolean
|
getUseFastbootErase()
Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil. |
int
|
getUserFlags(int userId)
Rechercher et renvoyer les indicateurs d'un utilisateur donné |
|
getUserInfos()
Récupère la carte de useId sur |
int
|
getUserSerialNumber(int userId)
Renvoyez le numéro de série associé à l'ID utilisateur s'il est trouvé, et -10000 dans les autres cas. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Traitement de l'événement DeviceEvent donné. Traiter DeviceEvent, qui peut ou non faire passer cet appareil à une nouvelle allocation de l'état. |
boolean
|
hasFeature(String feature)
Vérifier si une fonctionnalité est disponible sur un appareil |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Installer un package Android sur l'appareil |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installer un package Android sur l'appareil |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Installer un package Android sur l'appareil d'un utilisateur donné |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installer un package Android sur l'appareil d'un utilisateur donné |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Vérifier si la plate-forme de l'appareil est compatible avec l'énumération d'applications |
boolean
|
isBypassLowTargetSdkBlockSupported()
Vérifier si la plate-forme sur l'appareil permet de contourner le blocage du SDK cible faible lors des installations d'applications |
boolean
|
isDebugfsMounted()
Vérifiez si debugfs est installé. |
boolean
|
isDeviceEncrypted()
Indique si l'appareil est chiffré. |
boolean
|
isDirectory(String path)
Renvoyez la valeur "True" si le chemin d'accès sur l'appareil est un répertoire, et la valeur "false" dans le cas contraire. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Indique si l'appareil est compatible avec le chiffrement. |
boolean
|
isExecutable(String fullPath)
Affiche la valeur "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, et la valeur "false" dans le cas contraire. |
boolean
|
isFastbootEnabled()
Renvoyez si fastboot est disponible pour l'appareil. |
boolean
|
isHeadless()
Renvoie la valeur "true" si l'appareil est headless (aucun écran), sinon la valeur "false". |
boolean
|
isHeadlessSystemUserMode()
Indique si l'appareil utilise le mode utilisateur système headless. |
boolean
|
isMainUserPermanentAdmin()
Indique si l'utilisateur principal est un administrateur permanent et si celui-ci ne peut pas être supprimé ou rétrogradé non-administrateur. |
boolean
|
isMultiUserSupported()
Détermine si le mode multi-utilisateur est pris en charge. |
boolean
|
isPackageInstalled(String packageName, String userId)
Interrogez l'appareil à la recherche d'un nom de package et d'un ID utilisateur donnés pour vérifier s'il est actuellement installé ou non pour cet utilisateur. |
boolean
|
isPackageInstalled(String packageName)
Interrogez l'appareil sur le nom de package donné pour vérifier s'il est actuellement installé ou non. |
boolean
|
isRuntimePermissionSupported()
Vérifier si la plate-forme sur l'appareil est compatible avec l'octroi d'autorisations d'exécution |
boolean
|
isStateBootloaderOrFastbootd()
Renvoie la valeur "true" si l'appareil se trouve dans |
boolean
|
isUserRunning(int userId)
Vérifiez si un utilisateur donné est en cours d'exécution. |
boolean
|
isUserSecondary(int userId)
Indique 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 sur l'écran donné. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan dans |
boolean
|
isVisibleBackgroundUsersSupported()
Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan. |
boolean
|
isWifiEnabled()
Vérifiez si le Wi-Fi est activé. |
|
listDisplayIds()
Collecter la liste des identifiants d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys" SurfaceFlinger". |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Récupère la liste des écrans pouvant être utilisés pour |
|
listUsers()
Récupère la liste des utilisateurs de l'appareil. |
boolean
|
logAnrs(ITestLogger logger)
Recueille et consigne les erreurs ANR de l'appareil. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Méthode d'assistance permettant de générer un rapport de bug et de le consigner pour les reporters. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Consigner un message dans le fichier logcat de l'appareil. |
void
|
mountDebugfs()
Installation de debugfs |
void
|
nonBlockingReboot()
Émet une commande pour redémarrer l'appareil et renvoie une commande terminée et plus visible par adb. |
void
|
postAdbRootAction()
À remplacer si l'appareil nécessite des actions spécifiques après la racine adb et avant la l'appareil est à nouveau connecté. |
void
|
postAdbUnrootAction()
À remplacer si l'appareil nécessite des actions spécifiques après le retrait d'adb et avant l'appareil est à nouveau connecté. |
void
|
postBootSetup()
Suivez les instructions pour configurer l'appareil afin de le tester après chaque démarrage. |
void
|
postInvocationTearDown(Throwable exception)
Des étapes supplémentaires pour un nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est terminé. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Étapes supplémentaires pour une configuration spécifique à l'appareil qui sera exécutée sur l'appareil avant le flux d'appel. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Récupérez de manière récursive le contenu du répertoire de l'appareil. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Récupérez de manière récursive le contenu du répertoire de l'appareil. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Récupère un fichier depuis l'appareil. |
File
|
pullFile(String remoteFilePath, int userId)
Récupère un fichier depuis l'appareil, le stocke dans un |
File
|
pullFile(String remoteFilePath)
Récupère un fichier depuis l'appareil, le stocke dans un |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Récupère un fichier depuis l'appareil. |
String
|
pullFileContents(String remoteFilePath)
Récupère un fichier depuis l'appareil, puis renvoie son contenu. |
File
|
pullFileFromExternal(String remoteFilePath)
Méthode pratique permettant de récupérer un fichier de la mémoire de stockage externe de l'appareil, en le stockant dans un
|
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Transférez le contenu du répertoire de manière récursive sur l'appareil tout en excluant certains répertoires filtrée. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Transférez le contenu du répertoire de manière récursive sur l'appareil. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Transférez le contenu du répertoire de manière récursive sur l'appareil. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante de |
boolean
|
pushFile(File localFile, String remoteFilePath)
Transférer un fichier sur l'appareil |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Transférer un fichier sur l'appareil |
boolean
|
pushString(String contents, String remoteFilePath)
Envoyer le fichier créé à partir d'une chaîne vers l'appareil |
void
|
reboot(String reason)
Redémarre l'appareil en mode adb avec la valeur |
void
|
reboot()
Redémarre l'appareil en mode adb. |
void
|
rebootIntoBootloader()
Redémarre l'appareil en mode bootloader. |
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 de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération). Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant |
void
|
rebootIntoSideload(boolean autoReboot)
Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération). Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant |
void
|
rebootUntilOnline()
Alternative à |
void
|
rebootUntilOnline(String reason)
Alternative à |
void
|
rebootUserspace()
Redémarre uniquement une partie de l'espace utilisateur de l'appareil. |
void
|
rebootUserspaceUntilOnline()
Autre solution à |
boolean
|
recoverDevice()
Tentatives de récupération de la communication de l'appareil. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Enregistre un |
void
|
remountSystemReadOnly()
Rendez la partition système de l'appareil en lecture seule. |
void
|
remountSystemWritable()
Rendez la partition système de l'appareil accessible en écriture. |
void
|
remountVendorReadOnly()
Définissez la partition du fournisseur sur l'appareil en lecture seule. |
void
|
remountVendorWritable()
Rendez la partition du fournisseur accessible en écriture sur l'appareil. |
boolean
|
removeAdmin(String componentName, int userId)
Supprimer l'administrateur de l'appareil indiqué pour l'utilisateur concerné et renvoyer |
void
|
removeOwners()
Supprimez au mieux tous les propriétaires existants de profils sur l'appareil. |
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 de nouveau. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Méthode pratique permettant d'exécuter |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Exécute des tests d'instrumentation et permet de récupérer l'appareil. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Identique à |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Identique à |
void
|
setConfiguration(IConfiguration configuration)
Il injecte les |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Définit la date sur l'appareil Remarque: Pour définir la date sur l'appareil, vous devez être en mode root |
boolean
|
setDeviceOwner(String componentName, int userId)
Définissez un composant d'administrateur 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 |
void
|
setEmulatorProcess(Process p)
Définit |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Définissez l'option fastboot pour l'appareil. |
void
|
setFastbootPath(String fastbootPath)
Définit le chemin d'accès au binaire fastboot à utiliser. |
void
|
setIDevice(IDevice newDevice)
Mettez à jour l'IDevice associé à cet ITestDevice. |
void
|
setLogStartDelay(int delay)
Définit le délai d'attente, en millisecondes, avant de lancer la capture logcat pour un appareil en ligne. |
void
|
setOptions(TestDeviceOptions options)
Définir le |
boolean
|
setProperty(String propKey, String propValue)
Définit la valeur de propriété donnée sur l'appareil. |
void
|
setRecovery(IDeviceRecovery recovery)
Définissez les |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Définissez le mode de récupération à utiliser pour l'appareil. |
void
|
setSetting(String namespace, String key, String value)
Voir |
void
|
setSetting(int userId, String namespace, String key, String value)
Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné. |
void
|
setTestLogger(ITestLogger testLogger)
Il injecte l'instance |
void
|
setTrackingSerial(String trackingSerial)
Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer l'appareil. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil. |
void
|
startLogcat()
Commencez à capturer la sortie logcat de l'appareil en arrière-plan. |
boolean
|
startUser(int userId)
Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. |
boolean
|
startUser(int userId, boolean waitFlag)
Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui signifie que l'utilisateur pour lancer des activités sur cet affichage). |
void
|
stopEmulatorOutput()
Fermez et supprimez la sortie de l'émulateur. |
void
|
stopLogcat()
Arrêtez la capture de 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êter 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)
Passez à un autre ID utilisateur avec un délai d'inactivité par défaut. |
boolean
|
switchUser(int userId, long timeout)
Passez à un autre ID utilisateur avec le délai d'expiration fourni comme délai. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Synchronise de manière incrémentielle le contenu d'un répertoire de fichiers local sur l'appareil. |
Bugreport
|
takeBugreport()
Créez un rapport de bug et renvoyez-le dans un objet |
String
|
uninstallPackage(String packageName)
Désinstaller un package Android de l'appareil |
String
|
uninstallPackageForUser(String packageName, int userId)
Désinstallez un package Android de l'appareil d'un utilisateur donné. |
boolean
|
unlockDevice()
Déverrouille l'appareil s'il est chiffré. |
void
|
unmountDebugfs()
Désinstallez debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Bloque jusqu'à ce que l'indicateur de démarrage terminé de l'appareil soit défini. |
boolean
|
waitForDeviceAvailable()
Attend que l'appareil réponde et soit disponible pour des tests. |
boolean
|
waitForDeviceAvailable(long waitTime)
Attend que l'appareil réponde et soit disponible pour des 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 l'appareil soit visible en fastboot. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Blocs pour que l'appareil soit dans la récupération adb (notez qu'il ne s'agit pas
|
boolean
|
waitForDeviceInSideload(long waitTime)
Blocs pour que l'appareil soit dans le téléchargement indépendant adb état |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blocages pour que l'appareil soit indisponible, c'est-à-dire absent d'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 adb shell de base. |
Méthodes protégées | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Crée la commande OS pour la session de commande shell adb et les arguments donnés. |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Créez un |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Effectuez un redémarrage adb. |
void
|
ensureRuntimePermissionSupported()
Méthode d'assistance permettant de générer une exception si l'autorisation d'exécution n'est pas prise en charge |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Obtenez l'instance |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Récupère une propriété d'appareil, à partir du cache ddmlib par défaut, et en revenant à adb shell getprop" ou "fastboot getvar", selon que l'appareil est en Fastboot ou non. |
boolean
|
isInRebootCallback()
Indique si des rappels de redémarrage sont en cours d'exécution ou non. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Renvoie |
void
|
notifyRebootEnded()
Notifie toutes les |
void
|
notifyRebootStarted()
Notifie toutes les |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Effectue une action sur cet appareil. |
void
|
postAdbReboot()
Actions supplémentaires possibles après un redémarrage. |
void
|
prePostBootSetup()
Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Définissez l'instance Clock à utiliser. |
void
|
setMicrodroidProcess(Process process)
Marque l'appareil TestDevice comme microdroid et définit son numéro client. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Exécute une commande fastboot simple avec des variables d'environnement et indique l'état du . |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Exécute une commande fastboot simple et indique l'état de la commande. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Attendez que l'appareil devienne indisponible (arrêtez de signaler à adb). |
Constantes
ID_UTILISATEUR_NON_VALIDE
public static final int INVALID_USER_ID
Valeur renvoyée pour tout ID utilisateur non valide/introuvable: UserHandle a défini la valeur -10000.
Valeur constante: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Valeur constante: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
le nombre de tentatives d'exécution de la commande par défaut
Valeur constante: 2. (0x00000002)
Champs
CHEMIN_DEBUGFS
public static final String DEBUGFS_PATH
CARTE_SD
protected static final String SD_CARD
STOCKAGE_ÉMULÉ
protected static final String STORAGE_EMULATED
Constructeurs publics
Appareil natif
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crée un TestDevice
.
Paramètres | |
---|---|
device |
IDevice : le IDevice associé |
stateMonitor |
IDeviceStateMonitor : mécanisme IDeviceStateMonitor à utiliser |
allocationMonitor |
IDeviceMonitor : IDeviceMonitor pour informer les changements d'état d'allocation.
Peut être nul |
Méthodes publiques
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Micro-optimisation (environ 400 millisecondes) en préchargeant tous les accessoires dont nous avons besoin au lieu d'appeler "adb" getprop' pour chacune d'entre elles. Autrement dit, récupérer toutes les propriétés est aussi rapide qu'une propriété. Des éléments tels que device.getApiLevel(), checkApiLevelAgainstNextRelease et getBuildAlias font tous l'appel "adb getprop" en arrière-plan. Nous les récupérons en un seul appel et appelons "NativeDevice.setProperty". Même si nous ne le faisons pas, NativeDevice appellera setProperty et mettra en cache le résultat pour les prochains appels. C'est ce que nous faisons un peu plus tôt. Si l'appareil est en cours de récupération d'autres erreurs lors de la récupération des props, nous les ignorons.
CanSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Vérifier si une fonctionnalité est actuellement compatible avec un niveau de compatibilité minimal. Ce prend en compte les fonctionnalités qui n'ont pas encore été publiées, avant que le niveau d'API ne soit augmenté.
Paramètres | |
---|---|
strictMinLevel |
int : niveau minimal strict possible pour la fonctionnalité. |
Renvoie | |
---|---|
boolean |
"True" si le niveau est accepté. Sinon, cette valeur est "false". |
Génère | |
---|---|
DeviceNotAvailableException |
vérifier la connectivité
public boolean checkConnectivity ()
Vérifiez que l'appareil est connecté au réseau.
Renvoie | |
---|---|
boolean |
true si la connexion réseau de l'appareil fonctionne
false en excès. |
Génère | |
---|---|
DeviceNotAvailableException |
ClearErrorDialogs
public boolean clearErrorDialogs ()
Essayez de fermer les boîtes de dialogue d'erreur affichées dans l'interface utilisateur de l'appareil.
Renvoie | |
---|---|
boolean |
true si aucune boîte de dialogue n'était présente ou si les boîtes de dialogue ont bien été effacées.
false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
ClearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Efface le dernier réseau Wi-Fi connecté. Ce nom doit être appelé lors du démarrage d'un nouvel appel pour éviter de vous connecter au réseau Wi-Fi utilisé lors du test précédent après le redémarrage de l'appareil.
ClearLogcat
public void clearLogcat ()
Supprime toutes les données logcat accumulées.
Cela est utile lorsque vous voulez vous assurer que ITestDevice#getLogcat()
ne renvoie que des
les données de journal générées après un certain point (par exemple, après le flash d'un nouveau build d'appareil, etc.).
se connecter au réseauWi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Se connecte à un réseau Wi-Fi.
Active le Wi-Fi et le bloque jusqu'à ce que la connexion soit établie avec l'un des réseaux Wi-Fi
réseaux donnés dans la
carte wifiSsidToPsk. Une fois la connexion établie, l'instance
restaurer la connexion après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
est appelé.
Paramètres | |
---|---|
wifiSsidToPsk |
: mappage des SSID Wi-Fi aux mots de passe. |
scanSsid |
boolean : rechercher les SSID masqués pour ce réseau |
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
sinon |
Génère | |
---|---|
DeviceNotAvailableException |
se connecter au réseauWi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Se connecte à un réseau Wi-Fi.
Active le Wi-Fi et le bloque jusqu'à ce que la connexion au réseau Wi-Fi spécifié soit établie.
Une fois la connexion établie, l'instance tentera de la restaurer après chaque redémarrage
jusqu'au ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
est appelé.
Paramètres | |
---|---|
wifiSsid |
String : indicateur Wi-Fi auquel se connecter |
wifiPsk |
String : phrase secrète de la clé pré-partagée ou valeur nulle en l'absence de chiffrement |
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
sinon |
Génère | |
---|---|
DeviceNotAvailableException |
se connecter au réseauWi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Se connecte à un réseau Wi-Fi.
Active le Wi-Fi et le bloque jusqu'à ce que la connexion soit établie avec l'un des réseaux Wi-Fi
réseaux donnés dans la
carte wifiSsidToPsk. Une fois la connexion établie, l'instance
restaurer la connexion après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
est appelé.f
Paramètres | |
---|---|
wifiSsidToPsk |
: mappage des SSID Wi-Fi aux mots de passe. |
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
sinon |
Génère | |
---|---|
DeviceNotAvailableException |
se connecter au réseauWi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Se connecte à un réseau Wi-Fi.
Active le Wi-Fi et le bloque jusqu'à ce que la connexion au réseau Wi-Fi spécifié soit établie.
Une fois la connexion établie, l'instance tentera de la restaurer après chaque redémarrage
jusqu'au ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
est appelé.
Paramètres | |
---|---|
wifiSsid |
String : indicateur Wi-Fi auquel se connecter |
wifiPsk |
String : phrase secrète de la clé pré-partagée ou valeur nulle en l'absence de chiffrement |
scanSsid |
boolean : rechercher ou non le SSID masqué pour ce réseau |
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
sinon |
Génère | |
---|---|
DeviceNotAvailableException |
ConnectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Variante de connectToWifiNetwork(String, String)
qui se connecte uniquement si l'appareil
ne dispose actuellement d'aucune connectivité réseau.
Paramètres | |
---|---|
scanSsid |
boolean : rechercher ou non le SSID masqué pour ce réseau |
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
sinon |
Génère | |
---|---|
DeviceNotAvailableException |
ConnectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Variante de connectToWifiNetwork(String, String)
qui se connecte uniquement si l'appareil
ne dispose actuellement d'aucune connectivité réseau.
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
sinon |
Génère | |
---|---|
DeviceNotAvailableException |
créerutilisateur
public int createUser (String name, boolean guest, boolean ephemeral)
Créer un utilisateur avec un nom donné et les options fournies
Paramètres | |
---|---|
name |
String : de l'utilisateur à créer sur l'appareil |
guest |
boolean : activer l'indicateur utilisateur --guest lors de la création |
ephemeral |
boolean : activer l'option utilisateur --ephemeral lors de la création |
Renvoie | |
---|---|
int |
ID de l'utilisateur créé |
Génère | |
---|---|
DeviceNotAvailableException |
créerutilisateur
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Créer un utilisateur avec un nom donné et les options fournies
Paramètres | |
---|---|
name |
String : de l'utilisateur à créer sur l'appareil |
guest |
boolean : activer l'indicateur utilisateur --guest lors de la création |
ephemeral |
boolean : activer l'option utilisateur --ephemeral lors de la création |
forTesting |
boolean : active l'indicateur de test --for-testing lors de la création. |
Renvoie | |
---|---|
int |
ID de l'utilisateur créé |
Génère | |
---|---|
DeviceNotAvailableException |
créerutilisateur
public int createUser (String name)
Créez un utilisateur avec un nom donné et les indicateurs par défaut de 0.
Paramètres | |
---|---|
name |
String : de l'utilisateur à créer sur l'appareil |
Renvoie | |
---|---|
int |
l'entier pour l'ID utilisateur créé |
Génère | |
---|---|
DeviceNotAvailableException |
créerUtilisateurPasDeJeter
public int createUserNoThrow (String name)
Créez un utilisateur avec un nom donné et les indicateurs par défaut de 0.
Paramètres | |
---|---|
name |
String : de l'utilisateur à créer sur l'appareil |
Renvoie | |
---|---|
int |
l'entier pour l'ID utilisateur créé ou -1 pour l'erreur. |
Génère | |
---|---|
DeviceNotAvailableException |
Supprimer le fichier
public void deleteFile (String deviceFilePath, int userId)
Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil.
Paramètres | |
---|---|
deviceFilePath |
String : chemin absolu du fichier sur l'appareil. |
userId |
int : ID utilisateur à supprimer |
Génère | |
---|---|
DeviceNotAvailableException |
Supprimer le fichier
public void deleteFile (String deviceFilePath)
Méthode d'assistance permettant de supprimer un fichier ou un répertoire sur l'appareil.
Paramètres | |
---|---|
deviceFilePath |
String : chemin absolu du fichier sur l'appareil. |
Génère | |
---|---|
DeviceNotAvailableException |
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Supprime le IDeviceActionReceiver
enregistré.
Paramètres | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver qui sera supprimé. |
appareilSoftRedémarré
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible en comparant le serveur system_server actuel avec
Le ProcessInfo
system_server précédent. Utilisez getProcessByName(String)
pour obtenir ProcessInfo
.
Paramètres | |
---|---|
prevSystemServerProcess |
ProcessInfo : ProcessInfo du processus system_server précédent. |
Renvoie | |
---|---|
boolean |
true si l'appareil a redémarré de façon réversible |
Génère | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Méthode d'assistance permettant de vérifier si l'appareil a redémarré de façon réversible depuis l'heure UTC depuis l'epoch
appareil et son ERROR(/TimeUnit)
. Soft-Restart fait référence au
système « system_server » redémarré en dehors d’un
un redémarrage matériel de l'appareil (redémarrage demandé, par exemple) ; L'utcEpochTime de l'appareil actuel dans
Vous pouvez obtenir Milliseccond à l'aide de la méthode getDeviceDate()
.
Paramètres | |
---|---|
utcEpochTime |
long : heure de l'appareil en secondes depuis l'epoch. |
timeUnit |
TimeUnit : unité de temps TimeUnit pour l'objet utcEpochTime donné. |
Renvoie | |
---|---|
boolean |
true si l'appareil a redémarré de façon réversible |
Génère | |
---|---|
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 bloque jusqu'à appareil est disponible.
Renvoie | |
---|---|
boolean |
true si l'opération réussit. |
Génère | |
---|---|
DeviceNotAvailableException |
désactiver la protection des touches
public void disableKeyguard ()
Tente de désactiver la protection du clavier.
Attendez d'abord que l'envoi des entrées soit prêt. Cela se produit au même moment, lorsque la fonction l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car le framework actuel présente une condition de concurrence occasionnelle. Ensuite, la commande est envoyée pour désactiver la protection du clavier (uniquement sur les sites non sécurisés)
Génère | |
---|---|
DeviceNotAvailableException |
désactiver MoniteurRéseau
public boolean disableNetworkMonitor ()
Désactive la surveillance du réseau sur l'appareil.
Renvoie | |
---|---|
boolean |
true si la surveillance est désactivée. false
en cas d'échec. |
Génère | |
---|---|
DeviceNotAvailableException |
déconnecter du Wifi
public boolean disconnectFromWifi ()
Se déconnecte d'un réseau Wi-Fi.
Supprime tous les réseaux de la liste des réseaux connus et désactive le Wi-Fi.
Renvoie | |
---|---|
boolean |
true si la connexion au réseau Wi-Fi aboutit. false
si la déconnexion échoue. |
Génère | |
---|---|
DeviceNotAvailableException |
DoFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Méthode d'assistance permettant de déterminer si un fichier sur l'appareil existe pour un utilisateur donné.
Paramètres | |
---|---|
deviceFilePath |
String : chemin absolu du fichier sur l'appareil à vérifier |
userId |
int : ID utilisateur par rapport auquel l'existence du fichier doit être vérifiée. |
Renvoie | |
---|---|
boolean |
true si le fichier existe, false dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
DoFileExist
public boolean doesFileExist (String deviceFilePath)
Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.
Paramètres | |
---|---|
deviceFilePath |
String : chemin absolu du fichier sur l'appareil à vérifier |
Renvoie | |
---|---|
boolean |
true si le fichier existe, false dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
tas de mémoire
public File dumpHeap (String process, String devicePath)
Essayez de vider le tas de mémoire à partir de system_server. Il incombe à l'appelant de nettoyer le fichier vidé.
Paramètres | |
---|---|
process |
String : nom du processus de l'appareil sur lequel effectuer le vidage du tas. |
devicePath |
String : chemin d'accès sur l'appareil où placer le fichier de vidage. Il doit s'agir d'un emplacement où
les autorisations le permettent. |
Renvoie | |
---|---|
File |
le ERROR(/File) contenant le rapport. Null en cas d'échec. |
Génère | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public boolean enableAdbRoot ()
Active la racine adb. Si la commande "enable-root" est défini sur "false", un message est consigné sans activer la racine.
L'activation de la racine adb peut entraîner la déconnexion de l'appareil d'adb. Cette méthode bloque jusqu'à appareil est disponible.
Renvoie | |
---|---|
boolean |
true si l'opération réussit. |
Génère | |
---|---|
DeviceNotAvailableException |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Active la surveillance du réseau sur l'appareil.
Renvoie | |
---|---|
boolean |
true si la surveillance a bien été activée. false
en cas d'échec. |
Génère | |
---|---|
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'expiration spécifié.
Dans la mesure du possible, utilisez plutôt executeShellCommand(String)
, car cela
permet d'améliorer la détection des défaillances et les performances.
Paramètres | |
---|---|
timeout |
long : temps écoulé en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas, 0L pour
aucun délai |
cmdArgs |
String : commande adb et arguments à exécuter |
Renvoie | |
---|---|
String |
la commande stdout from. null si l'exécution de la commande a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
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'expiration spécifié.
Dans la mesure du possible, utilisez plutôt executeShellCommand(String)
, car cela
permet d'améliorer la détection des défaillances et les performances.
Paramètres | |
---|---|
timeout |
long : temps écoulé en millisecondes avant que l'appareil ne soit considéré comme ne répondant pas, 0L pour
aucun délai |
envMap |
: environnement à définir pour la commande |
cmdArgs |
String : commande adb et arguments à exécuter |
Renvoie | |
---|---|
String |
la commande stdout from. null si l'exécution de la commande a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
exécuterAdbCommand
public String executeAdbCommand (String... cmdArgs)
Méthode d'assistance qui exécute une commande adb en tant que commande système.
Dans la mesure du possible, utilisez plutôt executeShellCommand(String)
, car cela
permet d'améliorer la détection des défaillances et les performances.
Paramètres | |
---|---|
cmdArgs |
String : commande adb et arguments à exécuter |
Renvoie | |
---|---|
String |
la commande stdout from. null si l'exécution de la commande a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
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'inactivité par défaut de 2 minutes
À utiliser lorsque l'appareil est déjà en mode fastboot.
Paramètres | |
---|---|
cmdArgs |
String : commande fastboot et arguments à exécuter |
Renvoie | |
---|---|
CommandResult |
la commande CommandResult contenant le résultat de la commande |
Génère | |
---|---|
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.
À utiliser lorsque l'appareil est déjà en mode fastboot.
Paramètres | |
---|---|
timeout |
long : durée (en millisecondes) avant l'expiration de la commande. |
cmdArgs |
String : commande fastboot et arguments à exécuter |
Renvoie | |
---|---|
CommandResult |
la commande CommandResult contenant le résultat de la commande |
Génère | |
---|---|
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)
, mais utilise un délai d'inactivité plus long.
Paramètres | |
---|---|
cmdArgs |
String : commande fastboot et arguments à exécuter |
Renvoie | |
---|---|
CommandResult |
la commande CommandResult contenant le résultat de la commande |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterLongFastbootCommand
public CommandResult 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 l'état système variables d'environnement.
Identique à executeFastbootCommand(String)
, mais utilise un délai d'inactivité plus long.
Paramètres | |
---|---|
envVarMap |
: variables d'environnement système exécutées par la commande fastboot |
cmdArgs |
String : commande fastboot et arguments à exécuter |
Renvoie | |
---|---|
CommandResult |
la commande CommandResult contenant le résultat de la commande |
Génère | |
---|---|
DeviceNotAvailableException |
exécuterShellCommand
public String executeShellCommand (String command)
Méthode d'assistance qui exécute une commande shell adb et renvoie le résultat en tant que String
.
Paramètres | |
---|---|
command |
String : commande shell adb à exécuter |
Renvoie | |
---|---|
String |
la sortie du shell |
Génère | |
---|---|
DeviceNotAvailableException |
exécuterShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command |
String : commande shell adb à exécuter |
receiver |
IShellOutputReceiver : IShellOutputReceiver vers lequel diriger la sortie du shell. |
maxTimeToOutputShellResponse |
long : durée maximale pendant laquelle la commande est
autorisé à ne générer aucune réponse ; l'unité, comme indiqué dans timeUnit |
timeUnit |
TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts |
int : nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une
une exception. L'exception DeviceNotResponsiveException est levée si retryAttempts
sont effectuées sans succès. |
Génère | |
---|---|
DeviceNotAvailableException |
exécuterShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
command |
String : commande shell adb à exécuter |
receiver |
IShellOutputReceiver : IShellOutputReceiver vers lequel diriger la sortie du shell. |
maxTimeoutForCommand |
long : délai maximal avant l'exécution de la commande unité
spécifié dans timeUnit |
maxTimeToOutputShellResponse |
long : durée maximale pendant laquelle la commande est
autorisé à ne générer aucune réponse ; l'unité, comme indiqué dans timeUnit |
timeUnit |
TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts |
int : nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une
une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont
sans succès. |
Génère | |
---|---|
DeviceNotAvailableException |
exécuterShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Exécute la commande shell adb donnée, en effectuant plusieurs tentatives si la commande échoue.
Une forme plus simple de
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
avec
valeurs par défaut.
Paramètres | |
---|---|
command |
String : commande shell adb à exécuter |
receiver |
IShellOutputReceiver : IShellOutputReceiver vers lequel diriger la sortie du shell. |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public CommandResult executeShellV2Command (String cmd)
Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément CommandResult
correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.
Paramètres | |
---|---|
cmd |
String : commande à exécuter. |
Renvoie | |
---|---|
CommandResult |
Résultat dans CommandResult . |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public 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 élément CommandResult
correctement renseigné avec le résultat de l'état de la commande et la valeur stderr. stdout est
dirigé vers le flux spécifié.
Paramètres | |
---|---|
cmd |
String : commande à exécuter. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou valeur null. |
Renvoie | |
---|---|
CommandResult |
Résultat dans CommandResult . |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Méthode d'assistance qui exécute une commande shell adb et renvoie les résultats sous la forme d'un élément CommandResult
correctement renseigné avec le résultat de l'état de la commande, stdout et stderr.
Paramètres | |
---|---|
cmd |
String : commande à exécuter. |
pipeAsInput |
File : valeur ERROR(/File) qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle. |
Renvoie | |
---|---|
CommandResult |
Résultat dans CommandResult . |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
cmd |
String : commande shell adb à exécuter |
maxTimeoutForCommand |
long : délai maximal avant l'exécution de la commande unité
spécifié dans timeUnit |
timeUnit |
TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts |
int : nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une
une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont
sans succès. |
Renvoie | |
---|---|
CommandResult |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
cmd |
String : commande shell adb à exécuter |
maxTimeoutForCommand |
long : délai maximal avant l'exécution de la commande unité
spécifié dans timeUnit |
timeUnit |
TimeUnit : unité pour maxTimeToOutputShellResponse |
Renvoie | |
---|---|
CommandResult |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
cmd |
String : commande shell adb à exécuter |
pipeAsInput |
File : valeur ERROR(/File) qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou valeur null. |
maxTimeoutForCommand |
long : délai maximal avant l'exécution de la commande unité
spécifié dans timeUnit |
timeUnit |
TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts |
int : nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une
une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont
sans succès. |
Renvoie | |
---|---|
CommandResult |
Génère | |
---|---|
DeviceNotAvailableException |
ExécuterShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Exécute une commande shell adb, avec davantage de paramètres pour contrôler le comportement de la commande.
Paramètres | |
---|---|
cmd |
String : commande shell adb à exécuter |
pipeAsInput |
File : valeur ERROR(/File) qui sera redirigée en tant qu'entrée de la commande, ou valeur nulle. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée, ou valeur null. |
pipeToError |
OutputStream : ERROR(/OutputStream) où l'erreur std sera redirigée, ou valeur null. |
maxTimeoutForCommand |
long : délai maximal avant l'exécution de la commande unité
spécifié dans timeUnit |
timeUnit |
TimeUnit : unité pour maxTimeToOutputShellResponse |
retryAttempts |
int : nombre maximal de nouvelles tentatives de la commande si elle échoue en raison d'une
une exception. L'exception DeviceNotResponsiveException est levée si les retryAttempts sont
sans succès. |
Renvoie | |
---|---|
CommandResult |
Génère | |
---|---|
DeviceNotAvailableException |
fastbootEffacerPartition
public CommandResult fastbootWipePartition (String partition)
Méthode d'assistance qui efface une partition de l'appareil.
Si getUseFastbootErase()
est défini sur true
, l'effacement rapide sera utilisé pour effacer
la partition. L'appareil doit ensuite créer un système de fichiers au prochain démarrage.
Sinon, le format fastboot est utilisé, ce qui crée un nouveau système de fichiers sur le périphérique.
À utiliser lorsque l'appareil est déjà en mode fastboot.
Paramètres | |
---|---|
partition |
String : partition à effacer |
Renvoie | |
---|---|
CommandResult |
la commande CommandResult contenant le résultat de la commande |
Génère | |
---|---|
DeviceNotAvailableException |
GetActiveApexes
publicgetActiveApexes ()
Récupérez les informations sur les apex activés sur l'appareil.
Renvoie | |
---|---|
|
ERROR(/Set) sur ApexInfo actuellement activés sur l'appareil |
Génère | |
---|---|
DeviceNotAvailableException |
getTous les paramètres
publicgetAllSettings (String namespace)
Renvoie les paires clé/valeur de l'espace de noms demandé.
Paramètres | |
---|---|
namespace |
String : doit correspondre à l'une des valeurs suivantes : {"system", "secure", "global"} |
Renvoie | |
---|---|
|
le mappage des paires clé-valeur. Valeur Null si l'espace de noms n'est pas accepté. |
Génère | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Renvoyer l'état d'allocation actuel de l'appareil
Renvoie | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Recherchez et renvoyez l'android-id associé à un userId. La valeur "null" est absente si vous ne l'avez pas trouvé.
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
String |
Génère | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
Créer une carte des identifiants Android trouvés pour les ID utilisateur correspondants. Il n’y a pas d’assurance que chaque utilisateur id trouve un identifiant Android associé à cette fonction. Certains ID utilisateur peuvent donc correspondre à "null".
Renvoie | |
---|---|
|
Carte des ID Android trouvés pour les ID utilisateur correspondants. |
Génère | |
---|---|
DeviceNotAvailableException |
niveau getApi
public int getApiLevel ()
Obtenir le niveau d'API de l'appareil La valeur par défaut est UNKNOWN_API_LEVEL
.
Renvoie | |
---|---|
int |
Nombre entier indiquant le niveau d'API de l'appareil |
Génère | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Récupérer des informations sur un package installé sur l'appareil
Paramètres | |
---|---|
packageName |
String |
Renvoie | |
---|---|
PackageInfo |
PackageInfo ou null si les informations n'ont pas pu être récupérées |
Génère | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Récupère des informations sur les packages installés sur l'appareil.
Renvoie | |
---|---|
|
ERROR(/List) applications sur PackageInfo installées sur l'appareil. |
Génère | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Méthode pratique permettant d'obtenir la version bande de base (radio) de cet appareil. Obtenir la version radio
est spécifique à un appareil, et il est donc possible qu'elle ne renvoie pas les bonnes informations pour tous les appareils. Ce
repose sur la propriété gsm.version.baseband pour renvoyer les informations de version correctes.
Cette valeur est inexacte pour certains appareils CDMA et peut ne pas correspondre à la version renvoyée ici.
la version signalée par fastboot et peut ne pas renvoyer la version du signal radio CDMA.
En résumé, cette méthode ne signale la version précise que si la propriété gsm.version.baseband est la
identique à la version renvoyée par fastboot getvar version-baseband
.
Renvoie | |
---|---|
String |
la version de bande de base String ou null si elle ne peut pas être déterminée ;
(l'appareil n'a pas d'option, ou la chaîne de version ne peut pas être lue) |
Génère | |
---|---|
DeviceNotAvailableException |
getBatterie
public Integer getBattery ()
Renvoie le niveau de batterie actuel d'un appareil, ou la valeur "null" si le niveau de batterie n'est pas disponible.
Renvoie | |
---|---|
Integer |
getBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Renvoie la valeur booléenne d'une propriété donnée.
Paramètres | |
---|---|
name |
String : nom de la propriété |
defaultValue |
boolean : valeur par défaut à renvoyer si la propriété est vide ou n'existe pas. |
Renvoie | |
---|---|
boolean |
true si la propriété a la valeur "1" , "y" , "yes" ,
"on" , ou "true" , false si la propriété a la valeur "0" ,
"n" , "no" , "off" , "false" ou defaultValue
sinon. |
Génère | |
---|---|
DeviceNotAvailableException |
getBootHistory
publicgetBootHistory ()
La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps et le motif de démarrage.
Renvoie | |
---|---|
|
Carte du temps de démarrage (temps UTC en seconde depuis l'epoch) et du motif de démarrage |
Génère | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
La méthode d'assistance collecte la carte de l'historique de démarrage avec le temps de démarrage et le motif du démarrage
le temps écoulé depuis l'epoch de l'appareil et l'unité de temps spécifiée. L'utcEpochTime de l'appareil actuel dans
La milliseconde peut être obtenue par la méthode getDeviceDate()
.
Paramètres | |
---|---|
utcEpochTime |
long : durée de l'appareil depuis l'epoch. |
timeUnit |
TimeUnit : unité de temps TimeUnit . |
Renvoie | |
---|---|
|
Carte du temps de démarrage (temps UTC en seconde depuis l'epoch) et du motif de démarrage |
Génère | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
Méthode pratique permettant d'obtenir la version du bootloader de cet appareil.
Tentative de récupération de la version du bootloader à partir de l'état actuel de l'appareil. (c'est-à-dire si l'appareil est en mode fastboot, il tentera de récupérer la version à partir de fastboot).
Renvoie | |
---|---|
String |
La version du bootloader String ou null si elle est introuvable |
Génère | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Récupère un rapport de bug de l'appareil.
La mise en œuvre de cette fonctionnalité continuera de fonctionner sur un appareil sans carte SD (ou là où la carte SD n'est pas encore installée).
Renvoie | |
---|---|
InputStreamSource |
InputStreamSource qui génère le contenu du rapport de bug à la demande. Dans
en cas d'échec, InputStreamSource produira une ERROR(/InputStream) vide. |
GetBugreportz
public InputStreamSource getBugreportz ()
Récupère un rapport de bug de l'appareil. Le rapport de bug au format Zip contient le rapport de bug principal et d'autres fichiers journaux utiles pour le débogage.
Uniquement compatible avec la "version adb" > 1.0.36
Renvoie | |
---|---|
InputStreamSource |
Une InputStreamSource du fichier ZIP contenant bugreportz, renvoie la valeur "null" dans
en cas d'échec. |
getBuildAlias
public String getBuildAlias ()
Récupérez l'alias de la compilation en cours d'exécution par l'appareil.
L'alias de compilation est généralement une chaîne plus lisible que l'ID de compilation (généralement un nombre pour les builds Nexus). Par exemple, la version finale d'Android 4.2 est associée à l'alias de build JDQ39 et à un ID de build. 573038
Renvoie | |
---|---|
String |
l'alias de build ou passer à l'ID de build s'il n'a pas pu être récupéré |
Génère | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
Récupérez le type de compilation pour l'appareil.
Renvoie | |
---|---|
String |
le type de compilation ou la valeur "null" si elle n'a pas pu être récupérée ; |
Génère | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Récupérez la version en cours d'exécution de l'appareil.
Renvoie | |
---|---|
String |
L'ID de la compilation ou IBuildInfo#UNKNOWN_BUILD_ID s'il n'a pas pu être récupéré |
Génère | |
---|---|
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 version (contrôlé par des fabricants d'appareils individuels)
Renvoie | |
---|---|
String |
Clé de signature si trouvée, valeur null dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Renvoie un DeviceDescriptor
mis en cache si l'appareil est alloué. Sinon, renvoie le
DeviceDescriptor
en cours.
Renvoie | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Renvoie un DeviceDescriptor
mis en cache si l'appareil est alloué. Sinon, renvoie le
DeviceDescriptor
en cours.
Paramètres | |
---|---|
shortDescriptor |
boolean : indique s'il faut limiter ou non le descripteur à un minimum d'informations. |
Renvoie | |
---|---|
DeviceDescriptor |
Enfants
public String[] getChildren (String path)
Alternative à l'utilisation de IFileEntry
qui ne fonctionne parfois pas en raison des autorisations
Paramètres | |
---|---|
path |
String : est le chemin d'accès sur l'appareil où effectuer la recherche. |
Renvoie | |
---|---|
String[] |
Tableau de chaîne contenant tous les fichiers d'un chemin d'accès sur l'appareil. |
Génère | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
Connexion actuelle associée à l'appareil.
Renvoie | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Renvoie ContentProviderHandler
ou la valeur "null" si aucune valeur n'est disponible.
Le fournisseur de contenu peut être réutilisé s'il a été créé précédemment avec le même userId
.
Paramètres | |
---|---|
userId |
int : ID utilisateur avec lequel initialiser le fournisseur de contenu. |
Renvoie | |
---|---|
ContentProviderHandler |
Génère | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème.
Renvoie | |
---|---|
DeviceFoldableState |
Génère | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Renvoie l'identifiant de l'utilisateur actuel. En cas d'erreur, renvoyez -10000.
Renvoie | |
---|---|
int |
Génère | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Permet d'obtenir la classe de l'appareil.
Renvoie | |
---|---|
String |
la classe d'appareil String . |
getDeviceDate
public long getDeviceDate ()
Renvoie la date de l'appareil en millisecondes depuis l'epoch.
Renvoie | |
---|---|
long |
la date de l'appareil au format epoch. |
Génère | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Renvoyez un DeviceDescriptor
à partir des informations de l'appareil pour obtenir des informations le concernant sans
en transmettant l'objet réel de l'appareil.
Renvoie | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Renvoyez un DeviceDescriptor
à partir des informations de l'appareil pour obtenir des informations le concernant sans
en transmettant l'objet réel de l'appareil.
Paramètres | |
---|---|
shortDescriptor |
boolean : indique s'il faut limiter ou non le descripteur à un minimum d'informations. |
Renvoie | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
Obtenez l'état de l'appareil.
Renvoie | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Outil d'aide pour obtenir le décalage horaire entre l'appareil et un ERROR(/Date)
donné. Utiliser l'epoch
en interne.
Paramètres | |
---|---|
date |
Date |
Renvoie | |
---|---|
long |
la différence en millisecondes |
Génère | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Obtenir le flux de l'émulateur stdout et stderr
Renvoie | |
---|---|
InputStreamSource |
sortie de l'émulateur |
getEmulatorProcess
public Process getEmulatorProcess ()
Renvoyez le Process
correspondant à cet émulateur.
Renvoie | |
---|---|
Process |
le Process ou null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Journal contenant tous les journaux executeShellCommand(String)
.
Renvoie | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la mémoire de stockage externe de l'appareil.
Renvoie | |
---|---|
long |
quantité d'espace disponible en Ko |
Génère | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
Renvoie le chemin d'accès au binaire fastboot utilisé.
Pour que les fonctions fastboot soient activées, isFastbootEnabled()
doit toujours être défini sur "true".
Renvoie | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.
Cette méthode ne doit être utilisée que si l'appareil doit être en mode Fastboot. C'est une variante un peu plus sûre
que la méthode générique getProductType()
dans ce cas, car ITestDevice
saura qu'il doit restaurer l'appareil en fastboot si son état est incorrect ou s'il est
ne répond pas.
Renvoie | |
---|---|
String |
Nom du type de produit String ou null s'il ne peut pas être déterminé |
Génère | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
Méthode pratique permettant d'obtenir le type de produit de cet appareil en mode fastboot.
Cette méthode ne doit être utilisée que si l'appareil doit être en mode Fastboot. C'est une variante un peu plus sûre
que la méthode générique getProductType()
dans ce cas, car ITestDevice
saura qu'il doit restaurer l'appareil en fastboot si son état est incorrect ou s'il est
ne répond pas.
Renvoie | |
---|---|
String |
Nom du type de produit String ou null s'il ne peut pas être déterminé |
Génère | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Renvoie le numéro de série du mode fastboot.
Renvoie | |
---|---|
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 : nom de la variable. |
Renvoie | |
---|---|
String |
La valeur de la propriété ou null si elle n'existe pas |
Génère | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Renvoie la chaîne de version du binaire fastboot utilisé. Ou "null" si quelque chose se passe faux.
Renvoie | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
Récupérer une référence à un fichier distant sur un appareil
Paramètres | |
---|---|
path |
String : chemin d'accès au fichier à récupérer. Il peut s'agir d'un chemin absolu ou relatif à "/". (ex. :
à la fois "/system" et "système" est compatible) |
Renvoie | |
---|---|
IFileEntry |
IFileEntry ou null si le fichier à l'path donné ne peut pas
être trouvé |
Génère | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Outil d'aide non officiel pour obtenir un FileEntry
à partir d'un chemin d'accès non racine. PROBLÈME: refactoriser le fichier
FileEntry pour qu'il soit disponible depuis n'importe quel chemin d'accès. (même non racine).
Paramètres | |
---|---|
entry |
FileListingService.FileEntry : un élément FileEntry qui n'est pas nécessairement racine, comme l'exige Ddmlib. |
Renvoie | |
---|---|
IFileEntry |
un FileEntryWrapper représentant l'entrée FileEntry. |
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Renvoie la liste des états des appareils pliables sur l'appareil. Obtention de la commande "cmd device_state" "print-states" (états d'impression).
Renvoie | |
---|---|
|
Génère | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Renvoie une référence au fichier ddmlib IDevice
associé.
Un nouveau IDevice
peut être alloué par le service de gestion des données (DMS) chaque fois que l'appareil se déconnecte et
se reconnecte à partir d'adb. Ainsi, les appelants ne doivent pas garder de référence à IDevice
,
car cette référence peut devenir obsolète.
Renvoie | |
---|---|
IDevice |
l'/le/la IDevice |
getInstallPackageNames
publicgetInstalledPackageNames ()
Récupérez les noms des packages d'application présents sur l'appareil.
Renvoie | |
---|---|
|
ERROR(/Set) noms de packages sur String sont actuellement installés sur l'appareil. |
Génère | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Renvoie la valeur entière de la propriété donnée à partir de l'appareil.
Paramètres | |
---|---|
name |
String : nom de la propriété |
defaultValue |
long : valeur par défaut à renvoyer si la propriété est vide ou n'existe pas. |
Renvoie | |
---|---|
long |
la valeur de la propriété ou defaultValue si la propriété est vide ou n'existe pas ;
ou n'a pas de valeur entière. |
Génère | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
Récupère l'adresse IP de l'appareil.
Renvoie | |
---|---|
String |
l'adresse IP de l'appareil, ou null si l'appareil n'en a pas ; |
Génère | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Renvoyez un objet pour obtenir l'état actuel du verrouillage du clavier ou la valeur "null" si cette fonctionnalité n'est pas disponible.
Renvoie | |
---|---|
KeyguardControllerState |
Une KeyguardControllerState contenant un instantané de l'état de la protection du clavier
et renvoie Null si la requête de garde du clavier n'est pas prise en charge. |
Génère | |
---|---|
DeviceNotAvailableException |
getLastExpectRestartTimeMillis
public long getLastExpectedRebootTimeMillis ()
Renvoie la dernière fois où les API Tradefed ont déclenché un redémarrage en millisecondes depuis EPOCH en tant que
renvoyé par System.currentTimeMillis()
.
Renvoie | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
Permet d'obtenir le premier niveau d'API lancé sur l'appareil. La valeur par défaut est UNKNOWN_API_LEVEL
.
Renvoie | |
---|---|
int |
Nombre entier indiquant le premier niveau d'API de l'appareil |
Génère | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Récupère un flux d'instantanés des données logcat.
Fonctionne dans deux modes:
TestDeviceOptions.getMaxLogcatDataSize()
octets du contenu actuel de l'arrière-plan.
capture logcat
Renvoie | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Récupère un flux d'instantanés de la dernière maxBytes
de données logcat capturées.
Utile pour les cas où vous souhaitez capturer des instantanés fréquents des données logcat capturées
sans subir la pénalité d'espace disque potentiellement importante que représente l'obtention de l'instantané getLogcat()
complet.
Paramètres | |
---|---|
maxBytes |
int : quantité maximale de données à renvoyer. Il doit s'agir d'un montant pouvant
s'adaptent parfaitement à la mémoire |
Renvoie | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Obtenir un vidage du logcat actuel pour l'appareil Contrairement à getLogcat()
, cette méthode
renvoie toujours un vidage statique du fichier logcat.
L'inconvénient est que rien n'est renvoyé si l'appareil n'est pas accessible.
Renvoie | |
---|---|
InputStreamSource |
une InputStreamSource des données logcat. Un flux vide est renvoyé en cas d'échec.
pour capturer les données logcat. |
getLogcatLogcat
public InputStreamSource getLogcatSince (long date)
Récupère un flux d'instantanés des données logcat capturées à partir de la date fournie. L'heure du
l'appareil doit être utilisé getDeviceDate()
.
Paramètres | |
---|---|
date |
long : en millisecondes depuis le format epoch du démarrage de l'instantané jusqu'à présent.
(peut être obtenu en utilisant "date +%s") |
Renvoie | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
Renvoie l'adresse MAC de l'appareil, qui est nulle si la requête échoue.
Renvoie | |
---|---|
String |
IDUtilisateurMain
public Integer getMainUserId ()
Renvoie l'ID utilisateur principal.
Renvoie | |
---|---|
Integer |
L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas. |
Génère | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Obtenez les informations sur les modules principaux installés sur l'appareil.
Renvoie | |
---|---|
|
ERROR(/Set) modules principaux sur String actuellement installés sur l'appareil. |
Génère | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersCompatibles
public int getMaxNumberOfRunningUsersSupported ()
Obtenir le nombre maximal d'utilisateurs pouvant s'exécuter simultanément La valeur par défaut est 0.
Renvoie | |
---|---|
int |
Nombre entier indiquant le nombre d'utilisateurs exécutant simultanément |
Génère | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersCompatibles
public int getMaxNumberOfUsersSupported ()
Obtenir le nombre maximal d'utilisateurs pris en charge La valeur par défaut est 0.
Renvoie | |
---|---|
int |
Entier indiquant le nombre d'utilisateurs acceptés |
Génère | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Renvoie | |
---|---|
Process |
Renvoie le processus de la VM Microdroid. Si TestDevice n'est pas un Microdroid, renvoie "null". |
getMonitor
public IDeviceStateMonitor getMonitor ()
Renvoie le IDeviceStateMonitor
associé à l'appareil.
Renvoie | |
---|---|
IDeviceStateMonitor |
GetMountPoint
public String getMountPoint (String mountName)
Renvoie un point d'installation.
Interroge directement l'appareil si les informations mises en cache dans IDevice
ne sont pas disponibles.
À FAIRE: déplacer ce comportement vers IDevice#getMountPoint(String)
Paramètres | |
---|---|
mountName |
String : nom du point d'installation |
Renvoie | |
---|---|
String |
le point d'installation ou null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Renvoie un MountPointInfo
correspondant au chemin d'accès au point de montage spécifié, ou
null
si ce chemin n'est pas installé ou n'apparaît pas dans
/proc/mounts
comme point de montage.
Paramètres | |
---|---|
mountpoint |
String |
Renvoie | |
---|---|
ITestDevice.MountPointInfo |
Une ERROR(/List) de MountPointInfo contenant les informations dans "/proc/mounts" |
Génère | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
Renvoie une version analysée des informations contenues dans /proc/mounts sur l'appareil.
Renvoie | |
---|---|
|
Une ERROR(/List) de MountPointInfo contenant les informations dans "/proc/mounts" |
Génère | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
Récupérez les options de test pour l'appareil.
Renvoie | |
---|---|
TestDeviceOptions |
TestDeviceOptions associé à l'appareil testé. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Méthode d'assistance permettant de déterminer la quantité d'espace disponible sur la partition de l'appareil.
Paramètres | |
---|---|
partition |
String |
Renvoie | |
---|---|
long |
quantité d'espace disponible en Ko |
Génère | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
Renvoie l'identifiant de l'utilisateur principal.
Renvoie | |
---|---|
Integer |
L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas. |
Génère | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
La méthode d'assistance exécute la fonction "pidof" et "stat" et renvoie l'objet ProcessInfo
avec
PID et heure de début du processus donné.
Paramètres | |
---|---|
processName |
String : nom du processus (String). |
Renvoie | |
---|---|
ProcessInfo |
ProcessInfo associé au nom processName donné |
Génère | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
Renvoie le pid du service ou la valeur "null" en cas de problème.
Paramètres | |
---|---|
process |
String : chaîne du nom du processus. |
Renvoie | |
---|---|
String |
Génère | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
Méthode pratique permettant d'obtenir le type de produit de cet appareil.
Cette méthode fonctionne si l'appareil est en mode adb ou fastboot.
Renvoie | |
---|---|
String |
le nom du type de produit String . Ne sera pas nul |
Génère | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
Méthode pratique permettant d'obtenir la variante du produit de cet appareil.
Cette méthode fonctionne si l'appareil est en mode adb ou fastboot.
Renvoie | |
---|---|
String |
le nom de la variante du produit String ou null s'il ne peut pas être
déterminé |
Génère | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Récupère la valeur de propriété donnée à partir de l'appareil.
Paramètres | |
---|---|
name |
String : nom de la propriété |
Renvoie | |
---|---|
String |
La valeur de la propriété ou null si elle n'existe pas |
Génère | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Obtenez le mode de récupération actuellement utilisé pour l'appareil.
Renvoie | |
---|---|
ITestDevice.RecoveryMode |
le mode de récupération actuellement utilisé pour l'appareil. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Permet de prendre une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot(format) à la place avec l'encodage JPEG pour réduire la taille.
Paramètres | |
---|---|
format |
String : fichiers PNG et JPEG acceptés. |
Renvoie | |
---|---|
InputStreamSource |
un InputStreamSource de la capture d'écran au format, ou null si
la capture d'écran a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Récupère une capture d'écran de l'appareil correspondant à l'identifiant d'affichage. Le format est PNG.
À FAIRE: étendre les implémentations ci-dessus pour prendre en charge le "format" et "redimensionner"
Paramètres | |
---|---|
displayId |
long : ID d'affichage de l'écran à partir duquel obtenir la capture d'écran. |
Renvoie | |
---|---|
InputStreamSource |
un InputStreamSource de la capture d'écran au format, ou null si le
la capture d'écran a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Permet de prendre une capture d'écran de l'appareil. Il est recommandé d'utiliser plutôt getScreenshot(String)
avec un encodage JPEG pour une taille plus petite.
Paramètres | |
---|---|
format |
String : fichiers PNG et JPEG acceptés. |
rescale |
boolean : si la capture d'écran doit être redimensionnée pour réduire la taille de l'image obtenue |
Renvoie | |
---|---|
InputStreamSource |
un InputStreamSource de la capture d'écran au format, ou null si le
la capture d'écran a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
Permet de prendre une capture d'écran de l'appareil.
Renvoie | |
---|---|
InputStreamSource |
Une InputStreamSource de la capture d'écran au format png, ou null si
la capture d'écran a échoué. |
Génère | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
Méthode pratique permettant d'obtenir le numéro de série de cet appareil.
Renvoie | |
---|---|
String |
le numéro de série String |
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 suivants: {"system", "secure", "global"}
Paramètres | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Renvoie | |
---|---|
String |
Valeur associée à l'espace de noms "namespace:key" d'un utilisateur. Null si introuvable. |
Génère | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Voir getSetting(int, String, String)
et effectué sur l'utilisateur système.
Paramètres | |
---|---|
namespace |
String |
key |
String |
Renvoie | |
---|---|
String |
Génère | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Renvoyez l'opérateur de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible.
Renvoie | |
---|---|
String |
getSimState
public String getSimState ()
Renvoyez l'état de la carte SIM ou la valeur "null" si ce dernier n'est pas disponible ou si l'appareil n'est pas disponible.
Renvoie | |
---|---|
String |
getTombstones
publicgetTombstones ()
Récupérez et renvoyez la liste des tombstones des appareils. Racine requise.
la méthode est la meilleure méthode. Ainsi, si une pierre tombale n'est pas extraite pour une raison quelconque, elle sera
absents de la liste. Seul un DeviceNotAvailableException
mettra fin à la méthode.
plus tôt.
Renvoie | |
---|---|
|
Liste de fichiers tombstone, vide s'il n'y en a pas. |
Génère | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Renvoie la taille totale de la mémoire physique en octets ou -1 en cas d'erreur interne.
Renvoie | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Pour gérer les appareils, récupérez le numéro de série utilisé pour le suivre.
Renvoie | |
---|---|
String |
getDésinstallerablePackageNames
publicgetUninstallablePackageNames ()
Récupérez les noms des packages d'application qui peuvent être désinstallés. Elle est actuellement définie comme les packages non-système et les packages système mis à jour.
Renvoie | |
---|---|
|
ERROR(/Set) des noms de packages String pouvant être désinstallés actuellement installés sur le
appareil. |
Génère | |
---|---|
DeviceNotAvailableException |
getUseFastbootEffacer
public boolean getUseFastbootErase ()
Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.
Renvoie | |
---|---|
boolean |
true si l'effacement rapide est utilisé ou false si le format Fastboot est
être utilisée. |
getUserFlags
public int getUserFlags (int userId)
Rechercher et renvoyer les indicateurs d'un utilisateur donné Les indicateurs sont définis dans "android.content.pm.UserInfo" dans le projet Android Open Source.
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
int |
les indicateurs associés à l'ID utilisateur fourni s'il est trouvé, -10000 dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
Récupère la carte de useId sur UserInfo
sur l'appareil. Une erreur DeviceRuntimeException
est générée si le résultat de l'appareil n'est pas conforme à vos attentes.
Renvoie | |
---|---|
|
la liste des objets UserInfo. |
Génère | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Renvoyez le numéro de série associé à l'ID utilisateur s'il est trouvé, et -10000 dans les autres cas.
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
int |
Génère | |
---|---|
DeviceNotAvailableException |
Événement de gestion des allocations
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Traitement de l'événement DeviceEvent donné. Passage possible de l'appareil
au nouvel état. Informer IDeviceMonitor
de toute transition d'état.
Traiter DeviceEvent, qui peut ou non faire passer cet appareil à une nouvelle allocation de l'état.
Paramètres | |
---|---|
event |
DeviceEvent |
Renvoie | |
---|---|
IManagedTestDevice.DeviceEventResponse |
Fonction
public boolean hasFeature (String feature)
Vérifier si une fonctionnalité est disponible sur un appareil
Paramètres | |
---|---|
feature |
String : quel format devrait être "feature: |
Renvoie | |
---|---|
boolean |
"True" si la caractéristique est détectée, false dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
Installer le package
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Installer un package Android sur l'appareil
Paramètres | |
---|---|
packageFile |
File : fichier APK à installer. |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles"
options. |
Renvoie | |
---|---|
String |
une String avec un code d'erreur, ou null en cas de réussite. |
Génère | |
---|---|
DeviceNotAvailableException |
Installer le package
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installer un package Android sur l'appareil
Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.
Paramètres | |
---|---|
packageFile |
File : 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 à transmettre. Voir "adb shell pm -h" pour "disponibles"
options. |
Renvoie | |
---|---|
String |
une String avec un code d'erreur, ou null en cas de réussite. |
Génère | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Installer un package Android sur l'appareil d'un utilisateur donné
Paramètres | |
---|---|
packageFile |
File : fichier APK à installer. |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
userId |
int : ID utilisateur entier pour lequel installer l'application. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles"
options. |
Renvoie | |
---|---|
String |
une String avec un code d'erreur, ou null en cas de réussite. |
Génère | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installer un package Android sur l'appareil d'un utilisateur donné
Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.
Paramètres | |
---|---|
packageFile |
File : 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 : ID utilisateur entier pour lequel installer l'application. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles"
options. |
Renvoie | |
---|---|
String |
une String avec un code d'erreur, ou null en cas de réussite. |
Génère | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Renvoie | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Vérifier si la plate-forme de l'appareil est compatible avec l'énumération d'applications
Renvoie | |
---|---|
boolean |
"True" si l'énumération d'applications est compatible, "false" dans le cas contraire |
Génère | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockCompatible
public boolean isBypassLowTargetSdkBlockSupported ()
Vérifier si la plate-forme sur l'appareil permet de contourner le blocage du SDK cible faible lors des installations d'applications
Renvoie | |
---|---|
boolean |
"True" si le bloc du SDK cible de contournement à faible valeur est accepté, ou "false" dans le cas contraire |
Génère | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Vérifiez si debugfs est installé.
Renvoie | |
---|---|
boolean |
true si debugfs est installé |
Génère | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Indique si l'appareil est chiffré.
Renvoie | |
---|---|
boolean |
true si l'appareil est chiffré |
Génère | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Renvoyez la valeur "True" si le chemin d'accès sur l'appareil est un répertoire, et la valeur "false" dans le cas contraire.
Paramètres | |
---|---|
path |
String |
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Renvoie | |
---|---|
boolean |
true si la racine adb doit être activée sur l'appareil |
isChiffrementCompatible
public boolean isEncryptionSupported ()
Indique si l'appareil est compatible avec le chiffrement.
Renvoie | |
---|---|
boolean |
true si l'appareil est compatible avec le chiffrement. |
Génère | |
---|---|
DeviceNotAvailableException |
isExecutable (isExecutable)
public boolean isExecutable (String fullPath)
Affiche la valeur "True" si le chemin d'accès au fichier sur l'appareil est un fichier exécutable, et la valeur "false" dans le cas contraire.
Paramètres | |
---|---|
fullPath |
String |
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
IsFastbootEnabled
public boolean isFastbootEnabled ()
Renvoie si fastboot est disponible pour l'appareil.
Renvoie | |
---|---|
boolean |
IsHeadless
public boolean isHeadless ()
Renvoie la valeur "true" si l'appareil est headless (aucun écran), sinon la valeur "false".
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Indique si l'appareil utilise le mode utilisateur système headless.
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Indique si l'utilisateur principal est un administrateur permanent et si celui-ci ne peut pas être supprimé ou rétrogradé non-administrateur.
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isMultiUserCompatible
public boolean isMultiUserSupported ()
Détermine si le mode multi-utilisateur est pris en charge.
Renvoie | |
---|---|
boolean |
"true" si le mode multi-utilisateur est pris en charge, "false" dans le cas contraire |
Génère | |
---|---|
DeviceNotAvailableException |
isPackageInstallée
public boolean isPackageInstalled (String packageName, String userId)
Interrogez l'appareil à la recherche d'un nom de package et d'un ID utilisateur donnés pour vérifier s'il est actuellement installé ou non pour cet utilisateur.
Paramètres | |
---|---|
packageName |
String : le package dont nous vérifions s'il est installé. |
userId |
String : l'ID utilisateur pour lequel nous vérifions que le package est installé. Si la valeur est null, l'utilisateur principal
zéro sera utilisé. |
Renvoie | |
---|---|
boolean |
"True" si le package est signalé comme installé. Sinon, cette valeur est "false". |
Génère | |
---|---|
DeviceNotAvailableException |
isPackageInstallée
public boolean isPackageInstalled (String packageName)
Interrogez l'appareil sur le nom de package donné pour vérifier s'il est actuellement installé ou non.
Paramètres | |
---|---|
packageName |
String |
Renvoie | |
---|---|
boolean |
"True" si le package est signalé comme installé. Sinon, cette valeur est "false". |
Génère | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionCompatible
public boolean isRuntimePermissionSupported ()
Vérifier si la plate-forme sur l'appareil est compatible avec l'octroi d'autorisations d'exécution
Renvoie | |
---|---|
boolean |
"True" si les autorisations d'exécution sont prises en charge, et "false" dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Renvoie la valeur "true" si l'appareil se trouve dans TestDeviceState#FASTBOOT
ou TestDeviceState.FASTBOOTD
.
Renvoie | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
Vérifiez si un utilisateur donné est en cours d'exécution.
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
boolean |
"True" si l'utilisateur est en cours d'exécution, "false" dans tous les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
isUserSecondaire
public boolean isUserSecondary (int userId)
Indique si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
boolean |
La valeur est "true" si l'utilisateur est un utilisateur secondaire, et la valeur "false" dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
Vérifie si l'utilisateur donné est visible.
Un élément "visible" l'utilisateur est un utilisateur qui interagit avec un "humain" utilisateur et peut donc lancer les activités de lancement (généralement sur l'écran par défaut).
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Vérifie si l'utilisateur donné est visible sur l'écran donné.
Un élément "visible" l'utilisateur est un utilisateur qui interagit avec un "humain" utilisateur et peut donc lancer des activités de lancement dans cet affichage.
Paramètres | |
---|---|
userId |
int |
displayId |
int |
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Si c'est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean)
en transmettant
un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers()
(qui
doit inclure ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersCompatible
public boolean isVisibleBackgroundUsersSupported ()
Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.
Si c'est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean)
en transmettant
un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers()
.
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Vérifiez si le Wi-Fi est activé.
Vérifie si le Wi-Fi est activé sur l'appareil. Utile pour vérifier l'état du Wi-Fi avant de tester que ne doit pas fonctionner en Wi-Fi les tests de données mobiles.
Renvoie | |
---|---|
boolean |
true si le Wi-Fi est activé. false si désactivé |
Génère | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Collecter la liste des identifiants d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys" SurfaceFlinger".
Renvoie | |
---|---|
|
Liste des écrans. La valeur par défaut renvoie toujours la valeur d'affichage par défaut 0. |
Génère | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Récupère la liste des écrans pouvant être utilisés pour start a user visible in the background
.
Renvoie | |
---|---|
|
Génère | |
---|---|
DeviceNotAvailableException |
Lister les utilisateurs
publiclistUsers ()
Récupère la liste des utilisateurs de l'appareil. Une erreur DeviceRuntimeException
est générée en cas de sortie.
de l'appareil n'est pas conforme à vos attentes.
Renvoie | |
---|---|
|
la liste des ID utilisateur. |
Génère | |
---|---|
DeviceNotAvailableException |
logAnrs
public boolean logAnrs (ITestLogger logger)
Recueille et consigne les erreurs ANR de l'appareil.
Paramètres | |
---|---|
logger |
ITestLogger : ITestLogger pour consigner les erreurs ANR. |
Renvoie | |
---|---|
boolean |
La valeur est "true" si la journalisation a réussi, ou "false" dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
Rapport logBug
public boolean logBugreport (String dataName, ITestLogger listener)
Méthode d'assistance permettant de générer un rapport de bug et de le consigner pour les reporters.
Paramètres | |
---|---|
dataName |
String : nom sous lequel le rapport de bug sera signalé. |
listener |
ITestLogger : ITestLogger pour consigner le rapport de bug. |
Renvoie | |
---|---|
boolean |
La valeur est "true" si la journalisation a réussi, ou "false" dans le cas contraire. |
ouverture de session sur l'appareil
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Consigner un message dans le fichier logcat de l'appareil. Il s'agit d'un appel sécurisé qui ne sera pas généré, même si la journalisation échoue.
Paramètres | |
---|---|
tag |
String : balise sous laquelle nous enregistrons notre message dans logcat. |
level |
Log.LogLevel : niveau de débogage du message dans Logcat. |
format |
String : format du message. |
args |
Object : arguments à remplacer via String.format(). |
nonBlocageRedémarrer
public void nonBlockingReboot ()
Émet une commande pour redémarrer l'appareil et renvoie une commande terminée et plus visible par adb.
Génère | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
À remplacer si l'appareil nécessite des actions spécifiques après la racine adb et avant la l'appareil est à nouveau connecté. L'implémentation par défaut n'inclut aucune action supplémentaire. L'activation de la racine adb n'est pas garantie à ce stade.
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
À remplacer si l'appareil nécessite des actions spécifiques après le retrait d'adb et avant l'appareil est à nouveau connecté. L'implémentation par défaut n'inclut aucune autre action. Il n'est pas garanti que la racine adb soit désactivée à ce stade.
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public void postBootSetup ()
Suivez les instructions pour configurer l'appareil afin de le tester après chaque démarrage.
Doit être appelé une fois l'appareil entièrement démarré/disponible
En règle générale, il n'est pas nécessaire d'appeler cette méthode explicitement, car les implémentations doivent effectuer ces étapes automatiquement lors d'un redémarrage.
Il peut être nécessaire de l'appeler lorsque l'appareil redémarre en raison d'autres événements (par exemple, lorsqu'un la commande fastboot update est terminée).
Génère | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Des étapes supplémentaires pour un nettoyage spécifique à l'appareil sont requises et exécutées après l'appel est terminé.
Paramètres | |
---|---|
exception |
Throwable : le cas échéant, exception finale générée par l'échec de l'appel. |
PreInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Étapes supplémentaires pour une configuration spécifique à l'appareil qui sera exécutée sur l'appareil avant le flux d'appel.
Paramètres | |
---|---|
info |
IBuildInfo : IBuildInfo de l'appareil. |
attributes |
MultiMap : attributs stockés dans le contexte d'appel |
Génère | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
Fonction pull Dir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Récupérez de manière récursive le contenu du répertoire de l'appareil.
Paramètres | |
---|---|
deviceFilePath |
String : chemin d'accès absolu au fichier de la source distante |
localDir |
File : répertoire local dans lequel extraire les fichiers |
userId |
int : ID utilisateur à partir duquel effectuer l'extraction. |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été extrait. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
Fonction pull Dir
public boolean pullDir (String deviceFilePath, File localDir)
Récupérez de manière récursive le contenu du répertoire de l'appareil.
Paramètres | |
---|---|
deviceFilePath |
String : chemin d'accès absolu au fichier de la source distante |
localDir |
File : répertoire local dans lequel extraire les fichiers |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été extrait. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
Récupère un fichier depuis l'appareil.
Paramètres | |
---|---|
remoteFilePath |
String : chemin absolu vers le fichier sur l'appareil |
localFile |
File : fichier local dans lequel stocker le contenu. Si vous n'indiquez aucune valeur, le contenu sera
remplacé. |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été récupéré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
Récupère un fichier depuis l'appareil, le stocke dans un ERROR(/File)
temporaire local, puis l'affiche.
File
Paramètres | |
---|---|
remoteFilePath |
String : chemin absolu vers le fichier sur l'appareil |
userId |
int : ID utilisateur à partir duquel effectuer l'extraction. |
Renvoie | |
---|---|
File |
Un ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si le
Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Génère | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Récupère un fichier depuis l'appareil, le stocke dans un ERROR(/File)
temporaire local, puis l'affiche.
File
Paramètres | |
---|---|
remoteFilePath |
String : chemin absolu vers le fichier sur l'appareil |
Renvoie | |
---|---|
File |
Un ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si le
Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Génère | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Récupère un fichier depuis l'appareil.
Paramètres | |
---|---|
remoteFilePath |
String : chemin absolu vers le fichier sur l'appareil |
localFile |
File : fichier local dans lequel stocker le contenu. Si vous n'indiquez aucune valeur, le contenu sera
remplacé. |
userId |
int : ID utilisateur à partir duquel effectuer l'extraction. |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été récupéré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Récupère un fichier depuis l'appareil, puis renvoie son contenu.
Paramètres | |
---|---|
remoteFilePath |
String : chemin absolu vers le fichier sur l'appareil |
Renvoie | |
---|---|
String |
Un String contenant le contenu du fichier de l'appareil, ou null si le
Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Génère | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Méthode pratique permettant de récupérer un fichier de la mémoire de stockage externe de l'appareil, en le stockant dans un
ERROR(/File)
temporaire local et renvoyer une référence à ce File
.
Paramètres | |
---|---|
remoteFilePath |
String : chemin d'accès au fichier sur l'appareil, par rapport à son espace de stockage externe
Mountpoint |
Renvoie | |
---|---|
File |
Un ERROR(/File) contenant le contenu du fichier de l'appareil, ou null si le
Échec de la copie pour une raison quelconque (y compris des problèmes avec le système de fichiers hôte) |
Génère | |
---|---|
DeviceNotAvailableException |
Rép. push
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Transférez le contenu du répertoire de manière récursive sur l'appareil tout en excluant certains répertoires filtrée.
Paramètres | |
---|---|
localFileDir |
File : répertoire local à transférer |
deviceFilePath |
String : chemin d'accès absolu au fichier de la destination distante |
excludedDirectories |
: ensemble de noms de répertoires exclus à ne pas transférer. |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été transféré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
Rép. push
public boolean pushDir (File localFileDir, String deviceFilePath)
Transférez le contenu du répertoire de manière récursive sur l'appareil.
Paramètres | |
---|---|
localFileDir |
File : répertoire local à transférer |
deviceFilePath |
String : chemin d'accès absolu au fichier de la destination distante |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été transféré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
Rép. push
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Transférez le contenu du répertoire de manière récursive sur l'appareil.
Paramètres | |
---|---|
localFileDir |
File : répertoire local à transférer |
deviceFilePath |
String : chemin d'accès absolu au fichier de la destination distante |
userId |
int : ID utilisateur vers lequel transférer le contenu |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été transféré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
fichier push
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante de pushFile(File, String)
, qui peut éventuellement envisager d'évaluer le besoin
pour le fournisseur de contenu.
Paramètres | |
---|---|
localFile |
File : fichier local à transférer |
remoteFilePath |
String : chemin d'accès absolu au fichier de destination à distance |
evaluateContentProviderNeeded |
boolean : indique si nous avons besoin du fournisseur de contenu. |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été transféré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
fichier push
public boolean pushFile (File localFile, String remoteFilePath)
Transférer un fichier sur l'appareil Utilisation par défaut d'un fournisseur de contenu.
Paramètres | |
---|---|
localFile |
File : fichier local à transférer |
remoteFilePath |
String : chemin d'accès absolu au fichier de destination à distance |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été transféré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
fichier push
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Transférer un fichier sur l'appareil Utilisation par défaut d'un fournisseur de contenu.
Paramètres | |
---|---|
localFile |
File : fichier local à transférer |
remoteFilePath |
String : chemin d'accès absolu au fichier de destination à distance |
userId |
int : ID utilisateur vers lequel envoyer le transfert |
Renvoie | |
---|---|
boolean |
true si le fichier a bien été transféré. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Envoyer le fichier créé à partir d'une chaîne vers l'appareil
Paramètres | |
---|---|
contents |
String : contenu du fichier à transférer |
remoteFilePath |
String : chemin d'accès absolu au fichier de destination à distance |
Renvoie | |
---|---|
boolean |
true si la chaîne a bien été transmise. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer
public void reboot (String reason)
Redémarre l'appareil en mode adb avec la valeur reason
donnée pour être conservée lors du redémarrage.
Bloque jusqu'à ce que l'appareil soit disponible.
Vous pouvez obtenir le motif du dernier redémarrage en interrogeant la propriété sys.boot.reason
.
Paramètres | |
---|---|
reason |
String : motif de ce redémarrage ou null si aucun motif n'est spécifié. |
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer
public void reboot ()
Redémarre l'appareil en mode adb.
Bloque jusqu'à ce que l'appareil soit disponible.
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer le bootloader dans le bootloader
public void rebootIntoBootloader ()
Redémarre l'appareil en mode bootloader.
Blocages jusqu'à ce que l'appareil soit en mode bootloader.
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer
public void rebootIntoFastbootd ()
Redémarre l'appareil en mode fastbootd.
Blocages jusqu'à ce que l'appareil soit en mode fastbootd
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer votre navigateur
public void rebootIntoRecovery ()
Redémarre l'appareil en mode de récupération adb.
Blocages tant que l'appareil n'entre pas dans le processus de récupération
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer le chargement latéral
public void rebootIntoSideload ()
Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).
Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer le chargement latéral
public void rebootIntoSideload (boolean autoReboot)
Redémarre l'appareil en mode de chargement indépendant adb (notez qu'il s'agit d'un mode spécial en cas de récupération).
Blocages jusqu'à ce que l'appareil passe en mode de téléchargement indépendant
Paramètres | |
---|---|
autoReboot |
boolean : indique si l'appareil doit être redémarré automatiquement après un téléchargement indépendant. |
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer jusqu'au magasin en ligne
public void rebootUntilOnline ()
Alternative à reboot()
qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer jusqu'au magasin en ligne
public void rebootUntilOnline (String reason)
Alternative à reboot()
qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire visible par adb.
Paramètres | |
---|---|
reason |
String : motif de ce redémarrage ou null si aucun motif n'est spécifié. |
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer l'espace utilisateur
public void rebootUserspace ()
Redémarre uniquement une partie de l'espace utilisateur de l'appareil.
Bloque jusqu'à ce que l'appareil soit disponible.
AVERTISSEMENT. Le redémarrage de l'espace utilisateur est actuellement en cours de développement. Utilisez-le à vos propres risques.
Génère | |
---|---|
DeviceNotAvailableException |
redémarrer l'espaceUtilisateurJusqu'àEnligne
public void rebootUserspaceUntilOnline ()
Autre solution à rebootUserspace()
()} qui ne se bloque que jusqu'à ce que l'appareil soit en ligne, c'est-à-dire
visible par adb.
Génère | |
---|---|
DeviceNotAvailableException |
récupérer l'appareil
public boolean recoverDevice ()
Tentatives de récupération de la communication de l'appareil.
Renvoie | |
---|---|
boolean |
"True" en cas de tentative de récupération réussie, False si la récupération a été ignorée |
Génère | |
---|---|
DeviceNotAvailableException |
si l'appareil n'est plus disponible |
RegisterDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Enregistre un IDeviceActionReceiver
pour cet appareil.
Tous les IDeviceActionReceiver
enregistrés seront avertis avant toute action sur l'appareil
et après la fin de l'action sur l'appareil.
Paramètres | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver qui sera enregistré. |
réinstaller le système en lecture seule
public void remountSystemReadOnly ()
Rendez la partition système de l'appareil en lecture seule. Peut redémarrer l'appareil.
Génère | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Rendez la partition système de l'appareil accessible en écriture. Peut redémarrer l'appareil.
Génère | |
---|---|
DeviceNotAvailableException |
réinstallerVendorReadOnly
public void remountVendorReadOnly ()
Définissez la partition du fournisseur sur l'appareil en lecture seule. Peut redémarrer l'appareil.
Génère | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Rendez la partition du fournisseur accessible en écriture sur l'appareil. Peut redémarrer l'appareil.
Génère | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Supprimer l'administrateur de l'appareil indiqué pour l'utilisateur concerné et renvoyer true
si l'opération réussit, ou false
dans le cas contraire.
Paramètres | |
---|---|
componentName |
String : de l'administrateur de l'appareil à supprimer. |
userId |
int : de l'utilisateur dans lequel réside l'administrateur de l'appareil. |
Renvoie | |
---|---|
boolean |
"True" en cas de réussite, sinon "false". |
Génère | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.
Génère | |
---|---|
DeviceNotAvailableException |
Supprimer l'utilisateur
public boolean removeUser (int userId)
Supprimer un utilisateur donné de l'appareil
Paramètres | |
---|---|
userId |
int : de l'utilisateur à supprimer |
Renvoie | |
---|---|
boolean |
"true" si nous avons réussi à supprimer l'utilisateur, "false" dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
réinitialiserContentProviderSetup
public void resetContentProviderSetup ()
Réinitialisez l'indicateur de configuration du fournisseur de contenu afin de le déclencher de nouveau.
exécuterInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Méthode pratique permettant d'exécuter ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
avec un ou plusieurs écouteurs transmis en tant que paramètres.
Paramètres | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner qui exécute les tests. |
listeners |
ITestLifeCycleReceiver : le ou les écouteurs des résultats du test. |
Renvoie | |
---|---|
boolean |
true si la commande de test est terminée. false en cas d'échec
terminée, mais la récupération a réussi |
Génère | |
---|---|
DeviceNotAvailableException |
exécuterInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Exécute des tests d'instrumentation et permet de récupérer l'appareil.
Si la connexion à l'appareil est perdue avant la fin de l'exécution du test et que la récupération réussit, toutes les écouteurs seront informés de testRunFailed et "false" est renvoyé. La commande test ne seront pas réexécutées. Les appelants peuvent réessayer, si nécessaire.
Si la connexion à l'appareil est perdue avant la fin du test et que la récupération échoue, toutes les écouteurs seront informés de testRunFailed, et une exception DeviceNotAvailableException sera générée.
Paramètres | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner qui exécute les tests. |
listeners |
: écouteurs des résultats du test |
Renvoie | |
---|---|
boolean |
true si la commande de test est terminée. false en cas d'échec
terminée en raison d'une exception de communication de l'appareil, mais récupération réussie |
Génère | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Identique à ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, mais
exécute le test pour l'utilisateur donné.
Paramètres | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Identique à ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, mais exécute le test pour un utilisateur donné.
Paramètres | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
Définir une configuration
public void setConfiguration (IConfiguration configuration)
Il injecte les IConfiguration
en cours d'utilisation.
Paramètres | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Paramètres | |
---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
Définit la date sur l'appareil
Remarque: Pour définir la date sur l'appareil, vous devez être en mode root
Paramètres | |
---|---|
date |
Date : spécifie une date particulière. utilisera la date de l'hôte si null |
Génère | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Définissez un composant d'administrateur de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné.
Paramètres | |
---|---|
componentName |
String : pour que l'administrateur de l'appareil soit le propriétaire de l'appareil. |
userId |
int : correspond à l'utilisateur dans lequel réside le propriétaire de l'appareil. |
Renvoie | |
---|---|
boolean |
"True" en cas de réussite, sinon "false". |
Génère | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Mettez à jour l'état de l'appareil.
Paramètres | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Pour l'émulateur, définissez SizeLimitedOutputStream
pour consigner la sortie.
Paramètres | |
---|---|
output |
SizeLimitedOutputStream : pour consigner la sortie |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Définit Process
lorsque cet appareil est un émulateur.
Paramètres | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Définissez l'option fastboot pour l'appareil. Doit être défini lorsque l'appareil est le premier alloué.
Paramètres | |
---|---|
fastbootEnabled |
boolean : indique si fastboot est disponible pour l'appareil. |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Définit le chemin d'accès au binaire fastboot à utiliser.
Pour que les fonctions fastboot soient activées, isFastbootEnabled()
doit toujours être défini sur "true".
Paramètres | |
---|---|
fastbootPath |
String |
Définir l'appareil
public void setIDevice (IDevice newDevice)
Mettez à jour l'IDevice associé à cet ITestDevice.
Le nouvel IDevice doit faire référence au même appareil physique que la référence actuelle. Cette méthode est appelé si DCM a alloué un nouvel appareil
Paramètres | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Définit le délai d'attente, en millisecondes, avant de lancer la capture logcat pour un appareil en ligne.
Paramètres | |
---|---|
delay |
int : délai en ms. |
Définir les options
public void setOptions (TestDeviceOptions options)
Définir le TestDeviceOptions
pour l'appareil
Paramètres | |
---|---|
options |
TestDeviceOptions |
Définir une propriété
public boolean setProperty (String propKey, String propValue)
Définit la valeur de propriété donnée sur l'appareil. La valeur de la racine adb est "true".
Paramètres | |
---|---|
propKey |
String : clé ciblée à définir. |
propValue |
String : valeur de la propriété à définir. |
Renvoie | |
---|---|
boolean |
renvoie True si la commande setprop a abouti et la valeur "False" dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Définissez les IDeviceRecovery
à utiliser pour cet appareil. Doit être défini lors du premier appareil
alloué.
Paramètres | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Définissez le mode de récupération à utiliser pour l'appareil.
Permet de contrôler la méthode de récupération à utiliser en cas de problème de communication sur l'appareil rencontrés. Nous vous recommandons de n'utiliser cette méthode qu'avec parcimonie lorsque cela est nécessaire (par exemple, lorsque le framework est hors service, etc.
Paramètres | |
---|---|
mode |
ITestDevice.RecoveryMode : indique si la récupération doit être disponible en ligne uniquement. doit être activé ou non. |
Définir un paramètre
public void setSetting (String namespace, String key, String value)
Voir setSetting(int, String, String, String)
et effectué sur l'utilisateur système.
Paramètres | |
---|---|
namespace |
String |
key |
String |
value |
String |
Génère | |
---|---|
DeviceNotAvailableException |
Définir un paramètre
public void setSetting (int userId, String namespace, String key, String value)
Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné. Certains paramètres ne seront disponibles après un redémarrage. L'espace de noms doit être l'un des suivants: {"system", "secure", "global"}
Paramètres | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Génère | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Il injecte l'instance ITestLogger
.
Paramètres | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Pour la gestion des appareils, suivez le numéro de série que nous utilisons pour référencer l'appareil.
Paramètres | |
---|---|
trackingSerial |
String |
setUseFastbootEffacer
public void setUseFastbootErase (boolean useFastbootErase)
Indiquez si vous souhaitez utiliser le format fastboot ou le format fastboot pour effacer une partition de l'appareil.
Paramètres | |
---|---|
useFastbootErase |
boolean : true si l'effacement rapide doit être utilisé ou false si
le format fastboot doit être utilisé. |
startLogcat
public void startLogcat ()
Commencez à capturer la sortie logcat de l'appareil en arrière-plan.
N'aura aucun effet si la sortie logcat est déjà en cours de capture. Les données peuvent être récupérées ultérieurement via getLogcat.
Lorsque l'appareil n'est plus utilisé, stopLogcat()
doit être appelé.
Normalement, startLogcat()
et stopLogcat()
n'ont pas besoin d'être appelés lorsque
dans un contexte d'appel TF, car le framework TF démarre et arrête Logcat.
utilisateurdémarrer
public boolean startUser (int userId)
Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. Si l'utilisateur est déjà exécutée en arrière-plan, cette méthode est une opération NOOP.
Paramètres | |
---|---|
userId |
int : de l'utilisateur pour qu'il démarre en arrière-plan |
Renvoie | |
---|---|
boolean |
est défini sur "true" si l'utilisateur a démarré en arrière-plan. |
Génère | |
---|---|
DeviceNotAvailableException |
utilisateurdémarrer
public boolean startUser (int userId, boolean waitFlag)
Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. Si l'utilisateur est déjà exécutée en arrière-plan, cette méthode est une opération NOOP. Possibilité de fournir un indicateur supplémentaire à attendre l'opération à prendre en compte.
Paramètres | |
---|---|
userId |
int : de l'utilisateur pour qu'il démarre en arrière-plan |
waitFlag |
boolean : la commande attend que l'utilisateur soit démarré et déverrouillé. |
Renvoie | |
---|---|
boolean |
est défini sur "true" si l'utilisateur a démarré en arrière-plan. |
Génère | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui signifie que l'utilisateur pour lancer des activités sur cet affichage).
REMARQUE : Cette commande ne vérifie pas si l'utilisateur existe, si l'affichage est disponible, device supports such feature
, etc.
Paramètres | |
---|---|
userId |
int : de l'utilisateur pour qu'il démarre en arrière-plan |
displayId |
int : afficher pour que l'utilisateur soit visible sur |
waitFlag |
boolean : la commande attend que l'utilisateur soit démarré et déverrouillé. |
Renvoie | |
---|---|
boolean |
true si l'utilisateur a bien été démarré et visible en arrière-plan |
Génère | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Fermez et supprimez la sortie de l'émulateur.
stopLogcat
public void stopLogcat ()
Arrêtez la capture de la sortie logcat de l'appareil et supprimez les données logcat actuellement enregistrées.
N'aura aucun effet si la sortie logcat n'est pas capturée.
utilisateur stop
public boolean stopUser (int userId)
Arrête un utilisateur donné. Si l'utilisateur est déjà arrêté, cette méthode est NOOP. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.
Paramètres | |
---|---|
userId |
int : de l'utilisateur à arrêter. |
Renvoie | |
---|---|
boolean |
La valeur est définie sur "true" si l'utilisateur a bien été arrêté. |
Génère | |
---|---|
DeviceNotAvailableException |
utilisateur stop
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Arrêter un utilisateur donné. Possibilité de fournir des indicateurs supplémentaires pour attendre que l'opération prenne effet. et forcer l'arrêt de l'utilisateur. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.
Paramètres | |
---|---|
userId |
int : de l'utilisateur à arrêter. |
waitFlag |
boolean : la commande attend que l'utilisateur s'arrête. |
forceFlag |
boolean : force l'arrêt de l'utilisateur. |
Renvoie | |
---|---|
boolean |
La valeur est définie sur "true" si l'utilisateur a bien été arrêté. |
Génère | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Basculez l'appareil en mode adb-over-tcp.
Renvoie | |
---|---|
String |
Numéro de série du tcp ou null si l'appareil n'a pas pu être changé |
Génère | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Basculez l'appareil en mode adb via USB.
Renvoie | |
---|---|
boolean |
true si le changement a réussi, false dans le cas contraire. |
Génère | |
---|---|
DeviceNotAvailableException |
contacteur
public boolean switchUser (int userId)
Passez à un autre ID utilisateur avec un délai d'inactivité par défaut. switchUser(int, long)
.
Paramètres | |
---|---|
userId |
int |
Renvoie | |
---|---|
boolean |
"True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false". |
Génère | |
---|---|
DeviceNotAvailableException |
changer d'utilisateur
public boolean switchUser (int userId, long timeout)
Passez à un autre ID utilisateur avec le délai d'expiration fourni comme délai. Tentative de désactivation du verrouillage du clavier une fois la modification de l'utilisateur effectuée.
Paramètres | |
---|---|
userId |
int |
timeout |
long : attendre la valeur "false" avant de renvoyer la valeur "false" pour l'utilisateur switch-user. |
Renvoie | |
---|---|
boolean |
"True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false". |
Génère | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Synchronise de manière incrémentielle le contenu d'un répertoire de fichiers local sur l'appareil.
Décide les fichiers à transférer en comparant les codes temporels des fichiers locaux avec ceux des fichiers distants équivalents. 'plus récent' uniquement ou inexistants seront transférés sur l’appareil. Par conséquent, doit être relativement petite si le fichier installé sur l'appareil est déjà à jour.
Les fichiers masqués (dont le nom commence par ".") sont ignorés.
Exemple d'utilisation: syncFiles("/tmp/files", "/sdcard") crée un répertoire /sdcard/files si il n'existe pas encore, et il transfère le contenu de /tmp/files de manière récursive vers /sdcard/files.
Paramètres | |
---|---|
localFileDir |
File : répertoire de fichiers local contenant les fichiers à transférer de manière récursive. |
deviceFilePath |
String : racine du chemin d'accès absolu au fichier de destination à distance Tous les répertoires qu'il contient
le chemin d'accès au fichier doit être lisible. Par exemple, transfert vers /data/local/tmp lorsqu'adb n'est pas racine
échouera |
Renvoie | |
---|---|
boolean |
true si les fichiers ont bien été synchronisés. false dans les autres cas. |
Génère | |
---|---|
DeviceNotAvailableException |
TakeBugreport
public Bugreport takeBugreport ()
Créez un rapport de bug et renvoyez-le dans un objet Bugreport
pour le gérer. Valeur nulle
en cas de problème. Le fichier référencé dans l'objet Bugreport doit être nettoyé via Bugreport.close()
.
Renvoie | |
---|---|
Bugreport |
désinstaller le package
public String uninstallPackage (String packageName)
Désinstaller un package Android de l'appareil
Paramètres | |
---|---|
packageName |
String : package Android à désinstaller |
Renvoie | |
---|---|
String |
une String avec un code d'erreur, ou null en cas de réussite. |
Génère | |
---|---|
DeviceNotAvailableException |
désinstallerPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Désinstallez un package Android de l'appareil d'un utilisateur donné.
Paramètres | |
---|---|
packageName |
String : package Android à désinstaller |
userId |
int : ID utilisateur entier pour lequel désinstaller. |
Renvoie | |
---|---|
String |
une String avec un code d'erreur, ou null en cas de réussite. |
Génère | |
---|---|
DeviceNotAvailableException |
déverrouiller l'appareil
public boolean unlockDevice ()
Déverrouille l'appareil s'il est chiffré.
Cette méthode peut redémarrer le framework, mais n'appellera paspostBootSetup()
. Par conséquent,
l'appareil risque de ne pas être entièrement
prêt à être testé lorsque cette méthode sera renvoyée.
Renvoie | |
---|---|
boolean |
true en cas de réussite ou si l'appareil n'est pas chiffré. |
Génère | |
---|---|
DeviceNotAvailableException |
unmountDebugfs
public void unmountDebugfs ()
Désinstallez debugfs.
Génère | |
---|---|
DeviceNotAvailableException |
WaitForBootComplete
public boolean waitForBootComplete (long timeOut)
Bloque jusqu'à ce que l'indicateur de démarrage terminé de l'appareil soit défini.
Paramètres | |
---|---|
timeOut |
long : temps d'attente, exprimé en ms, pour que l'indicateur soit défini. |
Renvoie | |
---|---|
boolean |
"true" si l'indicateur de démarrage terminé de l'appareil est défini dans le délai avant expiration |
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Attend que l'appareil réponde et soit disponible pour des tests. Utilise le délai d'inactivité par défaut.
Renvoie | |
---|---|
boolean |
"True" si l'appareil est disponible, "False" si la récupération est désactivée et indisponible. |
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Attend que l'appareil réponde et soit disponible pour des tests.
Paramètres | |
---|---|
waitTime |
long : temps d'attente en ms. |
Renvoie | |
---|---|
boolean |
"True" si l'appareil est disponible, "False" si la récupération est désactivée et indisponible. |
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Attend que l'appareil soit réactif et disponible sans tenir compte du chemin de récupération.
Paramètres | |
---|---|
waitTime |
long |
Renvoie | |
---|---|
boolean |
"True" si l'appareil est disponible, "False" s'il n'est pas disponible. |
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceBootloader
public void waitForDeviceBootloader ()
Bloque jusqu'à ce que l'appareil soit visible en fastboot. Utiliser le délai avant expiration par défaut.
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blocs pour que l'appareil soit dans la récupération adb (notez qu'il ne s'agit pas
IDeviceRecovery
).
Paramètres | |
---|---|
waitTime |
long : temps d'attente en ms. |
Renvoie | |
---|---|
boolean |
true si la récupération de l'appareil est lancée avant l'expiration du délai.
false dans les autres cas |
WaitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blocs pour que l'appareil soit dans le téléchargement indépendant adb état
Paramètres | |
---|---|
waitTime |
long : temps d'attente en ms. |
Renvoie | |
---|---|
boolean |
true si l'appareil démarre en téléchargement indépendant avant l'expiration du délai. false
dans les autres cas |
WaitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blocages pour que l'appareil soit indisponible, c'est-à-dire absent d'adb
Paramètres | |
---|---|
waitTime |
long : temps d'attente en ms. |
Renvoie | |
---|---|
boolean |
true si l'appareil n'est plus disponible avant l'expiration du délai.
false dans les autres cas |
WaitForDeviceOnline
public void waitForDeviceOnline ()
Bloque jusqu'à ce que l'appareil soit visible via adb. Utilise le délai d'inactivité par défaut
Notez que l'appareil ne répond pas nécessairement aux commandes une fois l'opération terminée. Utilisez
waitForDeviceAvailable()
à la place.
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Bloque jusqu'à ce que l'appareil soit visible via adb.
Notez que l'appareil ne répond pas nécessairement aux commandes une fois l'opération terminée. Utilisez
waitForDeviceAvailable()
à la place.
Paramètres | |
---|---|
waitTime |
long : temps d'attente en ms. |
Génère | |
---|---|
DeviceNotAvailableException |
WaitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Attend que l'appareil réponde à une commande adb shell de base.
Paramètres | |
---|---|
waitTime |
long : temps d'attente en ms. |
Renvoie | |
---|---|
boolean |
true si l'appareil devient réactif avant que waitTime ne se soit écoulé. |
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)
Crée la commande OS pour la session de commande shell adb et les arguments donnés.
Paramètres | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Renvoie | |
---|---|
String[] |
checkApiLevelA par rapport à
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Paramètres | |
---|---|
feature |
String |
strictMinLevel |
int |
createRedémarrerDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Créez un RebootDeviceAction
à utiliser lors d'une action de redémarrage.
Paramètres | |
---|---|
rebootMode |
NativeDevice.RebootMode : mode de ce redémarrage. |
reason |
String : pour ce redémarrage. |
Renvoie | |
---|---|
NativeDevice.RebootDeviceAction |
le RebootDeviceAction créé. |
doAdbRedémarrer
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Effectuez un redémarrage adb.
Paramètres | |
---|---|
rebootMode |
NativeDevice.RebootMode : mode de ce redémarrage. |
reason |
String : pour ce redémarrage. |
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Assurez-vous que les autorisations d'exécution sont prises en charge
protected void ensureRuntimePermissionSupported ()
Méthode d'assistance permettant de générer une exception si l'autorisation d'exécution n'est pas prise en charge
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Renvoie | |
---|---|
int |
Initialiser la connexion
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Paramètres | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Génère | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
interneGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Récupère une propriété d'appareil, à partir du cache ddmlib par défaut, et en revenant à adb shell getprop" ou "fastboot getvar", selon que l'appareil est en Fastboot ou non.
Paramètres | |
---|---|
propName |
String : nom de la propriété de l'appareil renvoyé par "adb shell getprop" |
fastbootVar |
String : nom de la variable fastboot équivalente à interroger. si null ,
la requête fastboot ne sera pas tentée |
description |
String : description simple de la variable. La première lettre doit être en majuscule. |
Renvoie | |
---|---|
String |
Chaîne (éventuellement null ou vide) contenant la valeur de la propriété donnée |
Génère | |
---|---|
DeviceNotAvailableException |
isInRedémarrerCallback
protected boolean isInRebootCallback ()
Indique si des rappels de redémarrage sont en cours d'exécution ou non. Toutes les API publiques pour le redémarrage doit être désactivé si la valeur est "true".
Renvoie | |
---|---|
boolean |
isNewer (Plus récent)
protected boolean isNewer (File localFile, IFileEntry entry)
Renvoie true
si le fichier local est plus récent que le fichier distant. IFileEntry
étant
à la minute près, le fichier est considéré comme plus récent, même si les heures sont égales.
Paramètres | |
---|---|
localFile |
File |
entry |
IFileEntry |
Renvoie | |
---|---|
boolean |
VerifyRedémarrerEnded
protected void notifyRebootEnded ()
Notifie toutes les IDeviceActionReceiver
de l'événement de fin de redémarrage.
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
VerifyRedémarrerStarted
protected void notifyRebootStarted ()
Notifie toutes les IDeviceActionReceiver
de l'événement de début de redémarrage.
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performanceDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Effectue une action sur cet appareil. L'appareil tente de récupérer l'appareil et peut éventuellement relancer la commande si l'opération échoue.
Paramètres | |
---|---|
actionDescription |
String : brève description de l'action à effectuer. Utilisé pour la journalisation
uniquement. |
action |
NativeDevice.DeviceAction : action à effectuer |
retryAttempts |
int : la nouvelle tentative tente d'effectuer l'action en cas d'échec, mais la récupération réussit. |
Renvoie | |
---|---|
boolean |
true si l'action a bien été effectuée |
Génère | |
---|---|
DeviceNotAvailableException |
si la tentative de récupération échoue ou si le nombre maximal de tentatives est atteint sans succès |
postAdbRedémarrer
protected void postAdbReboot ()
Actions supplémentaires possibles après un redémarrage.
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
configuration prePostBootSetup
protected void prePostBootSetup ()
Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour configuration post-amorçage spécifique.
Génère | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Paramètres | |
---|---|
remoteFilePath |
String |
localFile |
File |
Renvoie | |
---|---|
boolean |
Génère | |
---|---|
DeviceNotAvailableException |
régler l'horloge
protected void setClock (Clock clock)
Définissez l'instance Clock à utiliser.
Paramètres | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marque l'appareil TestDevice comme microdroid et définit son numéro client.
Paramètres | |
---|---|
process |
Process : processus de la VM Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Paramètres | |
---|---|
deviceOptions |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Exécute une commande fastboot simple avec des variables d'environnement et indique l'état du .
Paramètres | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Renvoie | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Exécute une commande fastboot simple et indique l'état de la commande.
Paramètres | |
---|---|
timeout |
long |
fullCmd |
String |
Renvoie | |
---|---|
CommandResult |
WaitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Attendez que l'appareil devienne indisponible (arrêtez de signaler à adb).
Paramètres | |
---|---|
operationDesc |
String : nom de l'opération en attente d'indisponibilité. |
time |
long : délai d'attente avant l'indisponibilité. |
Renvoie | |
---|---|
boolean |
"True" si l'appareil est devenu indisponible. |