Cette page a été traduite par l'API Cloud Translation.

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Sous-classes indirectes connues

IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice

IManagedTestDevice	ITestDevice dont le cycle de vie est géré.
LocalAndroidVirtualDevice	Classe des appareils virtuels locaux exécutés sur l'hôte TradeFed.
ManagedRemoteDevice	Appareil exécuté dans une machine virtuelle que nous gérons à distance via une instance Tradefed dans la VM.
NativeDevice	Implémentation par défaut d'une `ITestDevice` pour les appareils Android non complets.
NestedRemoteDevice	Représentation de l'appareil exécuté dans une VM Cuttlefish distante.
AppareilAndroidDistant	Implémentation d'un `ITestDevice` pour un appareil Android full stack connecté via adb connect.
RemoteAndroidVirtualDevice	Élargit le comportement de `RemoteAndroidDevice` pour un appareil Android à pile complète exécuté dans Google Compute Engine (GCE).
Appareil test	Implémentation d'un `ITestDevice` pour un appareil Android full stack

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

Réessaie les commandes de l'appareil pendant 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 de struct simple permettant de stocker des informations sur un seul APEX
`class`	`ITestDevice.MountPointInfo` Une classe struct simple pour stocker des informations sur un seul point d'installation

Méthodes publiques
`abstract boolean`	`canSwitchToHeadlessSystemUser()` Indique si l'utilisateur système headless est autorisé à passer à l'utilisateur système headless.
`abstract boolean`	`checkConnectivity()` Vérifiez que l'appareil dispose d'une connexion réseau.
`abstract boolean`	`clearErrorDialogs()` Essayez de fermer les boîtes de dialogue d'erreur actuellement affichées dans l'interface utilisateur de l'appareil.
`abstract void`	`clearLastConnectedWifiNetwork()` Efface le dernier réseau Wi-Fi connecté.
`abstract boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Se connecte à un réseau Wi-Fi.
`abstract boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Se connecte à un réseau Wi-Fi.
`abstract boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Se connecte à un réseau Wi-Fi.
`abstract boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Se connecte à un réseau Wi-Fi.
`abstract boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Variante de `connectToWifiNetwork(String, String)` qui ne se connecte que si l'appareil n'est pas actuellement connecté au réseau.
`abstract boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Variante de `connectToWifiNetwork(String, String)` qui ne se connecte que si l'appareil ne dispose actuellement pas d'une connectivité 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éer un utilisateur avec un nom donné et les options fournies
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Créer un utilisateur avec un nom donné et les options fournies
`abstract int`	`createUserNoThrow(String name)` Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
`abstract void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Supprime l'`IDeviceActionReceiver` enregistrée.
`abstract void`	`disableKeyguard()` Tentatives de désactivation du clavier de protection.
`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)` Tentative de vidage de la pile à partir de system_server.
`abstract boolean`	`enableNetworkMonitor()` Active la surveillance du réseau sur l'appareil.
`abstract`	`getActiveApexes()` Récupérez les informations sur les APEX activés sur l'appareil.
`abstract`	`getAllSettings(String namespace)` Renvoie les paires clé/valeur de l'espace de noms demandé.
`abstract String`	`getAndroidId(int userId)` Recherchez et renvoyez l'android-id associé à un userId, ou "null" si aucun n'est trouvé.
`abstract`	`getAndroidIds()` Créez une carte des ID Android 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ère des informations sur les packages installés sur l'appareil.
`abstract InputStreamSource`	`getBugreport()` Récupère un rapport de bug à partir de l'appareil.
`abstract InputStreamSource`	`getBugreportz()` Récupère un bugreportz à partir de l'appareil.
`abstract DeviceFoldableState`	`getCurrentFoldableState()` Renvoie l'état actuel de l'appareil pliable ou la valeur "null" si des problèmes se sont produits.
`abstract int`	`getCurrentUser()` Renvoie l'identifiant de l'utilisateur actuel.
`abstract`	`getFoldableStates()` Renvoie la liste des états de pliage de l'appareil.
`abstract`	`getInstalledPackageNames()` Récupérez les noms des packages d'application présents sur l'appareil.
`abstract String`	`getIpAddress()` Récupère l'adresse IP de l'appareil.
`abstract KeyguardControllerState`	`getKeyguardState()` Renvoyez un objet pour obtenir l'état actuel du clavier de verrouillage ou la valeur nulle s'il n'est pas compatible.
`abstract Integer`	`getMainUserId()` Renvoie l'ID utilisateur principal.
`abstract`	`getMainlineModuleInfo()` Obtenez les informations sur les modules principaux installés sur l'appareil.
`abstract int`	`getMaxNumberOfRunningUsersSupported()` Obtenez le nombre maximal d'utilisateurs pouvant exécuter simultanément l'application.
`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()` Renvoie l'ID utilisateur principal.
`abstract InputStreamSource`	`getScreenshot(String format, boolean rescale)` Permet de prendre une capture d'écran de l'appareil.
`abstract InputStreamSource`	`getScreenshot(long displayId)` Capture une capture d'écran de l'appareil avec l'ID d'affichage donné.
`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 système.
`abstract`	`getUninstallablePackageNames()` Récupérez les noms des packages d'application qui peuvent être désinstallés.
`abstract int`	`getUserFlags(int userId)` Recherchez et renvoyez les indicateurs d'un utilisateur donné.
`abstract`	`getUserInfos()` Récupère la carte de l'identifiant d'utilisation 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é, -10000 dans les autres cas.
`abstract boolean`	`hasFeature(String feature)` Vérifier si une fonctionnalité est disponible sur un appareil
`abstract String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` 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é.
`default String`	`installPackages( packageFiles, boolean reinstall, String... extraArgs)` Installez une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire).
`default String`	`installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` Installez une application Android composée de plusieurs fichiers APK (un package principal et des packages fractionnés supplémentaires) situés sur l'appareil Android.
`default 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 fractionnés supplémentaires) pour un utilisateur donné.
`default String`	`installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installez une application Android composée de plusieurs fichiers APK (un package divisé principal et un package divisé supplémentaire) pour un utilisateur donné.
`default String`	`installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)` Installez une application Android composée de plusieurs fichiers APK (un package principal et des packages fractionnés supplémentaires) situés 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 package principal et des packages fractionnés supplémentaires) situés 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é en non-administrateur.
`abstract boolean`	`isMultiUserSupported()` Détermine si le mode multi-utilisateur est pris en charge.
`abstract boolean`	`isPackageInstalled(String packageName, String userId)` Interrogez l'appareil à la recherche d'un nom de package et d'un ID utilisateur donnés pour vérifier s'il est actuellement installé 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 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 permet aux utilisateurs d'être visibles en arrière-plan dans `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`abstract boolean`	`isVisibleBackgroundUsersSupported()` Indique si l'appareil permet aux utilisateurs d'être visibles en arrière-plan.
`abstract boolean`	`isWifiEnabled()` Vérifiez si le Wi-Fi est activé.
`abstract`	`listDisplayIds()` Collectez la liste des identifiants d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
`abstract`	`listDisplayIdsForStartingVisibleBackgroundUsers()` Récupère la liste des écrans pouvant être utilisés pour `start a user visible in the background`.
`abstract`	`listUsers()` Récupère la liste des utilisateurs 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 auprès des signalants.
`default void`	`notifySnapuserd(SnapuserdWaitPhase waitPhase)` Demander à l'appareil d'attendre la fin de l'opération Snapuserd
`abstract void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Enregistre un `IDeviceActionReceiver` pour cet appareil.
`abstract boolean`	`removeAdmin(String componentName, int userId)` Supprimez l'administrateur de l'appareil donné dans l'utilisateur donné et renvoyez `true` si la suppression aboutit, sinon `false`.
`abstract void`	`removeOwners()` Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.
`abstract boolean`	`removeUser(int userId)` Supprimer un utilisateur donné de l'appareil
`abstract boolean`	`setDeviceOwner(String componentName, int userId)` Définir 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 système.
`abstract void`	`setSetting(int userId, String namespace, String key, String value)` Ajoute une valeur de paramètre à l'espace de noms d'un utilisateur donné.
`abstract boolean`	`startUser(int userId)` 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, 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êter un utilisateur donné.
`abstract boolean`	`switchUser(int userId)` Passez à un autre userId avec un délai avant expiration par défaut.
`abstract boolean`	`switchUser(int userId, long timeout)` Passez à un autre userId avec le délai avant expiration fourni comme échéance.
`abstract Bugreport`	`takeBugreport()` Prend un bugreport et le renvoie 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 nécessaire, attendez que snapuserd ait terminé.

Méthodes publiques

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity ()

Vérifiez que l'appareil dispose d'une connexion 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établie.

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Renvoie
`boolean`	`true` si aucune boîte de dialogue n'était présente ou si les boîtes de dialogue ont été effacées. Sinon, `false`.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

ClearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Supprime le dernier réseau Wi-Fi auquel l'appareil a été connecté. Cette méthode doit être appelée lors du démarrage d'un nouvel appel 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 connecte à un réseau Wi-Fi.

Active le Wi-Fi et le 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 tente de la rétablir après chaque redémarrage jusqu'à ce que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() soit appelé.

Paramètres
`wifiSsidToPsk`	: mappage des SSID Wi-Fi et des mots de passe.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi est établie. `false` dans les autres cas

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se connecte à un réseau Wi-Fi.

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

Paramètres
`wifiSsidToPsk`	: mappage des SSID Wi-Fi avec les mots de passe.
`scanSsid`	`boolean`: indique si des SSID masqués doivent être recherchés pour ce réseau.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi est établie. `false` dans les autres cas

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et bloque jusqu'à ce qu'une connexion au réseau Wi-Fi spécifié soit établie. Une fois une 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 du réseau Wi-Fi auquel se connecter
`wifiPsk`	`String`: phrase de passe PSK ou nulle si non chiffrée

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

connectToWifiNetwork

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

Se connecte à un réseau Wi-Fi.

Active le Wi-Fi et le bloque jusqu'à ce qu'une connexion au réseau Wi-Fi spécifié soit établie. 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 du réseau Wi-Fi auquel se connecter
`wifiPsk`	`String`: phrase de passe PSK ou nulle si non chiffrée
`scanSsid`	`boolean`: rechercher le SSID masqué pour ce réseau

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être récupéré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 pas actuellement connecté au réseau.

Paramètres
`scanSsid`	`boolean`: indique si vous devez rechercher un SSID masqué pour ce réseau.

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

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

ConnectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Renvoie
`boolean`	`true` si la connexion au réseau Wi-Fi aboutit. `false` sinon

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

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éer un utilisateur avec un nom donné et les options fournies

Paramètres
`name`	`String`: de l'utilisateur à créer sur l'appareil
`guest`	`boolean`: activez l'indicateur utilisateur --guest lors de la création.
`ephemeral`	`boolean`: activez l'indicateur 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éer un utilisateur avec un nom donné et les options fournies

Paramètres
`name`	`String`: de l'utilisateur à créer sur l'appareil
`guest`	`boolean`: activez l'indicateur utilisateur --guest lors de la création.
`ephemeral`	`boolean`: activez l'indicateur utilisateur --ephemeral lors de la création.
`forTesting`	`boolean`: activez l'indicateur de test --for-testing lors de la création.

Renvoie
`int`	ID de l'utilisateur créé

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

Renvoie
`int`	Entier correspondant à 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 l'IDeviceActionReceiver enregistrée.

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

disableKeyguard

public abstract void disableKeyguard ()

Tentatives de désactivation du clavier.

Attendez d'abord que la distribution des entrées 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 occasionnellement une condition de course. La commande est ensuite envoyée pour ignorer le clavier de verrouillage (fonctionne uniquement sur les claviers 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` si la déconnexion a échoué.

Génère
`DeviceNotAvailableException`	Si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

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 absolu du fichier sur l'appareil à vérifier
`userId`	`int`: ID utilisateur à l'aide duquel vérifier l'existence du fichier

Renvoie
`boolean`	`true` si le fichier existe, `false` dans le cas contraire.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Tentative de vidage de la pile à partir de system_server. Il incombe à l'appelant de nettoyer le fichier vidé.

Paramètres
`process`	`String`: nom du processus de l'appareil sur lequel vider le tas.
`devicePath`	`String`: chemin d'accès sur l'appareil où placer le dump. Il doit s'agir d'un emplacement où les autorisations le permettent.

Renvoie
`File`	le `ERROR(/File)` contenant le rapport. Valeur nulle si un problème est survenu.

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érez les informations sur les APEX activés sur l'appareil.

Renvoie
	`ERROR(/Set)` codes `ApexInfo` actuellement activés 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 défini sur {"system", "secure", "global"}

Renvoie
	la carte des paires clé-valeur. Valeur Null si l'espace de noms n'est pas accepté.

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

getAndroidId

public abstract String getAndroidId (int userId)

Recherchez et renvoyez l'android-id associé à un userId, ou "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 correspondant aux ID utilisateur. Il n'est pas garanti que chaque ID utilisateur trouvera un ID Android associé dans cette fonction. Par conséquent, certains ID utilisateur peuvent correspondre à "null".

