Gestionnaire d'appareils

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
↳	com.android.tradefed.device.DeviceManager.

---

Résumé

Classes imbriquées
class	DeviceManager.FastbootDevice Représentation d'un appareil en mode Fastboot.

Champs
public static final String	UNKNOWN_DISPLAY_STRING Chaîne à afficher pour les propriétés inconnues
protected DeviceMonitorMultiplexer	mDvcMon
protected boolean	mFastbootEnabled

Constructeurs publics
DeviceManager() Le DeviceManager doit être récupéré à partir de GlobalConfiguration.

Méthodes publiques
void	addAvailableDevice(IDevice stubDevice)
void	addDeviceMonitor(IDeviceMonitor mon) Ajoute un IDeviceMonitor
void	addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
void	addFastbootListener(IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état de fastboot.
void	addMonitoringTcpFastbootDevice(String serial, String fastboot_serial) Ajoutez un appareil au moniteur Fastboot.
ITestDevice	allocateDevice(IDeviceSelection options, boolean isTemporary) Demandez un appareil répondant à certains critères à des fins de test.
ITestDevice	allocateDevice(IDeviceSelection options) Demandez un appareil répondant à certains critères à des fins de test.
ITestDevice	allocateDevice() Demander un appareil physique à des fins de test
ITestDevice	connectToTcpDevice(String ipAndPort) Se connecter à un appareil avec adb-over-tcp Cette méthode alloue un nouvel appareil, qui doit à terme être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) Le ITestDevice renvoyé sera en ligne, mais peut ne pas répondre.
boolean	disconnectFromTcpDevice(ITestDevice tcpDevice) Déconnectez-vous d'un appareil connecté adb-over-tcp.
void	displayDevicesInfo(PrintWriter stream, boolean includeStub) Générez une description conviviale contenant la liste des appareils connus, leur état et leurs valeurs. pour connaître les options IDeviceSelection couramment utilisées.
CommandResult	executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit) Méthode d'assistance permettant d'exécuter une commande shell sur un appareil disponible.
String	executeGlobalAdbCommand(String... cmdArgs) Exécutez une commande adb qui n'est pas ciblée sur un appareil particulier, par exemple
ITestDevice	forceAllocateDevice(String serial) Allouer un appareil de façon abusive, même s'il n'est pas disponible actuellement
void	freeDevice(ITestDevice device, FreeDeviceState deviceState) Remettre un appareil dans le pool Les tentatives de retour d'un appareil qui n'a pas été alloué précédemment seront ignorées.
String	getAdbPath() Renvoie le chemin d'accès au binaire adb à utiliser.
String	getAdbVersion() Obtenez la version d'adb actuellement utilisée par le gestionnaire d'appareils.
DeviceDescriptor	getDeviceDescriptor(String serial) Renvoie le DeviceDescriptor avec le numéro de série donné.
String	getFastbootPath() Renvoie le chemin d'accès au binaire fastboot à utiliser.
void	init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Initialisez le gestionnaire d'appareils.
void	init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Initialisez le gestionnaire d'appareils.
void	init() Initialisez le gestionnaire d'appareils.
boolean	isEmulator(String serial) Déterminer si le numéro de série donné représente un émulateur
boolean	isFileSystemMountCheckEnabled() Indique si nous devons vérifier dans NativeDeviceStateMonitor si le système de fichiers est correctement fixée.
boolean	isNullDevice(String serial) Déterminer si le numéro de série donné représente un appareil nul
void	killEmulator(ITestDevice device) Arrêtez l'émulateur donné.
void	launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Méthode d'assistance pour lancer l'émulateur.
	listAllDevices(boolean shortDescriptor) Renvoie une liste de DeviceDescriptors pour tous les appareils connus.
	listAllDevices() Renvoie une liste de DeviceDescriptors pour tous les appareils connus.
