Appareil de test

public class TestDevice
extends NativeDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

Sous-classes directes connues ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice ManagedRemoteDevice Appareil exécuté dans une machine virtuelle que nous gérons à distance via une instance Tradefed dans la VM.  NestedRemoteDevice Représentation de l'appareil exécuté dans une VM Cuttlefish distante.  RemoteAndroidDevice Implémentation d'un ITestDevice pour un appareil Android à pile complète connecté via une connexion ADB.

Sous-classes indirectes connues LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice LocalAndroidVirtualDevice Classe des appareils virtuels locaux exécutés sur l'hôte TradeFed.  Appareil virtuel d'appareil distant Élargit le comportement de RemoteAndroidDevice pour un appareil Android à pile complète exécuté dans Google Compute Engine (GCE).

---

Implémentation d'un ITestDevice pour un appareil Android full stack

Résumé

Classes imbriquées
class	TestDevice.MicrodroidBuilder Générateur utilisé pour créer un TestDevice Microdroid.

Champs
public static final String	DISMISS_KEYGUARD_CMD Commandes permettant de fermer le clavier de verrouillage.

Constructeurs publics
TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Méthodes publiques
boolean	canSwitchToHeadlessSystemUser() Indique si l'utilisateur système headless est autorisé à passer à l'utilisateur système headless.
boolean	clearErrorDialogs() Essayez de fermer les boîtes de dialogue d'erreur actuellement affichées dans l'interface utilisateur de l'appareil.
int	createUser(String name) Créez un utilisateur avec un nom donné et les options par défaut de 0.
int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Créer un utilisateur avec un nom donné et les options fournies
int	createUser(String name, boolean guest, boolean ephemeral) Créer un utilisateur avec un nom donné et les options fournies
int	createUserNoThrow(String name) Créez un utilisateur avec un nom donné et les options par défaut de 0.
void	disableKeyguard() Tentatives de désactivation du clavier de protection.
boolean	doesFileExist(String deviceFilePath) Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.
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é.
File	dumpHeap(String process, String devicePath) Tentative de vidage de la pile à partir de system_server.
	getActiveApexes() Récupérez les informations sur les APEX activés sur l'appareil.
	getAllSettings(String namespace) Renvoie les paires clé-valeur de l'espace de noms demandé.
String	getAndroidId(int userId) Recherchez et renvoyez l'android-id associé à un userId, ou "null" si aucun n'est trouvé.
	getAndroidIds() Créez une carte des ID Android correspondant aux ID utilisateur.
PackageInfo	getAppPackageInfo(String packageName) Récupérez des informations sur un package installé sur l'appareil.
	getAppPackageInfos() Récupérez les informations sur les packages installés sur l'appareil.
InputStreamSource	getBugreport() Récupère un rapport de bug à partir de l'appareil.
InputStreamSource	getBugreportz() Récupère un bugreportz à partir de l'appareil.
DeviceFoldableState	getCurrentFoldableState() Renvoie l'état actuel de l'appareil pliable ou la valeur "null" si des problèmes se sont produits.
int	getCurrentUser() Renvoie l'ID de l'utilisateur en cours d'exécution.
	getFoldableStates() Renvoie la liste des états des appareils pliables sur l'appareil.
	getInstalledPackageNames() Récupérez les noms des packages d'application présents sur l'appareil.
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.
Integer	getMainUserId() Renvoie l'ID utilisateur principal.
	getMainlineModuleInfo() Obtenez les informations sur les modules principaux installés sur l'appareil.
int	getMaxNumberOfRunningUsersSupported() Obtenez le nombre maximal d'utilisateurs pouvant exécuter simultanément l'application.
int	getMaxNumberOfUsersSupported() Obtenir le nombre maximal d'utilisateurs pris en charge
Integer	getPrimaryUserId() Renvoie l'identifiant de l'utilisateur principal.
InputStreamSource	getScreenshot() Prend une capture d'écran de l'appareil.
InputStreamSource	getScreenshot(String format, boolean rescale) Prend une capture d'écran de l'appareil.
InputStreamSource	getScreenshot(long displayId) Capture une capture d'écran de l'appareil avec l'ID d'affichage donné.
InputStreamSource	getScreenshot(String format) Prend une capture d'écran de l'appareil.
String	getSetting(String namespace, String key) Voir getSetting(int, String, String) et effectué sur l'utilisateur système.
String	getSetting(int userId, String namespace, String key) Renvoie la valeur du paramètre demandé.
	getUninstallablePackageNames() Récupérez les noms des packages d'application qui peuvent être désinstallés.
