Classes imbriquées |
---|
class | TestDevice.MicrodroidBuilder Un constructeur utilisé pour créer un Microdroid TestDevice. |
Des champs |
---|
public static final String | DISMISS_KEYGUARD_CMD Commandes qui peuvent être utilisées pour désactiver le protège-clavier. |
Méthodes publiques |
---|
boolean | canSwitchToHeadlessSystemUser () Renvoie s'il est autorisé à passer à l'utilisateur SYSTEM sans tête. |
boolean | clearErrorDialogs () Essayez de fermer toutes les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil. |
int | createUser (String name) Créez un utilisateur avec un nom donné et des drapeaux par défaut 0. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Créer un utilisateur avec un nom donné et les drapeaux fournis |
int | createUser (String name, boolean guest, boolean ephemeral) Créer un utilisateur avec un nom donné et les drapeaux fournis |
int | createUserNoThrow (String name) Créez un utilisateur avec un nom donné et des drapeaux par défaut 0. |
void | disableKeyguard () Tente de désactiver le verrouillage du clavier. |
boolean | doesFileExist (String deviceFilePath) Méthode d'assistance pour déterminer si le fichier sur l'appareil existe. |
boolean | doesFileExist (String deviceFilePath, int userId) Méthode d'assistance pour déterminer si le fichier sur l'appareil existe pour un utilisateur donné. |
File | dumpHeap (String process, String devicePath) Essayez de vider le tas du 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) Recherche et renvoie l'identifiant android associé à un userId, null s'il n'est pas trouvé. |
| getAndroidIds () Créez une carte des identifiants Android trouvés correspondant aux identifiants d'utilisateur. |
PackageInfo | getAppPackageInfo (String packageName) Récupérer des informations sur un package installé sur l'appareil. |
| getAppPackageInfos () Récupérer les informations des packages installés sur l'appareil. |
InputStreamSource | getBugreport () Récupère un rapport de bogue de l'appareil. |
InputStreamSource | getBugreportz () Récupère un bugreportz de l'appareil. |
DeviceFoldableState | getCurrentFoldableState () Renvoie l'état pliable actuel de l'appareil ou null si des problèmes se sont produits. |
int | getCurrentUser () Renvoie l'identifiant de l'utilisateur en cours d'exécution. |
| getFoldableStates () Renvoie la liste des états pliables sur l'appareil. |
| getInstalledPackageNames () Récupérez les noms des packages d'applications présents sur l'appareil. |
KeyguardControllerState | getKeyguardState () Renvoie un objet pour obtenir l'état actuel du keyguard ou null s'il n'est pas pris en charge. |
Integer | getMainUserId () Renvoie l'identifiant de l'utilisateur principal. |
| getMainlineModuleInfo () Obtenez les informations sur les modules principaux installés sur l'appareil. |
int | getMaxNumberOfRunningUsersSupported () Obtenez le nombre maximum d'utilisateurs fonctionnant simultanément pris en charge. |
int | getMaxNumberOfUsersSupported () Obtenez le nombre maximum d'utilisateurs pris en charge. |
Integer | getPrimaryUserId () Renvoie l'ID utilisateur principal. |
InputStreamSource | getScreenshot () Prend une capture d'écran de l'appareil. |
InputStreamSource | getScreenshot (String format, boolean rescale) Prend une capture d'écran de l'appareil. |
InputStreamSource | getScreenshot (String format) Prend une capture d'écran de l'appareil. |
InputStreamSource | getScreenshot (long displayId) Prend une capture d'écran de l'appareil avec 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) Recherche et renvoie les drapeaux d'un utilisateur donné. |
| getUserInfos () Obtient la carte de useId à UserInfo sur l'appareil. |
int | getUserSerialNumber (int userId) Renvoie le numéro de série associé à l'userId s'il est trouvé, -10000 dans tous les autres cas. |
boolean | hasFeature (String feature) Vérifiez si une fonctionnalité est disponible sur un appareil. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Installez un package Android sur l'appareil. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installez un package Android sur l'appareil. |
String | installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) Installez un package Android sur l'appareil. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installez un package Android sur l'appareil pour un utilisateur donné. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Installez un package Android sur l'appareil pour un utilisateur donné. |
String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) |
String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications |
boolean | isHeadlessSystemUserMode () Indique si l'appareil utilise le mode utilisateur du système sans tête. |
boolean | isMainUserPermanentAdmin () Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ou rétrogradé au statut de non-administrateur. |
boolean | isMultiUserSupported () Détermine si le multi-utilisateur est pris en charge. |
boolean | isPackageInstalled (String packageName) Interrogez l'appareil pour un nom de package donné pour vérifier s'il est actuellement installé ou non. |
boolean | isPackageInstalled (String packageName, String userId) Interrogez l'appareil pour un nom de package donné et un identifiant d'utilisateur donné pour vérifier s'il est actuellement installé ou non pour cet utilisateur. |
boolean | isUserRunning (int userId) Vérifiez si un utilisateur donné est en cours d'exécution. |
boolean | isUserSecondary (int userId) Retourne si l'utilisateur spécifié est un utilisateur secondaire selon ses drapeaux. |
boolean | isUserVisible (int userId) Vérifie si l'utilisateur donné est visible. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Vérifie si l'utilisateur donné est visible dans l'affichage donné. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Indique si l'appareil autorise les utilisateurs à démarrer visible en arrière-plan dans le ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan. |
| listDisplayIds () Collectez la liste des identifiants d'affichage disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger". |
| listDisplayIdsForStartingVisibleBackgroundUsers () Obtient la liste des affichages pouvant être utilisés pour start a user visible in the background . |
| listUsers () Obtient la liste des utilisateurs sur l'appareil. |
boolean | logBugreport (String dataName, ITestLogger listener) Méthode d'assistance pour prendre un rapport de bogue et le consigner aux reporters. |
void | postInvocationTearDown (Throwable exception) Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui seront exécutés une fois l'invocation terminée. |
boolean | removeAdmin (String componentName, int userId) Supprimez l'administrateur de l'appareil donné dans l'utilisateur donné et renvoyez true si cela réussit, false sinon. |
void | removeOwners () Supprimez tous les propriétaires de profils d'appareils existants avec le meilleur effort. |
boolean | removeUser (int userId) Supprimer un utilisateur donné de l'appareil. |
boolean | setDeviceOwner (String componentName, int userId) Définissez un composant d'administration de l'appareil en tant que propriétaire de l'appareil dans 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) Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné. |
void | shutdownMicrodroid ( ITestDevice microdroidDevice) Arrête le dispositif microdroid, s'il en existe un. |
boolean | startUser (int userId) Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. |
boolean | startUser (int userId, boolean waitFlag) Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Démarre un utilisateur donné en arrière-plan, visible dans l'affichage donné (c'est-à-dire, permettant à l'utilisateur de lancer des activités dans cet affichage). |
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 pour exécuter un microdroid. |
boolean | supportsMicrodroid (boolean protectedVm) Vérifie les conditions préalables pour exécuter un microdroid. |
boolean | switchUser (int userId) Basculez vers un autre ID utilisateur avec un délai d'expiration par défaut. |
boolean | switchUser (int userId, long timeout) Passez à un autre ID utilisateur avec le délai d'expiration fourni comme date limite. |
Bugreport | takeBugreport () Prend un rapport de bogue et le renvoie dans un objet Bugreport pour le gérer. |
String | uninstallPackage (String packageName) Désinstallez un package Android de l'appareil. |
String | uninstallPackageForUser (String packageName, int userId) Désinstallez un package Android de l'appareil pour un utilisateur donné. |
Des champs
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Commandes qui peuvent être utilisées pour désactiver le protège-clavier.
Constructeurs publics
Méthodes publiques
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Renvoie s'il est autorisé à passer à l'utilisateur SYSTEM sans tête.
clearErrorDialogs
public boolean clearErrorDialogs ()
Essayez de fermer toutes les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil.
Retour |
---|
boolean | true si aucune boîte de dialogue n'était présente ou si les boîtes de dialogue ont été effacées avec succès. false sinon. |
Créer un utilisateur
public int createUser (String name)
Créez un utilisateur avec un nom donné et des drapeaux par défaut 0.
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
Retour |
---|
int | l'entier de l'identifiant utilisateur créé |
Créer un utilisateur
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Créer un utilisateur avec un nom donné et les drapeaux fournis
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
guest | boolean : active le drapeau utilisateur --guest lors de la création |
ephemeral | boolean : active le flag utilisateur --ephemeral lors de la création |
forTesting | boolean : active le drapeau de test --for-testing lors de la création |
Retour |
---|
int | identifiant de l'utilisateur créé |
Créer un utilisateur
public int createUser (String name,
boolean guest,
boolean ephemeral)
Créer un utilisateur avec un nom donné et les drapeaux fournis
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
guest | boolean : active le drapeau utilisateur --guest lors de la création |
ephemeral | boolean : active le flag utilisateur --ephemeral lors de la création |
Retour |
---|
int | identifiant de l'utilisateur créé |
createUserNoThrow
public int createUserNoThrow (String name)
Créez un utilisateur avec un nom donné et des drapeaux par défaut 0.
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
Retour |
---|
int | l'entier pour l'ID utilisateur créé ou -1 pour l'erreur. |
désactiverKeyguard
public void disableKeyguard ()
Tente de désactiver le verrouillage du clavier.
Attendez d'abord que l'envoi d'entrée soit prêt, cela se produit à peu près au même moment où l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework a parfois une condition de concurrence. Ensuite, la commande est envoyée pour supprimer le keyguard (fonctionne uniquement sur les non sécurisés)
est-ce queFichierExiste
public boolean doesFileExist (String deviceFilePath)
Méthode d'assistance pour déterminer si le fichier sur l'appareil existe.
Paramètres |
---|
deviceFilePath | String : le chemin absolu du fichier sur l'appareil à vérifier |
Retour |
---|
boolean | true si le fichier existe, false sinon. |
est-ce queFichierExiste
public boolean doesFileExist (String deviceFilePath,
int userId)
Méthode d'assistance pour déterminer si le fichier sur l'appareil existe pour un utilisateur donné.
Paramètres |
---|
deviceFilePath | String : le chemin absolu du fichier sur l'appareil à vérifier |
userId | int : l'ID utilisateur par rapport auquel vérifier l'existence du fichier |
Retour |
---|
boolean | true si le fichier existe, false sinon. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Essayez de vider le tas du system_server. Il est de la responsabilité de l'appelant de nettoyer le fichier vidé.
Paramètres |
---|
process | String : le nom du processus de périphérique sur lequel effectuer le dumpheap. |
devicePath | String : le chemin sur le périphérique où placer le dump. Il doit s'agir d'un emplacement où les autorisations le permettent. |
Retour |
---|
File | l' ERROR(/File) contenant le rapport. Null si quelque chose a échoué. |
getActiveApexes
public getActiveApexes ()
Récupérez les informations sur les APEX activés sur l'appareil.
getAllSettings
public getAllSettings (String namespace)
Renvoie les paires clé-valeur de l'espace de noms demandé.
Paramètres |
---|
namespace | String : doit être l'une des {"system", "secure", "global"} |
Retour |
---|
| la carte des paires clé-valeur. Null si l'espace de noms n'est pas pris en charge. |
getAndroidId
public String getAndroidId (int userId)
Recherche et renvoie l'identifiant android associé à un userId, null s'il n'est pas trouvé.
getAndroidIds
public getAndroidIds ()
Créez une carte des identifiants Android trouvés correspondant aux identifiants d'utilisateur. Il n'y a aucune garantie que chaque identifiant d'utilisateur trouvera un identifiant Android associé à cette fonction, de sorte que certains identifiants d'utilisateur peuvent correspondre à null.
Retour |
---|
| Carte des identifiants Android trouvés correspondant aux identifiants d'utilisateur. |
getAppPackageInfogetAppPackageInfo
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érer les informations des packages installés sur l'appareil.
getBugreport
public InputStreamSource getBugreport ()
Récupère un rapport de bogue de l'appareil.
La mise en œuvre de ceci est garantie de continuer à fonctionner sur un appareil sans carte SD (ou sur lequel la carte SD n'est pas encore montée).
getBugreportz
public InputStreamSource getBugreportz ()
Récupère un bugreportz de l'appareil. Le rapport de bogue au format Zip contient le rapport de bogue principal et d'autres fichiers journaux utiles pour le débogage.
Uniquement pris en charge pour la 'version adb'> 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Renvoie l'état pliable actuel de l'appareil ou null si des problèmes se sont produits.
getCurrentUser
public int getCurrentUser ()
Renvoie l'identifiant de l'utilisateur en cours d'exécution. En cas d'erreur, retourne -10000.
getFoldableStates
public getFoldableStates ()
Renvoie la liste des états pliables sur l'appareil. Peut être obtenu avec "cmd device_state print-states".
getInstalledPackageNames
public getInstalledPackageNames ()
Récupérez les noms des packages d'applications présents sur l'appareil.
Retour |
---|
| ERROR(/Set) des noms de packages String actuellement installés sur l'appareil. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Renvoie un objet pour obtenir l'état actuel du keyguard ou null s'il n'est pas pris en charge.
getMainUserId
public Integer getMainUserId ()
Renvoie l'identifiant de l'utilisateur principal.
Retour |
---|
Integer | l'userId de l'utilisateur principal s'il y en a un, et null s'il n'y a pas d'utilisateur principal. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Obtenez les informations sur les modules principaux installés sur l'appareil.
Retour |
---|
| ERROR(/Set) des modules principaux String actuellement installés sur l'appareil. |
public int getMaxNumberOfRunningUsersSupported ()
Obtenez le nombre maximum d'utilisateurs fonctionnant simultanément pris en charge. La valeur par défaut est 0.
Retour |
---|
int | un entier indiquant le nombre d'utilisateurs en cours d'exécution simultanément |
public int getMaxNumberOfUsersSupported ()
Obtenez le nombre maximum d'utilisateurs pris en charge. La valeur par défaut est 0.
Retour |
---|
int | un entier indiquant le nombre d'utilisateurs pris en charge |
getPrimaryUserId
public Integer getPrimaryUserId ()
Renvoie l'ID utilisateur principal.
Retour |
---|
Integer | l'userId de l'utilisateur principal s'il y en a un, et null s'il n'y a pas d'utilisateur principal. |
obtenir une capture d'écran
public InputStreamSource getScreenshot ()
Prend une capture d'écran de l'appareil.
obtenir une capture d'écran
public InputStreamSource getScreenshot (String format,
boolean rescale)
Prend une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot(String)
à la place avec l'encodage JPEG pour une taille plus petite.
Paramètres |
---|
format | String : PNG, JPEG pris en charge |
rescale | boolean : si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante |
obtenir une capture d'écran
public InputStreamSource getScreenshot (String format)
Prend une capture d'écran de l'appareil. Recommandé d'utiliser getScreenshot(format) à la place avec l'encodage JPEG pour une taille plus petite
Paramètres |
---|
format | String : PNG, JPEG pris en charge |
obtenir une capture d'écran
public InputStreamSource getScreenshot (long displayId)
Prend une capture d'écran de l'appareil avec l'identifiant d'affichage. Le format est PNG.
À FAIRE : étendre les implémentations ci-dessus pour prendre en charge le "format" et le "redimensionnement"
Paramètres |
---|
displayId | long : l'identifiant d'affichage de l'écran à partir duquel obtenir une 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 |
Retour |
---|
String | la valeur associée au namespace:key d'un utilisateur. Null si introuvable. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Récupérez les noms des packages d'application qui peuvent être désinstallés. Ceci est actuellement défini comme des packages non système et des packages système mis à jour.
Retour |
---|
| ERROR(/Set) des noms de packages String désinstallables actuellement installés sur l'appareil. |
getUserFlags
public int getUserFlags (int userId)
Recherche et renvoie les drapeaux d'un utilisateur donné. Les drapeaux sont définis dans la classe "android.content.pm.UserInfo" dans Android Open Source Project.
Retour |
---|
int | les drapeaux associés à l'ID utilisateur fourni s'il est trouvé, -10000 dans tous les autres cas. |
getUserInfos
public getUserInfos ()
Obtient la carte de useId à UserInfo
sur l'appareil. Lèvera DeviceRuntimeException
si la sortie de l'appareil n'est pas celle attendue.
Retour |
---|
| la liste des objets UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Renvoie le numéro de série associé à l'userId s'il est trouvé, -10000 dans tous les autres cas.
aFonctionnalité
public boolean hasFeature (String feature)
Vérifiez si une fonctionnalité est disponible sur un appareil.
Paramètres |
---|
feature | String : quel format doit être "fonction : " ou " " directement. |
Retour |
---|
boolean | Vrai si la fonctionnalité est trouvée, faux sinon. |
installer le paquet
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Installez un package Android sur l'appareil.
Paramètres |
---|
packageFile | File : le fichier apk à installer |
reinstall | boolean : true si une réinstallation doit être effectuée |
extraArgs | String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles. |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
installer le paquet
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installez un package Android sur l'appareil.
Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.
Paramètres |
---|
packageFile | File : le fichier apk à installer |
reinstall | boolean : true si une réinstallation doit être effectuée |
grantPermissions | boolean : si toutes les autorisations d'exécution doivent être accordées au moment de l'installation |
extraArgs | String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles. |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
installer le paquet
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Installez un package Android sur l'appareil.
Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.
Paramètres |
---|
packageFile | File : le fichier apk à installer |
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 les options disponibles. |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Installez un package Android sur l'appareil pour un utilisateur donné.
Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.
Paramètres |
---|
packageFile | File : le fichier apk à installer |
reinstall | boolean : true si une réinstallation doit être effectuée |
grantPermissions | boolean : si toutes les autorisations d'exécution doivent être accordées au moment de l'installation |
userId | int : l'ID utilisateur entier pour lequel installer. |
extraArgs | String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles. |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Installez un package Android sur l'appareil pour un utilisateur donné.
Paramètres |
---|
packageFile | File : le fichier apk à installer |
reinstall | boolean : true si une réinstallation doit être effectuée |
userId | int : l'ID utilisateur entier pour lequel installer. |
extraArgs | String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles. |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
installPackagesForUser
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 |
isAppEnumerationSupportedisAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications
Retour |
---|
boolean | True si l'énumération des applications est prise en charge, false sinon |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Indique si l'appareil utilise le mode utilisateur du système sans tête.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ou rétrogradé au statut de non-administrateur.
isMultiUserSupported
public boolean isMultiUserSupported ()
Détermine si le multi-utilisateur est pris en charge.
Retour |
---|
boolean | true si le multi-utilisateur est pris en charge, false sinon |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Interrogez l'appareil pour un nom de package donné pour vérifier s'il est actuellement installé ou non.
Paramètres |
---|
packageName | String |
Retour |
---|
boolean | True si le package est signalé comme installé. Faux sinon. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Interrogez l'appareil pour un nom de package donné et un identifiant d'utilisateur donné pour vérifier s'il est actuellement installé ou non pour cet utilisateur.
Paramètres |
---|
packageName | String : le paquet dont nous vérifions s'il est installé. |
userId | String : l'ID utilisateur pour lequel nous vérifions que le package est installé. Si null, l'utilisateur principal zéro sera utilisé. |
Retour |
---|
boolean | True si le package est signalé comme installé. Faux sinon. |
isUserRunning
public boolean isUserRunning (int userId)
Vérifiez si un utilisateur donné est en cours d'exécution.
Retour |
---|
boolean | Vrai si l'utilisateur est en cours d'exécution, faux dans tous les autres cas. |
isUserSecondary
public boolean isUserSecondary (int userId)
Retourne si l'utilisateur spécifié est un utilisateur secondaire selon ses drapeaux.
Retour |
---|
boolean | true si l'utilisateur est secondaire, false sinon. |
isUserVisible
public boolean isUserVisible (int userId)
Vérifie si l'utilisateur donné est visible.
Un utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et qui est donc capable de lancer des activités de lancement (généralement dans l'affichage par défaut).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Vérifie si l'utilisateur donné est visible dans l'affichage donné.
Un utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et qui est donc capable de lancer des activités de lancement dans cet affichage.
Paramètres |
---|
userId | int |
displayId | int |
listDisplayIdslistDisplayIds
public listDisplayIds ()
Collectez la liste des identifiants d'affichage disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
Retour |
---|
| La liste des affichages. Par défaut renvoie toujours l'affichage par défaut 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Obtient la liste des affichages pouvant être utilisés pour start a user visible in the background
.
listeUtilisateurs
public listUsers ()
Obtient la liste des utilisateurs sur l'appareil. Lèvera DeviceRuntimeException
si la sortie de l'appareil n'est pas celle attendue.
Retour |
---|
| la liste des identifiants des utilisateurs. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Méthode d'assistance pour prendre un rapport de bogue et le consigner aux reporters.
Paramètres |
---|
dataName | String : nom sous lequel le rapport de bug sera signalé. |
listener | ITestLogger : un ITestLogger pour enregistrer le rapport de bug. |
Retour |
---|
boolean | Vrai si la journalisation a réussi, faux sinon. |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui seront exécutés une fois l'invocation terminée.
Paramètres |
---|
exception | Throwable : le cas échéant, la dernière exception levée par l'échec de l'invocation. |
supprimerAdmin
public boolean removeAdmin (String componentName,
int userId)
Supprimez l'administrateur de l'appareil donné dans l'utilisateur donné et renvoyez true
si cela réussit, false
sinon.
Paramètres |
---|
componentName | String : de l'administrateur de l'appareil à supprimer. |
userId | int : de l'utilisateur dans lequel vit l'administrateur de l'appareil. |
Retour |
---|
boolean | Vrai si c'est réussi, faux sinon. |
supprimerPropriétaires
public void removeOwners ()
Supprimez tous les propriétaires de profils d'appareils existants avec le meilleur effort.
supprimer l'utilisateur
public boolean removeUser (int userId)
Supprimer un utilisateur donné de l'appareil.
Paramètres |
---|
userId | int : de l'utilisateur à supprimer |
Retour |
---|
boolean | true si nous avons réussi à supprimer l'utilisateur, false sinon. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Définissez un composant d'administration de l'appareil en tant que propriétaire de l'appareil dans un utilisateur donné.
Paramètres |
---|
componentName | String : de l'administrateur de l'appareil à être propriétaire de l'appareil. |
userId | int : de l'utilisateur dans lequel vit le propriétaire de l'appareil. |
Retour |
---|
boolean | Vrai si c'est réussi, faux sinon. |
setSetting
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 |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné. Certains paramètres ne seront disponibles qu'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 |
arrêtMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Arrête le dispositif microdroid, s'il en existe un.
Paramètres |
---|
microdroidDevice | ITestDevice |
startUser
public boolean startUser (int userId)
Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est un NOOP.
Paramètres |
---|
userId | int : de l'utilisateur à démarrer en arrière-plan |
Retour |
---|
boolean | true si l'utilisateur a été démarré avec succès en arrière-plan. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est un NOOP. Possibilité de fournir un indicateur supplémentaire pour attendre que l'opération prenne effet.
Paramètres |
---|
userId | int : de l'utilisateur à démarrer en arrière-plan |
waitFlag | boolean : fera attendre la commande jusqu'à ce que l'utilisateur soit démarré et déverrouillé. |
Retour |
---|
boolean | true si l'utilisateur a été démarré avec succès en arrière-plan. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Démarre un utilisateur donné en arrière-plan, visible dans l'affichage donné (c'est-à-dire, permettant à l'utilisateur de lancer des activités dans cet affichage).
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 à démarrer en arrière-plan |
displayId | int : affichage pour démarrer l'utilisateur visible sur |
waitFlag | boolean : fera attendre la commande jusqu'à ce que l'utilisateur soit démarré et déverrouillé. |
Retour |
---|
boolean | true si l'utilisateur a été démarré avec succès visible en arrière-plan. |
stopUser
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 actuel et l'utilisateur système.
Paramètres |
---|
userId | int : de l'utilisateur à arrêter. |
waitFlag | boolean : fera attendre la commande jusqu'à ce que l'utilisateur soit arrêté. |
forceFlag | boolean : forcera l'arrêt de l'utilisateur. |
Retour |
---|
boolean | true si l'utilisateur a été arrêté avec succès. |
stopUser
public boolean stopUser (int userId)
Arrête un utilisateur donné. Si l'utilisateur est déjà arrêté, cette méthode est un NOOP. Impossible d'arrêter l'utilisateur actuel et l'utilisateur système.
Paramètres |
---|
userId | int : de l'utilisateur à arrêter. |
Retour |
---|
boolean | true si l'utilisateur a été arrêté avec succès. |
prend en chargeMicrodroid
public boolean supportsMicrodroid ()
Vérifie les conditions préalables pour exécuter un microdroid.
Retour |
---|
boolean | renvoie true si les préconditions sont satisfaites, false sinon. |
prend en chargeMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Vérifie les conditions préalables pour exécuter un microdroid.
Paramètres |
---|
protectedVm | boolean : vrai si le microdroid est destiné à s'exécuter sur une VM protégée. |
Retour |
---|
boolean | renvoie true si les préconditions sont satisfaites, false sinon. |
changer d'utilisateur
public boolean switchUser (int userId)
Basculez vers un autre ID utilisateur avec un délai d'expiration par défaut. switchUser(int, long)
.
Retour |
---|
boolean | True si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Faux sinon. |
changer d'utilisateur
public boolean switchUser (int userId,
long timeout)
Passez à un autre ID utilisateur avec le délai d'expiration fourni comme date limite. Essayez de désactiver le verrouillage du clavier une fois le changement d'utilisateur réussi.
Paramètres |
---|
userId | int |
timeout | long : attendre avant de retourner false pour l'échec du changement d'utilisateur. |
Retour |
---|
boolean | True si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Faux sinon. |
prendreBugreport
public Bugreport takeBugreport ()
Prend un rapport de bogue et le renvoie dans un objet Bugreport
pour le gérer. Renvoie null en cas de problème. Le fichier référencé dans l'objet Bugreport doit être nettoyé via Bugreport.close()
.
uninstallPackage
public String uninstallPackage (String packageName)
Désinstallez un package Android de l'appareil.
Paramètres |
---|
packageName | String : le package Android à désinstaller |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
désinstallerPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Désinstallez un package Android de l'appareil pour un utilisateur donné.
Paramètres |
---|
packageName | String : le package Android à désinstaller |
userId | int : l'ID utilisateur entier pour lequel désinstaller. |
Retour |
---|
String | une String avec un code d'erreur, ou null en cas de succès. |
Méthodes protégées
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Effectuez un redémarrage adb.
Paramètres |
---|
rebootMode | NativeDevice.RebootMode : un mode de ce redémarrage. |
reason | String : pour ce redémarrage. |
getBugreportzInternal
protected File getBugreportzInternal ()
Méthode d'assistance interne pour obtenir le fichier zip bugreportz en tant que ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Exposé pour essai.
getHostCurrentTime
protected long getHostCurrentTime ()
Exposé pour les tests
prePostBootSetup
protected void prePostBootSetup ()
Permet à chaque type de périphérique (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration post-démarrage spécifique.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/07/19 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Il n'y a pas l'information dont j'ai besoin"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Trop compliqué/Trop d'étapes"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsolète"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Mauvais exemple/Erreur de code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]