TestDevice

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 s'exécutant dans une VM Cuttlefish distante.  RemoteAndroidDevice Implémentation d'un ITestDevice pour un appareil Android full stack connecté via adb connect.

Sous-classes indirectes connues LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice LocalAndroidVirtualDevice Classe pour les appareils virtuels locaux exécutés sur l'hôte TradeFed.  RemoteAndroidVirtualDevice Étend le comportement de RemoteAndroidDevice pour un appareil Android à pile complète s'exécutant 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.

Constantes
String	DISMISS_KEYGUARD_CMD Commandes pouvant être utilisées pour fermer le keyguard.

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

Méthodes publiques
boolean	canSwitchToHeadlessSystemUser() Indique si le changement vers l'utilisateur SYSTEM headless est autorisé.
boolean	clearErrorDialogs() Tente de fermer toutes les boîtes de dialogue d'erreur actuellement affichées sur l'interface utilisateur de l'appareil.
int	createUser(String name) Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
int	createUser(String name, boolean guest, boolean ephemeral) Créez un utilisateur avec un nom donné et les indicateurs fournis.
int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Créez un utilisateur avec un nom donné et les indicateurs fournis.
int	createUserNoThrow(String name) Créez un utilisateur avec un nom donné et des indicateurs par défaut de 0.
void	disableKeyguard() Tentatives de désactivation du keyguard.
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é.
boolean	doesFileExist(String deviceFilePath) Méthode d'assistance permettant de déterminer si un fichier existe sur l'appareil.
File	dumpHeap(String process, String devicePath) Essayez de vider le tas depuis system_server.
	getActiveApexes() Récupère 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. Renvoie la valeur "null" si aucun n'est trouvé.
	getAndroidIds() Créez une carte des ID Android trouvés correspondant aux ID utilisateur.
PackageInfo	getAppPackageInfo(String packageName) Récupérez des informations sur un package installé sur l'appareil.
	getAppPackageInfos() Récupérer les informations des packages installés sur l'appareil.
InputStreamSource	getBugreport() Récupère un rapport de bug depuis l'appareil.
InputStreamSource	getBugreportz() Récupère un bugreportz depuis l'appareil.
DeviceFoldableState	getCurrentFoldableState() Renvoie l'état de pliage actuel de l'appareil ou la valeur "null" en cas de problème.
int	getCurrentUser() Renvoie l'ID de l'utilisateur actuellement en cours d'exécution.
	getFoldableStates() Renvoie la liste des états de pliage de l'appareil.
	getInstalledPackageNames() Récupère les noms de packages d'application présents sur l'appareil.
KeyguardControllerState	getKeyguardState() Renvoie un objet pour obtenir l'état actuel du keyguard ou la valeur "null" si ce n'est pas pris en charge.
Integer	getMainUserId() Renvoie l'ID utilisateur principal.
	getMainlineModuleInfo() Obtenez des informations sur les modules principaux installés sur l'appareil.
int	getMaxNumberOfRunningUsersSupported() Obtenez le nombre maximal d'utilisateurs pouvant être exécutés simultanément.
int	getMaxNumberOfUsersSupported() Obtenez le nombre maximal d'utilisateurs acceptés.
Integer	getPrimaryUserId() Renvoie l'ID utilisateur principal.
InputStreamSource	getScreenshot(String format, boolean rescale) Prend une capture d'écran de l'appareil.
InputStreamSource	getScreenshot(long displayId) Effectue une capture d'écran à partir de l'ID d'affichage de l'appareil.
InputStreamSource	getScreenshot(String format) Prend une capture d'écran de l'appareil.
InputStreamSource	getScreenshot() Prend une capture d'écran de l'appareil.
String	getSetting(int userId, String namespace, String key) Renvoie la valeur du paramètre demandé.
String	getSetting(String namespace, String key) Voir getSetting(int, String, String) et effectué sur l'utilisateur du système.
	getUninstallablePackageNames() Récupère les noms de package des applications qui peuvent être désinstallées.
int	getUserFlags(int userId) Recherchez et renvoyez les indicateurs d'un utilisateur donné.
	getUserInfos() Récupère le mappage d'useId vers UserInfo sur l'appareil.
