IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Sous-classes indirectes connues Gestionnaire de périphériques Gestionnaire de périphériques

---

Interface de gestion de l'ensemble des appareils disponibles pour les tests.

Sommaire

Classes imbriquées
interface	IDeviceManager.IFastbootListener Un écouteur pour les changements d'état de démarrage rapide.

Méthodes publiques
abstract void	addDeviceMonitor ( IDeviceMonitor mon) Ajoute un IDeviceMonitor
abstract void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état du démarrage rapide.
abstract void	addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Ajoutez un périphérique au moniteur de démarrage rapide.
abstract ITestDevice	allocateDevice ( IDeviceSelection options, boolean isTemporary) Demandez un appareil à tester qui répond à certains critères.
abstract ITestDevice	allocateDevice ( IDeviceSelection options) Demandez un appareil à tester qui répond à certains critères.
abstract ITestDevice	allocateDevice () Demander un appareil physique pour le test
abstract ITestDevice	connectToTcpDevice (String ipAndPort) Se connecter à un appareil avec adb-over-tcp Cette méthode alloue un nouveau dispositif, qui doit finalement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) Le retourné ITestDevice sera en ligne, mais ne peut pas répondre.
abstract boolean	disconnectFromTcpDevice (ITestDevice tcpDevice) Déconnectez-vous d'un appareil connecté adb-over-tcp.
abstract void	displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Affiche une description conviviale contenant la liste des dispositifs connus, leur état et les valeurs couramment utilisées pour IDeviceSelection options.
abstract CommandResult	executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Une méthode d'assistance pour exécuter la commande shell sur le périphérique disponible.
abstract ITestDevice	forceAllocateDevice (String serial) Attribuez grossièrement un appareil, même s'il n'est pas disponible actuellement.
abstract void	freeDevice (ITestDevice device, FreeDeviceState state) Remettre un appareil dans la piscine Les tentatives de retour d'un périphérique qui n'a pas été précédemment alloué seront ignorées.
abstract String	getAdbPath () Renvoie le chemin d'accès au binaire adb à utiliser.
abstract String	getAdbVersion () Obtenez la version adb actuellement utilisée par le gestionnaire de périphériques.
abstract DeviceDescriptor	getDeviceDescriptor (String serial) Renvoie le DeviceDescriptor avec le numéro de série donné.
abstract String	getFastbootPath () Renvoie le chemin d'accès au binaire fastboot à utiliser.
abstract void	init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Initialisez le gestionnaire de périphériques avec un filtre de périphérique.
abstract void	init () Initialisez le gestionnaire de périphériques.
abstract boolean	isEmulator (String serial) Déterminer si la série donnée représente un émulateur
default boolean	isFileSystemMountCheckEnabled () Retourne si oui ou non nous devons vérifier dans NativeDeviceStateMonitor le système de fichiers est monté correctement.
abstract boolean	isNullDevice (String serial) Déterminer si le numéro de série donné représente un périphérique nul
abstract void	killEmulator (ITestDevice device) Arrêtez l'émulateur donné.
abstract void	launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Méthode d'assistance pour lancer l'émulateur.
abstract	listAllDevices () Renvoie une liste de DeviceDescriptors pour tous les appareils connus
abstract ITestDevice	reconnectDeviceToTcp (ITestDevice usbDevice) Une méthode d'assistance qui commute le dispositif USB en mode donné ADB-over-tcp, puis se connecte à elle par l' intermédiaire d' connectToTcpDevice(String) .
abstract void	removeDeviceMonitor ( IDeviceMonitor mon) Supprime un précédemment ajouté IDeviceMonitor .
abstract void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un auditeur n'est plus intéressé par les changements d'état du démarrage rapide.
abstract void	restartAdbBridge () Redémarrage (si stopAdbBridge() a été appelé) pont ADB et les services dépendent de la BAD connexions.
abstract void	stopAdbBridge () Arrêtez le pont adb et les services dépendent des connexions adb.
abstract void	terminate () Arrête les services de surveillance des périphériques et met fin à la bibliothèque ddm.
abstract void	terminateDeviceMonitor () Arrêtez les moniteurs de périphériques.
abstract void	terminateDeviceRecovery () Arrête le thread de récupération de périphérique.
default void	terminateHard (String reason) Comme terminateHard() .
abstract void	terminateHard () Comme terminate() , mais les tentatives de fermer avec force vers le bas adb aussi bien.
abstract boolean	waitForFirstDeviceAdded (long timeout) Attendez qu'un premier périphérique physique soit connecté.

