Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

TestDevice

public class TestDevice
extends NativeDevice

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


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

Résumé

Des champs

public static final String DISMISS_KEYGUARD_CMD

Commandes qui peuvent être utilisées pour fermer le keyguard.

Constructeurs publics

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Méthodes publiques

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 indicateurs par défaut 0.

int createUser (String name, boolean guest, boolean ephemeral)

Créer un utilisateur avec un nom donné et les indicateurs 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 keyguard.

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)

Trouvez et renvoyez l'id-android associé à un userId, nul s'il n'est pas trouvé.

getAndroidIds ()

Créez une carte des identifiants Android trouvés.

PackageInfo getAppPackageInfo (String packageName)

Récupérez des informations sur un package installé sur l'appareil.

int getCurrentUser ()

Renvoie l'ID de l'utilisateur en cours d'exécution.

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.

int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximum d'utilisateurs exécutés 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 (int displayId)

Prend une capture d'écran à partir de l'identifiant d'affichage de l'appareil.

InputStreamSource getScreenshot (String format)

Prend une capture d'écran de l'appareil.

String getSetting (String namespace, String key)

Voir getSetting(int, String, String) et exécuté 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)

Trouvez et renvoyez les drapeaux d'un utilisateur donné.

getUserInfos ()

Obtient le mappage de useId à UserInfo sur l'appareil.

int getUserSerialNumber (int userId)

Renvoie le numéro de série associé à userId s'il est trouvé, -10000 dans les autres cas.

boolean hasFeature (String feature)

Vérifiez si une fonction est disponible sur un appareil.

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

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

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

listDisplayIds ()

Collectez la liste des affichages disponibles sur le périphérique, comme indiqué par "dumpsys SurfaceFlinger".

listUsers ()

Obtient la liste des utilisateurs sur l'appareil.

void postInvocationTearDown ()

Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté après l'appel.

boolean removeAdmin (String componentName, int userId)

Supprimez l'administrateur de l'appareil donné dans l'utilisateur donné et retournez true s'il réussit, false cas contraire.

void removeOwners ()

Supprimez tous les propriétaires de profil d'appareil 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 comme propriétaire de l'appareil dans un utilisateur donné.

void setSetting (String namespace, String key, String value)

Voir setSetting(int, String, String, String) et exécuté 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é.

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 stopUser (int userId, boolean waitFlag, boolean forceFlag)

Arrêtez un utilisateur donné.

boolean stopUser (int userId)

Arrête un utilisateur donné.

boolean switchUser (int userId)

Basculez vers un autre userId avec un délai d'expiration par défaut.

boolean switchUser (int userId, long timeout)

Basculez vers un autre userId avec le délai d'expiration fourni comme date limite.

String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

Méthodes protégées

void doAdbReboot (String into)

Effectuez un redémarrage adb.

long getCheckNewUserSleep ()

Exposé pour les tests.

long getHostCurrentTime ()

Exposé pour les tests

void prePostBootSetup ()

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

Des champs

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Commandes qui peuvent être utilisées pour fermer le keyguard.

Constructeurs publics

TestDevice

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

Méthodes publiques

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é correctement effacées. false sinon.

Jette
DeviceNotAvailableException

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 de l'ID utilisateur créé

Jette
DeviceNotAvailableException

Créer un utilisateur

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Créer un utilisateur avec un nom donné et les indicateurs 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 - éphémère lors de la création

Retour
int id de l'utilisateur créé

Jette
DeviceNotAvailableException

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 le nombre entier de l'ID utilisateur créé ou -1 en cas d'erreur.

Jette
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Tente de désactiver le keyguard.

Attendez d'abord que la distribution d'entrée soit prête, cela se produit à peu près au même moment où le périphérique signale BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework a une condition de concurrence occasionnelle. Ensuite, la commande est envoyée pour ignorer le keyguard (fonctionne uniquement sur les non sécurisés)

Jette
DeviceNotAvailableException

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

devicePath String : le chemin sur le périphérique où placer le vidage. Il doit s'agir d'un emplacement où les autorisations le permettent.

Retour
File l' ERROR(/File) contenant le rapport. Nul si quelque chose a échoué.

Jette
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Récupérez les informations sur les APEX activés sur l'appareil.

Retour
ERROR(/Set) d' ApexInfo actuellement activé sur l'appareil

Jette
DeviceNotAvailableException

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 valeur / clé. Null si l'espace de noms n'est pas pris en charge.

Jette
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Trouvez et renvoyez l'id-android associé à un userId, nul s'il n'est pas trouvé.

Paramètres
userId int

Retour
String

Jette
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Créez une carte des identifiants Android trouvés. Il n'y a aucune assurance que chaque identifiant d'utilisateur trouvera un identifiant Android associé à cette fonction, de sorte que certains identifiants d'utilisateurs peuvent correspondre à null.