Renvoie
	Carte des ID Android correspondants 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érez les informations sur les packages installés sur l'appareil.

Renvoie
	`ERROR(/List)` `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 de l'appareil.

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Compatible uniquement avec la version "adb" 1.0.36 ou supérieure

Renvoie
`InputStreamSource`	un `InputStreamSource` du fichier ZIP contenant le bugreportz, renvoyez null en cas d'échec.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Renvoie l'état actuel de l'appareil pliable ou la valeur "null" si des problèmes se sont produits.

Renvoie
`DeviceFoldableState`

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

getCurrentUser

public abstract int getCurrentUser ()

Renvoie l'ID de l'utilisateur 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 l'appareil pliable. Peut être obtenu avec "cmd device_state print-states".

Renvoie

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

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

Renvoie
`String`	l'adresse IP de l'appareil ou `null` si l'appareil n'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 ()

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

Renvoie
`KeyguardControllerState`	Une `KeyguardControllerState` contenant un instantané de l'état du verrouillage du clavier et qui renvoie la valeur "Null" si la requête de protection du clavier n'est pas compatible.

Génère
`DeviceNotAvailableException`	Si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

getMainUserId

public abstract Integer getMainUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
`Integer`	L'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur "null" s'il n'y en a pas.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	si la sortie de l'appareil ne correspond pas à vos attentes.
`DeviceNotAvailableException`

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

Renvoie
	`ERROR(/Set)` des modules principaux `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 exécuter simultanément l'application. La valeur par défaut est 0.

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
`Integer`	l'ID utilisateur de l'utilisateur principal, le cas échéant, et la valeur nulle 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) à la place avec l'encodage JPEG pour une taille plus petite.

Paramètres
`format`	`String`: PNG, JPEG acceptés
`rescale`	`boolean`: si la capture d'écran doit être redimensionnée pour réduire la taille de l'image obtenue

Renvoie
`InputStreamSource`	Un `InputStreamSource` de la capture d'écran au format, ou `null` si la capture d'écran a échoué.

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Capture une capture d'écran de l'appareil avec l'ID d'affichage donné. Le format est PNG.

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

Paramètres
`displayId`	`long`: ID d'affichage de l'écran à partir duquel effectuer une capture d'écran.

Renvoie
`InputStreamSource`	Un `InputStreamSource` de la capture d'écran au format, ou `null` si la capture d'écran a échoué.

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Paramètres
`format`	`String`: PNG, JPEG acceptés

Renvoie
`InputStreamSource`	une `InputStreamSource` de la capture d'écran au format, ou `null` si la capture d'écran a échoué.

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

Renvoie
`InputStreamSource`	une `InputStreamSource` de la capture d'écran au format PNG, ou `null` si la capture d'écran a échoué.

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

getSetting

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

Renvoie la valeur du paramètre demandé. L'espace de noms doit être l'un des suivants: {"system", "secure", "global"}

Paramètres
`userId`	`int`
`namespace`	`String`
`key`	`String`

Renvoie
`String`	la valeur associée à l'espace de noms "namespace:key" d'un utilisateur. Valeur nulle si aucune valeur n'est trouvée.

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Paramètres
`namespace`	`String`
`key`	`String`

Renvoie
`String`

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Récupérez les noms des packages d'application pouvant être désinstallés. Il s'agit actuellement des packages non système et des packages système mis à jour.

Renvoie
	`ERROR(/Set)` de noms de packages `String` pouvant être désinstallés 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, -10000 dans tous les autres cas.

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

getUserInfos

public abstract  getUserInfos ()

Récupère la mappage de l'identifiant d'utilisation à UserInfo sur l'appareil. Une exception DeviceRuntimeException est générée si la sortie de l'appareil ne correspond pas aux attentes.

Renvoie
	la liste des objets UserInfo.

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, -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érifier si une fonctionnalité est disponible sur un appareil

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

Renvoie
`boolean`	"True" si la caractéristique est détecté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. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

Installer le package

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

Installer un package Android sur l'appareil

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

Paramètres
`packageFile`	`File`: fichier APK à installer
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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)

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

