Appareil de test

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Commandes pouvant être utilisées pour ignorer le keyguard.

Appareil de test

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

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.

Créer un utilisateur

public int createUser (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.

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

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

createUserNoThrow

public int createUserNoThrow (String name)

Créez un utilisateur avec un nom donné et des indicateurs par défaut 0.

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ù le périphérique 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.

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

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

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

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.

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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.

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.

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Obtenez les informations sur les modules principaux installés sur l’appareil.

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximum d’utilisateurs fonctionnant simultanément pris en charge. La valeur par défaut est 0.

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Obtenez le nombre maximum d'utilisateurs pris en charge. La valeur par défaut est 0.

getPrimaryUserId

public Integer getPrimaryUserId ()

Renvoie l'identifiant de l'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.

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

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"

getSetting

public String getSetting (String namespace, 
                String key)

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

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"}

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.

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.

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.

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.

installer le paquet

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Installez un package Android sur l'appareil.

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.

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.

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.

installerPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Installez un package Android sur l'appareil pour un utilisateur donné.

installerPackages

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

installerPackages

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

installerPackagesForUser

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

installerPackagesForUser

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

installerRemotePackages

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

installerRemotePackages

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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Vérifiez si la plate-forme sur l'appareil prend en charge l'énumération des applications

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.

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.

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.

estUserRunning

public boolean isUserRunning (int userId)

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

isUserSecondary

public boolean isUserSecondary (int userId)

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

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.

isVisibleBackgroundUsersOnDefaultDisplaySupported

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

Si tel est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean) , en transmettant un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers() (qui devrait inclure ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Indique si l'appareil autorise le démarrage des utilisateurs visibles en arrière-plan.

Si tel est le cas, vous pouvez appeler startVisibleBackgroundUser(int, int, boolean) , en transmettant un affichage renvoyé par listDisplayIdsForStartingVisibleBackgroundUsers() .

listDisplayIds

public  listDisplayIds ()

Collectez la liste des identifiants d'affichage disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".

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.

logbugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Méthode d'assistance pour rédiger un rapport de bug et le consigner aux journalistes.

notifierSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

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.

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.

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

setSetting

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

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

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"}

arrêtMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Arrête le périphérique microdroïde, s'il en existe un.

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.

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.

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.

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.

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.

prend en chargeMicrodroid

public boolean supportsMicrodroid ()

Vérifie les conditions préalables pour exécuter un microdroïde.

prend en chargeMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Vérifie les conditions préalables pour exécuter un microdroïde.

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

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.

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.

désinstallerPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Désinstallez un package Android de l'appareil pour un utilisateur donné.

attendreSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

créerParser

protected AaptParser createParser (File appFile)

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Effectuez un redémarrage adb.

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

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.