IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

Résumé

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 de 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 périphérique, qui devrait éventuellement être libéré via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

L' ITestDevice retourné sera en ligne, mais peut ne pas être réactif.

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 périphériques connus, leur état et les valeurs des options IDeviceSelection couramment utilisées.

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)

Affectez grossièrement un appareil, 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é précédemment attribué seront ignorées.

abstract String getAdbPath ()

Renvoie le chemin vers le 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 vers le 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 ()

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

abstract boolean isNullDevice (String serial)

Déterminer si la série donnée 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 (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les périphériques connus

abstract listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les périphériques connus

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

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

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

abstract void restartAdbBridge ()

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

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 termine la bibliothèque ddm.

abstract void terminateDeviceMonitor ()

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

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 tente également d'arrêter de force 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 démarrage rapide.

Actuellement, un IDeviceManager ne surveillera les périphériques en démarrage rapide que s'il existe un ou plusieurs écouteurs actifs.

À FAIRE : c'est un peu un hack - trouvez 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 : 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 abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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 de disponible

allouerDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

allouerDevice

public abstract ITestDevice allocateDevice ()

Demander un appareil physique pour le test

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

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Se connecter à 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)

L' ITestDevice retourné sera en ligne, mais peut ne pas être réactif.

Notez que l'exécution d'une action telle qu'un redémarrage sur un périphérique connecté tcp rompra la connexion tcp au périphérique et entraînera une DeviceNotAvailableException

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

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

déconnecterDeTcpDevice

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 : 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 abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

Paramètres
printWriter PrintWriter : l' ERROR(/PrintWriter) pour sortir la description vers

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

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 : Le temps nécessaire à la commande pour se terminer.

timeUnit TimeUnit : L'unité pour le délai d'attente.

Retour
CommandResult Un CommandResult .

forcerallouerappareil

public abstract ITestDevice forceAllocateDevice (String serial)

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

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 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é précédemment attribué seront ignorées.

Paramètres
device ITestDevice : l' ITestDevice à libérer

state FreeDeviceState : le FreeDeviceState . Utilisé pour contrôler si l'appareil est renvoyé au pool d'appareils disponibles.

getAdbPath

public abstract String getAdbPath ()

Renvoie le chemin vers le 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

getDeviceDescriptorgetDeviceDescriptor

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

Renvoie le chemin vers le binaire fastboot à utiliser.

Retour
String

initialiser

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 des appareils

deviceMonitors

initialiser

public abstract void init ()

Initialisez le gestionnaire de périphériques. Celle-ci doit être appelée une fois et une seule 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 ()

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

Retour
boolean

estNullDevice

public abstract boolean isNullDevice (String serial)

Déterminer si la série donnée 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 représentant l'émulateur à arrêter

Lance
DeviceNotAvailableException si l'émulateur ne parvient pas à s'arrêter

lancer l'émulateur

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 le périphérique émulateur alloué

bootTimeout long : le temps en ms d'attente du démarrage de l'émulateur

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

Lance
DeviceNotAvailableException si l'émulateur ne démarre pas ou ne se connecte pas

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Renvoie une liste de DeviceDescriptors pour tous les périphériques connus

Paramètres
shortDescriptor boolean : s'il faut limiter les descripteurs aux informations minimales

Retour
une liste de DeviceDescriptor pour tous les appareils connus

listAllDevices

public abstract  listAllDevices ()

Renvoie une liste de DeviceDescriptors pour tous les périphériques connus

Retour
une liste de DeviceDescriptor pour tous les appareils connus

reconnecterDeviceToTcp

public abstract 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 l' ITestDevice nouvellement alloué en mode tcp ou null si une connexion tcp n'a pas pu être établie

Lance
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 IDeviceMonitor précédemment ajouté. N'a aucun effet si mon n'a pas été ajouté.

Paramètres
mon IDeviceMonitor

supprimerFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

redémarrerAdbBridge

public abstract void restartAdbBridge ()

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

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 termine la bibliothèque ddm.

Celle-ci doit être appelée lors de la résiliation de l'application.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

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

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 : motif facultatif donné pour la résiliation.

terminerDur

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Attendez qu'un premier appareil 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 le délai d'attente.

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

Retour
boolean