ITestDevice	reconnectDeviceToTcp(ITestDevice usbDevice) Une méthode d'assistance qui bascule le périphérique USB donné en mode adb-over-tcp, puis se connecte à via connectToTcpDevice(String).
void	removeDeviceMonitor(IDeviceMonitor mon) Supprime un élément IDeviceMonitor précédemment ajouté.
void	removeFastbootListener(IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un écouteur n'est plus intéressé par les changements d'état de fastboot.
void	restartAdbBridge() Redémarrer (si stopAdbBridge() a été appelé) le pont et les services adb dépendent d'adb connexions externes.
void	stopAdbBridge() L'arrêt du pont et des services adb dépendent des connexions adb.
void	terminate() Arrête les services de surveillance de l'appareil et la bibliothèque ddm.
void	terminateDeviceMonitor() Arrêtez les moniteurs d'appareil.
void	terminateDeviceRecovery() Arrête le thread de récupération de l'appareil.
void	terminateHard(String reason) Comme terminateHard().
void	terminateHard() Semblable à terminate(), mais tente également de forcer l'arrêt d'adb.
boolean	waitForFirstDeviceAdded(long timeout) Attendez qu'un premier appareil physique soit connecté.

Champs

STRING_DISPLAY_INCONNUE

public static final String UNKNOWN_DISPLAY_STRING

Chaîne à afficher pour les propriétés inconnues

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Constructeurs publics

Gestionnaire d'appareils

public DeviceManager ()

Le DeviceManager doit être récupéré à partir de GlobalConfiguration.

Méthodes publiques

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Paramètres
stubDevice	IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Ajoute un IDeviceMonitor

Paramètres
mon	IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Paramètres
fastbootDevice	DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état de fastboot.

Actuellement, un IDeviceManager ne surveille les appareils en fastboot que s'il existe un ou plus d'écouteurs actifs.

À FAIRE: il s'agit d'une astuce, trouvez une meilleure solution

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Ajoutez un appareil au moniteur Fastboot. Le moniteur fastboot utilisera "fastboot_serial" à communiquer avec l'appareil.

Paramètres
serial	String: numéro de série de l'appareil.
fastboot_serial	String: numéro de série du mode fastboot de l'appareil.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Demandez un appareil répondant à certains critères à des fins de test.

Paramètres
options	IDeviceSelection: le IDeviceSelection auquel l'appareil doit correspondre.
isTemporary	boolean: indique si un objet NullDevice temporaire doit être créé ou non.

Renvoie
ITestDevice	ITestDevice pour les tests, ou null si aucun n'est disponible

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

Demandez un appareil répondant à certains critères à des fins de test.

Paramètres
options	IDeviceSelection: le IDeviceSelection auquel l'appareil doit correspondre.

Renvoie
ITestDevice	ITestDevice pour les tests, ou null s'il y en a une n'est pas disponible

allocateDevice

public ITestDevice allocateDevice ()

Demander un appareil physique à des fins de test

Renvoie
ITestDevice	ITestDevice pour les tests, ou null si aucun n'est disponible

ConnectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

Cette méthode alloue un nouvel appareil, qui doit à terme être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Le ITestDevice renvoyé sera en ligne, mais peut ne pas répondre.

Notez que si vous effectuez une action telle qu'un redémarrage sur un appareil connecté à tcp, Connexion TCP à l'appareil, entraînant une DeviceNotAvailableException

Paramètres
ipAndPort	String: adresse IP et port d'origine de l'appareil auquel se connecter

Renvoie
ITestDevice	ITestDevice ou null si une connexion tcp n'a pas pu être établie

déconnecterFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Déconnectez-vous d'un appareil connecté adb-over-tcp.

Rétablit l'appareil en mode USB et le libère.

Paramètres
tcpDevice	ITestDevice: l'appareil actuellement en mode tcp, précédemment alloué via connectToTcpDevice(String)

Renvoie
boolean	true si le passage en mode USB a réussi

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Générez une description conviviale contenant la liste des appareils connus, leur état et leurs valeurs. pour connaître les options IDeviceSelection couramment utilisées.

Paramètres
stream	PrintWriter: ERROR(/PrintWriter) utilisé pour la description.
includeStub	boolean: indique si les appareils bouchon doivent également être affichés.

runCmdOnAvailableDevice

public CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Méthode d'assistance permettant d'exécuter une commande shell sur un appareil disponible.

Paramètres
serial	String: numéro de série de l'appareil.
command	String: commande shell.
timeout	long: durée d'exécution de la commande.
timeUnit	TimeUnit: unité du délai avant expiration.

Renvoie
CommandResult	Un CommandResult.

ExécuterGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Exécutez une commande adb qui n'est pas ciblée sur un appareil particulier, par exemple adb connect

Renvoie
String	std output si la commande réussit null dans le cas contraire.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Allouer un appareil de façon abusive, même s'il n'est pas disponible actuellement

N'a aucun effet si l'appareil est déjà alloué.

Paramètres
serial	String: série de l'appareil à allouer

Renvoie
ITestDevice	ITestDevice ou null s'il n'a pas pu être alloué

FreeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Remettre un appareil dans le pool

Les tentatives de retour d'un appareil qui n'a pas été alloué précédemment seront ignorées.

Paramètres
device	ITestDevice: ITestDevice à sans frais.
deviceState	FreeDeviceState: FreeDeviceState. Permet de contrôler si l'appareil est renvoyé dans le pool d'appareils disponible.

getAdbPath

public String getAdbPath ()

Renvoie le chemin d'accès au binaire adb à utiliser.

Renvoie
String

getAdbVersion

public String getAdbVersion ()

Obtenez la version d'adb actuellement utilisée par le gestionnaire d'appareils.

Renvoie
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Renvoie le DeviceDescriptor avec le numéro de série donné.

Paramètres
serial	String: numéro de série de l'appareil à récupérer

Renvoie
DeviceDescriptor	la valeur DeviceDescriptor pour l'appareil sélectionné, ou la valeur "null" si le numéro de série correspondant à un appareil connu.

getFastbootPath

public String getFastbootPath ()

Renvoie le chemin d'accès au binaire fastboot à utiliser.

Renvoie
String

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

Initialisez le gestionnaire d'appareils. Il ne doit être appelé qu'une seule fois avant toute autre méthodes sont appelées.

Paramètres
globalDeviceFilter	IDeviceSelection
globalDeviceMonitors
deviceFactory	IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Initialisez le gestionnaire d'appareils. Il ne doit être appelé qu'une seule fois avant toute autre méthodes sont appelées.

Paramètres
globalDeviceFilter	IDeviceSelection: filtre d'appareil
globalDeviceMonitors

init

public void init ()

Initialisez le gestionnaire d'appareils. Il ne doit être appelé qu'une seule fois avant toute autre méthodes sont appelées.

isEmulator

public boolean isEmulator (String serial)

Déterminer si le numéro de série donné représente un émulateur

Paramètres
serial	String

Renvoie
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Indique si nous devons vérifier dans NativeDeviceStateMonitor si le système de fichiers est correctement fixée.

Renvoie
boolean

isNullDevice

public boolean isNullDevice (String serial)

Déterminer si le numéro de série donné représente un appareil nul

Paramètres
serial	String

Renvoie
boolean

killEmulator

public void killEmulator (ITestDevice device)

Arrêtez l'émulateur donné.

Bloque jusqu'à ce que l'émulateur disparaisse d'adb. N'aura aucun effet si l'émulateur ne l'est déjà pas disponibles.

Paramètres
device	ITestDevice: ITestDevice représentant l'émulateur à arrêter.

Génère
DeviceNotAvailableException

launchEmulator

public void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Méthode d'assistance pour lancer l'émulateur.

L'émulateur sera lancé comme spécifié par l'appelant.

Paramètres
device	ITestDevice: espace réservé ITestDevice représentant l'appareil d'émulateur alloué
bootTimeout	long: temps d'attente en ms pour le démarrage de l'émulateur.
emulatorArgs	: arguments de ligne de commande pour lancer l'émulateur

Génère
DeviceNotAvailableException

listTous les appareils

public  listAllDevices (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Paramètres
shortDescriptor	boolean: indique s'il faut limiter les descripteurs au minimum d'informations.

Renvoie
	une liste de DeviceDescriptor pour tous les appareils connus ;

listTous les appareils

public  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Renvoie
	une liste de DeviceDescriptor pour tous les appareils connus ;

reconnecterDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Une méthode d'assistance qui bascule le périphérique USB donné en mode adb-over-tcp, puis se connecte à via connectToTcpDevice(String).

Paramètres
usbDevice	ITestDevice: l'appareil actuellement en mode USB

Renvoie
ITestDevice	le ITestDevice nouvellement alloué en mode tcp ou null si un tcp Impossible d'établir la connexion

Génère
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Supprime un élément IDeviceMonitor précédemment ajouté. N'a aucun effet si "mon" n'a pas été ajouté.

Paramètres
mon	IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un écouteur n'est plus intéressé par les changements d'état de fastboot.

redémarrer votre AdbBridge

public void restartAdbBridge ()

Redémarrer (si stopAdbBridge() a été appelé) le pont et les services adb dépendent d'adb connexions externes.

stopAdbridge

public void stopAdbBridge ()

L'arrêt du pont et des services adb dépendent des connexions adb.

finis

public void terminate ()

Arrête les services de surveillance de l'appareil et la bibliothèque ddm.

Cette action doit être appelée à l'arrêt de l'application.

endDeviceMonitor

public void terminateDeviceMonitor ()

Arrêtez les moniteurs d'appareil.

résilierDeviceRecovery

public void terminateDeviceRecovery ()

Arrête le thread de récupération de l'appareil.

EndHard

public void terminateHard (String reason)

Comme terminateHard().

Paramètres
reason	String: motif facultatif fourni pour la résiliation.

EndHard

public void terminateHard ()

Semblable à terminate(), mais tente également de forcer l'arrêt d'adb.

WaitForFirstDeviceAjout

public boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier appareil physique soit connecté. Si un appareil a déjà été connecté, il renvoie directement True. Si aucun appareil n'a été ajouté, la valeur "false" est renvoyée après le délai d'inactivité.

Paramètres
timeout	long: temps d'attente en millisecondes avant de renvoyer la valeur "false".

Renvoie
boolean