Appareil de test

public class TestDevice
extends NativeDevice

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


Implémentation d'un ITestDevice pour un appareil Android full stack

Résumé

Classes imbriquées

class TestDevice.MicrodroidBuilder

Compilateur utilisé pour créer un Microdroid TestDevice. 

Champs

public static final String DISMISS_KEYGUARD_CMD

Commandes permettant de désactiver la protection du clavier.

Constructeurs publics

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Méthodes publiques

boolean canSwitchToHeadlessSystemUser()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.

boolean clearErrorDialogs()

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

int createUser(String name)

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

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, boolean guest, boolean ephemeral)

Créer un utilisateur avec un nom donné et les options fournies

int createUserNoThrow(String name)

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

void disableKeyguard()

Tente de désactiver la protection du clavier.

boolean doesFileExist(String deviceFilePath)

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

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

File dumpHeap(String process, String devicePath)

Essayez de vider le tas de mémoire à partir de system_server.

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

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.

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.

InputStreamSource getBugreport()

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

InputStreamSource getBugreportz()

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

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.

getFoldableStates()

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

getInstalledPackageNames()

Récupérez les noms des packages d'application présents sur 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.

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

Integer getPrimaryUserId()

Renvoie l'identifiant de l'utilisateur principal.

InputStreamSource getScreenshot()

Permet de prendre une capture d'écran de l'appareil.

InputStreamSource getScreenshot(String format, boolean rescale)

Permet de prendre une capture d'écran de 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.

String getSetting(String namespace, String key)

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

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

Renvoie la valeur du paramètre demandé.

getUninstallablePackageNames()

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

int getUserFlags(int userId)

Rechercher et renvoyer les indicateurs d'un utilisateur donné

getUserInfos()

Récupère la carte de useId sur UserInfo sur l'appareil.

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.

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 installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)

Installer un package Android sur l'appareil

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

Installer un package Android sur l'appareil d'un utilisateur donné

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

Installer un package Android sur l'appareil d'un utilisateur donné

String installPackages( packageFiles, boolean reinstall, String... extraArgs)

String installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

String installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)

String installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)

String installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

boolean isAppEnumerationSupported()

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

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)

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

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 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 ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

boolean isVisibleBackgroundUsersSupported()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.

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 start a user visible in the background.

listUsers()

Récupère la liste des utilisateurs 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 notifySnapuserd(SnapuserdWaitPhase waitPhase)
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é.

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.

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

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 setSetting(String namespace, String key, String value)

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

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 shutdownMicrodroid(ITestDevice microdroidDevice)

Arrête le dispositif microdroïde, s'il existe.

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

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

Arrêter un utilisateur donné.

boolean stopUser(int userId)

Arrête un utilisateur donné.

boolean supportsMicrodroid()

Vérifie les conditions préalables à l'exécution d'un microdroïde.

boolean supportsMicrodroid(boolean protectedVm)

Vérifie les conditions préalables à l'exécution d'un microdroïde.

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.

Bugreport takeBugreport()

Créez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer.

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

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Méthodes protégées

AaptParser createParser(File appFile)
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

Effectuez un redémarrage adb.

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

Méthode d'assistance interne permettant d'obtenir le fichier ZIP bugreportz en tant que ERROR(/File).

long getCheckNewUserSleep()

Exposée à des fins de test.

long getHostCurrentTime()

Exposée à des fins de test

void prePostBootSetup()

Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour configuration post-amorçage spécifique.

Champs

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Commandes permettant de désactiver la protection du clavier.

Constructeurs publics

Appareil de test

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

Méthodes publiques

CanSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.

Renvoie
boolean

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

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

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

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

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

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

GetActiveApexes

public  getActiveApexes ()

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

public  getAllSettings (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

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

public  getAndroidIds ()

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

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

public  getAppPackageInfos ()

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

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.

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

getFoldableStates

public  getFoldableStates ()

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

getInstallPackageNames

public  getInstalledPackageNames ()

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

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

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

public  getMainlineModuleInfo ()

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

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

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

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

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

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

getDésinstallerablePackageNames

public  getUninstallablePackageNames ()

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

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

public  getUserInfos ()

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

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:" ou "" directement.

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

Installer le package

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                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.

certFile File: true si une réinstallation doit être effectuée.

reinstall 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, 
                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

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

Installation de packages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Paramètres
packageFiles

reinstall boolean

extraArgs String

Renvoie
String

Génère
DeviceNotAvailableException

Installation de packages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Paramètres
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Renvoie
String

Génère
DeviceNotAvailableException

installPackagespour l'utilisateur

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Paramètres
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Renvoie
String

Génère
DeviceNotAvailableException

installPackagespour l'utilisateur

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Paramètres
packageFiles

reinstall boolean

userId int

extraArgs String

Renvoie
String

Génère
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Paramètres
remoteApkPaths

reinstall boolean

extraArgs String

Renvoie
String

Génère
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Paramètres
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Renvoie
String

Génère
DeviceNotAvailableException

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

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)

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

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

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

listDisplayIds

public  listDisplayIds ()

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

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

public  listUsers ()

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

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.

notifierSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Paramètres
waitPhase SnapuserdWaitPhase

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.

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

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

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

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Arrête le dispositif microdroïde, s'il existe.

Paramètres
microdroidDevice ITestDevice

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

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

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

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

SupportMicrodroid

public boolean supportsMicrodroid ()

Vérifie les conditions préalables à l'exécution d'un microdroïde.

Renvoie
boolean renvoie "true" si les conditions préalables sont remplies et "false" dans le cas contraire.

SupportMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Vérifie les conditions préalables à l'exécution d'un microdroïde.

Paramètres
protectedVm boolean: vrai si le microdroid est destiné à s'exécuter sur une VM protégée.

Renvoie
boolean renvoie "true" si les conditions préalables sont remplies et "false" dans le cas contraire.

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

contacteur

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

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

attendForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Paramètres
currentPhase SnapuserdWaitPhase

Génère
DeviceNotAvailableException

Méthodes protégées

createParser

protected AaptParser createParser (File appFile)

Paramètres
appFile File

Renvoie
AaptParser

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

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Renvoie
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Méthode d'assistance interne permettant d'obtenir le fichier ZIP bugreportz en tant que ERROR(/File).

Renvoie
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposée à des fins de test.

Renvoie
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposée à des fins de test

Renvoie
long

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
DeviceNotAvailableException