Paramètres
`packageFile`	`File`: fichier APK à installer
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`userId`	`int`: ID utilisateur entier pour lequel l'installation doit être effectuée.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

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

Paramètres
`packageFile`	`File`: fichier APK à installer
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée.
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`userId`	`int`: ID utilisateur entier pour lequel l'installation doit être effectuée.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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, 
                String... extraArgs)

Installez une application Android composée de plusieurs fichiers APK (un package de division principal et un package de division supplémentaire). Pour savoir comment diviser un APK en plusieurs fichiers, consultez la page https://developer.android.com/studio/build/configure-apk-splits.

Paramètres
`packageFiles`	: fichiers APK locaux
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`UnsupportedOperationException`	si l'autorisation d'exécution n'est pas prise en charge par la plate-forme sur l'appareil.

Installation de packages

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

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

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

Paramètres
`packageFiles`	: chemins d'accès aux fichiers APK distants à installer
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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)

Installez une application Android composée de plusieurs fichiers APK (un package principal et des packages fractionnés supplémentaires) pour un utilisateur donné. Consultez la page "https://developer.android.com/studio/build/configure-apk-splits" pour découvrir comment diviser un APK en plusieurs fichiers.

Paramètres
`packageFiles`	: fichiers APK locaux
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée
`userId`	`int`: ID utilisateur entier pour lequel l'installation doit être effectuée.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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)

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

Paramètres
`packageFiles`	: fichiers APK locaux
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`userId`	`int`: ID utilisateur entier pour lequel l'installation doit être effectuée.
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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 package principal et des packages fractionnés supplémentaires) situés sur l'appareil Android. Consultez la page "https://developer.android.com/studio/build/configure-apk-splits" pour savoir comment diviser un 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. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	un `String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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)

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

Paramètres
`remoteApkPaths`	: chemins d'accès aux fichiers APK distants
`reinstall`	`boolean`: `true` si une réinstallation doit être effectuée
`grantPermissions`	`boolean`: si toutes les autorisations d'exécution doivent être accordées au moment de l'installation
`extraArgs`	`String`: arguments supplémentaires facultatifs à transmettre. Pour connaître les options disponibles, consultez "adb shell pm -h".

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.
`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é vers un statut non-administrateur.

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isMultiUserCompatible

public abstract boolean isMultiUserSupported ()

Détermine si la multi-utilisation est prise en charge.

Renvoie
`boolean`	"true" si la multi-utilisateur est prise 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 à la recherche d'un nom de package et d'un ID utilisateur donnés pour vérifier s'il est actuellement installé pour cet utilisateur.

Paramètres
`packageName`	`String`: package que nous vérifions pour voir s'il est installé.
`userId`	`String`: ID de l'utilisateur pour lequel le package est installé. Si la valeur est nulle, l'utilisateur principal sera défini sur zéro.

Renvoie
`boolean`	"True" si le package est signalé comme installé. Sinon, cette valeur est "false".

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Paramètres
`packageName`	`String`

Renvoie
`boolean`	"True" si le package est signalé comme installé. Sinon, cette valeur est "false".

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

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Paramètres
`userId`	`int`

Renvoie
`boolean`	"True" si l'utilisateur est en cours d'exécution, "false" dans tous les autres cas.

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

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 peut donc lancer des activités de lancement (généralement dans l'affichage 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 peut donc lancer des activités de lancement dans cet écran.

Paramètres
`userId`	`int`
`displayId`	`int`

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indique si l'appareil autorise les utilisateurs à être démarrés 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 permet aux utilisateurs d'être démarrés en arrière-plan.

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

Renvoie
`boolean`

Génère
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

Renvoie
`boolean`	`true` si le Wi-Fi est activé. `false` si désactivé

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

listDisplayIds

public abstract  listDisplayIds ()

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

Renvoie
	Liste des écrans. Par défaut, la valeur affichée est toujours 0.

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Renvoie

Génère
`DeviceNotAvailableException`

listUsers

public abstract  listUsers ()

Récupère la liste des utilisateurs de l'appareil. Une erreur DeviceRuntimeException est renvoyée si le résultat de l'appareil n'est pas conforme à vos attentes.

Renvoie
	la liste des ID utilisateur.

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

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 auprès des signalants.

Paramètres
`dataName`	`String`: nom sous lequel le rapport de bug sera envoyé.
`listener`	`ITestLogger`: un `ITestLogger` pour consigner le rapport de bug.

Renvoie
`boolean`	"True" si la journalisation a réussi, sinon "false".

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Informez 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 seront informés avant le début d'une action de l'appareil et après la fin de l'action de l'appareil.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Supprimez l'administrateur de l'appareil donné dans l'utilisateur donné et renvoyez true si la suppression aboutit, sinon false.

Paramètres
`componentName`	`String`: administrateur de l'appareil à supprimer.
`userId`	`int`: de l'utilisateur dans lequel réside l'administrateur de l'appareil.

Renvoie
`boolean`	"True" si la requête a réussi, "false" dans le cas contraire.

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

removeOwners

public abstract void removeOwners ()

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

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

removeUser

public abstract boolean removeUser (int userId)

Supprimer un utilisateur donné de l'appareil

Paramètres
`userId`	`int`: de l'utilisateur à supprimer

Renvoie
`boolean`	"true" si la suppression de l'utilisateur a réussi, "false" dans le cas contraire.

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Paramètres
`componentName`	`String`: pour que l'administrateur de l'appareil soit le propriétaire de l'appareil.
`userId`	`int`: pays de l'utilisateur dans lequel le propriétaire de l'appareil réside.

Renvoie
`boolean`	"True" si la requête 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 système.

Paramètres
`namespace`	`String`
`key`	`String`
`value`	`String`

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

Définir un paramètre

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

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 opération sans effet.

Paramètres
`userId`	`int`: de l'utilisateur pour qu'il démarre en arrière-plan

Renvoie
`boolean`	est défini sur "true" si l'utilisateur a démarré en arrière-plan.

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

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 opération sans effet. 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`: la commande attendra que l'utilisateur soit démarré et déverrouillé.