Retour
Carte des identifiants Android trouvés.

Jette
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Récupérez des informations sur un package installé sur l'appareil.

Paramètres
packageName String

Retour
PackageInfo PackageInfo ou null si les informations n'ont pas pu être récupérées

Jette
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Renvoie l'ID de l'utilisateur en cours d'exécution.

Retour
int

Jette
DeviceNotAvailableException
DeviceRuntimeException

getInstalledPackageNames

public  getInstalledPackageNames ()

Récupérez les noms des packages d'application présents sur l'appareil.

Retour
ERROR(/Set) des noms de package String actuellement installés sur l'appareil.

Jette
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Renvoie un objet pour obtenir l'état actuel du keyguard ou null s'il n'est pas pris en charge.

Retour
KeyguardControllerState un KeyguardControllerState contenant un instantané de l'état du keyguard et renvoie Null si la requête Keyguard n'est pas prise en charge.

Jette
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximum d'utilisateurs exécutés simultanément pris en charge. La valeur par défaut est 0.

Retour
int un entier indiquant le nombre d'utilisateurs exécutés simultanément

Jette
DeviceNotAvailableException

getMaxNumberOfUsersSupported

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

Jette
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Renvoie l'ID utilisateur principal.

Retour
Integer userId de l'utilisateur principal s'il y en a un et null s'il n'y a pas d'utilisateur principal.

Jette
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

Prend une capture d'écran de l'appareil.

Retour
InputStreamSource une InputStreamSource de la capture d'écran au format png, ou null si la capture d'écran n'a pas réussi.

Jette
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Prend une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot(String) place avec le codage 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

Retour
InputStreamSource une InputStreamSource de la capture d'écran au format, ou null si la capture d'écran n'a pas réussi.

Jette
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (int displayId)

Récupère une capture d'écran de l'ID d'affichage de l'appareil. Le format est PNG.

TODO: étendez les implémentations ci-dessus pour prendre en charge le 'format' et le 'redimensionnement'

Paramètres
displayId int : l'identifiant d'affichage de l'écran à partir duquel obtenir une capture d'écran.

Retour
InputStreamSource une InputStreamSource de la capture d'écran au format, ou null si la capture d'écran n'a pas réussi.

Jette
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

Prend une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot (format) à la place avec le codage JPEG pour une taille plus petite

Paramètres
format String : PNG, JPEG pris en charge

Retour
InputStreamSource une InputStreamSource de la capture d'écran au format, ou null si la capture d'écran n'a pas réussi.

Jette
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Paramètres
namespace String

key String

Retour
String

Jette
DeviceNotAvailableException

getSetting

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

Renvoie la valeur du paramètre demandé. l'espace de noms doit être l'un des suivants: {"system", "secure", "global"}

Paramètres
userId int

namespace String

key String

Retour
String la valeur associée à l'espace de noms: clé d'un utilisateur. Null si non trouvé.

Jette
DeviceNotAvailableException

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 package String désinstallables actuellement installés sur l'appareil.

Jette
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Trouvez et renvoyez les drapeaux d'un utilisateur donné. Les indicateurs sont définis dans la classe "android.content.pm.UserInfo" dans le projet Open Source Android.

Paramètres
userId int

Retour
int les indicateurs associés à userId fournis s'ils sont trouvés, -10000 dans tous les autres cas.

Jette
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

Obtient le mappage de useId à UserInfo sur l'appareil. DeviceRuntimeException si la sortie du périphérique n'est pas celle attendue.

Retour
la liste des objets UserInfo.

Jette
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Renvoie le numéro de série associé à userId s'il est trouvé, -10000 dans les autres cas.

Paramètres
userId int

Retour
int

Jette
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

Vérifiez si une fonction est disponible sur un appareil.

Paramètres
feature String : quel format doit être "fonctionnalité: ".

Retour
boolean Vrai si la fonctionnalité est trouvée, false dans le cas contraire

Jette
DeviceNotAvailableException

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 install --help' pour les options disponibles.

Retour
String une String avec un code d'erreur, ou null cas de succès.

Jette
DeviceNotAvailableException

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 qui nécessitent 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 install --help' pour les options disponibles.

Retour
String une String avec un code d'erreur, ou null cas de succès.

Jette
DeviceNotAvailableException

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 qui nécessitent 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 install --help' pour les options disponibles.

Retour
String une String avec un code d'erreur, ou null cas de succès.

Jette
DeviceNotAvailableException

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 qui nécessitent 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 install --help' pour les options disponibles.

Retour
String une String avec un code d'erreur, ou null cas de succès.

Jette
DeviceNotAvailableException

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 install --help' pour les options disponibles.

Retour
String une String avec un code d'erreur, ou null cas de succès.

Jette
DeviceNotAvailableException

installPackages

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

Paramètres
packageFiles

reinstall boolean

