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 |
abstract void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un auditeur est intéressé par les changements d'état de fastboot. |
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 les tests |
abstract 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é viadisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) Le ITestDevice renvoyé sera en ligne, mais pourrait 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 les valeurs des options |
abstract CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Une méthode d'assistance pour exécuter une commande shell sur un appareil disponible. |
abstract ITestDevice | forceAllocateDevice (String serial) Allouez grossièrement un appareil, même s’il n’est pas actuellement disponible. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) 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. |
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 () Indique si nous devons ou non vérifier dans |
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 (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 fait passer le périphérique USB donné en mode adb-over-tcp, puis s'y connecte via |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Supprime un |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un auditeur n'est plus intéressé par les changements d'état de fastboot. |
abstract void | restartAdbBridge () Redémarrez (si |
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 appareils 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 du périphérique. |
default void | terminateHard (String reason) Comme |
abstract void | terminateHard () Comme |
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 auditeur est intéressé par les changements d'état de fastboot.
Actuellement, unIDeviceManager
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 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 : 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 abstract 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 abstract 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 abstract 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é viadisconnectFromTcpDevice(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 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 appareils connus, leur état et les valeurs des options IDeviceSelection
couramment utilisées.
Paramètres | |
---|---|
printWriter | 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 abstract 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 . |
forceAllocateDevice
public abstract 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 abstract void freeDevice (ITestDevice device, FreeDeviceState state)
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 |
state | FreeDeviceState : le FreeDeviceState . Utilisé pour contrôler si le périphérique est renvoyé dans le 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 à 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 d'accès au binaire fastboot à utiliser.
Retour | |
---|---|
String |
initialisation
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 |
initialisation
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.
estEmulator
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 ()
Indique 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 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 : le ITestDevice représentant l'émulateur à arrêter |
Jetés | |
---|---|
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'appelantParamè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 |
Jetés | |
---|---|
DeviceNotAvailableException | si l'émulateur ne parvient pas à démarrer ou à se connecter |
listTous les appareils
public abstractlistAllDevices (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 abstractlistAllDevices ()
Renvoie une liste de DeviceDescriptors pour tous les appareils 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 | le ITestDevice nouvellement alloué en mode TCP ou null si une connexion TCP n'a pas pu être établie |
Jetés | |
---|---|
DeviceNotAvailableException | si la connexion avec usbDevice a été perdue et n'a pas pu être récupérée |
supprimerDeviceMonitor
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 auditeur n'est plus intéressé par les changements d'état de fastboot.
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 appareils et met fin à la bibliothèque ddm.
Celui-ci doit être appelé à la fin de l'application.Voir également:
terminerDeviceMonitor
public abstract void terminateDeviceMonitor ()
Arrêtez les moniteurs de périphériques.
terminerDeviceRecovery
public abstract 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 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 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 |
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/12/01 (UTC).