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 pouvant être utilisées pour ignorer le keyguard. |
Méthodes publiques |
---|
boolean | canSwitchToHeadlessSystemUser () Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans tête. |
boolean | clearErrorDialogs () Essayez de fermer 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 indicateurs 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 indicateurs par défaut 0. |
void | disableKeyguard () Tente de désactiver le protège-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 serveur_système. |
| 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'ID Android associé à un ID utilisateur, nul s'il n'est pas trouvé. |
| getAndroidIds () Créez une carte des identifiants Android trouvés correspondant aux identifiants utilisateur. |
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 bug de l'appareil. |
InputStreamSource | getBugreportz () Récupère un rapport de bug de l'appareil. |
DeviceFoldableState | getCurrentFoldableState () Renvoie l'état pliable actuel de l'appareil ou null si des problèmes sont survenus. |
int | getCurrentUser () Renvoie l'identifiant de l'utilisateur actuel. |
| getFoldableStates () Renvoie la liste des états pliables sur l'appareil. |
| getInstalledPackageNames () Récupérez les noms des packages d’application 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'identifiant de l'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) Récupère une capture d'écran de l'appareil en fonction de l'identifiant d'affichage. |
String | getSetting (String namespace, String key) Voir getSetting(int, String, String) et effectué sur l'utilisateur du 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 drapeaux d'un utilisateur donné. |
| getUserInfos () Obtient la carte de useId vers UserInfo sur l’appareil. |
int | getUserSerialNumber (int userId) Renvoie le numéro de série associé au userId s'il est trouvé, -10000 dans les autres cas. |
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 non-administrateur. |
boolean | isMultiUserSupported () Détermine si le multi-utilisateur est pris en charge. |
boolean | isPackageInstalled (String packageName) Recherchez sur l'appareil 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) Renvoie si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs. |
boolean | isUserVisible (int userId) Vérifie si l'utilisateur donné est visible. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Vérifie si l'utilisateur donné est visible dans l'affichage donné. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Indique si l'appareil autorise le démarrage des utilisateurs, visible en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Indique si l'appareil autorise le démarrage des utilisateurs visibles en arrière-plan. |
| 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 rédiger un rapport de bug et le consigner aux journalistes. |
void | postInvocationTearDown (Throwable exception) Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté une fois l'appel terminé. |
boolean | removeAdmin (String componentName, int userId) Supprimez l'administrateur de l'appareil donné chez un utilisateur donné et renvoyez true en cas de succès, false sinon. |
void | removeOwners () Supprimez tous les propriétaires de profils d’appareil existants en faisant de votre mieux. |
boolean | removeUser (int userId) Supprimer un utilisateur donné de l'appareil. |
boolean | setDeviceOwner (String componentName, int userId) Définissez un composant d'administration de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné. |
void | setSetting (String namespace, String key, String value) Voir setSetting(int, String, String, String) et effectué sur l'utilisateur du système. |
void | setSetting (int userId, String namespace, String key, String value) Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné. |
void | shutdownMicrodroid ( ITestDevice microdroidDevice) Arrête le périphérique microdroïde, 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êtez un utilisateur donné. |
boolean | stopUser (int userId) Arrête un utilisateur donné. |
boolean | supportsMicrodroid () Vérifie les conditions préalables pour exécuter un microdroïde. |
boolean | supportsMicrodroid (boolean protectedVm) Vérifie les conditions préalables pour exécuter un microdroïde. |
boolean | switchUser (int userId) Basculez vers un autre ID utilisateur avec un délai d'expiration par défaut. |
boolean | switchUser (int userId, long timeout) Basculez vers un autre ID utilisateur avec le délai d'expiration fourni comme date limite. |
Bugreport | takeBugreport () Prenez un rapport de bug et retournez-le dans un objet Bugreport pour le gérer. |
String | uninstallPackage (String packageName) Désinstallez un package Android de l'appareil. |
String | uninstallPackageForUser (String packageName, int userId) Désinstallez un package Android de l'appareil pour un utilisateur donné. |
Des champs
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Commandes pouvant être utilisées pour ignorer le keyguard.
Constructeurs publics
Méthodes publiques
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans tête.
clearErrorDialogs
public boolean clearErrorDialogs ()
Essayez de fermer les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil.
Retour |
---|
boolean | true si aucune boîte de dialogue n’était présente ou si les boîtes de dialogue ont été effacées avec succès. false sinon. |
Créer un utilisateur
public int createUser (String name)
Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
Retour |
---|
int | l'entier pour l'identifiant utilisateur créé |
Créer un utilisateur
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Créer un utilisateur avec un nom donné et les drapeaux fournis
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
guest | boolean : active le drapeau utilisateur --guest lors de la création |
ephemeral | boolean : active le drapeau utilisateur --ephemeral lors de la création |
forTesting | boolean : active l'indicateur de test --for-testing lors de la création |
Retour |
---|
int | identifiant de l'utilisateur créé |
Créer un utilisateur
public int createUser (String name,
boolean guest,
boolean ephemeral)
Créer un utilisateur avec un nom donné et les drapeaux fournis
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
guest | boolean : active le drapeau utilisateur --guest lors de la création |
ephemeral | boolean : active le drapeau utilisateur --ephemeral lors de la création |
Retour |
---|
int | identifiant de l'utilisateur créé |
createUserNoThrow
public int createUserNoThrow (String name)
Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.
Paramètres |
---|
name | String : de l'utilisateur à créer sur l'appareil |
Retour |
---|
int | l'entier pour l'ID utilisateur créé ou -1 pour l'erreur. |
désactiverKeyguard
public void disableKeyguard ()
Tente de désactiver le protège-clavier.
Attendez d'abord que la répartition des entrées soit prête, cela se produit à peu près au même moment où l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework présente des conditions de concurrence occasionnelles. Ensuite, la commande est envoyée pour ignorer le keyguard (fonctionne uniquement sur les claviers non sécurisés)
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'identifiant 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 serveur_système. Il est de la responsabilité de l'appelant de nettoyer le fichier sauvegardé.
Paramètres |
---|
process | String : le nom du processus de périphérique sur lequel effectuer le dumpheap. |
devicePath | String : le chemin sur le périphérique où placer le dump. Il doit s'agir d'un emplacement où les autorisations le permettent. |
Retour |
---|
File | l' ERROR(/File) contenant le rapport. Nul si quelque chose échoue. |
getActiveApex
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'un des {"system", "secure", "global"} |
Retour |
---|
| la carte des paires clé-valeur. Null si l’espace de noms n’est pas pris en charge. |
obtenirAndroidId
public String getAndroidId (int userId)
Recherchez et renvoyez l'ID Android associé à un ID utilisateur, nul s'il n'est pas trouvé.
obtenir des identifiants Android
public getAndroidIds ()
Créez une carte des identifiants Android trouvés correspondant aux identifiants utilisateur. Il n'y a aucune assurance que chaque identifiant utilisateur trouvera un identifiant Android associé à cette fonction, donc certains identifiants utilisateur peuvent correspondre à null.
Retour |
---|
| Carte des identifiants Android trouvés correspondant aux identifiants utilisateur. |
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érer les informations des packages installés sur l'appareil.
obtenir un rapport de bug
public InputStreamSource getBugreport ()
Récupère un rapport de bug de l'appareil.
La mise en œuvre de ceci est garantie de continuer à fonctionner sur un appareil sans carte SD (ou lorsque la carte SD n'est pas encore montée).
obtenirbugreportz
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 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 sont survenus.
getCurrentUser
public int getCurrentUser ()
Renvoie l'identifiant de l'utilisateur actuel. En cas d'erreur, renvoie -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’application 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 | le 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 nombre entier indiquant le nombre d'utilisateurs fonctionnant 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'identifiant de l'utilisateur principal.
Retour |
---|
Integer | l'ID utilisateur de l'utilisateur principal s'il y en a un, et null s'il n'y a pas d'utilisateur principal. |
obtenirCapture d'écran
public InputStreamSource getScreenshot ()
Prend une capture d'écran de l'appareil.
obtenirCapture 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 un 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 |
obtenirCapture d'écran
public InputStreamSource getScreenshot (String format)
Prend une capture d'écran de l'appareil. Il est 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 |
obtenirCapture d'écran
public InputStreamSource getScreenshot (long displayId)
Récupère une capture d'écran de l'appareil en fonction de l'identifiant d'affichage. Le format est PNG.
À FAIRE : étendre les implémentations ci-dessus pour prendre en charge "format" et "rescale"
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 du 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. Nul s’il n’est pas trouvé. |
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)
Rechercher et renvoyer les drapeaux d'un utilisateur donné. Les indicateurs sont définis dans la classe "android.content.pm.UserInfo" du projet Android Open Source.
Retour |
---|
int | les indicateurs associés à l'ID utilisateur fourni s'ils sont trouvés, -10 000 dans les autres cas. |
getUserInfos
public getUserInfos ()
Obtient la carte de useId vers UserInfo
sur l’appareil. Lèvera DeviceRuntimeException
si la sortie du périphérique 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é au userId s'il est trouvé, -10000 dans les autres cas.
hasFeature
public boolean hasFeature (String feature)
Vérifiez si une fonctionnalité est disponible sur un appareil.
Paramètres |
---|
feature | String : quel format doit être "feature : " 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. |
installerPackageForUser
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'identifiant 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. |
installerPackageForUser
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'identifiant 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. |
installerPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
installerPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
installerPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
installerPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Paramètres |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
installerRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Paramètres |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
installerRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Paramètres |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications
Retour |
---|
boolean | Vrai si l'énumération des applications est prise en charge, faux 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 non-administrateur.
isMultiUserSupported
public boolean isMultiUserSupported ()
Détermine si le multi-utilisateur est pris en charge.
Retour |
---|
boolean | vrai si plusieurs utilisateurs sont pris en charge, faux sinon |
estPackageInstalled
public boolean isPackageInstalled (String packageName)
Recherchez sur l'appareil un nom de package donné pour vérifier s'il est actuellement installé ou non.
Paramètres |
---|
packageName | String |
Retour |
---|
boolean | Vrai si le package est signalé comme installé. Faux sinon. |
estPackageInstalled
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 package dont nous vérifions s'il est installé. |
userId | String : l'identifiant de l'utilisateur pour lequel nous vérifions que le package est installé. Si nul, l’utilisateur principal zéro sera utilisé. |
Retour |
---|
boolean | Vrai si le package est signalé comme installé. Faux sinon. |
estUserRunning
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)
Renvoie si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.
Retour |
---|
boolean | vrai si l'utilisateur est secondaire, faux sinon. |
estUtilisateurVisible
public boolean isUserVisible (int userId)
Vérifie si l'utilisateur donné est visible.
Un utilisateur « visible » est un utilisateur qui interagit avec l'utilisateur « humain » et est donc capable de lancer des activités de lancement (généralement dans l'affichage par défaut).
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 est donc capable de lancer des activités de lancement sur cet affichage.
Paramètres |
---|
userId | int |
displayId | int |
listDisplayIds
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 du périphérique 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 rédiger un rapport de bug et le consigner aux journalistes.
Paramètres |
---|
dataName | String : nom sous lequel le bugreport sera rapporté. |
listener | ITestLogger : un ITestLogger pour enregistrer le rapport de bug. |
Retour |
---|
boolean | Vrai si la journalisation a réussi, faux dans le cas contraire. |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté une fois l'appel terminé.
Paramètres |
---|
exception | Throwable : le cas échéant, l'exception finale déclenchée par l'échec de l'invocation. |
supprimerAdmin
public boolean removeAdmin (String componentName,
int userId)
Supprimez l'administrateur de l'appareil donné chez un utilisateur donné et renvoyez true
en cas de succès, false
sinon.
Paramètres |
---|
componentName | String : de l'administrateur de l'appareil à supprimer. |
userId | int : l'utilisateur dans lequel réside l'administrateur de l'appareil. |
Retour |
---|
boolean | Vrai si l’opération réussit, faux sinon. |
Supprimer les propriétaires
public void removeOwners ()
Supprimez tous les propriétaires de profils d’appareil existants en faisant de votre mieux.
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 | vrai si nous avons réussi à supprimer l’utilisateur, faux 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 pour un utilisateur donné.
Paramètres |
---|
componentName | String : l'administrateur de l'appareil doit être propriétaire de l'appareil. |
userId | int : de l'utilisateur dans lequel réside le propriétaire de l'appareil. |
Retour |
---|
boolean | Vrai si l’opération réussit, faux sinon. |
setSetting
public void setSetting (String namespace,
String key,
String value)
Voir setSetting(int, String, String, String)
et effectué sur l'utilisateur du 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 périphérique microdroïde, s'il en existe un.
Paramètres |
---|
microdroidDevice | ITestDevice |
démarrerUtilisateur
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. |
démarrerUtilisateur
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. |
arrêter l'utilisateur
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Arrêtez un utilisateur donné. Possibilité de fournir des indicateurs supplémentaires pour attendre que l'opération prenne effet et forcer la terminaison 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. |
arrêter l'utilisateur
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 microdroïde.
Retour |
---|
boolean | renvoie vrai si les conditions préalables sont satisfaites, faux sinon. |
prend en chargeMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Vérifie les conditions préalables pour exécuter un microdroïde.
Paramètres |
---|
protectedVm | boolean : vrai si le microdroid est destiné à s'exécuter sur une VM protégée. |
Retour |
---|
boolean | renvoie vrai si les conditions préalables sont satisfaites, faux 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 nouveau userId correspond au fournisseur userId. Faux sinon. |
changer d'utilisateur
public boolean switchUser (int userId,
long timeout)
Basculez vers un autre ID utilisateur avec le délai d'expiration fourni comme date limite. Tentative de désactivation du protège-clavier une fois le changement d'utilisateur réussi.
Paramètres |
---|
userId | int |
timeout | long : attendre avant de renvoyer false en cas d'échec du changement d'utilisateur. |
Retour |
---|
boolean | True si le nouveau userId correspond au fournisseur userId. Faux sinon. |
prendre un rapport de bug
public Bugreport takeBugreport ()
Prenez un rapport de bug et retournez-le 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()
.
désinstallerPackage
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'identifiant 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
créerParser
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 les tests.
getHostCurrentTime
protected long getHostCurrentTime ()
Exposé pour les tests
préPostBootSetup
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/12/01 (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"
}]