extraArgs String

Retour
String

Jette
DeviceNotAvailableException

installPackages

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

Paramètres
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Retour
String

Jette
DeviceNotAvailableException

installPackagesForUser

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

Paramètres
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Retour
String

Jette
DeviceNotAvailableException

installPackagesForUser

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

Paramètres
packageFiles

reinstall boolean

userId int

extraArgs String

Retour
String

Jette
DeviceNotAvailableException

installRemotePackages

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

Paramètres
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Retour
String

Jette
DeviceNotAvailableException

installRemotePackages

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

Paramètres
remoteApkPaths

reinstall boolean

extraArgs String

Retour
String

Jette
DeviceNotAvailableException

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

Jette
DeviceNotAvailableException

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 Vrai si le package est signalé comme installé. Faux sinon.

Jette
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Interrogez l'appareil pour un nom de package donné et un identifiant utilisateur donné pour vérifier s'il est actuellement installé ou non pour cet utilisateur.

Paramètres
packageName String : le package que nous vérifions s'il est installé.

userId String : l'ID 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.

Jette
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Vérifiez si un utilisateur donné est en cours d'exécution.

Paramètres
userId int

Retour
boolean Vrai si l'utilisateur est en cours d'exécution, faux dans tous les autres cas.

Jette
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

Renvoie si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.

Paramètres
userId int

Retour
boolean true si l'utilisateur est secondaire, false dans le cas contraire.

Jette
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

Collectez la liste des affichages disponibles sur le périphérique, comme indiqué par "dumpsys SurfaceFlinger".

Retour
La liste des affichages. La valeur par défaut renvoie toujours l'affichage par défaut 0.

Jette
DeviceNotAvailableException

listUsers

public  listUsers ()

Obtient la liste des utilisateurs sur l'appareil. DeviceRuntimeException si la sortie du périphérique n'est pas celle attendue.

Retour
la liste des identifiants utilisateur.

Jette
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown ()

Étapes supplémentaires pour le nettoyage requis spécifique au périphérique qui sera exécuté après l'appel.

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Supprimez l'administrateur de l'appareil donné dans l'utilisateur donné et retournez true s'il réussit, false 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.

Retour
boolean Vrai s'il réussit, faux dans le cas contraire.

Jette
DeviceNotAvailableException

removeOwners

public void removeOwners ()

Supprimez tous les propriétaires de profil d'appareil existants avec le meilleur effort.

Jette
DeviceNotAvailableException

removeUser

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 réussissons à supprimer l'utilisateur, false dans le cas contraire.

Jette
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Définissez un composant d'administration de l'appareil comme propriétaire de l'appareil dans un utilisateur donné.

Paramètres
componentName String : de l'administrateur de l'appareil en tant que propriétaire de l'appareil.

userId int : de l'utilisateur dans lequel vit le propriétaire de l'appareil.

Retour
boolean Vrai s'il réussit, faux dans le cas contraire.

Jette
DeviceNotAvailableException

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

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

Paramètres
namespace String

key String

value String

Jette
DeviceNotAvailableException

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

Jette
DeviceNotAvailableException

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.

Jette
DeviceNotAvailableException

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.

Jette
DeviceNotAvailableException

stopUser

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 ait effet et forcer la fin de l'utilisateur. Impossible d'arrêter l'utilisateur actuel et le 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.

Jette
DeviceNotAvailableException

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 le système.

Paramètres
userId int : de l'utilisateur à arrêter.

Retour
boolean true si l'utilisateur a été arrêté avec succès.

Jette
DeviceNotAvailableException

changer d'utilisateur

public boolean switchUser (int userId)

Basculez vers un autre userId avec un délai d'expiration par défaut. switchUser(int, long) .

Paramètres
userId int

Retour
boolean True si le nouveau userId correspond au fournisseur userId. Faux sinon.

Jette
DeviceNotAvailableException

changer d'utilisateur

public boolean switchUser (int userId, 
                long timeout)

Basculez vers un autre userId avec le délai d'expiration fourni comme date limite. Tentative de désactivation du verrouillage du clavier une fois le changement d'utilisateur réussi.

Paramètres
userId int

timeout long : attendre avant de renvoyer false pour le commutateur-utilisateur a échoué.

Retour
boolean True si le nouveau userId correspond au fournisseur userId. Faux sinon.

Jette
DeviceNotAvailableException

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 cas de succès.

Jette
DeviceNotAvailableException

Méthodes protégées

doAdbReboot

protected void doAdbReboot (String into)

Effectuez un redémarrage adb.

Paramètres
into String : le nom du chargeur de démarrage dans lequel redémarrer ou null pour redémarrer simplement l'appareil.

Jette
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposé pour les tests.

Retour
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposé pour les tests

Retour
long

prePostBootSetup

protected void prePostBootSetup ()

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

Jette
DeviceNotAvailableException