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 |
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
L' |
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 |
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,
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 |
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,
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 |
abstract
void
|
removeDeviceMonitor(IDeviceMonitor mon)
Supprime un |
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 |
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 |
abstract
void
|
terminateHard()
Comme |
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 abstractlistAllDevices (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 abstractlistAllDevices ()
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.
Voir aussi :
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 |