Appareil de test
public
class
TestDevice
extends NativeDevice
Sous-classes directes connues
|
Sous-classes indirectes connues
|
Implémentation d'un ITestDevice
pour un appareil Android full stack
Résumé
Champs |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Commandes permettant de désactiver la protection du clavier.
|
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)
|
Champs
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Commandes permettant de désactiver la protection du clavier.
Constructeurs publics
Méthodes publiques
CanSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.
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. |
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éé |
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éé |
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éé |
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. |
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)
doesFileExist
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. |
doesFileExist
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. |
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. |
GetActiveApexes
public getActiveApexes ()
Récupérez les informations sur les apex activés sur l'appareil.
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é. |
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é.
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. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Récupérer des informations sur un package installé sur l'appareil
Paramètres |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Récupère des informations sur les packages installés sur l'appareil.
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).
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
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème.
getCurrentUser
public int getCurrentUser ()
Renvoie l'identifiant de l'utilisateur actuel. En cas d'erreur, renvoyez -10000.
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).
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. |
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.
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. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Obtenez les informations sur les modules principaux installés sur l'appareil.
Renvoie |
|
ERROR(/Set) module principal sur String actuellement installé sur l'appareil. |
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 |
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 |
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. |
getScreenshot
public InputStreamSource getScreenshot ()
Permet de prendre une capture d'écran de l'appareil.
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 |
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. |
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. |
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 |
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 |
la valeur associée à l'espace de noms "namespace:key" d'un utilisateur. Null si introuvable. |
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. |
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.
Renvoie |
int |
les indicateurs associés à l'ID utilisateur fourni s'il est trouvé, -10000 dans les autres cas. |
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. |
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.
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. |
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. |
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. |
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. |
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. |
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. |
Installation de packages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Paramètres |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
Installation de packages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Paramètres |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
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 |
installPackagespour l'utilisateur
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Paramètres |
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Paramètres |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Paramètres |
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
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 |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Indique si l'appareil utilise le mode utilisateur système headless.
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.
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 |
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". |
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". |
isUserRunning
public boolean isUserRunning (int userId)
Vérifiez si un utilisateur donné est en cours d'exécution.
Renvoie |
boolean |
"True" si l'utilisateur est en cours d'exécution, "false" dans tous les autres cas. |
isUserSecondaire
public boolean isUserSecondary (int userId)
Indique si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.
Renvoie |
boolean |
La valeur est "true" si l'utilisateur est un utilisateur secondaire, et la valeur "false" dans le cas contraire. |
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).
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 |
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. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Récupère la liste des écrans pouvant être utilisés pour start a user visible in the background
.
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. |
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 |
"True" si la journalisation a réussi, sinon "false". |
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". |
removeOwners
public void removeOwners ()
Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.
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. |
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". |
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 |
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 |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Arrête le dispositif microdroïde, s'il existe.
Paramètres |
microdroidDevice |
ITestDevice |
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. |
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. |
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 |
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é. |
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é. |
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)
.
Renvoie |
boolean |
"True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false". |
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". |
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()
.
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. |
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. |
attendForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Paramètres |
currentPhase |
SnapuserdWaitPhase |
Méthodes protégées
createParser
protected AaptParser createParser (File appFile)
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. |
getBugreportzInternal
protected File getBugreportzInternal ()
Méthode d'assistance interne permettant d'obtenir le fichier ZIP bugreportz en tant que ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Exposée à des fins de test.
getHostCurrentTime
protected long getHostCurrentTime ()
Exposée à des fins de test
configuration prePostBootSetup
protected void prePostBootSetup ()
Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour
configuration post-amorçage spécifique.