Gestionnaire de périphériques

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.

Des champs

public static final String UNKNOWN_DISPLAY_STRING

Afficher la chaîne pour les propriétés inconnues

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Constructeurs publics

DeviceManager ()

Le DeviceManager doit être récupéré à partir du GlobalConfiguration

Méthodes publiques

void addAvailableDevice (IDevice stubDevice)
void addDeviceMonitor ( IDeviceMonitor mon)

Ajoute un IDeviceMonitor

void addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener ( IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un auditeur est intéressé par les changements d'état de fastboot.

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Ajoutez un périphérique au moniteur de démarrage rapide.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice ( IDeviceSelection options)

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

ITestDevice allocateDevice ()

Demander un appareil physique pour les tests

ITestDevice connectToTcpDevice (String ipAndPort)

Connectez-vous à un appareil avec adb-over-tcp

Cette méthode alloue un nouveau périphérique, qui devrait éventuellement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Le ITestDevice renvoyé sera en ligne, mais pourrait ne pas répondre.

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Déconnectez-vous d’un appareil connecté 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)

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

String executeGlobalAdbCommand (String... cmdArgs)

Exécutez une commande adb non ciblée sur un périphérique particulier, par exemple.

ITestDevice forceAllocateDevice (String serial)

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

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Remettre un appareil dans le pool

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

String getAdbPath ()

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

String getAdbVersion ()

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

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.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Initialisez le gestionnaire de périphériques.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Initialisez le gestionnaire de périphériques.

void init ()

Initialisez le gestionnaire de périphériques.

boolean isEmulator (String serial)

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

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

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

void killEmulator ( ITestDevice device)

Arrêtez l'émulateur donné.

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.

listAllDevices (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

Une méthode d'assistance qui fait passer le périphérique 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 auditeur n'est plus intéressé par les changements d'état de fastboot.

void restartAdbBridge ()

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

void stopAdbBridge ()

Arrêtez le pont adb et les services 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 de périphériques.

void terminateDeviceRecovery ()

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

void terminateHard (String reason)

Comme terminateHard() .

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier appareil physique soit connecté.

Des champs

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Afficher la chaîne pour les propriétés inconnues

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Constructeurs publics

Gestionnaire de périphériques

public DeviceManager ()

Le DeviceManager doit être récupéré à partir du GlobalConfiguration

Méthodes publiques

addAvailableDevice

public void addAvailableDevice (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 auditeur est intéressé par les changements d'état de fastboot.

Actuellement, un IDeviceManager ne surveillera les appareils en démarrage rapide que s'il y a un ou plusieurs écouteurs actifs.

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

addMonitoringTcpFastbootDevice

public 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 : le numéro de série de l'appareil.

fastboot_serial String : le numéro de série du mode fastboot de l'appareil.

allouerDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

Retour
ITestDevice un ITestDevice pour les tests, ou null s'il n'y en a pas un

allouerDevice

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

Retour
ITestDevice un ITestDevice pour les tests, ou null s'il n'y en a pas un

allouerDevice

public ITestDevice allocateDevice ()

Demander un appareil physique pour les tests

Retour
ITestDevice un ITestDevice pour les tests, ou null s'il n'y en a pas un

connecterToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Connectez-vous à un appareil avec adb-over-tcp

Cette méthode alloue un nouveau périphérique, qui devrait éventuellement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Le ITestDevice renvoyé sera en ligne, mais pourrait ne pas répondre.

Notez que l'exécution d'une action telle qu'un redémarrage sur un appareil connecté à TCP rompra la connexion TCP à l'appareil et entraînera une DeviceNotAvailableException .

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

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

déconnecterFromTcpDevice

public 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 : l'appareil actuellement en mode TCP, précédemment alloué via connectToTcpDevice(String)

Retour
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 : l' ERROR(/PrintWriter) vers laquelle afficher la description

includeStub boolean : s'il faut ou non afficher également les périphériques stub.

exécuterCmdOnAvailableDevice

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

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

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

command String : La commande shell.

timeout long : Le temps nécessaire à l'exécution de la commande.

timeUnit TimeUnit : L'unité du délai d'attente.

Retour
CommandResult Un CommandResult .

exécuterGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Exécutez une commande adb non ciblée sur un périphérique particulier, par exemple. 'connexion adb'

Retour
String sortie std si la commande réussit null sinon.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

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

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

Retour
ITestDevice le ITestDevice , ou null s'il n'a pas pu être alloué

appareil gratuit

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Remettre un appareil dans le pool

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

Paramètres
device ITestDevice : le ITestDevice à libérer

deviceState FreeDeviceState : le FreeDeviceState . Utilisé pour contrôler si le périphérique est renvoyé dans le pool de périphériques disponible.

getAdbPath

public String getAdbPath ()

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

Retour
String

getAdbVersion

public String getAdbVersion ()

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

Retour
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

Retour
DeviceDescriptor le DeviceDescriptor pour le périphérique sélectionné, ou null si le numéro de série ne correspond pas à un périphérique connu.

getFastbootPath

public String getFastbootPath ()

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

Retour
String

initialisation

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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.

Paramètres
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

initialisation

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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.

Paramètres
globalDeviceFilter IDeviceSelection : le filtre des appareils

globalDeviceMonitors

initialisation

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

estEmulator

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

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

Retour
boolean

estNullDevice

public 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 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 : le ITestDevice représentant l'émulateur à arrêter

Jetés
DeviceNotAvailableException

lancer l'émulateur

public 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 le périphérique d'émulation alloué

bootTimeout long : le temps en ms d'attente pour que l'émulateur démarre

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

Jetés
DeviceNotAvailableException

listTous les appareils

public  listAllDevices (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

Paramètres
shortDescriptor boolean : s'il faut limiter les descripteurs au minimum d'informations

Retour
une liste de DeviceDescriptor pour tous les appareils connus

listTous les appareils

public  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

Retour
une liste de DeviceDescriptor pour tous les appareils connus

reconnecterDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

Jetés
DeviceNotAvailableException

supprimerDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Paramètres
mon IDeviceMonitor

supprimerFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

redémarrerAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

mettre fin

public void terminate ()

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

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

terminerDeviceMonitor

public void terminateDeviceMonitor ()

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

terminerDeviceRecovery

public void terminateDeviceRecovery ()

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

terminerDur

public void terminateHard (String reason)

Comme terminateHard() .

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

terminerDur

public void terminateHard ()

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

waitForFirstDeviceAdded

public 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 périphérique n'a été ajouté, il renvoie false après l'expiration du délai.

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

Retour
boolean