Méthodes publiques

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Ajoute un IDeviceMonitor

Paramètres
mon	IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état du démarrage rapide.

Actuellement IDeviceManager ne contrôle des appareils à fastboot s'il y a un ou plus d' auditeurs actifs.

À FAIRE : c'est un peu un hack - trouver une meilleure solution

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Ajoutez un périphérique au moniteur de démarrage rapide. Le moniteur fastboot utilisera 'fastboot_serial' pour communiquer avec l'appareil.

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

allouerAppareil

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Demandez un appareil à tester qui répond à certains critères.

Paramètres
options	IDeviceSelection : le IDeviceSelection l'appareil doit répondre.
isTemporary	boolean : si oui ou non un nulldevice temporaire doit être créé.

Retour
ITestDevice	un ITestDevice pour le test, ou null si l' on est pas disponible

allouerAppareil

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Demandez un appareil à tester qui répond à certains critères.

Paramètres
options	IDeviceSelection : le IDeviceSelection l'appareil doit répondre.

Retour
ITestDevice	un ITestDevice pour le test, ou null si l' on est pas disponible

allouerAppareil

public abstract ITestDevice allocateDevice ()

Demander un appareil physique pour le test

Retour
ITestDevice	un ITestDevice pour le test, ou null si l' on est pas disponible

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

Cette méthode alloue un nouveau dispositif, qui doit finalement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

On notera que la réalisation des mesures telles que le redémarrage d'un appareil connecté à tcp, va rompre la connexion TCP au dispositif, et le résultat dans un DeviceNotAvailableException

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

Retour
ITestDevice	la ITestDevice ou null si une connexion TCP n'a pas pu être formée

déconnecterFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

Remet l'appareil en mode USB et le libère.

Paramètres
tcpDevice	ITestDevice : le dispositif actuellement en mode de tcp, précédemment alloué par connectToTcpDevice(String)

Retour
boolean	true si le commutateur en mode USB a réussi

afficherAppareilsInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Affiche une description conviviale contenant la liste des dispositifs connus, leur état et les valeurs couramment utilisées pour IDeviceSelection options.

Paramètres
printWriter	PrintWriter : l' ERROR(/PrintWriter) pour délivrer en sortie la description de
includeStub	boolean : Que ce soit ou non à des dispositifs stub d'affichage aussi.

executeCmdOnAvailableDevice

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

Une méthode d'assistance pour exécuter la commande shell sur le périphérique disponible.

Paramètres
serial	String : Le numéro de série de l' appareil.
command	String : La commande shell.
timeout	long : La quantité de temps pour la commande complète.
timeUnit	TimeUnit : L'unité de délai d' attente.

Retour
CommandResult	Un CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Attribuez grossièrement un appareil, même s'il n'est pas disponible actuellement.

N'aura aucun effet si le périphérique est déjà alloué.

Paramètres
serial	String : le numéro de série de l' appareil d'allouer

Retour
ITestDevice	la ITestDevice ou null si elle ne pouvait pas être attribué

appareil gratuit

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Remettre un appareil dans la piscine

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

Paramètres
device	ITestDevice : le ITestDevice au libre
state	FreeDeviceState : le FreeDeviceState . Utilisé pour contrôler si le périphérique est renvoyé au pool de périphériques disponible.

getAdbPath

public abstract String getAdbPath ()

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

Retour
String

getAdbVersion

public abstract String getAdbVersion ()

Obtenez la version adb actuellement utilisée par le gestionnaire de périphériques.

Retour
String

getDeviceDescriptor

