IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


Interface permettant de gérer l'ensemble des appareils disponibles pour les tests.

Résumé

Classes imbriquées

interface IDeviceManager.IFastbootListener

Écouteur des changements d'état de Fastboot. 

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 de Fastboot.

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Ajout d'un appareil au moniteur fastboot.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice(IDeviceSelection options)

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

abstract ITestDevice allocateDevice()

Demander un appareil physique pour les tests

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

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

L'ITestDevice renvoyé sera en ligne, mais il est possible qu'il ne soit pas réactif.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Se déconnecter d'un appareil connecté via adb-over-tcp

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

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

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

abstract ITestDevice forceAllocateDevice(String serial)

Attribuez un appareil de manière inappropriée, même s'il n'est pas disponible pour le moment.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Remettre un appareil dans le pool

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

abstract String getAdbPath()

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

abstract String getAdbVersion()

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

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)

Initialisez le Gestionnaire d'appareils avec un filtre d'appareil.

abstract void init()

Initialisez le gestionnaire d'appareils.

abstract boolean isEmulator(String serial)

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

default boolean isFileSystemMountCheckEnabled()

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

abstract boolean isNullDevice(String serial)

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

abstract void killEmulator(ITestDevice device)

Arrêtez l'émulateur donné.

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

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

abstract listAllDevices(boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

abstract listAllDevices()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Méthode d'assistance qui met l'appareil USB donné en mode adb-over-tcp, puis s'y connecte via connectToTcpDevice(String).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Supprime un IDeviceMonitor précédemment ajouté.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

abstract void restartAdbBridge()

Redémarrez (si stopAdbBridge() a été appelé) le pont ADB et les services qui dépendent des connexions ADB.

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 de l'appareil et met fin à la bibliothèque ddm.

abstract void terminateDeviceMonitor()

Arrêtez les moniteurs d'appareils.

abstract void terminateDeviceRecovery()

Arrêt du thread de récupération de l'appareil.

default void terminateHard(String reason)

comme terminateHard().

abstract void terminateHard()

Comme terminate(), mais tente également d'arrêter de force adb.

abstract boolean waitForFirstDeviceAdded(long timeout)

Attendez qu'un premier appareil 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 de Fastboot.

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

À FAIRE: il s'agit d'un bidouillage. Trouvez une meilleure solution.

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Ajout d'un appareil au moniteur fastboot. 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: numéro de série de l'appareil en mode Fastboot.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

Paramètres
options IDeviceSelection: IDeviceSelection que l'appareil doit respecter.

isTemporary boolean: indique si un NullDevice temporaire doit être créé ou non.

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

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

Paramètres
options IDeviceSelection: IDeviceSelection que l'appareil doit respecter.

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

allocateDevice

public abstract ITestDevice allocateDevice ()

Demander un appareil physique pour les tests

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

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

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

L'ITestDevice renvoyé sera en ligne, mais il est possible qu'il ne soit pas réactif.

Notez que l'exécution d'une action telle qu'un redémarrage sur un appareil connecté par TCP interrompt la connexion TCP à l'appareil et génère une DeviceNotAvailableException

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

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

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Se déconnecter d'un appareil connecté via adb-over-tcp

Réactive le mode USB de l'appareil et le libère.

Paramètres
tcpDevice ITestDevice: 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 abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

Paramètres
printWriter PrintWriter: ERROR(/PrintWriter) à utiliser pour générer la description

includeStub boolean: indique si les appareils fictifs doivent également s'afficher.

executeCmdOnAvailableDevice

public abstract 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.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Attribuez un appareil de manière inappropriée, même s'il n'est pas disponible pour le moment.

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

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

Renvoie
ITestDevice le ITestDevice ou null si l'allocation a échoué

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Remettre un appareil dans le pool

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

Paramètres
device ITestDevice: ITestDevice à libérer

state FreeDeviceState: le FreeDeviceState. Permet de contrôler si l'appareil est renvoyé au pool d'appareils disponibles.

getAdbPath

public abstract String getAdbPath ()

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

Renvoie
String

getAdbVersion

public abstract String getAdbVersion ()

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

Renvoie
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 à obtenir

Renvoie
DeviceDescriptor DeviceDescriptor de l'appareil sélectionné, ou valeur nulle si le numéro de série ne correspond pas à un appareil connu.

getFastbootPath

public abstract String getFastbootPath ()

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

Renvoie
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Initialisez le Gestionnaire d'appareils avec un filtre d'appareil. Ce filtre peut être utilisé pour demander à DeviceManager d'ignorer certains appareils connectés.

Paramètres
globalDeviceFilter IDeviceSelection: filtre de l'appareil

deviceMonitors

init

public abstract void init ()

Initialisez le gestionnaire d'appareils. Cette méthode doit être appelée une seule fois avant toute autre méthode.

isEmulator

public abstract boolean isEmulator (String serial)

Déterminer si un 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 installé.

Renvoie
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

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

Paramètres
serial String

Renvoie
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Arrêtez l'émulateur donné.

Bloque jusqu'à ce que l'émulateur disparaisse d'adb. N'a aucun effet si l'émulateur n'est pas déjà disponible.

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

Génère
DeviceNotAvailableException si l'émulateur ne parvient pas à s'arrêter

launchEmulator

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

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

Lance l'émulateur 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) avant le démarrage de l'émulateur

emulatorArgs : arguments de ligne de commande pour lancer l'émulateur

Génère
DeviceNotAvailableException Si l'émulateur ne démarre pas ou ne se connecte pas

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Paramètres
shortDescriptor boolean: indique si les descripteurs doivent être limités aux informations minimales.

Renvoie
une liste de DeviceDescriptor pour tous les appareils connus ;

listAllDevices

public abstract  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Renvoie
une liste de DeviceDescriptor pour tous les appareils connus ;

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Méthode d'assistance qui met l'appareil USB donné en mode adb-over-tcp, puis s'y connecte via connectToTcpDevice(String).

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

Renvoie
ITestDevice ITestDevice nouvellement alloué en mode TCP ou null si une connexion TCP n'a pas pu être établie

Génère
DeviceNotAvailableException si la connexion avec usbDevice a été perdue et qu'elle n'a pas pu être récupérée

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Supprime un IDeviceMonitor précédemment ajouté. Cette commande n'a aucun effet si le paramètre "mon" n'a pas été ajouté.

Paramètres
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public abstract void restartAdbBridge ()

Redémarrez (si stopAdbBridge() a été appelé) le pont ADB et les services qui dépendent des connexions ADB.

stopAdbBridge

public abstract void stopAdbBridge ()

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

finis

public abstract void terminate ()

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

Cette méthode doit être appelée à la fin de l'application.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Arrêtez les moniteurs d'appareils.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Arrêt du thread de récupération de l'appareil.

terminateHard

public void terminateHard (String reason)

comme terminateHard().

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

terminateHard

public abstract void terminateHard ()

Comme terminate(), mais tente également d'arrêter de force adb.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier appareil physique soit connecté. Si un appareil était connecté auparavant, la valeur renvoyée est directement "True". Si aucun appareil n'a été ajouté, la valeur renvoyée est "false" après le délai avant expiration.

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

Renvoie
boolean