int	getUserSerialNumber(int userId) Renvoie le numéro de série associé à l'ID utilisateur s'il est trouvé, ou -10000 dans les autres cas.
boolean	hasFeature(String feature) Vérifiez 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, File certFile, boolean reinstall, String... extraArgs) Installez un package Android sur l'appareil.
String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installez un package Android sur l'appareil.
String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Installez un package Android sur l'appareil pour un utilisateur donné.
String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installez un package Android sur l'appareil pour un utilisateur donné.
boolean	installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId) Installe les APK avec le mode incrémentiel.
String	installPackages( packageFiles, boolean reinstall, String... extraArgs)
String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, 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 sur l'appareil est compatible avec l'énumération des applications
boolean	isHeadlessSystemUserMode() Indique si l'appareil utilise le mode utilisateur système headless.
boolean	isMainUserPermanentAdmin() Indique si l'utilisateur principal est un administrateur permanent et ne peut pas être supprimé ni rétrogradé au statut de non-administrateur.
boolean	isMultiUserSupported() Détermine si plusieurs utilisateurs sont acceptés.
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	isPackageInstalled(String packageName) Interrogez l'appareil pour un nom de package donné afin de vérifier s'il est actuellement installé ou non.
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 en fonction de 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 le démarrage visible des utilisateurs en arrière-plan dans ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
boolean	isVisibleBackgroundUsersSupported() Indique si l'appareil autorise le démarrage visible des utilisateurs en arrière-plan.
	listDisplayIds() Collectez la liste des ID d'écrans disponibles sur l'appareil, comme indiqué par "dumpsys SurfaceFlinger".
	listDisplayIdsForStartingVisibleBackgroundUsers() Obtient la liste des écrans pouvant être utilisés pour start a user visible in the background.
	listUsers() Récupère la liste des utilisateurs sur l'appareil.
boolean	logBugreport(String dataName, ITestLogger listener) Méthode d'assistance permettant de créer un rapport de bug et de l'enregistrer pour les reporters.
void	notifySnapuserd(SnapuserdWaitPhase waitPhase)
void	postInvocationTearDown(Throwable exception) Étapes supplémentaires pour le nettoyage requis spécifique à l'appareil, qui seront exécutées une fois l'appel terminé.
boolean	removeAdmin(String componentName, int userId) Supprime l'administrateur de l'appareil donné pour l'utilisateur donné et renvoie true en cas de succès, false sinon.
void	removeOwners() Supprimez tous les propriétaires de profils d'appareils existants du mieux que vous pouvez.
boolean	removeUser(int userId) Supprimez un utilisateur donné de l'appareil.
boolean	setDeviceOwner(String componentName, int userId) Définir un composant d'administrateur de l'appareil comme propriétaire de l'appareil pour un utilisateur donné.
void	setFirstBootloaderReboot()
void	setSetting(String namespace, String key, String value) Voir setSetting(int, String, String, String) et effectué sur l'utilisateur du 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) Arrête le microdroid, s'il existe.
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 en permettant à l'utilisateur de lancer des activités sur cet écran).
boolean	stopUser(int userId) Arrête un utilisateur donné.
boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Arrêtez 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 d'inactivité par défaut.
boolean	switchUser(int userId, long timeout) Passez à un autre identifiant utilisateur avec le délai d'expiration fourni comme date limite.
Bugreport	takeBugreport() Prenez un rapport de bug et renvoyez-le 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 sous la forme d'un ERROR(/File).
long	getCheckNewUserSleep() Exposé pour les tests.
long	getHostCurrentTime() Exposé pour les tests
void	prePostBootSetup() Permet à chaque type d'appareil (AndroidNativeDevice, TestDevice) de remplacer cette méthode pour une configuration spécifique après le démarrage.

Constantes

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Commandes pouvant être utilisées pour fermer le keyguard.

Valeur de constante : "input keyevent 82"

Constructeurs publics

TestDevice

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

Méthodes publiques

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Renvoie
boolean

Génère
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Génère
DeviceNotAvailableException

createUser

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

createUser

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

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

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

Renvoie
int	ID de l'utilisateur créé

Génère
DeviceNotAvailableException

createUser

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

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

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

Renvoie
int	ID de l'utilisateur créé

Génère
DeviceNotAvailableException

createUserNoThrow

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	Entier pour l'ID utilisateur créé ou -1 en cas d'erreur.

Génère
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Tentatives de désactivation du keyguard.

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

Génère
DeviceNotAvailableException

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 d'accès absolu du fichier à vérifier sur l'appareil
userId	int : ID utilisateur pour lequel vérifier l'existence du fichier

Renvoie
boolean	true si le fichier existe, false sinon.

Génère
DeviceNotAvailableException

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 d'accès absolu du fichier à vérifier sur l'appareil

Renvoie
boolean	true si le fichier existe, false sinon.

Génère
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Essayez de vider le tas depuis system_server. Il incombe à l'appelant de nettoyer le fichier dumpé.