int	getUserFlags(int userId) Rechercher et renvoyer les indicateurs d'un utilisateur donné
	getUserInfos() Récupère la carte de useId sur UserInfo sur l'appareil.
int	getUserSerialNumber(int userId) Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, -10000 dans les autres cas.
boolean	hasFeature(String feature) Vérifier si une fonctionnalité est disponible sur un appareil
String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Installez un package Android sur l'appareil.
String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installer un package Android sur l'appareil
String	installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs) Installez un package Android sur l'appareil.
String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installez un package Android sur l'appareil pour un utilisateur donné.
String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Installez un package Android sur l'appareil pour un utilisateur donné.
String	installPackages( packageFiles, boolean reinstall, String... extraArgs)
String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
boolean	isAppEnumerationSupported() Vérifier si la plate-forme de l'appareil est compatible avec l'énumération des applications
boolean	isHeadlessSystemUserMode() Indique si l'appareil utilise le mode utilisateur du système headless.
boolean	isMainUserPermanentAdmin() Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ni rétrogradé en non-administrateur.
boolean	isMultiUserSupported() Détermine si la multi-utilisation est prise en charge.
boolean	isPackageInstalled(String packageName) Interrogez l'appareil pour un nom de package donné afin de vérifier s'il est actuellement installé ou non.
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.
boolean	isUserRunning(int userId) Vérifiez si un utilisateur donné est en cours d'exécution.
boolean	isUserSecondary(int userId) Indique si l'utilisateur spécifié est un utilisateur secondaire selon ses indicateurs.
boolean	isUserVisible(int userId) Vérifie si l'utilisateur donné est visible.
boolean	isUserVisibleOnDisplay(int userId, int displayId) Vérifie si l'utilisateur donné est visible dans l'affichage donné.
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).
boolean	isVisibleBackgroundUsersSupported() Indique si l'appareil permet aux utilisateurs d'être démarrés en arrière-plan.
	listDisplayIds() Collectez la liste des ID d'écran disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
	listDisplayIdsForStartingVisibleBackgroundUsers() Récupère la liste des écrans pouvant être utilisés pour start a user visible in the background.
	listUsers() Récupère la liste des utilisateurs de l'appareil.
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.
void	notifySnapuserd(SnapuserdWaitPhase waitPhase)
void	postInvocationTearDown(Throwable exception) Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui sera exécuté une fois l'appel terminé.
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.
void	removeOwners() Supprimez au mieux tous les propriétaires existants de profils sur l'appareil.
boolean	removeUser(int userId) Supprimez un utilisateur donné de l'appareil.
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é.
void	setSetting(String namespace, String key, String value) Voir setSetting(int, String, String, String) et effectué sur l'utilisateur système.
void	setSetting(int userId, String namespace, String key, String value) Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné.
void	shutdownMicrodroid(ITestDevice microdroidDevice) Éteint l'appareil microdroid, le cas échéant.
boolean	startUser(int userId) Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.
boolean	startUser(int userId, boolean waitFlag) Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté.
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).
boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Arrêter un utilisateur donné.
boolean	stopUser(int userId) Arrête un utilisateur donné.
boolean	supportsMicrodroid() Vérifie les conditions préalables à l'exécution d'un microdroid.
boolean	supportsMicrodroid(boolean protectedVm) Vérifie les conditions préalables à l'exécution d'un microdroid.
boolean	switchUser(int userId) Passez à un autre userId avec un délai avant expiration par défaut.
boolean	switchUser(int userId, long timeout) Passez à un autre userId avec l'expiration fournie comme échéance.
Bugreport	takeBugreport() Prend un bugreport et le renvoie dans un objet Bugreport pour le gérer.
String	uninstallPackage(String packageName) Désinstallez un package Android de l'appareil.
String	uninstallPackageForUser(String packageName, int userId) Désinstallez un package Android de l'appareil pour un utilisateur donné.
void	waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Méthodes protégées
AaptParser	createParser(File appFile)
void	doAdbReboot(NativeDevice.RebootMode rebootMode, String reason) Effectuez un redémarrage ADB.
InputStreamSource	getBugreportInternal()
File	getBugreportzInternal() Méthode d'assistance interne permettant d'obtenir le fichier ZIP bugreportz en tant que ERROR(/File).
long	getCheckNewUserSleep() Exposé à des fins de test.
long	getHostCurrentTime() Exposée à des fins de test
void	prePostBootSetup() Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage.

Champs

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Commandes permettant de fermer le clavier de verrouillage.

Constructeurs publics

TestDevice

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

Méthodes publiques

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Indique si l'utilisateur système headless est autorisé à passer à l'utilisateur système headless.

Renvoie
boolean

Génère
DeviceNotAvailableException

clearErrorDialogs

public 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

créerutilisateur

public int createUser (String name)

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

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

Renvoie
int	Entier correspondant à l'ID utilisateur créé

Génère
DeviceNotAvailableException

createUser

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

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

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

Renvoie
int	ID de l'utilisateur créé

Génère
DeviceNotAvailableException

createUser

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

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

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

Renvoie
int	ID de l'utilisateur créé

Génère
DeviceNotAvailableException

créerUtilisateurPasDeJeter

public 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	l'entier pour l'ID utilisateur créé ou -1 pour l'erreur.

Génère
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Tentatives de désactivation du clavier de protection.

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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

Renvoie
boolean	true si le fichier existe, false sinon.

Génère
DeviceNotAvailableException

doesFileExist

public 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 par rapport auquel l'existence du fichier doit être vérifiée.

Renvoie
boolean	true si le fichier existe, false sinon.

Génère
DeviceNotAvailableException

dumpHeap

public 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 effectuer le dumpheap.
devicePath	String: chemin d'accès sur l'appareil où placer le dump. Il doit s'agir d'un emplacement pour lequel les autorisations le permettent.

Renvoie
File	ERROR(/File) contenant le rapport. Null en cas d'échec.

Génère
DeviceNotAvailableException

getActiveApexes

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

getAllSettings

public  getAllSettings (String namespace)

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

Paramètres
namespace	String : doit correspondre à l'une des valeurs suivantes : {"system", "secure", "global"}

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

Génère
DeviceNotAvailableException

getAndroidId

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

getAndroidIds

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

getAppPackageInfo

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

getAppPackageInfos

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

getBugreport

public InputStreamSource getBugreport ()

Récupère un rapport de bug à partir 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 InputStreamSource getBugreportz ()

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

Uniquement compatible avec la version d'adb > 1.0.36

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

getCurrentFoldableState

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

getCurrentUser

public int getCurrentUser ()

Renvoie l'ID de l'utilisateur en cours d'exécution. En cas d'erreur, renvoyez -10000.

Renvoie
int

Génère
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Renvoie la liste des états de pliage de l'appareil. Obtention de la commande "cmd device_state print-states".

Renvoie

Génère
DeviceNotAvailableException

getInstalledPackageNames

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

getMainUserId

public Integer getMainUserId ()

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
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

Renvoie
	ERROR(/Set) modules principaux sur String actuellement installés sur l'appareil.

Génère
DeviceNotAvailableException

getMaxNumberOfRunningUsersCompatibles

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

getMaxNumberOfUsersCompatibles

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

getPrimaryUserId

public Integer getPrimaryUserId ()

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
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

Prend 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
DeviceNotAvailableException

getScreenshot

public 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: fichiers PNG et JPEG acceptés.
rescale	boolean: si la capture d'écran doit être redimensionnée pour réduire la taille de l'image obtenue

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

Génère
DeviceNotAvailableException

getScreenshot

public 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 accepter les options "formater" et "redimensionner"

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

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

Génère
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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
DeviceNotAvailableException

getSetting

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

getSetting

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

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

Paramètres
userId	int
namespace	String
key	String

Renvoie
String	la valeur associée à l'espace de noms "namespace:key" d'un utilisateur. Null si introuvable.

Génère
DeviceNotAvailableException

getUninstallablePackageNames

public  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) des noms de packages String pouvant être désinstallés actuellement installés sur l'appareil.

Génère
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Rechercher et renvoyer 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 s'il est trouvé, -10000 dans les autres cas.

Génère
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

Récupère la carte de useId sur UserInfo sur l'appareil. Génère une exception DeviceRuntimeException si la sortie de l'appareil ne correspond pas à vos attentes.

Renvoie
	la liste des objets UserInfo.

Génère
DeviceNotAvailableException

getUserSerialNumber

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

Fonction

public 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 une fonctionnalité est trouvée, "false" dans le cas contraire.

Génère
DeviceNotAvailableException

installPackage

public 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	un String avec un code d'erreur ou null en cas de réussite.

Génère
DeviceNotAvailableException

installPackage

public 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

installPackage

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                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
certFile	File: true si une réinstallation doit être effectuée
reinstall	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

installPackageForUser

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

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

Remarque: Seuls les cas d'utilisation nécessitant un contrôle explicite de l'octroi 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	une String avec un code d'erreur, ou null en cas de réussite.

Génère
DeviceNotAvailableException

installPackageForUser

public 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 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	une String avec un code d'erreur, ou null en cas de réussite.

Génère
DeviceNotAvailableException

installPackages

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

Paramètres
packageFiles
reinstall	boolean
extraArgs	String

Renvoie
String

Génère
DeviceNotAvailableException

installPackages

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

Paramètres
packageFiles
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Renvoie
String

Génère
DeviceNotAvailableException

installPackagesForUser

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

Paramètres
packageFiles
reinstall	boolean
grantPermissions	boolean
userId	int
extraArgs	String

Renvoie
String

Génère
DeviceNotAvailableException

installPackagesForUser

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

Paramètres
packageFiles
reinstall	boolean
userId	int
extraArgs	String

Renvoie
String

Génère
DeviceNotAvailableException

installRemotePackages

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

Paramètres
remoteApkPaths
reinstall	boolean
extraArgs	String

Renvoie
String

Génère
DeviceNotAvailableException

installRemotePackages

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

Paramètres
remoteApkPaths
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Renvoie
String

Génère
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Vérifier si la plate-forme de l'appareil est compatible avec l'énumération des applications

Renvoie
boolean	"True" si l'énumération des applications est prise en charge, "false" dans le cas contraire

Génère
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isMultiUserSupported

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

isPackageInstalled

public 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	"True" si le package est signalé comme installé. Sinon, cette valeur est "false".

Génère
DeviceNotAvailableException

isPackageInstalled

public 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 que nous vérifions pour voir s'il est installé.
userId	String: l'ID utilisateur pour lequel nous vérifions que 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
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Vérifier 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
DeviceNotAvailableException

isUserSecondary

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

isUserVisible

public boolean isUserVisible (int userId)

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

Un utilisateur "visible" est un utilisateur qui interagit avec l'utilisateur "humain" et 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 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 un 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

isVisibleBackgroundUsersOnDefaultDisplayCompatible

public 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 devrait inclure ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Renvoie
boolean

Génère
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

Renvoie
boolean

Génère
DeviceNotAvailableException

listDisplayIds

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

listDisplayIdsForStartingVisibleBackgroundUsers

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

logBugreport

public 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 signalé.
listener	ITestLogger: un ITestLogger pour consigner le rapport de bug.

Renvoie
boolean	"True" si la journalisation a réussi, "false" dans le cas contraire.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Paramètres
waitPhase	SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil qui sera exécuté une fois l'appel terminé.

Paramètres
exception	Throwable: exception finale générée par l'échec de l'appel, le cas échéant.

removeAdmin

