ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

Réessaye les commandes de périphérique pour un montant configurable et fournit une interface de récupération de périphérique pour les périphériques 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 tête.

abstract boolean checkConnectivity ()

Vérifiez que l'appareil dispose d'une connectivité réseau.

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

Efface le dernier réseau wifi connecté.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Se connecte à un réseau wifi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Se connecte à un réseau wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Se connecte à un réseau wifi.

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

Se connecte à un réseau wifi.

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

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

abstract int createUser (String name)

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

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

Créer un utilisateur avec un nom donné et les drapeaux fournis

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

Créer un utilisateur avec un nom donné et les drapeaux fournis

abstract int createUserNoThrow (String name)

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

abstract void disableKeyguard ()

Tente de désactiver le protège-clavier.

abstract boolean disableNetworkMonitor ()

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

abstract boolean disconnectFromWifi ()

Se déconnecte d'un réseau wifi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

Essayez de vider le tas du serveur_système.

abstract boolean enableNetworkMonitor ()

Permet 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'ID Android associé à un ID utilisateur, nul s'il n'est pas trouvé.

abstract getAndroidIds ()

Créez une carte des identifiants Android trouvés correspondant aux identifiants utilisateur.

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

Récupérer les informations des 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 pliable actuel de l'appareil ou null si des problèmes sont survenus.

abstract int getCurrentUser ()

Renvoie l'identifiant de l'utilisateur actuel.

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

Obtient l'adresse IP de l'appareil.

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

Renvoie l'identifiant de l'utilisateur principal.

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximum d’utilisateurs fonctionnant simultanément pris en charge.

abstract int getMaxNumberOfUsersSupported ()

Obtenez le nombre maximum 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 ()

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

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

Renvoie la valeur du paramètre demandé.

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 drapeaux d'un utilisateur donné.

abstract getUserInfos ()

Obtient la carte de useId vers UserInfo sur l’appareil.

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

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

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

Installez un package Android sur l'appareil.

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

Installez un package Android sur l'appareil.

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

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

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

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

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

Installez une application Android composée de plusieurs fichiers APK (un package principal et des packages supplémentaires).

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

Installez une application Android composée de plusieurs fichiers APK (un package principal et un package supplémentaire) qui se trouvent sur l'appareil Android.

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

Installez une application Android composée de plusieurs fichiers APK (un package principal et des packages supplémentaires) pour un utilisateur donné.

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

Installez une application Android composée de plusieurs fichiers APK (un package principal et des packages supplémentaires) pour un utilisateur donné.

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

Installez une application Android composée de plusieurs fichiers APK (un package principal et un package supplémentaire) qui se trouvent sur l'appareil Android.

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

Installez une application Android composée de plusieurs fichiers APK (un package principal et un package supplémentaire) qui se trouvent sur l'appareil Android.

abstract boolean isHeadlessSystemUserMode ()

Indique si l'appareil utilise le mode utilisateur du système sans tête.

abstract boolean isMainUserPermanentAdmin ()

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

abstract boolean isMultiUserSupported ()

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

abstract boolean isPackageInstalled (String packageName)

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

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

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

Renvoie 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 dans l'affichage donné.

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

abstract boolean isVisibleBackgroundUsersSupported ()

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

abstract boolean isWifiEnabled ()

Testez si le wifi est activé.

abstract listDisplayIds ()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtient la liste des affichages pouvant être utilisés pour start a user visible in the background .

abstract listUsers ()

Obtient la liste des utilisateurs sur l'appareil.

abstract boolean logBugreport (String dataName, ITestLogger listener)

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

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

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

abstract void removeOwners ()

Supprimez tous les propriétaires de profils d’appareil existants en faisant de votre mieux.

abstract boolean removeUser (int userId)

Supprimer un utilisateur donné de l'appareil.

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

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

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

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

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

abstract boolean startUser (int userId)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.

abstract boolean startUser (int userId, boolean waitFlag)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.

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

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

Arrêtez un utilisateur donné.

