TestDevice
public
class
TestDevice
extends NativeDevice
Sous-classes directes connues
|
Sous-classes indirectes connues
|
Implémentation d'un ITestDevice pour un appareil Android complet
Résumé
Méthodes publiques |
String
|
adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)
Installez un package Android sur l'appareil à l'aide de la commande adb.
|
String
|
adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installez un package Android sur l'appareil à l'aide de la commande adb.
|
boolean
|
canSwitchToHeadlessSystemUser()
Indique si le passage à l'utilisateur système headless est autorisé.
|
boolean
|
clearErrorDialogs()
Tente de fermer les boîtes de dialogue d'erreur actuellement affichées dans l'UI de l'appareil.
|
int
|
createUser(String name)
Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Créez un utilisateur avec un nom donné et les indicateurs fournis.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Créez 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 de 0.
|
void
|
disableKeyguard()
Tentatives de désactivation du keyguard.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil pour un utilisateur donné.
|
boolean
|
doesFileExist(String deviceFilePath)
Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.
|
File
|
dumpHeap(String process, String devicePath)
Essayez de vider le tas depuis system_server.
|
Set<ITestDevice.ApexInfo>
|
getActiveApexes()
Récupère les informations sur les APEX activés sur l'appareil.
|
Map<String, String>
|
getAllSettings(String namespace)
Renvoie les paires clé/valeur de l'espace de noms demandé.
|
String
|
getAndroidId(int userId)
Recherchez et renvoyez l'android-id associé à un userId. Renvoie la valeur "null" si aucun n'est trouvé.
|
Map<Integer, String>
|
getAndroidIds()
Créez une carte des ID Android trouvés correspondant aux ID utilisateur.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Récupérez des informations sur un package installé sur l'appareil.
|
List<PackageInfo>
|
getAppPackageInfos()
Récupérer les informations des packages installés sur l'appareil.
|
InputStreamSource
|
getBugreport()
Récupère un rapport de bug depuis l'appareil.
|
InputStreamSource
|
getBugreportz()
Récupère un bugreportz depuis l'appareil.
|
DeviceFoldableState
|
getCurrentFoldableState()
Renvoie l'état de pliage actuel de l'appareil ou la valeur "null" en cas de problème.
|
int
|
getCurrentUser()
Renvoie l'ID de l'utilisateur en cours d'exécution.
|
Set<DeviceFoldableState>
|
getFoldableStates()
Renvoie la liste des états de pliage de l'appareil.
|
Set<String>
|
getInstalledPackageNames()
Récupère les noms des packages d'application présents sur l'appareil.
|
KeyguardControllerState
|
getKeyguardState()
Renvoie un objet pour obtenir l'état actuel du keyguard ou la valeur "null" si ce n'est pas pris en charge.
|
Integer
|
getMainUserId()
Renvoie l'ID utilisateur principal.
|
Set<String>
|
getMainlineModuleInfo()
Obtenez des informations sur les modules Mainline installés sur l'appareil.
|
int
|
getMaxNumberOfRunningUsersSupported()
Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément.
|
int
|
getMaxNumberOfUsersSupported(String userType)
Obtenez le nombre maximal d'utilisateurs acceptés pour le type d'utilisateur donné.
|
int
|
getMaxNumberOfUsersSupported()
Obtenez le nombre maximal d'utilisateurs pouvant être changés, sans inclure les invités.
|
Integer
|
getPrimaryUserId()
Renvoie l'ID utilisateur principal.
|
int
|
getRemainingCreatableUserCount(String userType)
Renvoie le nombre d'utilisateurs du type d'utilisateur donné qui peuvent être créés sur cet appareil.
|
InputStreamSource
|
getScreenshot(Long displayId, String format, boolean rescale)
Prend une capture d'écran à partir de l'ID d'affichage de l'appareil avec le format pris en charge.
|
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)
Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil.
|
InputStreamSource
|
getScreenshot()
Prend une capture d'écran de l'appareil.
|
String
|
getSetting(int userId, String namespace, String key)
Renvoie la valeur du paramètre demandé.
|
String
|
getSetting(String namespace, String key)
Voir getSetting(int,String,String) et effectué sur l'utilisateur du système.
|
Set<String>
|
getUninstallablePackageNames()
Récupère les noms de package des applications qui peuvent être désinstallées.
|
int
|
getUserFlags(int userId)
Recherchez et renvoyez les indicateurs d'un utilisateur donné.
|
Map<Integer, UserInfo>
|
getUserInfos()
Obtient le mappage de useId vers UserInfo sur l'appareil.
|
int
|
getUserSerialNumber(int userId)
Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, -10000 dans tous les autres cas.
|
int
|
getUserVisibleOnDisplay(int displayId)
Obtient l'ID utilisateur de l'utilisateur visible sur l'écran donné.
|
boolean
|
hasFeature(String feature)
Vérifier si une fonctionnalité est disponible sur un appareil
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installez un package Android sur l'appareil.
|
String
|
installPackage(File packageFile, 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é.
|
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Installe les APK avec le mode incrémentiel.
|
String
|
installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
boolean
|
isAppEnumerationSupported()
Vérifier 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 système headless.
|
boolean
|
isMainUserPermanentAdmin()
Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ni rétrogradé au statut de non-administrateur.
|
boolean
|
isMultiUserSupported()
Indique si cet appareil prend en charge plusieurs utilisateurs interchangeables avec leur propre espace de connexion et personnalisable.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Interrogez l'appareil pour un nom de package et un ID utilisateur donnés afin de vérifier s'il est actuellement installé ou non pour cet utilisateur.
|
boolean
|
isPackageInstalled(String packageName)
Interrogez l'appareil pour un nom de package donné afin de vérifier s'il est actuellement installé ou non.
|
boolean
|
isUserRunning(int userId)
Vérifiez si un utilisateur donné est en cours d'exécution.
|
boolean
|
isUserSecondary(int userId)
Indique si l'utilisateur spécifié est un utilisateur secondaire en fonction de 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 visible des utilisateurs en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
|
boolean
|
isVisibleBackgroundUsersSupported()
Indique si l'appareil autorise le démarrage visible des utilisateurs en arrière-plan.
|
Set<Long>
|
listDisplayIds()
Collectez la liste des ID d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
|
Set<Integer>
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Obtient la liste des écrans pouvant être utilisés pour start a user visible in the background.
|
ArrayList<Integer>
|
listUsers()
Récupère la liste des utilisateurs sur l'appareil.
|
boolean
|
logBugreport(String dataName, ITestLogger listener)
Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer pour les reporters.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil, qui seront exécutées une fois l'invocation terminée.
|
boolean
|
removeAdmin(String componentName, int userId)
Supprime l'administrateur de l'appareil pour l'utilisateur spécifié et renvoie true en cas de succès, false sinon.
|
void
|
removeOwners()
Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.
|
boolean
|
removeUser(int userId)
Supprimez un utilisateur donné de l'appareil.
|
boolean
|
setDeviceOwner(String componentName, int userId)
Définissez un composant d'administrateur de l'appareil comme propriétaire de l'appareil pour un utilisateur donné.
|
void
|
setFirstBootloaderReboot()
|
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 microdroid, s'il existe.
|
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 sur l'écran donné (c'est-à-dire en permettant à l'utilisateur de lancer des activités sur cet écran).
|
boolean
|
stopUser(int userId)
Arrête un utilisateur donné.
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Arrêtez un utilisateur donné.
|
boolean
|
supportsMicrodroid()
Vérifie les conditions préalables à l'exécution d'un microdroid.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Vérifie les conditions préalables à l'exécution d'un microdroid.
|
boolean
|
switchUser(int userId)
Passez à un autre userId avec un délai d'inactivité par défaut.
|
boolean
|
switchUser(int userId, long timeout)
Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite.
|
Bugreport
|
takeBugreport()
Prenez un rapport de bug et renvoyez-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é.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Constantes
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Commandes pouvant être utilisées pour ignorer le keyguard.
Valeur de constante :
"input keyevent 82"
Constructeurs publics
Méthodes publiques
adbInstallPackage
public String adbInstallPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Installez un package Android sur l'appareil à l'aide de la commande adb.
| Paramètres |
packageFile |
File : fichier APK à installer |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles. |
| Renvoie |
String |
String avec un code d'erreur ou null en cas de succès. |
adbInstallPackage
public String adbInstallPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installez un package Android sur l'appareil à l'aide de la commande adb.
Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution au moment de l'installation doivent appeler cette fonction.
| Paramètres |
packageFile |
File : fichier APK à installer |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
grantPermissions |
boolean : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles. |
| Renvoie |
String |
String avec un code d'erreur ou null en cas de succès. |
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Indique si le passage à l'utilisateur système headless est autorisé.
clearErrorDialogs
public boolean clearErrorDialogs ()
Tente de fermer les boîtes de dialogue d'erreur actuellement affichées dans l'UI de l'appareil.
| Renvoie |
boolean |
true si aucune boîte de dialogue n'était présente ou si les boîtes de dialogue ont été effacées.
Sinon, false. |
createUser
public int createUser (String name)
Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
| Paramètres |
name |
String : de l'utilisateur à créer sur l'appareil |
| Renvoie |
int |
Entier correspondant à l'ID utilisateur créé |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
Créez un utilisateur avec un nom donné et les indicateurs fournis.
| Paramètres |
name |
String : de l'utilisateur à créer sur l'appareil |
guest |
boolean : activez le flag utilisateur "--guest" lors de la création. |
ephemeral |
boolean : activez le flag utilisateur --ephemeral lors de la création. |
| Renvoie |
int |
ID de l'utilisateur créé |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Créez un utilisateur avec un nom donné et les indicateurs fournis.
| Paramètres |
name |
String : de l'utilisateur à créer sur l'appareil |
guest |
boolean : activez le flag utilisateur "--guest" lors de la création. |
ephemeral |
boolean : activez le flag utilisateur --ephemeral lors de la création. |
forTesting |
boolean : activez le flag de test "--for-testing" lors de la création. |
| Renvoie |
int |
ID de l'utilisateur créé |
createUserNoThrow
public int createUserNoThrow (String name)
Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
| Paramètres |
name |
String : de l'utilisateur à créer sur l'appareil |
| Renvoie |
int |
Entier pour l'ID utilisateur créé ou -1 en cas d'erreur. |
disableKeyguard
public void disableKeyguard ()
Tentatives de désactivation du keyguard.
Attendez d'abord que la distribution d'entrée 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 parfois une condition de course. La commande est ensuite envoyée pour fermer le keyguard (fonctionne uniquement sur les keyguards non sécurisés).
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil pour un utilisateur donné.
| Paramètres |
deviceFilePath |
String : chemin d'accès absolu du fichier à vérifier sur l'appareil |
userId |
int : ID utilisateur par rapport auquel vérifier l'existence du fichier |
| Renvoie |
boolean |
true si le fichier existe, false sinon. |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.
| Paramètres |
deviceFilePath |
String : chemin d'accès absolu du fichier à vérifier sur l'appareil |
| Renvoie |
boolean |
true si le fichier existe, false sinon. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Essayez de vider le tas depuis system_server. Il incombe à l'appelant de nettoyer le fichier dumpé.
| Paramètres |
process |
String : nom du processus de l'appareil sur lequel effectuer dumpheap. |
devicePath |
String : chemin d'accès sur l'appareil où placer le fichier de vidage. Il doit s'agir d'un emplacement où les autorisations le permettent. |
| Renvoie |
File |
le File contenant le rapport. Null si un problème est survenu. |
getActiveApexes
public Set<ITestDevice.ApexInfo> getActiveApexes ()
Récupère les informations sur les APEX activés sur l'appareil.
getAllSettings
public Map<String, String> getAllSettings (String namespace)
Renvoie les paires clé/valeur de l'espace de noms demandé.
| Paramètres |
namespace |
String : doit être l'une des valeurs suivantes : {"system", "secure", "global"} |
| Renvoie |
Map<String, String> |
Carte des paires clé/valeur. Valeur nulle si l'espace de noms n'est pas pris en charge. |
getAndroidId
public String getAndroidId (int userId)
Recherchez et renvoyez l'android-id associé à un userId. Renvoie la valeur "null" si aucun n'est trouvé.
getAndroidIds
public Map<Integer, String> getAndroidIds ()
Créez une carte des ID Android trouvés correspondant aux ID utilisateur. Cette fonction ne garantit pas que chaque ID utilisateur trouvera un ID Android associé. Par conséquent, certains ID utilisateur peuvent correspondre à la valeur nulle.
| Renvoie |
Map<Integer, String> |
Carte des ID Android correspondant aux ID utilisateur. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Récupérez des informations sur un package installé sur l'appareil.
| Paramètres |
packageName |
String |
getAppPackageInfos
public List<PackageInfo> getAppPackageInfos ()
Récupérer les informations des packages installés sur l'appareil.
getBugreport
public InputStreamSource getBugreport ()
Récupère un rapport de bug depuis l'appareil.
L'implémentation de cette fonctionnalité est garantie de continuer à fonctionner sur un appareil sans carte SD (ou lorsque la carte SD n'est pas encore montée).
getBugreportz
public InputStreamSource getBugreportz ()
Récupère un bugreportz depuis l'appareil. Le rapport de bug au format ZIP contient le rapport de bug principal et d'autres fichiers journaux utiles pour le débogage.
Uniquement compatible avec "adb version" > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Renvoie l'état de pliage actuel de l'appareil ou la valeur "null" en cas de problème.
getCurrentUser
public int getCurrentUser ()
Renvoie l'ID de l'utilisateur en cours d'exécution. En cas d'erreur, renvoyez -10000.
getFoldableStates
public Set<DeviceFoldableState> getFoldableStates ()
Renvoie la liste des états de pliage de l'appareil. Peut être obtenu avec "cmd device_state
print-states".
getInstalledPackageNames
public Set<String> getInstalledPackageNames ()
Récupère les noms des packages d'application présents sur l'appareil.
| Renvoie |
Set<String> |
Set noms de packages sur String actuellement installés sur l'appareil. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Renvoie un objet pour obtenir l'état actuel du keyguard ou la valeur "null" si ce n'est pas pris en charge.
getMainUserId
public Integer getMainUserId ()
Renvoie l'ID utilisateur principal.
| Renvoie |
Integer |
ID utilisateur de l'utilisateur principal, le cas échéant. La valeur est "null" si aucun utilisateur principal n'est défini. |
getMainlineModuleInfo
public Set<String> getMainlineModuleInfo ()
Obtenez des informations sur les modules Mainline installés sur l'appareil.
| Renvoie |
Set<String> |
Set des modules principaux String actuellement installés sur l'appareil. |
public int getMaxNumberOfRunningUsersSupported ()
Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément. La valeur par défaut est 0.
| Renvoie |
int |
Nombre entier indiquant le nombre d'utilisateurs exécutés simultanément |
public int getMaxNumberOfUsersSupported (String userType)
Obtenez le nombre maximal d'utilisateurs acceptés pour le type d'utilisateur donné. La valeur par défaut est 0.
| Paramètres |
userType |
String : type d'utilisateur, tel que défini dans UserManager, par exemple "android.os.usertype.full.SECONDARY". |
| Renvoie |
int |
Entier indiquant le nombre d'utilisateurs acceptés pour le type d'utilisateur donné. |
public int getMaxNumberOfUsersSupported ()
Obtenez le nombre maximal d'utilisateurs pouvant être changés, sans inclure les invités. Après la version 36 de l'API, n'inclut pas les utilisateurs non interchangeables (comme les profils). La valeur par défaut est 0.
| Renvoie |
int |
Entier indiquant le nombre d'utilisateurs interchangeables acceptés. |
getPrimaryUserId
public Integer getPrimaryUserId ()
Renvoie l'ID utilisateur principal.
| Renvoie |
Integer |
ID utilisateur de l'utilisateur principal, le cas échéant. La valeur est "null" si aucun utilisateur principal n'est défini. |
getRemainingCreatableUserCount
public int getRemainingCreatableUserCount (String userType)
Renvoie le nombre d'utilisateurs du type d'utilisateur donné qui peuvent être créés sur cet appareil.
| Paramètres |
userType |
String : type d'utilisateur, tel que défini dans UserManager, par exemple "android.os.usertype.full.SECONDARY". |
| Renvoie |
int |
le nombre d'utilisateurs du type d'utilisateur donné pouvant être ajoutés. |
getScreenshot
public InputStreamSource getScreenshot (Long displayId,
String format,
boolean rescale)
Prend une capture d'écran à partir de l'ID d'affichage de l'appareil avec le format pris en charge. Autoriser la mise à l'échelle pour prendre en charge les tailles plus petites
| Paramètres |
displayId |
Long : ID de l'écran à partir duquel effectuer la capture d'écran. |
format |
String : PNG et JPEG acceptés |
rescale |
boolean : indique si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante. |
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Prend une capture d'écran de l'appareil. Nous vous recommandons d'utiliser getScreenshot(String) avec l'encodage JPEG pour une taille plus petite.
| Paramètres |
format |
String : PNG et JPEG acceptés |
rescale |
boolean : indique si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Prend une capture d'écran de l'appareil.
Il est recommandé d'utiliser getScreenshot(format) avec l'encodage JPEG pour une taille plus petite.
| Paramètres |
format |
String : PNG et JPEG acceptés |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil. Le format est PNG.
À FAIRE : étendre les implémentations ci-dessus pour prendre en charge "format" et "rescale"
| Paramètres |
displayId |
long : ID de l'écran à partir duquel effectuer la capture d'écran. |
getScreenshot
public InputStreamSource getScreenshot ()
Prend une capture d'écran de l'appareil.
getSetting
public String getSetting (int userId,
String namespace,
String key)
Renvoie la valeur du paramètre demandé.
L'espace de noms doit être l'un des suivants : {"system", "secure", "global"}
| Paramètres |
userId |
int |
namespace |
String |
key |
String |
| Renvoie |
String |
la valeur associée à l'espace de noms:clé d'un utilisateur. Null si introuvable. |
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 |
getUninstallablePackageNames
public Set<String> getUninstallablePackageNames ()
Récupère les noms de package des applications qui peuvent être désinstallées. Il est actuellement défini comme des packages non système et des packages système mis à jour.
| Renvoie |
Set<String> |
Set noms de packages String désinstallables actuellement installés sur l'appareil. |
getUserFlags
public int getUserFlags (int userId)
Recherchez et renvoyez les indicateurs d'un utilisateur donné.
Les indicateurs sont définis dans la classe "android.content.pm.UserInfo" du projet Android Open Source.
| Renvoie |
int |
Indique les indicateurs associés à l'userId fourni, le cas échéant, ou -10000 dans les autres cas. |
getUserInfos
public Map<Integer, UserInfo> getUserInfos ()
Obtient le mappage de useId vers UserInfo sur l'appareil. Génère DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.
| Renvoie |
Map<Integer, UserInfo> |
Liste des objets UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, -10000 dans tous les autres cas.
getUserVisibleOnDisplay
public int getUserVisibleOnDisplay (int displayId)
Obtient l'ID utilisateur de l'utilisateur visible sur l'écran donné.
| Paramètres |
displayId |
int : ID de l'écran. |
| Renvoie |
int |
ID utilisateur de l'utilisateur visible sur l'écran donné. Il ne fait pas la différence entre un utilisateur d'arrière-plan visible et l'utilisateur de premier plan actuel, car les deux types sont visibles. Pour faire la différence, comparez-le au résultat de getCurrentUser(). |
hasFeature
public boolean hasFeature (String feature)
Vérifier si une fonctionnalité est disponible sur un appareil
| Paramètres |
feature |
String : le format doit être "feature:" ou directement. |
| Renvoie |
boolean |
"True" si la fonctionnalité est trouvée, "false" dans le cas contraire. |
installPackage
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 d'une autorisation d'exécution au moment de l'installation doivent appeler cette fonction.
| Paramètres |
packageFile |
File : fichier APK à installer |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
grantPermissions |
boolean : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles. |
| Renvoie |
String |
String avec un code d'erreur ou null en cas de succès. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Installez un package Android sur l'appareil.
| Paramètres |
packageFile |
File : fichier APK à installer |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles. |
| Renvoie |
String |
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 d'une autorisation d'exécution au moment de l'installation doivent appeler cette fonction.
| Paramètres |
packageFile |
File : fichier APK à installer |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
grantPermissions |
boolean : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation. |
userId |
int : ID utilisateur entier pour lequel effectuer l'installation. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles. |
| Renvoie |
String |
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 : fichier APK à installer |
reinstall |
boolean : true si une réinstallation doit être effectuée. |
userId |
int : ID utilisateur entier pour lequel effectuer l'installation. |
extraArgs |
String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles. |
| Renvoie |
String |
String avec un code d'erreur ou null en cas de succès. |
installPackageWithIncrementalMode
public boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)
Installe les APK avec le mode incrémentiel.
| Paramètres |
apkFiles |
File : fichiers APK à installer. |
extraArgs |
String |
userId |
String |
installPackages
public String installPackages (List<File> packageFiles,
boolean reinstall,
String... extraArgs)
| Paramètres |
packageFiles |
List |
reinstall |
boolean |
extraArgs |
String |
installPackages
public String installPackages (List<File> packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
| Paramètres |
packageFiles |
List |
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser (List<File> packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
| Paramètres |
packageFiles |
List |
reinstall |
boolean |
userId |
int |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser (List<File> packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
| Paramètres |
packageFiles |
List |
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Vérifier si la plate-forme sur l'appareil prend en charge l'énumération des applications
| Renvoie |
boolean |
"True" si l'énumération des applications est acceptée, "false" dans le cas contraire. |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Indique si l'appareil utilise le mode utilisateur système headless.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ni rétrogradé au statut de non-administrateur.
isMultiUserSupported
public boolean isMultiUserSupported ()
Indique si cet appareil prend en charge plusieurs utilisateurs interchangeables avec leur propre espace de connexion et personnalisable.
Notez que, même si la valeur est "false", plusieurs utilisateurs peuvent toujours être possibles, tant qu'aucune UI de connexion n'est requise (par exemple, les profils peuvent toujours être pris en charge, car ils ne nécessitent pas d'UI de connexion).
Cela vérifie également config_enableMultiUserUI. À la demande, nous sommes autorisés à supposer que les appareils pour lesquels cela est vrai sont configurés pour autoriser l'ajout d'utilisateurs secondaires via adb.
| Renvoie |
boolean |
Indique si l'appareil accepte plusieurs utilisateurs interchangeables. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Interrogez l'appareil pour un nom de package et un ID utilisateur donnés afin de vérifier s'il est actuellement installé ou non pour cet utilisateur.
| Paramètres |
packageName |
String : package dont nous vérifions l'installation. |
userId |
String : ID de l'utilisateur pour lequel nous vérifions si le package est installé. Si la valeur est nulle, l'utilisateur principal zéro sera utilisé. |
| Renvoie |
boolean |
Valeur "true" si le package est signalé comme installé. ou "false" dans le cas contraire. |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Interrogez l'appareil pour un nom de package donné afin de vérifier s'il est actuellement installé ou non.
| Paramètres |
packageName |
String |
| Renvoie |
boolean |
Valeur "true" si le package est signalé comme installé. ou "false" dans le cas contraire. |
isUserRunning
public boolean isUserRunning (int userId)
Vérifiez si un utilisateur donné est en cours d'exécution.
| Renvoie |
boolean |
"True" si l'utilisateur court, "false" dans tous les autres cas. |
isUserSecondary
public boolean isUserSecondary (int userId)
Indique si l'utilisateur spécifié est un utilisateur secondaire en fonction de ses indicateurs.
| Renvoie |
boolean |
"true" si l'utilisateur est secondaire, "false" dans le cas contraire. |
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 peut donc 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 peut donc lancer des activités sur cet écran.
| Paramètres |
userId |
int |
displayId |
int |
listDisplayIds
public Set<Long> listDisplayIds ()
Collectez la liste des ID d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
| Renvoie |
Set<Long> |
Liste des écrans. Default renvoie toujours l'affichage par défaut 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()
Obtient la liste des écrans pouvant être utilisés pour start a user visible in the background.
listUsers
public ArrayList<Integer> listUsers ()
Récupère la liste des utilisateurs sur l'appareil. Génère DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.
| Renvoie |
ArrayList<Integer> |
Liste des ID utilisateur. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer pour les reporters.
| Paramètres |
dataName |
String : nom sous lequel le rapport de bug sera signalé. |
listener |
ITestLogger : ITestLogger pour enregistrer le rapport de bug. |
| Renvoie |
boolean |
"True" si la journalisation a réussi, "false" dans le cas contraire. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
| Paramètres |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil, qui seront exécutées une fois l'invocation terminée.
| Paramètres |
exception |
Throwable : le cas échéant, l'exception finale générée par l'échec de l'invocation. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Supprime l'administrateur de l'appareil pour l'utilisateur spécifié et renvoie true en cas de succès, false sinon.
| Paramètres |
componentName |
String : administrateur de l'appareil à supprimer. |
userId |
int : de l'utilisateur auquel appartient l'administrateur de l'appareil. |
| Renvoie |
boolean |
"True" si l'opération a réussi, "false" dans le cas contraire. |
removeOwners
public void removeOwners ()
Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.
removeUser
public boolean removeUser (int userId)
Supprimez un utilisateur donné de l'appareil.
| Paramètres |
userId |
int : de l'utilisateur à supprimer |
| Renvoie |
boolean |
"true" si l'utilisateur a bien été supprimé, "false" dans le cas contraire. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Définissez un composant d'administrateur de l'appareil comme propriétaire de l'appareil pour un utilisateur donné.
| Paramètres |
componentName |
String : de l'administrateur de l'appareil au propriétaire de l'appareil. |
userId |
int : de l'utilisateur dans lequel réside le propriétaire de l'appareil. |
| Renvoie |
boolean |
"True" si l'opération a réussi, "false" dans le cas contraire. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
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 |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Arrête le microdroid, s'il existe.
| 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 est déjà en cours d'exécution en arrière-plan, cette méthode est une NOOP.
| Paramètres |
userId |
int : de l'utilisateur à démarrer en arrière-plan |
| Renvoie |
boolean |
"true" si l'utilisateur a bien été démarré 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 est déjà en cours d'exécution en arrière-plan, cette méthode est une NOOP. Il est possible de fournir un indicateur supplémentaire pour attendre que l'opération ait un effet.
| Paramètres |
userId |
int : de l'utilisateur à démarrer en arrière-plan |
waitFlag |
boolean : la commande attend que l'utilisateur soit démarré et déverrouillé. |
| Renvoie |
boolean |
"true" si l'utilisateur a bien été démarré en arrière-plan. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (c'est-à-dire en permettant à l'utilisateur de lancer des activités sur cet écran).
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 : écran sur lequel l'utilisateur est visible au début |
waitFlag |
boolean : la commande attend que l'utilisateur soit démarré et déverrouillé. |
| Renvoie |
boolean |
true si l'utilisateur a bien démarré et est visible en arrière-plan. |
stopUser
public boolean stopUser (int userId)
Arrête un utilisateur donné. Si l'utilisateur est déjà arrêté, cette méthode est une NOOP.
Impossible d'arrêter l'utilisateur actuel et l'utilisateur système.
| Paramètres |
userId |
int de l'utilisateur à arrêter. |
| Renvoie |
boolean |
"true" si l'utilisateur a bien été arrêté. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Arrêtez un utilisateur donné. Il est possible de fournir des indicateurs supplémentaires pour attendre que l'opération prenne effet et forcer la résiliation 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 : la commande attendra jusqu'à ce que l'utilisateur soit arrêté. |
forceFlag |
boolean : force l'arrêt de l'utilisateur. |
| Renvoie |
boolean |
"true" si l'utilisateur a bien été arrêté. |
supportsMicrodroid
public boolean supportsMicrodroid ()
Vérifie les conditions préalables à l'exécution d'un microdroid.
| Renvoie |
boolean |
Renvoie "true" si les conditions préalables sont remplies, ou "false" dans le cas contraire. |
supportsMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Vérifie les conditions préalables à l'exécution d'un microdroid.
| Paramètres |
protectedVm |
boolean : "true" si microdroid est destiné à s'exécuter sur une VM protégée. |
| Renvoie |
boolean |
Renvoie "true" si les conditions préalables sont remplies, ou "false" dans le cas contraire. |
switchUser
public boolean switchUser (int userId)
Passez à un autre userId avec un délai d'inactivité par défaut. switchUser(int, long).
| Renvoie |
boolean |
"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. ou "false" dans le cas contraire. |
switchUser
public boolean switchUser (int userId,
long timeout)
Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite.
Tentative de désactivation du keyguard après le changement d'utilisateur réussi.
| Paramètres |
userId |
int |
timeout |
long : délai d'attente avant de renvoyer la valeur "false" en cas d'échec du changement d'utilisateur. |
| Renvoie |
boolean |
"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. ou "false" dans le cas contraire. |
takeBugreport
public Bugreport takeBugreport ()
Prenez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer. Renvoie la valeur null en cas de problème. Les fichiers référencés dans l'objet Bugreport doivent être nettoyés 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 |
| Renvoie |
String |
String avec un code d'erreur ou null en cas de succès. |
uninstallPackageForUser
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 : ID utilisateur entier pour lequel désinstaller l'application. |
| Renvoie |
String |
String avec un code d'erreur ou null en cas de succès. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
| Paramètres |
currentPhase |
SnapuserdWaitPhase |
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 : 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 File.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Exposé pour les tests.
getHostCurrentTime
protected long getHostCurrentTime ()
Exposé pour les tests
prePostBootSetup
protected void prePostBootSetup ()
Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage.