ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Fournit une API fiable de niveau légèrement supérieur à un IDevice ddmlib.

Relance les commandes de l'appareil pour une quantité configurable et permet de récupérer l'appareil pour les appareils qui ne répondent pas.

Résumé

Classes imbriquées

class ITestDevice.ApexInfo

Une classe struct simple pour stocker des informations sur un seul apex

class ITestDevice.MountPointInfo

Une classe struct simple pour stocker des informations sur un seul point de montage

Méthodes publiques

abstract boolean canSwitchToHeadlessSystemUser()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.

abstract boolean checkConnectivity()

Vérifiez que l'appareil est connecté au réseau.

abstract boolean clearErrorDialogs()

Essayez de fermer les boîtes de dialogue d'erreur affichées dans l'interface utilisateur de l'appareil.

abstract void clearLastConnectedWifiNetwork()

Efface le dernier réseau Wi-Fi connecté.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Se connecte à un réseau Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Se connecte à un réseau Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Se connecte à un réseau Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)

Se connecte à un réseau Wi-Fi.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)

Variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.

abstract int createUser(String name)

Créez un utilisateur avec un nom donné et les options par défaut de 0.

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

Créer un utilisateur avec un nom donné et les options fournies

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

Créer un utilisateur avec un nom donné et les options fournies

abstract int createUserNoThrow(String name)

Créez un utilisateur avec un nom donné et les options par défaut de 0.

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

abstract void disableKeyguard()

Tente de désactiver la protection du clavier.

abstract boolean disableNetworkMonitor()

Désactive la surveillance du réseau sur l'appareil.

abstract boolean disconnectFromWifi()

Se déconnecte d'un réseau Wi-Fi.

abstract boolean doesFileExist(String deviceFilePath, int userId)

Méthode d'assistance permettant de déterminer si un fichier sur l'appareil existe pour un utilisateur donné.

abstract File dumpHeap(String process, String devicePath)

Essayez de vider le tas de mémoire à partir de system_server.

abstract boolean enableNetworkMonitor()

Active la surveillance du réseau sur l'appareil.

abstract getActiveApexes()

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

abstract getAllSettings(String namespace)

Renvoie les paires clé/valeur de l'espace de noms demandé.

abstract String getAndroidId(int userId)

Recherchez et renvoyez l'android-id associé à un userId. La valeur "null" est absente si vous ne l'avez pas trouvé.

abstract getAndroidIds()

Créer une carte des identifiants Android trouvés pour les ID utilisateur correspondants.

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

Récupère des informations sur les packages installés sur l'appareil.

abstract InputStreamSource getBugreport()

Récupère un rapport de bug de l'appareil.

abstract InputStreamSource getBugreportz()

Récupère un rapport de bug de l'appareil.

abstract DeviceFoldableState getCurrentFoldableState()

Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème.

abstract int getCurrentUser()

Renvoie l'identifiant de l'utilisateur actuel.

abstract getFoldableStates()

Renvoie la liste des états des appareils pliables sur l'appareil.

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

Récupère l'adresse IP de l'appareil.

abstract KeyguardControllerState getKeyguardState()

Renvoyez un objet pour obtenir l'état actuel du verrouillage du clavier ou la valeur "null" si cette fonctionnalité n'est pas disponible.

abstract Integer getMainUserId()

Renvoie l'ID utilisateur principal.

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

Obtenir le nombre maximal d'utilisateurs pouvant s'exécuter simultanément

abstract int getMaxNumberOfUsersSupported()

Obtenir le nombre maximal d'utilisateurs pris en charge

abstract TestDeviceOptions getOptions()

Récupérez les options de test pour l'appareil.

abstract Integer getPrimaryUserId()

Renvoie l'identifiant de l'utilisateur principal.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Permet de prendre une capture d'écran de l'appareil.

abstract InputStreamSource getScreenshot(String format)

Permet de prendre une capture d'écran de l'appareil.

abstract InputStreamSource getScreenshot(long displayId)

Récupère une capture d'écran de l'appareil correspondant à l'identifiant d'affichage.

abstract InputStreamSource getScreenshot()

Permet de prendre une capture d'écran de l'appareil.

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

Renvoie la valeur du paramètre demandé.

abstract String getSetting(String namespace, String key)

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

abstract getUninstallablePackageNames()

Récupérez les noms des packages d'application qui peuvent être désinstallés.

abstract int getUserFlags(int userId)

Rechercher et renvoyer les indicateurs d'un utilisateur donné

abstract getUserInfos()

Récupère la carte de useId sur UserInfo sur l'appareil.

abstract int getUserSerialNumber(int userId)

Renvoyez le numéro de série associé à l'ID utilisateur s'il est trouvé, et -10000 dans les autres cas.

abstract boolean hasFeature(String feature)

Vérifier si une fonctionnalité est disponible sur un appareil

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

Installer un package Android sur l'appareil

abstract String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Installer un package Android sur l'appareil

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

Installer un package Android sur l'appareil d'un utilisateur donné

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

Installer un package Android sur l'appareil d'un utilisateur donné

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

Installez une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire).

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) sur l'appareil Android.

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) pour un utilisateur donné.

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) pour un utilisateur donné.

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) sur l'appareil Android.

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) sur l'appareil Android.

abstract boolean isHeadlessSystemUserMode()

Indique si l'appareil utilise le mode utilisateur système headless.

abstract boolean isMainUserPermanentAdmin()

Indique si l'utilisateur principal est un administrateur permanent et si celui-ci ne peut pas être supprimé ou rétrogradé non-administrateur.

abstract boolean isMultiUserSupported()

Détermine si le mode multi-utilisateur est pris en charge.

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

Interrogez l'appareil sur le nom de package donné pour vérifier s'il est actuellement installé ou non.

abstract boolean isUserRunning(int userId)

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

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

Vérifie si l'utilisateur donné est visible.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

Vérifie si l'utilisateur donné est visible sur l'écran donné.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

abstract boolean isVisibleBackgroundUsersSupported()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.

abstract boolean isWifiEnabled()

Vérifiez si le Wi-Fi est activé.

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Récupère la liste des écrans pouvant être utilisés pour start a user visible in the background.

abstract listUsers()

Récupère la liste des utilisateurs de l'appareil.

abstract boolean logBugreport(String dataName, ITestLogger listener)

Méthode d'assistance permettant de générer un rapport de bug et de l'enregistrer dans les rapports

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Demander à l'appareil d'attendre la fin de l'opération Snapuserd

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

abstract boolean removeAdmin(String componentName, int userId)

Supprimer l'administrateur de l'appareil indiqué pour l'utilisateur concerné et renvoyer true si l'opération réussit, ou false dans le cas contraire.

abstract void removeOwners()

Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.

abstract boolean removeUser(int userId)

Supprimer un utilisateur donné de l'appareil

abstract boolean setDeviceOwner(String componentName, int userId)

Définissez un composant d'administrateur de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné.

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

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

abstract void setSetting(int userId, String namespace, String key, String value)

Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné.

abstract boolean startUser(int userId)

Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté.

abstract boolean startUser(int userId, boolean waitFlag)

Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté.

abstract boolean startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)

Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui signifie que l'utilisateur pour lancer des activités sur cet affichage).

abstract boolean stopUser(int userId)

Arrête un utilisateur donné.

abstract boolean stopUser(int userId, boolean waitFlag, boolean forceFlag)

Arrêter un utilisateur donné.

abstract boolean switchUser(int userId)

Passez à un autre ID utilisateur avec un délai d'inactivité par défaut.

abstract boolean switchUser(int userId, long timeout)

Passez à un autre ID utilisateur avec le délai d'expiration fourni comme délai.

abstract Bugreport takeBugreport()

Créez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer.

abstract String uninstallPackage(String packageName)

Désinstaller un package Android de l'appareil

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Si prévu, attendez que Snapuserd ait terminé.

Méthodes publiques

CanSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans interface graphique.

Renvoie
boolean

Génère
DeviceNotAvailableException

vérifier la connectivité

public abstract boolean checkConnectivity ()

Vérifiez que l'appareil est connecté au réseau.

Renvoie
boolean true si la connexion réseau de l'appareil fonctionne false en excès.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

Essayez de fermer les boîtes de dialogue d'erreur affichées dans l'interface utilisateur de l'appareil.

Renvoie
boolean true si aucune boîte de dialogue n'était présente ou si les boîtes de dialogue ont bien été effacées. false dans les autres cas.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

ClearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Efface le dernier réseau Wi-Fi connecté. Ce nom doit être appelé lors du démarrage d'un nouvel appel pour éviter de vous connecter au réseau Wi-Fi utilisé lors du test précédent après le redémarrage de l'appareil.

se connecter au réseauWi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce que la connexion soit établie avec l'un des réseaux Wi-Fi réseaux donnés dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance restaurer la connexion après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() est appelé.

Paramètres
wifiSsidToPsk : mappage des SSID Wi-Fi et des mots de passe.
Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false sinon
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

se connecter au réseauWi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce que la connexion soit établie avec l'un des réseaux Wi-Fi réseaux donnés dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance restaurer la connexion après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() est appelé.

Paramètres
wifiSsidToPsk : mappage des SSID Wi-Fi et des mots de passe.
scanSsid boolean: rechercher les SSID masqués pour ce réseau
Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false sinon
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

se connecter au réseauWi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce que la connexion au réseau Wi-Fi spécifié soit établie. Une fois la connexion établie, l'instance tentera de la restaurer après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() est appelé.

Paramètres
wifiSsid String: indicateur Wi-Fi auquel se connecter
wifiPsk String: phrase secrète de la clé pré-partagée ou valeur nulle en l'absence de chiffrement
Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false sinon
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

se connecter au réseauWi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce que la connexion au réseau Wi-Fi spécifié soit établie. Une fois la connexion établie, l'instance tentera de la restaurer après chaque redémarrage jusqu'au ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() est appelé.

Paramètres
wifiSsid String: indicateur Wi-Fi auquel se connecter
wifiPsk String: phrase secrète de la clé pré-partagée ou valeur nulle en l'absence de chiffrement
scanSsid boolean: rechercher ou non le SSID masqué pour ce réseau
Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false sinon
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

ConnectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.

Paramètres
scanSsid boolean: rechercher ou non le SSID masqué pour ce réseau
Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false sinon
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement d'aucune connectivité réseau.

Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false sinon
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

créerutilisateur

public abstract int createUser (String name)

Créez un utilisateur avec un nom donné et les options par défaut de 0.

Paramètres
name String: de l'utilisateur à créer sur l'appareil
Renvoie
int l'entier pour l'ID utilisateur créé
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

créerutilisateur

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

Créer un utilisateur avec un nom donné et les options fournies

Paramètres
name String: de l'utilisateur à créer sur l'appareil
guest boolean: activer l'indicateur utilisateur --guest lors de la création
ephemeral boolean: activer l'option utilisateur --ephemeral lors de la création
Renvoie
int ID de l'utilisateur créé
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

créerutilisateur

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

Créer un utilisateur avec un nom donné et les options fournies

Paramètres
name String: de l'utilisateur à créer sur l'appareil
guest boolean: activer l'indicateur utilisateur --guest lors de la création
ephemeral boolean: activer l'option utilisateur --ephemeral lors de la création
forTesting boolean: active l'indicateur de test --for-testing lors de la création.
Renvoie
int ID de l'utilisateur créé
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

créerUtilisateurPasDeJeter

public abstract int createUserNoThrow (String name)

Créez un utilisateur avec un nom donné et les options par défaut de 0.

Paramètres
name String: de l'utilisateur à créer sur l'appareil
Renvoie
int l'entier pour l'ID utilisateur créé ou -1 pour l'erreur.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

Paramètres
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver qui sera supprimé.

désactiver la protection des touches

public abstract void disableKeyguard ()

Tente de désactiver la protection du clavier.

Attendez d'abord que l'envoi des entrées soit prêt. Cela se produit au même moment, lorsque la fonction l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car le framework actuel présente une condition de concurrence occasionnelle. Ensuite, la commande est envoyée pour désactiver la protection du clavier (uniquement sur les sites non sécurisés)

Génère
DeviceNotAvailableException

désactiver MoniteurRéseau

public abstract boolean disableNetworkMonitor ()

Désactive la surveillance du réseau sur l'appareil.

Renvoie
boolean true si la surveillance est désactivée. false en cas d'échec.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

déconnecter du Wifi

public abstract boolean disconnectFromWifi ()

Se déconnecte d'un réseau Wi-Fi.

Supprime tous les réseaux de la liste des réseaux connus et désactive le Wi-Fi.

Renvoie
boolean true si la connexion au réseau Wi-Fi aboutit. false si la déconnexion échoue.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Méthode d'assistance permettant de déterminer si un fichier sur l'appareil existe pour un utilisateur donné.

Paramètres
deviceFilePath String: chemin absolu du fichier sur l'appareil à vérifier
userId int: ID utilisateur par rapport auquel l'existence du fichier doit être vérifiée.
Renvoie
boolean true si le fichier existe, false dans le cas contraire.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

tas de mémoire

public abstract File dumpHeap (String process, 
                String devicePath)

Essayez de vider le tas de mémoire à partir de system_server. Il incombe à l'appelant de nettoyer le fichier vidé.

Paramètres
process String: nom du processus de l'appareil sur lequel vider le tas.
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 ERROR(/File) contenant le rapport. Null en cas d'échec.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Active la surveillance du réseau sur l'appareil.

Renvoie
boolean true si la surveillance a bien été activée. false en cas d'échec.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

GetActiveApexes

public abstract  getActiveApexes ()

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

Renvoie
ERROR(/Set) sur ApexInfo actuellement activés sur l'appareil
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getTous les paramètres

public abstract  getAllSettings (String namespace)

Renvoie les paires clé/valeur de l'espace de noms demandé.

Paramètres
namespace String : doit correspondre à l'une des valeurs suivantes : {"system", "secure", "global"}
Renvoie
le mappage des paires clé-valeur. Valeur Null si l'espace de noms n'est pas accepté.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Recherchez et renvoyez l'android-id associé à un userId. La valeur "null" est absente si vous ne l'avez pas trouvé.

Paramètres
userId int

Renvoie
String

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Créer une carte des identifiants Android trouvés pour les ID utilisateur correspondants. Il n’y a pas d’assurance que chaque utilisateur id trouve un identifiant Android associé à cette fonction. Certains ID utilisateur peuvent donc correspondre à "null".

Renvoie
Carte des ID Android trouvés pour les ID utilisateur correspondants.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Paramètres
packageName String

Renvoie
PackageInfo PackageInfo ou null si les informations n'ont pas pu être récupérées
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Récupère des informations sur les packages installés sur l'appareil.

Renvoie
ERROR(/List) applications sur PackageInfo installées sur l'appareil.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Récupère un rapport de bug de l'appareil.

La mise en œuvre de cette fonctionnalité continuera de fonctionner sur un appareil sans carte SD (ou là où la carte SD n'est pas encore installée).

Renvoie
InputStreamSource Un InputStreamSource qui génère le contenu du rapport de bug à la demande. Dans en cas d'échec, InputStreamSource produira un ERROR(/InputStream) vide.

GetBugreportz

public abstract 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 compatible avec la "version adb" > 1.0.36

Renvoie
InputStreamSource Une InputStreamSource du fichier ZIP contenant bugreportz, renvoie la valeur "null" dans en cas d'échec.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état actuel des appareils pliables ou la valeur "null" en cas de problème.

Renvoie
DeviceFoldableState

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Renvoie l'identifiant de l'utilisateur actuel. En cas d'erreur, renvoyez -10000.

Renvoie
int

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Renvoie la liste des états des appareils pliables sur l'appareil. Obtention de la commande "cmd device_state" "print-states" (états d'impression).