Renvoie
`boolean`	est défini sur "true" si l'utilisateur a démarré en arrière-plan.

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

startVisibleBackgroundUser

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

Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (c'est-à-dire, 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`: afficher pour que l'utilisateur soit visible sur
`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
`DeviceNotAvailableException`

utilisateur stop

public abstract boolean stopUser (int userId)

Arrête un utilisateur donné. Si l'utilisateur est déjà arrêté, cette méthode est une opération sans effet. Impossible d'arrêter l'utilisateur actuel et le 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`

utilisateur stop

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

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

Paramètres
`userId`	`int`: de l'utilisateur à arrêter.
`waitFlag`	`boolean`: la commande attendra l'arrêt de l'utilisateur.
`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 avant expiration 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, cette valeur est "false".

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Passez à un autre userId avec l'expiration fournie comme échéance. Tentative de désactivation du verrouillage du clavier une fois la modification de l'utilisateur effectuée.

Paramètres
`userId`	`int`
`timeout`	`long`: pour attendre avant de renvoyer la valeur "false" en cas d'échec de la modification de l'utilisateur.

Renvoie
`boolean`	"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Sinon, cette valeur est "false".

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

takeBugreport

public abstract Bugreport takeBugreport ()

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

Renvoie
`Bugreport`

uninstallPackage

public abstract String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

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

Renvoie
`String`	`String` avec un code d'erreur ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	Si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

désinstallerPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Paramètres
`packageName`	`String`: package Android à désinstaller
`userId`	`int`: ID utilisateur entier pour lequel désinstaller.

Renvoie
`String`	une `String` avec un code d'erreur, ou `null` en cas de réussite.

Génère
`DeviceNotAvailableException`	si la connexion avec l'appareil est perdue et ne peut pas être rétablie.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Si nécessaire, attendez que snapuserd ait terminé.

Paramètres
`currentPhase`	`SnapuserdWaitPhase`

Génère
`DeviceNotAvailableException`

ITestDevice

Résumé

Classes imbriquées

Méthodes publiques

Méthodes publiques

canSwitchToHeadlessSystemUser

checkConnectivity

ClearErrorDialogs

ClearLastConnectedWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

ConnectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

deregisterDeviceActionReceiver

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

dumpHeap

enableNetworkMonitor

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getIpAddress

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getOptions

getPrimaryUserId

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

hasFeature

installPackage

Installer le package

installPackageForUser

installPackageForUser

installPackages

Installation de packages

installPackagesForUser

installPackagesForUser

installRemotePackages

installRemotePackages

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserCompatible

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

isWifiEnabled

listDisplayIds