abstract boolean stopUser (int userId)

Arrête un utilisateur donné.

abstract boolean switchUser (int userId)

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

abstract boolean switchUser (int userId, long timeout)

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

abstract Bugreport takeBugreport ()

Prenez un rapport de bug et retournez-le dans un objet Bugreport pour le gérer.

abstract String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

abstract String uninstallPackageForUser (String packageName, int userId)

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

Méthodes publiques

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Indique s'il est autorisé à passer à l'utilisateur SYSTEM sans tête.

Retour
boolean

Jetés
DeviceNotAvailableException

checkConnectivité

public abstract boolean checkConnectivity ()

Vérifiez que l'appareil dispose d'une connectivité réseau.

Retour
boolean true si l'appareil dispose d'une connexion réseau fonctionnelle, false dans le cas contraire.

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Retour
boolean true si aucune boîte de dialogue n’était présente ou si les boîtes de dialogue ont été effacées avec succès. false sinon.

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

clearLastConnectedWifiRéseau

public abstract void clearLastConnectedWifiNetwork ()

Efface le dernier réseau wifi connecté. Celui-ci doit être appelé lors du démarrage d'une nouvelle invocation pour éviter de se connecter au réseau wifi utilisé lors du test précédent après le redémarrage de l'appareil.

se connecterAuRéseauWifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecte à un réseau wifi.

Active le wifi et bloque jusqu'à ce qu'une connexion réussie soit établie avec l'un des réseaux wifi indiqués dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance tentera de restaurer la connexion après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.

Paramètres
wifiSsidToPsk : Une carte des SSID wifi aux mots de passe.

scanSsid boolean : s'il faut rechercher les SSID cachés pour ce réseau.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

se connecterAuRéseauWifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecte à un réseau wifi.

Active le wifi et bloque jusqu'à ce qu'une connexion réussie soit établie avec l'un des réseaux wifi indiqués dans la carte wifiSsidToPsk. Une fois la connexion établie, l'instance tentera de restaurer la connexion après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.

Paramètres
wifiSsidToPsk : Une carte des SSID wifi aux mots de passe.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

se connecterAuRéseauWifi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecte à un réseau wifi.

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

Paramètres
wifiSsid String : le SSID wifi auquel se connecter

wifiPsk String : phrase secrète PSK ou null si non chiffrée

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

se connecterAuRéseauWifi

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

Se connecte à un réseau wifi.

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

Paramètres
wifiSsid String : le SSID wifi auquel se connecter

wifiPsk String : phrase secrète PSK ou null si non chiffrée

scanSsid boolean : s'il faut rechercher le SSID caché pour ce réseau.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

se connecter au réseau Wifi si nécessaire

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

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

Paramètres
scanSsid boolean : s'il faut rechercher le SSID caché pour ce réseau

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

se connecter au réseau Wifi si nécessaire

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Une variante de connectToWifiNetwork(String, String) qui se connecte uniquement si l'appareil ne dispose actuellement pas de connectivité réseau.

Retour
boolean true si la connexion au réseau wifi est réussie. false sinon

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Créer un utilisateur

public abstract int createUser (String name)

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

Paramètres
name String : de l'utilisateur à créer sur l'appareil

Retour
int l'entier pour l'identifiant utilisateur créé

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Créer un utilisateur

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

Créer un utilisateur avec un nom donné et les drapeaux fournis

Paramètres
name String : de l'utilisateur à créer sur l'appareil

guest boolean : active le drapeau utilisateur --guest lors de la création

ephemeral boolean : active le drapeau utilisateur --ephemeral lors de la création

forTesting boolean : active l'indicateur de test --for-testing lors de la création

Retour
int identifiant de l'utilisateur créé

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Créer un utilisateur

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

Créer un utilisateur avec un nom donné et les drapeaux fournis

Paramètres
name String : de l'utilisateur à créer sur l'appareil

guest boolean : active le drapeau utilisateur --guest lors de la création

ephemeral boolean : active le drapeau utilisateur --ephemeral lors de la création

Retour
int identifiant de l'utilisateur créé

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Paramètres
name String : de l'utilisateur à créer sur l'appareil

Retour
int l'entier pour l'ID utilisateur créé ou -1 pour l'erreur.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

désenregistrerDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

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

désactiverKeyguard

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

Jetés
DeviceNotAvailableException

désactiverNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

Retour
boolean true si la surveillance est désactivée avec succès. false s'il a échoué.

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

déconnecter du Wifi

public abstract boolean disconnectFromWifi ()

Se déconnecte d'un réseau wifi.

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

Retour
boolean true si la déconnexion du réseau wifi est réussie. false si la déconnexion a échoué.

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

Est-ce queFichierExiste

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Paramètres
deviceFilePath String : le chemin absolu du fichier sur l'appareil à vérifier

userId int : l'identifiant utilisateur par rapport auquel vérifier l'existence du fichier

Retour
boolean true si le fichier existe, false sinon.

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Essayez de vider le tas du serveur_système. Il est de la responsabilité de l'appelant de nettoyer le fichier sauvegardé.

Paramètres
process String : le nom du processus de périphérique sur lequel effectuer le dumpheap.

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

activerNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

Retour
boolean true si la surveillance est activée avec succès. false s'il a échoué.

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getActiveApex

public abstract  getActiveApexes ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Renvoie les paires clé-valeur de l’espace de noms demandé.

Paramètres
namespace String : doit être l'un des {"system", "secure", "global"}

Retour
la carte des paires clé-valeur. Null si l’espace de noms n’est pas pris en charge.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirAndroidId

public abstract String getAndroidId (int userId)

Recherchez et renvoyez l'ID Android associé à un ID utilisateur, nul s'il n'est pas trouvé.

Paramètres
userId int

Retour
String

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenir des identifiants Android

public abstract  getAndroidIds ()

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

Retour
Carte des identifiants Android trouvés correspondant aux identifiants utilisateur.

Jetés
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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

Retour
ERROR(/List) des PackageInfo installés sur l'appareil.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenir un rapport de bug

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

Retour
InputStreamSource Un InputStreamSource qui produira le contenu du rapport de bug à la demande. En cas d'échec, le InputStreamSource produira un ERROR(/InputStream) vide.

obtenirbugreportz

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 pris en charge pour la « version adb » > 1.0.36

Retour
InputStreamSource un InputStreamSource du fichier zip contenant le bugreportz, renvoie null en cas d'échec.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état pliable actuel de l'appareil ou null si des problèmes sont survenus.

Retour
DeviceFoldableState

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Retour
int

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Renvoie la liste des états pliables sur l'appareil. Peut être obtenu avec "cmd device_state print-states".

Retour

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirIpAddress

public abstract String getIpAddress ()

Obtient l'adresse IP de l'appareil.

Retour
String l'adresse IP de l'appareil, ou null si l'appareil n'a pas d'adresse IP

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

getMainUserId

public abstract Integer getMainUserId ()

Renvoie l'identifiant de l'utilisateur principal.

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

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

Retour
ERROR(/Set) des modules principaux String actuellement installés sur l’appareil.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Retour
int un nombre entier indiquant le nombre d'utilisateurs fonctionnant simultanément

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

Retour
int un entier indiquant le nombre d'utilisateurs pris en charge

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirOptions

public abstract TestDeviceOptions getOptions ()

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

Retour
TestDeviceOptions TestDeviceOptions liées à l’appareil testé.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Renvoie l'identifiant de l'utilisateur principal.

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.
DeviceNotAvailableException

obtenirCapture d'écran

public abstract InputStreamSource getScreenshot ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirCapture d'écran

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

rescale boolean : si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirCapture d'écran

public abstract InputStreamSource getScreenshot (String format)

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

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obtenirCapture d'écran

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

Jetés
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 du système.

Paramètres
namespace String

key String

