DeviceManager

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. 

Constantes

String UNKNOWN_DISPLAY_STRING

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

Champs

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 addAvailableNativeDevice(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 fastbootSerial)

Ajoutez un appareil au moniteur fastboot.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Demandez un appareil pour effectuer des tests qui répondent à certains critères.

ITestDevice allocateDevice(IDeviceSelection options)

Demandez un appareil pour effectuer des tests qui répondent à certains critères.

ITestDevice allocateDevice()

Demander un appareil physique pour les tests

ITestDevice connectToTcpDevice(String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

Cette méthode alloue un nouvel appareil, qui doit être libéré par la suite via disconnectFromTcpDevice(ITestDevice).

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

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

void displayDevicesInfo(PrintWriter stream, boolean includeStub)

Générez une description conviviale contenant la liste des appareils connus, leur état et les valeurs des 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 non ciblée sur un appareil particulier, par exemple :

ITestDevice forceAllocateDevice(String serial)

Alloue un appareil de manière impolie, même s'il n'est pas disponible actuellement.

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Renvoyer un appareil dans le pool

Toute tentative de renvoi d'un appareil qui n'a pas été attribué précédemment sera ignorée.

String getAdbPath()

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

String getAdbVersion()

Obtenez la version 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.

long getShellCheckCmdTime()

Obtient le délai avant expiration en ms de la commande de vérification de la disponibilité du shell.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Initialisez le gestionnaire d'appareils.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> 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 que NativeDeviceStateMonitor le système de fichiers est correctement installé.

boolean isNullDevice(String serial)

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

void killEmulator(ITestDevice device)

Éteignez l'émulateur donné.

void launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, List<String> emulatorArgs)

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

List<DeviceDescriptor> listAllDevices(boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

List<DeviceDescriptor> listAllDevices()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

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

void removeDeviceMonitor(IDeviceMonitor mon)

Supprime un 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 removeMonitoringTcpFastbootDevice(String serial)

void restartAdbBridge()

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

void stopAdbBridge()

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

void terminate()

Arrête les services de surveillance des appareils et met fin à la bibliothèque DDM.

void terminateDeviceMonitor()

Arrêtez les moniteurs d'appareils.

void terminateDeviceRecovery()

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

void terminateHard(String reason)

Comme terminateHard().

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

Attendez qu'un premier appareil physique soit connecté.

Constantes

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

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

Valeur constante : "unknown"

Champs

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Constructeurs publics

DeviceManager

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

addAvailableNativeDevice

public void addAvailableNativeDevice (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 mode Fastboot que s'il y a un ou plusieurs écouteurs actifs.

TODO: this is a bit of a hack - find a better solution

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

Ajoutez 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.
fastbootSerial String : numéro de série du mode Fastboot de l'appareil.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Demandez un appareil pour effectuer des tests qui répondent à 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 ITestDevice pour les tests ou null si aucun n'est disponible

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

Demandez un appareil pour effectuer des tests qui répondent à certains critères.

Paramètres
options IDeviceSelection : IDeviceSelection que l'appareil doit respecter.
Renvoie
ITestDevice ITestDevice pour les tests ou null si aucun n'est disponible

allocateDevice

public ITestDevice allocateDevice ()

Demander un appareil physique pour les tests

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 être libéré par la suite via disconnectFromTcpDevice(ITestDevice).

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

Notez que si vous effectuez une action telle qu'un redémarrage sur un appareil connecté en TCP, la connexion TCP à l'appareil sera interrompue et un 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

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

Repasse l'appareil en mode USB 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 void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

Paramètres
stream PrintWriter : PrintWriter dans lequel afficher la description
includeStub boolean : indique si les périphériques stub doivent également être affichés.

executeCmdOnAvailableDevice

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 d'inactivité.
Renvoie
CommandResult CommandResult

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Exécutez une commande adb non ciblée sur un appareil particulier, par exemple : adb connect

Renvoie
String Sortie standard si la commande réussit, null dans le cas contraire.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Alloue un appareil de manière impolie, même s'il n'est pas disponible actuellement.

N'aura aucun effet si l'appareil est déjà attribué.

Paramètres
serial String : numéro de série de l'appareil à attribuer
Renvoie
ITestDevice ITestDevice ou null si elle n'a pas pu être allouée

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Renvoyer un appareil dans le pool

Toute tentative de renvoi d'un appareil qui n'a pas été attribué précédemment sera ignorée.

Paramètres
device ITestDevice : ITestDevice à libérer
deviceState FreeDeviceState : FreeDeviceState. Permet de contrôler si l'appareil est renvoyé au pool d'appareils disponibles.

getAdbPath

public String getAdbPath ()

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

Renvoie
String

getAdbVersion

public String getAdbVersion ()

Obtenez la version 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 à obtenir
Renvoie
DeviceDescriptor DeviceDescriptor pour l'appareil sélectionné, ou null si le numéro de série ne correspond à aucun appareil connu.

getFastbootPath

public String getFastbootPath ()

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

Renvoie
String

getShellCheckCmdTime

public long getShellCheckCmdTime ()

Obtient le délai avant expiration en ms de la commande de vérification de la disponibilité du shell.

Renvoie
long

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

Paramètres
globalDeviceFilter IDeviceSelection

globalDeviceMonitors List

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors)

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

Paramètres
globalDeviceFilter IDeviceSelection : filtre d'appareil
globalDeviceMonitors List

init

public void init ()

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

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 que NativeDeviceStateMonitor le système de fichiers est correctement installé.

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)

Éteignez 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 : ITestDevice représentant l'émulateur à éteindre
Génère
DeviceNotAvailableException

launchEmulator

public void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                List<String> emulatorArgs)

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

Lance l'émulateur tel que spécifié par l'appelant

Paramètres
device ITestDevice : espace réservé ITestDevice représentant l'appareil émulateur attribué
bootTimeout long : délai d'attente en ms pour le démarrage de l'émulateur
emulatorArgs List : arguments de ligne de commande pour lancer l'émulateur
Génère
DeviceNotAvailableException

listAllDevices

public List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Paramètres
shortDescriptor boolean : indique s'il faut limiter les descriptions aux informations minimales.
Renvoie
List<DeviceDescriptor> Liste des DeviceDescriptor pour tous les appareils connus

listAllDevices

public List<DeviceDescriptor> listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Renvoie
List<DeviceDescriptor> Liste des DeviceDescriptor pour tous les appareils connus

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

Paramètres
usbDevice ITestDevice : appareil 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

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Supprime un IDeviceMonitor précédemment ajouté. Cette option n'a aucun effet si le 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.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Paramètres
serial String

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

résilier [context sensitive, see specific definition]

public void terminate ()

Arrête les services de surveillance des appareils et met fin à la bibliothèque DDM.

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

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Arrêtez les moniteurs d'appareils.

terminateDeviceRecovery

public void terminateDeviceRecovery ()

Arrête le 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 void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

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

Paramètres
timeout long : délai d'attente en millisecondes avant de renvoyer "false".
Renvoie
boolean