ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

Réessaie les commandes de l'appareil pour une durée configurable et fournit une interface de récupération de l'appareil pour les appareils qui ne répondent pas.

Résumé

Classes imbriquées

class ITestDevice.ApexInfo

Classe struct simple pour stocker des informations sur un seul APEX

class ITestDevice.MountPointInfo

Classe struct simple permettant de stocker des informations sur un point de montage unique

Méthodes publiques

abstract boolean canSwitchToHeadlessSystemUser()

Indique si le changement vers l'utilisateur SYSTEM headless est autorisé.

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

Tente de fermer toutes 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 Wi-Fi connecté.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Se connecter à un réseau Wi-Fi

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Se connecter à un réseau Wi-Fi

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Se connecter à un réseau Wi-Fi

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

Se connecter à un réseau Wi-Fi

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

Variante de connectToWifiNetwork(String, String) qui ne se connecte que si l'appareil n'est actuellement pas connecté au réseau.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Variante de connectToWifiNetwork(String, String) qui ne se connecte que si l'appareil n'est actuellement pas connecté au réseau.

abstract int createUser(String name)

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

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

Créez un utilisateur avec un nom donné et les indicateurs fournis.

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

Créez un utilisateur avec un nom donné et les indicateurs fournis.

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Supprime le IDeviceActionReceiver enregistré.

abstract void disableKeyguard()

Tentatives de désactivation du keyguard.

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 existe sur l'appareil pour un utilisateur donné.

abstract File dumpHeap(String process, String devicePath)

Essayez de vider le tas depuis system_server.

abstract boolean enableNetworkMonitor()

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

abstract getActiveApexes()

Récupère 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. Renvoie la valeur "null" si aucun n'est trouvé.

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

Récupérez 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 depuis l'appareil.

abstract InputStreamSource getBugreportz()

Récupère un bugreportz depuis l'appareil.

abstract DeviceFoldableState getCurrentFoldableState()

Renvoie l'état de pliage actuel de l'appareil ou la valeur "null" en cas de problème.

abstract int getCurrentUser()

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

abstract getFoldableStates()

Renvoie la liste des états de pliage de l'appareil.

abstract getInstalledPackageNames()

Récupère les noms de 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 la valeur "null" si ce n'est pas pris en charge.

abstract Integer getMainUserId()

Renvoie l'ID utilisateur principal.

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément.

abstract int getMaxNumberOfUsersSupported()

Obtenez le nombre maximal d'utilisateurs acceptés.

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

Cette méthode est obsolète. getPrimaryUser a été abandonné dans le service UserManager. Utilisez ERROR(/android.os.UserManager#getMainUserId()) pour obtenir le premier utilisateur complet ou 0 pour le système. Notez que pour les systèmes sans interface graphique, il ne s'agit pas d'un utilisateur complet.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(long displayId)

Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil.

abstract InputStreamSource getScreenshot(String format)

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

abstract InputStreamSource getScreenshot()

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

abstract getUninstallablePackageNames()

Récupère les noms de package des applications qui peuvent être désinstallées.

abstract int getUserFlags(int userId)

Recherchez et renvoyez les indicateurs d'un utilisateur donné.

abstract getUserInfos()

Récupère le mappage d'useId vers UserInfo sur l'appareil.

abstract int getUserSerialNumber(int userId)

Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, ou -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, int userId, String... extraArgs)

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

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 boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

Installe les APK avec le mode incrémentiel.

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

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

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

Installez une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires) qui se trouvent sur l'appareil Android.

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

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

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

Installe une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires) pour un utilisateur donné.

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

Installez une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires) qui se trouvent sur l'appareil Android.

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

Installez une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires) qui se trouvent 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 ne peut pas être supprimé ni rétrogradé au statut de non-administrateur.

abstract boolean isMultiUserSupported()

Détermine si plusieurs utilisateurs sont acceptés.

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

Interrogez l'appareil pour un nom de package donné afin de 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 en fonction de 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 visible des utilisateurs en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

Testez si le Wi-Fi est activé.

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Obtient 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 sur l'appareil.