Retour
String

Jetés
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

Retour
String la valeur associée au namespace:key d'un utilisateur. Nul s’il n’est pas trouvé.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

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

Paramètres
userId int

Retour
int les indicateurs associés à l'ID utilisateur fourni s'ils sont trouvés, -10 000 dans les autres cas.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Obtient la carte de useId vers UserInfo sur l’appareil. Lèvera DeviceRuntimeException si la sortie du périphérique n'est pas celle attendue.

Retour
la liste des objets UserInfo.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Paramètres
userId int

Retour
int

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Paramètres
feature String : quel format doit être "feature : " ou " " directement.

Retour
boolean Vrai si la fonctionnalité est trouvée, faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installer le paquet

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

Installez un package Android sur l'appareil.

Paramètres
packageFile File : le fichier apk à installer

reinstall boolean : true si une réinstallation doit être effectuée

extraArgs String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

installer le paquet

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

Installez un package Android sur l'appareil.

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
packageFile File : le fichier apk à installer

reinstall boolean : true si une réinstallation doit être effectuée

grantPermissions boolean : si toutes les autorisations d'exécution doivent être accordées au moment de l'installation

extraArgs String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerPackageForUser

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

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

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
packageFile File : le fichier apk à installer

reinstall boolean : true si une réinstallation doit être effectuée

grantPermissions boolean : si toutes les autorisations d'exécution doivent être accordées au moment de l'installation

userId int : l'identifiant utilisateur entier pour lequel installer.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerPackageForUser

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

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

Paramètres
packageFile File : le fichier apk à installer

reinstall boolean : true si une réinstallation doit être effectuée

userId int : l'identifiant utilisateur entier pour lequel installer.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

installerPackages

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

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

Paramètres
packageFiles : les 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 les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerPackages

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

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

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
packageFiles : les chemins des 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 les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerPackagesForUser

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

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

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
packageFiles : les 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 : l'identifiant utilisateur entier pour lequel installer.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerPackagesForUser

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

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

Paramètres
packageFiles : les fichiers apk locaux

reinstall boolean : true si une réinstallation doit être effectuée

userId int : l'identifiant utilisateur entier pour lequel installer.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Voir 'adb shell pm -h' pour les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerRemotePackages

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

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

Paramètres
remoteApkPaths : les chemins des 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 les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

installerRemotePackages

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

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

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi de l'autorisation d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
remoteApkPaths : les chemins des 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 les options disponibles.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.
UnsupportedOperationException si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Indique si l'appareil utilise le mode utilisateur du système sans tête.

Retour
boolean

Jetés
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Retour
boolean

Jetés
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

Retour
boolean vrai si plusieurs utilisateurs sont pris en charge, faux sinon

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

estPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Paramètres
packageName String

Retour
boolean Vrai si le package est signalé comme installé. Faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

estPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

userId String : l'identifiant de l'utilisateur pour lequel nous vérifions que le package est installé. Si nul, l’utilisateur principal zéro sera utilisé.

Retour
boolean Vrai si le package est signalé comme installé. Faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

estUserRunning

public abstract boolean isUserRunning (int userId)

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

Paramètres
userId int

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Paramètres
userId int

Retour
boolean vrai si l'utilisateur est secondaire, faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

estUtilisateurVisible

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

Paramètres
userId int

Retour
boolean

Jetés
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

Un utilisateur « visible » est un utilisateur qui interagit avec l'utilisateur « humain » et est donc capable de lancer des activités de lancement sur cet affichage.

Paramètres
userId int

displayId int

Retour
boolean

Jetés
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

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

Retour
boolean

Jetés
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

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

Retour
boolean

Jetés
DeviceNotAvailableException

estWifiEnabled

public abstract boolean isWifiEnabled ()

Testez si le wifi est activé.

Vérifie si le wifi est activé sur l'appareil. Utile pour affirmer l'état du wifi avant des tests qui ne devraient pas fonctionner avec le wifi, par exemple les tests de données mobiles.