public 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 se trouve l'administrateur de l'appareil.

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

Génère
DeviceNotAvailableException

removeOwners

public void removeOwners ()

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

Génère
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Supprimez 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
DeviceNotAvailableException

setDeviceOwner

public 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: de l'administrateur de l'appareil en tant que 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
DeviceNotAvailableException

setSetting

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

setSetting

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

Ajoutez une valeur de paramètre à l'espace de noms d'un utilisateur donné. Certains paramètres ne seront disponibles qu'après un redémarrage. L'espace de noms doit être l'un des suivants: {"system", "secure", "global"}

Paramètres
userId	int
namespace	String
key	String
value	String

Génère
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Éteint l'appareil microdroid, le cas échéant.

Paramètres
microdroidDevice	ITestDevice

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

utilisateurdémarrer

public boolean startUser (int userId)

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

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
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Démarre un utilisateur donné en arrière-plan s'il est actuellement arrêté. Si l'utilisateur s'exécute déjà en arrière-plan, cette méthode est 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 pour qu'il démarre 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
DeviceNotAvailableException

startVisibleBackgroundUser

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

Lance un utilisateur donné en arrière-plan, visible sur l'écran donné (ce qui permet à l'utilisateur de lancer des activités sur cet écran).

REMARQUE : Cette commande ne vérifie pas si l'utilisateur existe, si l'écran est disponible, si device supports such feature est disponible, 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 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 soit appliquée et forcer la fermeture de l'utilisateur. Impossible d'arrêter l'utilisateur système et l'utilisateur actuel.

Paramètres
userId	int: de l'utilisateur à arrêter.
waitFlag	boolean: la commande attendra l'arrêt de l'utilisateur.
forceFlag	boolean: force l'arrêt de l'utilisateur.

Renvoie
boolean	La valeur est définie sur "true" si l'utilisateur a bien été arrêté.

Génère
DeviceNotAvailableException

stopUser

public 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	La valeur est définie sur "true" si l'utilisateur a bien été arrêté.

Génère
DeviceNotAvailableException

supportsMicrodroid

public boolean supportsMicrodroid ()

Vérifie les conditions préalables à l'exécution d'un microdroïde.

Renvoie
boolean	renvoie "true" si les conditions préalables sont remplies, sinon "false".

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Vérifie les conditions préalables à l'exécution d'un microdroid.

Paramètres
protectedVm	boolean: vrai si Microdroid est destiné à s'exécuter sur une VM protégée.

Renvoie
boolean	renvoie "true" si les conditions préalables sont remplies, sinon "false".

contacteur

public 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 userId. Sinon, cette valeur est "false".

Génère
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

Passez à un autre userId avec l'expiration fournie comme échéance. Tentative de désactivation du verrouillage des touches une fois le changement d'utilisateur effectué.

Paramètres
userId	int
timeout	long: attendre la valeur "false" avant de renvoyer la valeur "false" pour l'utilisateur switch-user.

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

Génère
DeviceNotAvailableException

TakeBugreport

public Bugreport takeBugreport ()

Prend un bugreport et le renvoie dans un objet Bugreport pour le gérer. Renvoyez 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 String uninstallPackage (String packageName)

Désinstaller un package Android de l'appareil

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

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

Génère
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

Génère
DeviceNotAvailableException

attendForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Paramètres
currentPhase	SnapuserdWaitPhase

Génère
DeviceNotAvailableException

Méthodes protégées

createParser

protected AaptParser createParser (File appFile)

Paramètres
appFile	File

Renvoie
AaptParser

doAdbReboot

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

Effectuez un redémarrage adb.

Paramètres
rebootMode	NativeDevice.RebootMode: mode de ce redémarrage.
reason	String: pour ce redémarrage.

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

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Renvoie
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Méthode d'assistance interne permettant d'obtenir le fichier ZIP bugreportz en tant que ERROR(/File).

Renvoie
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposé à des fins de test.

Renvoie
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposé à des fins de test

Renvoie
long

configuration prePostBoot

protected void prePostBootSetup ()

Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage.

Génère
DeviceNotAvailableException