Renvoie
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstallPackageNames

public abstract  getInstalledPackageNames ()

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

Renvoie
ERROR(/Set) noms de packages sur String sont actuellement installés sur l'appareil.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Récupère l'adresse IP de l'appareil.

Renvoie
String l'adresse IP de l'appareil, ou null si l'appareil n'en a pas ;
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Renvoyez un objet pour obtenir l'état actuel du verrouillage du clavier ou la valeur "null" si cette fonctionnalité n'est pas disponible.

Renvoie
KeyguardControllerState Une KeyguardControllerState contenant un instantané de l'état de la protection du clavier et renvoie Null si la requête de garde du clavier n'est pas prise en charge.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

IDUtilisateurMain

public abstract Integer getMainUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
Integer L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

Renvoie
ERROR(/Set) module principal sur String actuellement installé sur l'appareil.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersCompatibles

public abstract int getMaxNumberOfRunningUsersSupported ()

Obtenir le nombre maximal d'utilisateurs pouvant s'exécuter simultanément La valeur par défaut est 0.

Renvoie
int Nombre entier indiquant le nombre d'utilisateurs exécutant simultanément
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersCompatibles

public abstract int getMaxNumberOfUsersSupported ()

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

Renvoie
int Nombre entier indiquant le nombre d'utilisateurs acceptés
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Récupérez les options de test pour l'appareil.

Renvoie
TestDeviceOptions TestDeviceOptions associé à l'appareil testé.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Renvoie l'identifiant de l'utilisateur principal.

Renvoie
Integer L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Permet de prendre une capture d'écran de l'appareil. Il est recommandé d'utiliser plutôt getScreenshot(String) avec un encodage JPEG pour une taille plus petite.

Paramètres
format String: fichiers PNG et JPEG acceptés.
rescale boolean: si la capture d'écran doit être redimensionnée pour réduire la taille de l'image obtenue
Renvoie
InputStreamSource un InputStreamSource de la capture d'écran au format, ou null si le la capture d'écran a échoué.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Permet de prendre une capture d'écran de l'appareil. Il est recommandé d'utiliser getScreenshot(format) à la place avec l'encodage JPEG pour réduire la taille.

Paramètres
format String: fichiers PNG et JPEG acceptés.
Renvoie
InputStreamSource un InputStreamSource de la capture d'écran au format, ou null si la capture d'écran a échoué.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

À FAIRE: étendre les implémentations ci-dessus pour prendre en charge le "format" et "redimensionner"

Paramètres
displayId long: ID d'affichage de l'écran à partir duquel obtenir la capture d'écran.
Renvoie
InputStreamSource un InputStreamSource de la capture d'écran au format, ou null si le la capture d'écran a échoué.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Permet de prendre une capture d'écran de l'appareil.

Renvoie
InputStreamSource Une InputStreamSource de la capture d'écran au format png, ou null si la capture d'écran a échoué.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract 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 "namespace:key" d'un utilisateur. Null si introuvable.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Paramètres
namespace String

key String

Renvoie
String

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDésinstallerablePackageNames

public abstract  getUninstallablePackageNames ()

Récupérez les noms des packages d'application qui peuvent être désinstallés. Elle est actuellement définie comme les packages non-système et les packages système mis à jour.

Renvoie
ERROR(/Set) des noms de packages String pouvant être désinstallés actuellement installés sur le appareil.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Rechercher et renvoyer les indicateurs d'un utilisateur donné Les indicateurs sont définis dans "android.content.pm.UserInfo" dans le projet Android Open Source.

Paramètres
userId int

Renvoie
int les indicateurs associés à l'ID utilisateur fourni s'il est trouvé, -10000 dans les autres cas.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Récupère la carte de useId sur UserInfo sur l'appareil. Une erreur DeviceRuntimeException est générée si le résultat de l'appareil n'est pas conforme à vos attentes.

