IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


Interface de gestion de l'ensemble des appareils disponibles pour les tests.

Sommaire

Classes imbriquées

interface IDeviceManager.IFastbootListener

Un écouteur pour les changements d'état de démarrage rapide.

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 du démarrage rapide.

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

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

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice ( IDeviceSelection options)

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

abstract ITestDevice allocateDevice ()

Demander un appareil physique pour le test

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

abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

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

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

abstract ITestDevice forceAllocateDevice (String serial)

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

abstract void freeDevice (ITestDevice device, FreeDeviceState state)

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.

abstract String getAdbPath ()

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

abstract String getAdbVersion ()

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

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) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

Initialisez le gestionnaire de périphériques avec un filtre de périphérique.

abstract void init ()

Initialisez le gestionnaire de périphériques.

abstract boolean isEmulator (String serial)

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

default boolean isFileSystemMountCheckEnabled ()

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

abstract boolean isNullDevice (String serial)

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

abstract void killEmulator (ITestDevice device)

Arrêtez l'émulateur donné.

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

abstract listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les appareils connus

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

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

Supprime un précédemment ajouté IDeviceMonitor .

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

abstract void restartAdbBridge ()

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

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

abstract void terminateDeviceMonitor ()

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

abstract void terminateDeviceRecovery ()

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

default void terminateHard (String reason)

Comme terminateHard() .

abstract void terminateHard ()

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

abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

forceAllocateDevice

public abstract 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 abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

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

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

getAdbPath

public abstract String getAdbPath ()

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

Retour
String

getAdbVersion

public abstract String getAdbVersion ()

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

Retour
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 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 abstract String getFastbootPath ()

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

Retour
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Initialisez le gestionnaire de périphériques avec un filtre de périphérique. Ce filtre peut être utilisé pour demander au DeviceManager d'ignorer certains appareils connectés.

Paramètres
globalDeviceFilter IDeviceSelection : le filtre de l' appareil

deviceMonitors

init

public abstract 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 abstract 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 abstract 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 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 n'est déjà pas disponible.

Paramètres
device ITestDevice : l' ITestDevice émulateur représentant pour fermer

Jetés
DeviceNotAvailableException si l'émulateur ne s'arrête pas

lancerEmulateur

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

listeTous les appareils

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

supprimerDeviceMonitor

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

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

stopAdbBridge

public abstract void stopAdbBridge ()

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

mettre fin

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

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

terminateDeviceRecovery

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

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

attendrePremierAppareilAjouté

public abstract 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 expiration du délai.

Paramètres
timeout long : le temps d'attente en milliseconde avant de retourner faux.

Retour
boolean