Retour
boolean true si le wifi est activé. false si désactivé

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

listDisplayIds

public abstract  listDisplayIds ()

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtient la liste des affichages pouvant être utilisés pour start a user visible in the background .

Retour

Jetés
DeviceNotAvailableException

listeUtilisateurs

public abstract  listUsers ()

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

Retour
la liste des identifiants des utilisateurs.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logbugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Paramètres
dataName String : nom sous lequel le bugreport sera rapporté.

listener ITestLogger : un ITestLogger pour enregistrer le rapport de bug.

Retour
boolean Vrai si la journalisation a réussi, faux dans le cas contraire.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

Tous les IDeviceActionReceiver enregistrés seront notifiés avant le début d’une action de périphérique et après la fin de l’action de périphérique.

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

supprimerAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Supprimez l'administrateur de l'appareil donné chez un utilisateur donné et renvoyez true en cas de succès, false sinon.

Paramètres
componentName String : de l'administrateur de l'appareil à supprimer.

userId int : l'utilisateur dans lequel réside l'administrateur de l'appareil.

Retour
boolean Vrai si l’opération réussit, faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Supprimer les propriétaires

public abstract void removeOwners ()

Supprimez tous les propriétaires de profils d’appareil existants en faisant de votre mieux.

Jetés
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

Retour
boolean vrai si nous avons réussi à supprimer l’utilisateur, faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Paramètres
componentName String : l'administrateur de l'appareil doit être propriétaire de l'appareil.

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

Retour
boolean Vrai si l’opération réussit, faux sinon.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract 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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract 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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

démarrerUtilisateur

public abstract boolean startUser (int userId)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est un NOOP.

Paramètres
userId int : de l'utilisateur à démarrer en arrière-plan

Retour
boolean true si l'utilisateur a été démarré avec succès en arrière-plan.

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

démarrerUtilisateur

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est un NOOP. Possibilité de fournir un indicateur supplémentaire pour attendre que l'opération prenne effet.

Paramètres
userId int : de l'utilisateur à démarrer en arrière-plan

waitFlag boolean : fera attendre la commande jusqu'à ce que l'utilisateur soit démarré et déverrouillé.

Retour
boolean true si l'utilisateur a été démarré avec succès en arrière-plan.

Jetés
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 dans l'affichage donné (c'est-à-dire, permettant à l'utilisateur de lancer des activités dans cet affichage).

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

Paramètres
userId int : de l'utilisateur à démarrer en arrière-plan

displayId int : affichage pour démarrer l'utilisateur visible sur

waitFlag boolean : fera attendre la commande jusqu'à ce que l'utilisateur soit démarré et déverrouillé.

Retour
boolean true si l'utilisateur a été démarré avec succès, visible en arrière-plan.

Jetés
DeviceNotAvailableException

arrêter l'utilisateur

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

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

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

waitFlag boolean : fera attendre la commande jusqu'à ce que l'utilisateur soit arrêté.

forceFlag boolean : forcera l'arrêt de l'utilisateur.

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

arrêter l'utilisateur

public abstract boolean stopUser (int userId)

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

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

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

changer d'utilisateur

public abstract boolean switchUser (int userId)

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

Paramètres
userId int

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

changer d'utilisateur

public abstract boolean switchUser (int userId, 
                long timeout)

Basculez vers un autre ID utilisateur avec le délai d'expiration fourni comme date limite. Tentative de désactivation du protège-clavier une fois le changement d'utilisateur réussi.

Paramètres
userId int

timeout long : attendre avant de renvoyer false en cas d'échec du changement d'utilisateur.

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

Jetés
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

prendre un rapport de bug

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

Retour
Bugreport

désinstallerPackage

public abstract String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

Paramètres
packageName String : le package Android à désinstaller

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

désinstallerPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Paramètres
packageName String : le package Android à désinstaller

userId int : l'identifiant utilisateur entier pour lequel désinstaller.

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

Jetés
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.