Renvoie
la liste des objets UserInfo.
Génère
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Renvoyez le numéro de série associé à l'ID utilisateur s'il est trouvé, et -10000 dans les autres cas.

Paramètres
userId int

Renvoie
int

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Fonction

public abstract boolean hasFeature (String feature)

Vérifier si une fonctionnalité est disponible sur un appareil

Paramètres
feature String: quel format devrait être "feature:" ou "" directement.
Renvoie
boolean "True" si la caractéristique est détectée, false dans le cas contraire.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Installer le package

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

Installer 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. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

Installer le package

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

Installer un package Android sur l'appareil

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
packageFile File: fichier APK à installer.
reinstall boolean: true si une réinstallation doit être effectuée.
grantPermissions boolean: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

installPackageForUser

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

Installer un package Android sur l'appareil d'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 installer l'application.
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

installPackageForUser

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

Installer un package Android sur l'appareil d'un utilisateur donné

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
packageFile File: 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: ID utilisateur entier pour lequel installer l'application.
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

Installation de packages

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

Installez une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire). Voir "https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser l'APK plusieurs fichiers.

Paramètres
packageFiles : fichiers APK locaux
reinstall boolean: true si une réinstallation doit être effectuée.
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

Installation de packages

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) sur l'appareil Android. Voir https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser l'APK plusieurs fichiers.

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
packageFiles : chemins d'accès aux fichiers APK distants à installer
reinstall boolean: true si une réinstallation doit être effectuée.
grantPermissions boolean: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

installPackagespour l'utilisateur

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) pour un utilisateur donné. Voir "https://developer.android.com/studio/build/configure-apk-splits" sur comment diviser un APK en plusieurs fichiers.

Paramètres
packageFiles : fichiers APK locaux
reinstall boolean: true si une réinstallation doit être effectuée.
userId int: ID utilisateur entier pour lequel installer l'application.
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

installPackagespour l'utilisateur

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) pour un utilisateur donné. Voir "https://developer.android.com/studio/build/configure-apk-splits" sur comment diviser un APK en plusieurs fichiers.

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
packageFiles : fichiers APK locaux
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: ID utilisateur entier pour lequel installer l'application.
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

installRemotePackages

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) sur l'appareil Android. Voir https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser l'APK plusieurs fichiers.

Paramètres
remoteApkPaths : chemins d'accès aux fichiers APK distants
reinstall boolean: true si une réinstallation doit être effectuée.
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

installRemotePackages

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

Installer une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire) sur l'appareil Android. Voir https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser l'APK plusieurs fichiers.

Remarque: uniquement pour les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'une autorisation d'exécution l'heure d'installation doit appeler cette fonction.

Paramètres
remoteApkPaths : chemins d'accès aux fichiers APK distants
reinstall boolean: true si une réinstallation doit être effectuée.
grantPermissions boolean: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
extraArgs String: arguments supplémentaires facultatifs à transmettre. Voir "adb shell pm -h" pour "disponibles" options.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.
UnsupportedOperationException Si l'autorisation d'exécution n'est pas compatible avec la plate-forme sur l'appareil.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Indique si l'appareil utilise le mode utilisateur système headless.

Renvoie
boolean

Génère
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Indique si l'utilisateur principal est un administrateur permanent et si celui-ci ne peut pas être supprimé ou rétrogradé non-administrateur.

Renvoie
boolean

Génère
DeviceNotAvailableException

isMultiUserCompatible

public abstract boolean isMultiUserSupported ()

Détermine si le mode multi-utilisateur est pris en charge.

Renvoie
boolean "true" si le mode multi-utilisateur est pris en charge, "false" dans le cas contraire
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstallée

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Paramètres
packageName String: le package dont nous vérifions s'il est installé.
userId String: l'ID utilisateur pour lequel nous vérifions que le package est installé. Si la valeur est null, l'utilisateur principal zéro sera utilisé.
Renvoie
boolean "True" si le package est signalé comme installé. Sinon, cette valeur est "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstallée

public abstract boolean isPackageInstalled (String packageName)

Interrogez l'appareil sur le nom de package donné pour vérifier s'il est actuellement installé ou non.

Paramètres
packageName String

Renvoie
boolean "True" si le package est signalé comme installé. Sinon, cette valeur est "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Paramètres
userId int

Renvoie
boolean "True" si l'utilisateur est en cours d'exécution, "false" dans tous les autres cas.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondaire

public abstract boolean isUserSecondary (int userId)

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

Paramètres
userId int

Renvoie
boolean La valeur est "true" si l'utilisateur est un utilisateur secondaire, et la valeur "false" dans le cas contraire.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Vérifie si l'utilisateur donné est visible.

Un élément "visible" l'utilisateur est un utilisateur qui interagit avec un "humain" utilisateur et peut donc lancer les activités de lancement (généralement sur l'écran par défaut).

Paramètres
userId int

Renvoie
boolean

Génère
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Vérifie si l'utilisateur donné est visible sur l'écran donné.

Un élément "visible" l'utilisateur est un utilisateur qui interagit avec un "humain" utilisateur et peut donc lancer des activités de lancement dans cet affichage.

Paramètres
userId int

displayId int

Renvoie
boolean

Génère
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplayCompatible

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isVisibleBackgroundUsersCompatible

public abstract boolean isVisibleBackgroundUsersSupported ()

Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Vérifiez si le Wi-Fi est activé.

Vérifie si le Wi-Fi est activé sur l'appareil. Utile pour vérifier l'état du Wi-Fi avant de tester que ne doit pas fonctionner en Wi-Fi les tests de données mobiles.

Renvoie
boolean true si le Wi-Fi est activé. false si désactivé
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

listDisplayIds

public abstract  listDisplayIds ()

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

Renvoie
Liste des écrans. La valeur par défaut renvoie toujours la valeur d'affichage par défaut 0.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Récupère la liste des écrans pouvant être utilisés pour start a user visible in the background.

Renvoie
Génère
DeviceNotAvailableException

Lister les utilisateurs

public abstract  listUsers ()

Récupère la liste des utilisateurs de l'appareil. Une erreur DeviceRuntimeException est générée en cas de sortie. de l'appareil n'est pas conforme à vos attentes.

Renvoie
la liste des ID utilisateur.
Génère
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

Rapport logBug

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Méthode d'assistance permettant de générer un rapport de bug et de le consigner pour les reporters.

Paramètres
dataName String: nom sous lequel le rapport de bug sera signalé.
listener ITestLogger: ITestLogger pour consigner le rapport de bug.
Renvoie
boolean "True" si la journalisation a réussi, sinon "false".

notifierSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Demander à l'appareil d'attendre la fin de l'opération Snapuserd

Paramètres
waitPhase SnapuserdWaitPhase

RegisterDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

Tous les IDeviceActionReceiver enregistrés seront avertis avant toute action sur l'appareil et après la fin de l'action sur l'appareil.

Paramètres
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver qui sera enregistré.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Supprimer l'administrateur de l'appareil indiqué pour l'utilisateur concerné et renvoyer true si l'opération réussit, ou false dans le 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.
Renvoie
boolean "True" en cas de réussite, sinon "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Supprimer l'utilisateur

public abstract boolean removeUser (int userId)

Supprimer un utilisateur donné de l'appareil

Paramètres
userId int: de l'utilisateur à supprimer
Renvoie
boolean "true" si nous avons réussi à supprimer l'utilisateur, "false" dans le cas contraire.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Définissez un composant d'administrateur de l'appareil en tant que propriétaire de l'appareil pour un utilisateur donné.

Paramètres
componentName String: pour que l'administrateur de l'appareil soit le propriétaire de l'appareil.
userId int: correspond à l'utilisateur dans lequel réside le propriétaire de l'appareil.
Renvoie
boolean "True" en cas de réussite, sinon "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Définir un paramètre

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

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