Paramètres
process	String : nom du processus de l'appareil sur lequel effectuer dumpheap.
devicePath	String : chemin d'accès sur l'appareil où placer le fichier de vidage. Il doit s'agir d'un emplacement pour lequel les autorisations le permettent.

Renvoie
File	le ERROR(/File) contenant le rapport. Null si une erreur s'est produite.

Génère
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

Génère
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

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

Renvoie
	Carte des paires clé/valeur. Valeur nulle si l'espace de noms n'est pas pris en charge.

Génère
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Recherchez et renvoyez l'android-id associé à un userId. Renvoie la valeur "null" si aucun n'est trouvé.

Paramètres
userId	int

Renvoie
String

Génère
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

Renvoie
	Carte des ID Android correspondant aux ID utilisateur.

Génère
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érer les informations des packages installés sur l'appareil.

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

Génère
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

Uniquement compatible avec "adb version" > 1.0.36

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Renvoie
DeviceFoldableState

Génère
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Renvoie
int

Génère
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Renvoie la liste des états de pliage de l'appareil. Vous pouvez l'obtenir avec la commande "cmd device_state print-states".

Renvoie

Génère
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

Génère
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Renvoie un objet pour obtenir l'état actuel du keyguard ou la valeur "null" si ce n'est pas pris en charge.

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

Génère
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Renvoie l'ID utilisateur principal.

Renvoie
Integer	userId de l'utilisateur principal, le cas échéant, ou null si aucun utilisateur principal n'est défini.

Génère
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

Génère
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

Renvoie
int	Nombre entier indiquant le nombre d'utilisateurs exécutés simultanément

Génère
DeviceNotAvailableException

getMaxNumberOfUsersSupported

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	ID utilisateur de l'utilisateur principal, le cas échéant. La valeur est "null" si aucun utilisateur principal n'est défini.

Génère
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

Renvoie
InputStreamSource	InputStreamSource de la capture d'écran au format null si la capture d'écran n'a pas réussi.

Génère
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

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

Renvoie
InputStreamSource	InputStreamSource de la capture d'écran au format null si la capture d'écran n'a pas réussi.

Génère
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

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

Paramètres
format	String : PNG, JPEG

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

Génère
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

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

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

Génère
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:clé d'un utilisateur. Null si introuvable.

Génère
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Paramètres
namespace	String
key	String

Renvoie
String

Génère
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

Génère
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

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

Paramètres
userId	int

Renvoie
int	les indicateurs associés à l'ID utilisateur fourni, le cas échéant, ou -10000 dans les autres cas.

Génère
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

Renvoie
	Liste des objets UserInfo.

Génère
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Paramètres
userId	int

Renvoie
int

Génère
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

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

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

Renvoie
boolean	"True" si la fonctionnalité est trouvée, "false" dans le cas contraire.

Génère
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. Consultez "adb shell pm -h" pour connaître les options disponibles.

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

Génère
DeviceNotAvailableException

installPackage

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

Installez un package Android sur l'appareil.

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

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

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

Génère
DeviceNotAvailableException

installPackage

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

Installez un package Android sur l'appareil.

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

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

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

Génère
DeviceNotAvailableException

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 installer.
extraArgs	String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.

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

Génère
DeviceNotAvailableException

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 qui nécessitent 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 : indique si toutes les autorisations d'exécution doivent être accordées au moment de l'installation.
userId	int : ID utilisateur entier pour lequel installer.
extraArgs	String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm -h" pour connaître les options disponibles.

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

Génère
DeviceNotAvailableException

installPackageWithIncrementalMode

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

Installe les APK avec le mode incrémentiel.

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

Renvoie
boolean

Génère
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, 
                int userId, 
                String... extraArgs)

Paramètres
packageFiles
reinstall	boolean
userId	int
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

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 sur l'appareil est compatible avec l'énumération des applications

Renvoie
boolean	"True" si l'énumération des applications est acceptée, "false" dans le cas contraire.

Génère
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Indique si l'appareil utilise le mode utilisateur 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é au statut de non-administrateur.

Renvoie
boolean

Génère
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

Détermine si plusieurs utilisateurs sont acceptés.

Renvoie
boolean	"true" si le multi-utilisateur est pris en charge, "false" dans le cas contraire

Génère
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 dont nous vérifions l'installation.
userId	String : ID de l'utilisateur pour lequel nous vérifions si le package est installé. Si la valeur est nulle, l'utilisateur principal zéro sera utilisé.

