Gestionnaire de périphériques

public class DeviceManager
extends Object implements IDeviceManager en implements IDeviceManager

java.lang.Object
?? com.android.tradefed.device.DeviceManager


Sommaire

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 extrait du GlobalConfiguration

Méthodes publiques

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

Ajoute un IDeviceMonitor

void addFastbootListener ( IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état du démarrage rapide.

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 le test

ITestDevice connectToTcpDevice (String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

Cette méthode alloue un nouveau dispositif, qui doit finalement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Le retourné ITestDevice sera en ligne, mais ne peut pas répondre.

boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

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

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

Une méthode d'assistance pour exécuter la commande shell sur le 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)

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

void freeDevice (ITestDevice device, FreeDeviceState deviceState)

Remettre un appareil dans la piscine

Les tentatives de retour d'un périphérique 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 ()

Retourne si oui ou non nous devons vérifier dans NativeDeviceStateMonitor 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 ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Une méthode d'assistance qui commute le dispositif USB en mode donné ADB-over-tcp, puis se connecte à elle par l' intermédiaire d' connectToTcpDevice(String) .

void removeDeviceMonitor ( IDeviceMonitor mon)

Supprime un précédemment ajouté IDeviceMonitor .

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un auditeur n'est plus intéressé par les changements d'état du démarrage rapide.

void restartAdbBridge ()

Redémarrage (si stopAdbBridge() a été appelé) pont ADB et les services dépendent de la BAD connexions.

void stopAdbBridge ()

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

void terminate ()

Arrête les services de surveillance des périphériques 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 de périphérique.

void terminateHard (String reason)

Comme terminateHard() .

void terminateHard ()

Comme terminate() , mais les tentatives de fermer avec force vers le bas adb aussi bien.

boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier périphérique 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

mFastbootActivé

protected boolean mFastbootEnabled

Constructeurs publics

Gestionnaire de périphériques

public DeviceManager ()

Le DeviceManager doit être extrait 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

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état du démarrage rapide.

Actuellement IDeviceManager ne contrôle des appareils à fastboot s'il y a un ou plus d' auditeurs actifs.

À FAIRE : c'est un peu un hack - trouver 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 : numéro de série de l'appareil.

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

allouerAppareil

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

Paramètres
options IDeviceSelection : le IDeviceSelection l'appareil doit répondre.

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

Retour
ITestDevice un ITestDevice pour le test, ou null si l' on est pas disponible

allouerAppareil

public ITestDevice allocateDevice (IDeviceSelection options)

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

Paramètres
options IDeviceSelection : le IDeviceSelection l'appareil doit répondre.

Retour
ITestDevice un ITestDevice pour le test, ou null si l' on est pas disponible

allouerAppareil

public ITestDevice allocateDevice ()

Demander un appareil physique pour le test

Retour
ITestDevice un ITestDevice pour le test, ou null si l' on est pas disponible

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Se connecter à un appareil avec adb-over-tcp

Cette méthode alloue un nouveau dispositif, qui doit finalement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Le retourné ITestDevice sera en ligne, mais ne peut pas répondre.

On notera que la réalisation des mesures telles que le redémarrage d'un appareil connecté à tcp, va rompre la connexion TCP au dispositif, et le résultat dans un DeviceNotAvailableException

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

Retour
ITestDevice la ITestDevice ou null si une connexion TCP n'a pas pu être formée

déconnecterDePériphériqueTcp

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 : le dispositif actuellement en mode de tcp, précédemment alloué par connectToTcpDevice(String)

Retour
boolean true si le commutateur en mode USB a réussi

afficherAppareilsInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

Paramètres
stream PrintWriter : l' ERROR(/PrintWriter) pour délivrer en sortie la description de

includeStub boolean : Que ce soit ou non à des dispositifs stub d'affichage aussi.

executeCmdOnAvailableDevice

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

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

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

command String : La commande shell.

timeout long : La quantité de temps pour la commande complète.

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

Retour
CommandResult Un CommandResult .

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

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

Retour
String sortie std si la commande successm null sinon.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

N'aura aucun effet si le périphérique est déjà alloué.

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

Retour
ITestDevice la ITestDevice ou null si elle ne pouvait pas être attribué

appareil gratuit

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Remettre un appareil dans la piscine

Les tentatives de retour d'un périphérique qui n'a pas été précédemment alloué seront ignorées.

Paramètres
device ITestDevice : le ITestDevice au libre

deviceState FreeDeviceState : le FreeDeviceState . Utilisé pour contrôler si le périphérique est renvoyé au 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 pour obtenir

Retour
DeviceDescriptor le DeviceDescriptor pour le dispositif sélectionné, ou une valeur nulle si le numéro de série ne correspond pas à un dispositif connu.

getFastbootPath

public String getFastbootPath ()

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

Retour
String

init

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

init

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 de l' appareil

globalDeviceMonitors

init

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.

isEmulator

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

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

Retour
boolean

isNullDevice

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 : l' ITestDevice émulateur représentant pour fermer

Jetés
DeviceNotAvailableException

lancerEmulateur

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 dispositif d'émulation alloué

bootTimeout long : le temps en ms pour attendre l'émulateur pour démarrer

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

Jetés
DeviceNotAvailableException

listAllDevices

public  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

Retour
une liste de DeviceDescriptor pour tous les appareils connus

reconnecter l'appareil à TCP

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Une méthode d'assistance qui commute le dispositif USB en mode donné ADB-over-tcp, puis se connecte à elle par l' intermédiaire d' connectToTcpDevice(String) .

Paramètres
usbDevice ITestDevice : le dispositif actuellement en mode USB

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

Jetés
DeviceNotAvailableException

supprimerDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Supprime un précédemment ajouté IDeviceMonitor . N'a aucun effet si lun 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 du démarrage rapide.

redémarrerAdbBridge

public void restartAdbBridge ()

Redémarrage (si stopAdbBridge() a été appelé) pont ADB et les services dépendent de la BAD connexions.

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 périphériques et met fin à la bibliothèque ddm.

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

terminateDeviceMonitor

public void terminateDeviceMonitor ()

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

terminateDeviceRecovery

public void terminateDeviceRecovery ()

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

terminerDur

public void terminateHard (String reason)

Comme terminateHard() .

Paramètres
reason String : option raison donnée pour la fin.

terminerDur

public void terminateHard ()

Comme terminate() , mais les tentatives de fermer avec force vers le bas adb aussi bien.

attendrePremierAppareilAjouté

public boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier périphérique physique soit connecté. Si un appareil était connecté auparavant, 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 : le temps d'attente en milliseconde avant de retourner faux.

Retour
boolean