abstract boolean logBugreport(String dataName, ITestLogger listener)

Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer pour les reporters.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Indiquez à l'appareil d'attendre la fin de snapuserd.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

abstract boolean removeAdmin(String componentName, int userId)

Supprime l'administrateur de l'appareil donné pour l'utilisateur donné et renvoie true en cas de succès, false sinon.

abstract void removeOwners()

Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.

abstract boolean removeUser(int userId)

Supprimez un utilisateur donné de l'appareil.

abstract boolean setDeviceOwner(String componentName, int userId)

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

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 sur l'écran donné (c'est-à-dire en permettant à l'utilisateur de lancer des activités sur cet écran).

abstract boolean stopUser(int userId)

Arrête un utilisateur donné.

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

Arrêtez un utilisateur donné.

abstract boolean switchUser(int userId)

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

abstract boolean switchUser(int userId, long timeout)

Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite.

abstract Bugreport takeBugreport()

Prenez un rapport de bug et renvoyez-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é.

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Si cela est prévu, attendez que snapuserd se termine.

Méthodes publiques

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Indique si le changement vers l'utilisateur SYSTEM headless est autorisé.

Renvoie
boolean

Génère
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Renvoie
boolean true si l'appareil dispose d'une connexion réseau opérationnelle, false sinon.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tente de fermer toutes les boîtes de dialogue d'erreur actuellement affichées sur 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 été effacées. Sinon, false.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Efface le dernier réseau Wi-Fi connecté. Cette méthode doit être appelée au début d'une nouvelle invocation pour éviter de se connecter au réseau Wi-Fi utilisé lors du test précédent après le redémarrage de l'appareil.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Se connecter à un réseau Wi-Fi

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

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecter à un réseau Wi-Fi

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

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecter à un réseau Wi-Fi

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

Paramètres
wifiSsid String : SSID Wi-Fi auquel se connecter
wifiPsk String : phrase secrète PSK ou valeur nulle si non chiffrée
Renvoie
boolean true si la connexion au réseau Wi-Fi a été établie. false sinon
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

connectToWifiNetwork

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

Se connecter à un réseau Wi-Fi

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

Paramètres
wifiSsid String : SSID Wi-Fi auquel se connecter
wifiPsk String : phrase secrète PSK ou valeur nulle si non chiffrée
scanSsid boolean : indique s'il faut rechercher le SSID masqué pour ce réseau.
Renvoie
boolean true si la connexion au réseau Wi-Fi a été établie. false sinon
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

connectToWifiNetworkIfNeeded

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

Variante de connectToWifiNetwork(String, String) qui ne se connecte que si l'appareil n'est actuellement pas connecté au réseau.

Paramètres
scanSsid boolean : indique si le SSID masqué doit être recherché pour ce réseau.
Renvoie
boolean true si la connexion au réseau Wi-Fi a été établie. 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 ne se connecte que si l'appareil n'est actuellement pas connecté au réseau.

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

createUser

public abstract int createUser (String name)

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

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

createUser

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

Créez un utilisateur avec un nom donné et les indicateurs fournis.

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

createUser

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

Créez un utilisateur avec un nom donné et les indicateurs fournis.

Paramètres
name String : de l'utilisateur à créer sur l'appareil
guest boolean : activer le flag utilisateur "--guest" lors de la création
ephemeral boolean : activez le flag utilisateur --ephemeral lors de la création.
forTesting boolean : activez le flag de test "--for-testing" lors de la création.
Renvoie
int ID de l'utilisateur créé
Génère
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 de 0.

Paramètres
name String : de l'utilisateur à créer sur l'appareil
Renvoie
int Entier pour l'ID utilisateur créé ou -1 en cas d'erreur.
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 à supprimer.

disableKeyguard

public abstract void disableKeyguard ()

Tentatives de désactivation du keyguard.

Attendez d'abord que la distribution d'entrée soit prête. Cela se produit à peu près au même moment où l'appareil signale BOOT_COMPLETE, apparemment de manière asynchrone, car l'implémentation actuelle du framework présente parfois une condition de course. La commande est ensuite envoyée pour fermer le keyguard (fonctionne uniquement sur les keyguards non sécurisés).

Génère
DeviceNotAvailableException

disableNetworkMonitor

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

disconnectFromWifi

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 déconnexion du réseau Wi-Fi a réussi. false if disconnect failed.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Paramètres
deviceFilePath String : chemin d'accès absolu du fichier à vérifier sur l'appareil
userId int : ID utilisateur pour lequel vérifier l'existence du fichier
Renvoie
boolean true si le fichier existe, false sinon.
Génère
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 depuis system_server. Il incombe à l'appelant de nettoyer le fichier dumpé.

Paramètres
process String : nom du processus de l'appareil sur lequel effectuer dumpheap.
devicePath String : chemin d'accès sur l'appareil où placer le fichier de vidage. Il doit s'agir d'un emplacement pour lequel les autorisations le permettent.
Renvoie
File le ERROR(/File) contenant le rapport. Null si une erreur s'est produite.
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 est 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ée.

getActiveApexes

public abstract  getActiveApexes ()

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

Renvoie
ERROR(/Set) sur ApexInfo actuellement activé sur l'appareil
Génère
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'une des valeurs suivantes : {"system", "secure", "global"}
Renvoie
Carte des paires clé/valeur. Valeur nulle si l'espace de noms n'est pas pris en charge.
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. Renvoie la valeur "null" si aucun n'est trouvé.

Paramètres
userId int

Renvoie
String

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

getAndroidIds

public abstract  getAndroidIds ()

Créez une carte des ID Android trouvés correspondant aux ID utilisateur. Cette fonction ne garantit pas que chaque ID utilisateur trouvera un ID Android associé. Par conséquent, certains ID utilisateur peuvent correspondre à la valeur nulle.

Renvoie
Carte des ID Android correspondant aux ID utilisateur.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Récupérez 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érer les informations des packages installés sur l'appareil.

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

getBugreport

public abstract InputStreamSource getBugreport ()

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

L'implémentation de cette fonctionnalité est garantie de continuer à fonctionner sur un appareil sans carte SD (ou lorsque la carte SD n'est pas encore montée).

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

Récupère un bugreportz depuis l'appareil. Le rapport de bug au format ZIP contient le rapport de bug principal et d'autres fichiers journaux utiles pour le débogage.

Uniquement compatible avec "adb version" > 1.0.36

Renvoie
InputStreamSource InputStreamSource du fichier ZIP contenant les bugreportz. Renvoie la valeur "null" en cas d'échec.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état de pliage actuel de l'appareil 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'ID de l'utilisateur actuellement en cours d'exécution. 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 de pliage de l'appareil. Vous pouvez l'obtenir avec la commande "cmd device_state print-states".

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Récupère les noms de packages d'application présents sur l'appareil.

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

getIpAddress

public abstract String getIpAddress ()

Obtient l'adresse IP de l'appareil.

Renvoie
String l'adresse IP de l'appareil ou null si l'appareil n'a pas d'adresse IP
Génère
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 la valeur "null" si ce n'est pas pris en charge.

Renvoie
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.
Génère
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'ID utilisateur principal.

Renvoie
Integer userId de l'utilisateur principal, le cas échéant, ou null si aucun utilisateur principal n'est défini.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si le résultat de l'appareil n'est pas celui attendu.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément. La valeur par défaut est 0.

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Obtenez le nombre maximal d'utilisateurs acceptés. La valeur par défaut est 0.

Renvoie
int 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 lié à l'appareil testé.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Cette méthode est obsolète.
getPrimaryUser a été abandonné dans le service UserManager. Utilisez ERROR(/android.os.UserManager#getMainUserId()) pour obtenir le premier utilisateur complet ou 0 pour le système. Notez que pour un système sans interface graphique, il ne s'agit pas d'un utilisateur complet.

Renvoie l'ID utilisateur principal.

Renvoie
Integer ID utilisateur de l'utilisateur principal, le cas échéant. La valeur est "null" si aucun utilisateur principal n'est défini.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si le résultat de l'appareil n'est pas celui attendu.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Prend une capture d'écran de l'appareil. Nous vous recommandons d'utiliser getScreenshot(String) avec l'encodage JPEG pour une taille plus petite.

Paramètres
format String : PNG, JPEG
rescale boolean : indique si la capture d'écran doit être redimensionnée pour réduire la taille de l'image résultante.
Renvoie
InputStreamSource InputStreamSource de la capture d'écran au format null si la capture d'écran n'a pas réussi.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil. Le format est PNG.

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

Paramètres
displayId long : ID de l'écran à partir duquel effectuer la capture d'écran.
Renvoie
InputStreamSource InputStreamSource de la capture d'écran au format null si la capture d'écran n'a pas réussi.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

Renvoie
InputStreamSource 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:clé 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 du système.

Paramètres
namespace String

key String

Renvoie
String

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Récupère les noms de package des applications qui peuvent être désinstallées. Il est actuellement défini comme des packages non système et des packages système mis à jour.

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

getUserFlags

public abstract int getUserFlags (int userId)

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

Paramètres
userId int

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

getUserInfos

public abstract  getUserInfos ()

Récupère le mappage d'useId vers UserInfo sur l'appareil. Génère DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.

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

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

Paramètres
userId int

Renvoie
int

Génère
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 : le format doit être "feature:" ou directement.
Renvoie
boolean "True" si la fonctionnalité est trouvée, "false" dans le cas contraire.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

Installez un package Android sur l'appareil.

Paramètres
packageFile File : fichier APK à installer
reinstall boolean : true si une réinstallation doit être effectuée.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

installPackage

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 d'autorisations d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
packageFile File : fichier APK à installer
reinstall boolean : true si une réinstallation doit être effectuée.
grantPermissions boolean : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installPackageForUser

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 : fichier APK à installer
reinstall boolean : true si une réinstallation doit être effectuée.
userId int : ID utilisateur entier pour lequel installer.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

installPackageForUser

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 d'autorisations d'exécution au moment de l'installation doivent appeler cette fonction.

Paramètres
packageFile File : fichier APK à installer
reinstall boolean : true si une réinstallation doit être effectuée.
grantPermissions boolean : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
userId int : ID utilisateur entier pour lequel installer.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installPackageWithIncrementalMode

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Installe les APK avec le mode incrémentiel.

Paramètres
apkFiles File : fichiers APK à installer.
extraArgs String

userId String

Renvoie
boolean

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

installPackages

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

Installez une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires). Consultez "https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser un fichier APK en 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. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installPackages

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

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

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'autorisations d'exécution au moment de l'installation doivent 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 : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installPackagesForUser

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

Installe une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires) pour un utilisateur donné. Consultez "https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser un fichier 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.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installPackagesForUser

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

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

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

Paramètres
packageFiles  : fichiers APK locaux
reinstall boolean : true si une réinstallation doit être effectuée.
grantPermissions boolean : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
userId int : ID utilisateur entier pour lequel installer.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installRemotePackages

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

Installez une application Android composée de plusieurs fichiers APK (un fichier principal et des packages divisés supplémentaires) qui se trouvent sur l'appareil Android. Consultez "https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser un fichier APK en 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. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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.

installRemotePackages

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

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

Remarque : Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi d'autorisations d'exécution au moment de l'installation doivent 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 : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
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 système headless.

Renvoie
boolean

Génère
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Détermine si plusieurs utilisateurs sont acceptés.

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Paramètres
packageName String

Renvoie
boolean Valeur "true" si le package est signalé comme installé. Sinon renvoie "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 court, "false" dans tous les autres cas.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Indique si l'utilisateur spécifié est un utilisateur secondaire en fonction de ses indicateurs.

Paramètres
userId int

Renvoie
boolean "true" si l'utilisateur est secondaire, "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 utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et qui peut donc lancer des 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 dans l'affichage donné.

Un utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et qui peut donc lancer des activités sur cet écran.

Paramètres
userId int

displayId int

Renvoie
boolean

Génère
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil autorise le démarrage visible des utilisateurs en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

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

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Testez si le Wi-Fi est activé.

Vérifie si le Wi-Fi est activé sur l'appareil. Utile pour affirmer l'état du Wi-Fi avant les tests qui ne doivent pas être exécutés avec le Wi-Fi, par exemple les tests de données mobiles.

Renvoie
boolean true si le Wi-Fi est activé. false si la fonctionnalité est désactivée
Génère
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 ID d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Renvoie
Génère
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Récupère la liste des utilisateurs sur l'appareil. Génère DeviceRuntimeException si la sortie de l'appareil n'est pas celle attendue.

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer pour les reporters.

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Indiquez à l'appareil d'attendre la fin de snapuserd.

Paramètres
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Enregistre un IDeviceActionReceiver pour cet appareil.

Tous les IDeviceActionReceiver enregistrés recevront une notification avant le début et après la fin d'une action sur un appareil.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Supprime l'administrateur de l'appareil donné pour l'utilisateur donné et renvoie true en cas de succès, false sinon.

Paramètres
componentName String : administrateur de l'appareil à supprimer.
userId int : de l'utilisateur auquel appartient l'administrateur de l'appareil.
Renvoie
boolean "True" si l'opération a réussi, "false" dans le cas contraire.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.

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

removeUser

public abstract boolean removeUser (int userId)

Supprimez un utilisateur donné de l'appareil.

Paramètres
userId int : de l'utilisateur à supprimer
Renvoie
boolean "true" si l'utilisateur a bien été supprimé, "false" dans le cas contraire.
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 comme propriétaire de l'appareil pour un utilisateur donné.

Paramètres
componentName String : de l'administrateur de l'appareil au propriétaire de l'appareil.
userId int : de l'utilisateur avec lequel le propriétaire de l'appareil vit.
Renvoie
boolean "True" si l'opération a réussi, "false" dans le cas contraire.
Génère
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

Génère
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

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

startUser

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

Paramètres
userId int : de l'utilisateur à démarrer en arrière-plan
Renvoie
boolean "true" si l'utilisateur a bien été démarré en arrière-plan.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

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 une NOOP. Il est possible 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 : la commande attendra que l'utilisateur soit démarré et déverrouillé.
Renvoie
boolean "true" si l'utilisateur a bien été 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é (c'est-à-dire en permettant à l'utilisateur de lancer des activités sur cet écran).

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

Paramètres
userId int : de l'utilisateur à démarrer en arrière-plan
displayId int : écran sur lequel l'utilisateur est visible au début
waitFlag boolean : la commande attendra que l'utilisateur soit démarré et déverrouillé.
Renvoie
boolean true si l'utilisateur a bien démarré et est visible en arrière-plan.
Génère
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

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

stopUser

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

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

Paramètres
userId int : de l'utilisateur à arrêter.
waitFlag boolean : la commande attendra jusqu'à ce que l'utilisateur soit arrêté.
forceFlag boolean : arrête de force l'utilisateur.
Renvoie
boolean "true" si l'utilisateur a bien été arrêté.
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Passez à un autre userId 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 d'ID utilisateur. Sinon renvoie "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite. Tentative de désactivation du keyguard après le changement d'utilisateur réussi.

Paramètres
userId int

timeout long : délai d'attente avant de renvoyer la valeur "false" en cas d'échec du changement d'utilisateur.
Renvoie
boolean "True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Sinon renvoie "false".
Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Prenez un rapport de bug et renvoyez-le dans un objet Bugreport pour le gérer. Renvoie la valeur null en cas de problème. Les fichiers référencés dans l'objet Bugreport doivent être nettoyés via Bugreport.close().

Renvoie
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

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

uninstallPackageForUser

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 : ID utilisateur entier pour lequel désinstaller l'application.
Renvoie
String String avec un code d'erreur ou null en cas de succès.
Génère
DeviceNotAvailableException si la connexion avec l'appareil est perdue et ne peut pas être récupérée.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Si cela est prévu, attendez que snapuserd se termine.

Paramètres
currentPhase SnapuserdWaitPhase

Génère
DeviceNotAvailableException