Renvoie
boolean	Valeur "true" si le package est signalé comme installé. Sinon renvoie "false".

Génère
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	Valeur "true" si le package est signalé comme installé. Sinon renvoie "false".

Génère
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

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

Paramètres
userId	int

Renvoie
boolean	"True" si l'utilisateur court, "false" dans tous les autres cas.

Génère
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 qui peut donc lancer des activités de lancement (généralement sur l'écran par défaut).

Paramètres
userId	int

Renvoie
boolean

Génère
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Paramètres
userId	int
displayId	int

Renvoie
boolean

Génère
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Renvoie
boolean

Génère
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

Renvoie
boolean

Génère
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

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

Renvoie
	Liste des écrans. Default renvoie toujours l'affichage par défaut 0.

Génère
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Renvoie

Génère
DeviceNotAvailableException

listUsers

public  listUsers ()

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

Renvoie
	Liste des ID utilisateur.

Génère
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 pour les reporters.

Paramètres
dataName	String : nom sous lequel le rapport de bug sera signalé.
listener	ITestLogger : ITestLogger pour enregistrer le rapport de bug.

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Paramètres
waitPhase	SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

Paramètres
componentName	String : administrateur de l'appareil à supprimer.
userId	int : de l'utilisateur auquel appartient l'administrateur de l'appareil.

Renvoie
boolean	"True" si l'opération a réussi, "false" dans le cas contraire.

Génère
DeviceNotAvailableException

removeOwners

public void removeOwners ()

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

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 l'utilisateur a bien été supprimé, "false" dans le cas contraire.

Génère
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

Paramètres
componentName	String : de l'administrateur de l'appareil au propriétaire de l'appareil.
userId	int : de l'utilisateur avec lequel le propriétaire de l'appareil vit.

Renvoie
boolean	"True" si l'opération a réussi, "false" dans le cas contraire.

Génère
DeviceNotAvailableException

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

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

Paramètres
namespace	String
key	String
value	String

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

Arrête le microdroid, s'il existe.

Paramètres
microdroidDevice	ITestDevice

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

startUser

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

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

Renvoie
boolean	"true" si l'utilisateur a bien été démarré en arrière-plan.

Génère
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 NOOP. Il est possible de fournir un indicateur supplémentaire pour attendre que l'opération prenne effet.

Paramètres
userId	int : de l'utilisateur à démarrer en arrière-plan
waitFlag	boolean : la commande attendra que l'utilisateur soit démarré et déverrouillé.

Renvoie
boolean	"true" si l'utilisateur a bien été démarré en arrière-plan.

Génère
DeviceNotAvailableException

startVisibleBackgroundUser

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

Démarre un utilisateur donné en arrière-plan, visible sur l'écran donné (c'est-à-dire en permettant à l'utilisateur de lancer des activités sur cet écran).

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

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

Renvoie
boolean	true si l'utilisateur a bien démarré et est visible en arrière-plan.

Génère
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

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

Renvoie
boolean	"true" si l'utilisateur a bien été arrêté.

Génère
DeviceNotAvailableException

stopUser

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

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

Paramètres
userId	int : de l'utilisateur à arrêter.
waitFlag	boolean : la commande attendra jusqu'à ce que l'utilisateur soit arrêté.
forceFlag	boolean : arrête de force l'utilisateur.

Renvoie
boolean	"true" si l'utilisateur a bien été arrêté.

Génère
DeviceNotAvailableException

supportsMicrodroid

public boolean supportsMicrodroid ()

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

Renvoie
boolean	Renvoie "true" si les conditions préalables sont remplies, ou "false" dans le cas contraire.

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

Renvoie
boolean	Renvoie "true" si les conditions préalables sont remplies, ou "false" dans le cas contraire.

switchUser

public boolean switchUser (int userId)

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

Paramètres
userId	int

Renvoie
boolean	"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Sinon renvoie "false".

Génère
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

Paramètres
userId	int
timeout	long : délai d'attente avant de renvoyer la valeur "false" en cas d'échec du changement d'utilisateur.

Renvoie
boolean	"True" si le nouvel ID utilisateur correspond au fournisseur d'ID utilisateur. Sinon renvoie "false".

Génère
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

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

Renvoie
Bugreport

uninstallPackage

public String uninstallPackage (String packageName)

Désinstallez un package Android de l'appareil.

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

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

Génère
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

Génère
DeviceNotAvailableException

waitForSnapuserd

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 sous la forme d'un ERROR(/File).

Renvoie
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposé pour les tests.

Renvoie
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposé pour les tests

Renvoie
long

prePostBootSetup

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