public abstract 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 pour obtenir

Retour
DeviceDescriptor	le DeviceDescriptor pour le dispositif sélectionné, ou une valeur nulle si le numéro de série ne correspond pas à un dispositif connu.

getFastbootPath

public abstract String getFastbootPath ()

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

Retour
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Initialisez le gestionnaire de périphériques avec un filtre de périphérique. Ce filtre peut être utilisé pour demander au DeviceManager d'ignorer certains appareils connectés.

Paramètres
globalDeviceFilter	IDeviceSelection : le filtre de l' appareil
deviceMonitors

init

public abstract void init ()

Initialisez le gestionnaire de périphériques. Cela doit être appelé une et une seule fois avant que toute autre méthode ne soit appelée.

isEmulator

public abstract boolean isEmulator (String serial)

Déterminer si la série donnée représente un émulateur

Paramètres
serial	String

Retour
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Retourne si oui ou non nous devons vérifier dans NativeDeviceStateMonitor le système de fichiers est monté correctement.

Retour
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Déterminer si le numéro de série donné représente un périphérique nul

Paramètres
serial	String

Retour
boolean

killEmulator

public abstract 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 n'est déjà pas disponible.

Paramètres
device	ITestDevice : l' ITestDevice émulateur représentant pour fermer

Jetés
DeviceNotAvailableException	si l'émulateur ne s'arrête pas

lancerEmulateur

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

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

Lancera l'émulateur comme spécifié par l'appelant

Paramètres
device	ITestDevice : l'espace réservé ITestDevice représentant dispositif d'émulation alloué
bootTimeout	long : le temps en ms pour attendre l'émulateur pour démarrer
emulatorArgs	: arguments de ligne de commande pour lancer l'émulateur

Jetés
DeviceNotAvailableException	si l'émulateur ne démarre pas ou ne se connecte pas

listeTous les appareils

public abstract  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

Retour
	une liste de DeviceDescriptor pour tous les appareils connus

reconnecter l'appareil à TCP

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Une méthode d'assistance qui commute le dispositif USB en mode donné ADB-over-tcp, puis se connecte à elle par l' intermédiaire d' connectToTcpDevice(String) .

Paramètres
usbDevice	ITestDevice : le dispositif actuellement en mode USB

Retour
ITestDevice	le nouvellement allouée ITestDevice en mode TCP ou null si une connexion TCP n'a pas pu être formée

Jetés
DeviceNotAvailableException	si la connexion avec usbDevice a été perdue et n'a pas pu être récupéré

supprimerDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Supprime un précédemment ajouté IDeviceMonitor . N'a aucun effet si lun n'a pas été ajouté.

Paramètres
mon	IDeviceMonitor

supprimerFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un auditeur n'est plus intéressé par les changements d'état du démarrage rapide.

redémarrerAdbBridge

public abstract void restartAdbBridge ()

Redémarrage (si stopAdbBridge() a été appelé) pont ADB et les services dépendent de la BAD connexions.

stopAdbBridge

public abstract void stopAdbBridge ()

Arrêtez le pont adb et les services dépendent des connexions adb.

mettre fin

public abstract void terminate ()

Arrête les services de surveillance des périphériques et met fin à la bibliothèque ddm.

Celui-ci doit être appelé à la fin de l'application.

Voir également:

• AndroidDebugBridge.terminate()

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Arrêtez les moniteurs de périphériques.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Arrête le thread de récupération de périphérique.

terminerDur

public void terminateHard (String reason)

Comme terminateHard() .

Paramètres
reason	String : option raison donnée pour la fin.

terminerDur

public abstract void terminateHard ()

Comme terminate() , mais les tentatives de fermer avec force vers le bas adb aussi bien.

attendrePremierAppareilAjouté

public abstract boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier périphérique physique soit connecté. Si un appareil était connecté auparavant, il renvoie directement True. Si aucun périphérique n'a été ajouté, il renvoie false après expiration du délai.

Paramètres
timeout	long : le temps d'attente en milliseconde avant de retourner faux.

Retour
boolean