Gestionnaire d'appareils

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 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)

Ajouter un appareil au moniteur Fastboot

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice(IDeviceSelection options)

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

abstract ITestDevice allocateDevice()

Demander un appareil physique à des fins de test

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

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

abstract void displayDevicesInfo(PrintWriter printWriter, 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.

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)

Allouer un appareil de façon grossière, même s'il n'est pas disponible actuellement.

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é alloué 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 le 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 fixée.

abstract boolean isNullDevice(String serial)

Déterminer si le 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)

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

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Supprime un élément 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émarrer (si stopAdbBridge() a été appelé) le pont et les services adb dépendent d'adb connexions externes.

abstract void stopAdbBridge()

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

abstract void terminate()

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

abstract void terminateDeviceMonitor()

Arrêtez les moniteurs d'appareil.

abstract void terminateDeviceRecovery()

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

default void terminateHard(String reason)

Comme terminateHard().

abstract void terminateHard()

Semblable à terminate(), mais tente également de forcer l'arrêt d'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 fastboot que s'il en existe un ou plus d'écouteurs actifs.

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

addMonitoringTcpFastbootDevice

public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 abstract void displayDevicesInfo (PrintWriter printWriter, 
                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
printWriter PrintWriter: ERROR(/PrintWriter) utilisé pour la description.
includeStub boolean: indique si les appareils bouchon doivent également être affichés.

runCmdOnAvailableDevice

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)

Allouer un appareil de façon grossière, même s'il n'est pas disponible actuellement.

Cela n'aura 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 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é alloué précédemment seront ignorées.

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

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 à 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 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 indiquer le DeviceManager d'ignorer certains appareils connectés.

Paramètres
globalDeviceFilter IDeviceSelection: filtre d'appareil
deviceMonitors

init

public abstract 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 abstract 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 abstract 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 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 ne l'est déjà pas disponibles.

Paramètres
device ITestDevice: ITestDevice représentant l'émulateur à arrêter.
Génère
DeviceNotAvailableException si l'émulateur ne s'arrête pas

launchEmulator

public abstract 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 si l'émulateur ne démarre pas ou se connecte

listTous les appareils

public abstract  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 abstract  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus.

Renvoie
une liste de DeviceDescriptor pour tous les appareils connus ;

reconnecterDeviceToTcp

public abstract 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 si la connexion avec usbDevice a été perdue et n'a pas pu être récupérée.

removeDeviceMonitor

public abstract 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 abstract 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 abstract void restartAdbBridge ()

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

stopAdbridge

public abstract void stopAdbBridge ()

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

finis

public abstract 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 abstract void terminateDeviceMonitor ()

Arrêtez les moniteurs d'appareil.

résilierDeviceRecovery

public abstract 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 abstract void terminateHard ()

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

WaitForFirstDeviceAjout

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