Paramètres
namespace String

key String

value String

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Définir un paramètre

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné. Certains paramètres ne seront disponibles 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

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

utilisateurdémarrer

public abstract boolean startUser (int userId)

Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. Si l'utilisateur est déjà exécutée en arrière-plan, cette méthode est une opération NOOP.

Paramètres
userId int: de l'utilisateur pour qu'il démarre en arrière-plan
Renvoie
boolean est défini sur "true" si l'utilisateur a démarré en arrière-plan.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

utilisateurdémarrer

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Lance un utilisateur donné en arrière-plan si celui-ci est actuellement arrêté. Si l'utilisateur est déjà exécutée en arrière-plan, cette méthode est une opération NOOP. Possibilité de fournir un indicateur supplémentaire à attendre l'opération à prendre en compte.

Paramètres
userId int: de l'utilisateur pour qu'il démarre en arrière-plan
waitFlag boolean: la commande attend que l'utilisateur soit démarré et déverrouillé.
Renvoie
boolean est défini sur "true" si l'utilisateur a démarré en arrière-plan.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui signifie que l'utilisateur pour lancer des activités sur cet affichage).

REMARQUE : Cette commande ne vérifie pas si l'utilisateur existe, si l'affichage est disponible, device supports such feature, etc.

Paramètres
userId int: de l'utilisateur pour qu'il démarre en arrière-plan
displayId int: afficher pour que l'utilisateur soit visible sur
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é et visible en arrière-plan
Génère
DeviceNotAvailableException

utilisateur stop

public abstract boolean stopUser (int userId)

Arrête un utilisateur donné. Si l'utilisateur est déjà arrêté, cette méthode est NOOP. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.

Paramètres
userId int: de l'utilisateur à arrêter.
Renvoie
boolean La valeur est définie sur "true" si l'utilisateur a bien été arrêté.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

utilisateur stop

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Arrêter un utilisateur donné. Possibilité de fournir des indicateurs supplémentaires pour attendre que l'opération prenne effet. et forcer l'arrêt de l'utilisateur. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.

Paramètres
userId int: de l'utilisateur à arrêter.
waitFlag boolean: la commande attend que l'utilisateur s'arrête.
forceFlag boolean: force l'arrêt de l'utilisateur.
Renvoie
boolean La valeur est définie sur "true" si l'utilisateur a bien été arrêté.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

contacteur

public abstract boolean switchUser (int userId)

Passez à un autre ID utilisateur avec un délai d'inactivité par défaut. switchUser(int, long).

Paramètres
userId int

Renvoie
boolean "True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

contacteur

public abstract boolean switchUser (int userId, 
                long timeout)

Basculez vers un autre ID utilisateur avec le délai d'expiration fourni comme délai. Tentative de désactivation du verrouillage du clavier une fois la modification de l'utilisateur effectuée.

Paramètres
userId int

timeout long: attendre la valeur "false" avant de renvoyer la valeur "false" pour l'utilisateur switch-user.
Renvoie
boolean "True" si le nouvel ID utilisateur correspond au fournisseur userId. Sinon, cette valeur est "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

TakeBugreport

public abstract Bugreport takeBugreport ()

Créez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer. Valeur nulle en cas de problème. Le fichier référencé dans l'objet Bugreport doit être nettoyé via Bugreport.close().

Renvoie
Bugreport

désinstaller le package

public abstract String uninstallPackage (String packageName)

Désinstaller un package Android de l'appareil

Paramètres
packageName String: package Android à désinstaller
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

désinstallerPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Paramètres
packageName String: package Android à désinstaller
userId int: ID utilisateur entier pour lequel désinstaller.
Renvoie
String une String avec un code d'erreur, ou null en cas de réussite.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupéré.

attendForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Si prévu, attendez que Snapuserd ait terminé.

Paramètres
currentPhase SnapuserdWaitPhase

Génère
DeviceNotAvailableException