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 Chaîne d'affichage pour les propriétés inconnues |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
Constructeurs publics | |
---|---|
DeviceManager () Le DeviceManager doit être récupéré à partir de |
Méthodes publiques | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Ajoute un |
void | addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice) |
void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Informe le gestionnaire qu'un écouteur est intéressé par les changements d'état de 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 périphérique, qui devrait éventuellement être libéré viadisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) L' ITestDevice retourné sera en ligne, mais peut ne pas être réactif. |
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 périphériques connus, leur état et les valeurs des 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 appareil particulier, par exemple. |
ITestDevice | forceAllocateDevice (String serial) Affectez grossièrement un appareil, même s'il n'est pas disponible actuellement. |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) 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. |
String | getAdbPath () Renvoie le chemin vers le 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 vers le 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 () Renvoie si nous devons ou non vérifier dans |
boolean | isNullDevice (String serial) Déterminer si la série donnée 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 périphériques connus | |
listAllDevices () Renvoie une liste de DeviceDescriptors pour tous les périphériques 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 |
void | removeDeviceMonitor ( IDeviceMonitor mon) Supprime un |
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. |
void | restartAdbBridge () Redémarrez (si |
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 termine la bibliothèque ddm. |
void | terminateDeviceMonitor () Arrêtez les moniteurs de périphérique. |
void | terminateDeviceRecovery () Arrête le thread de récupération de périphérique. |
void | terminateHard (String reason) Comme |
void | terminateHard () Comme |
boolean | waitForFirstDeviceAdded (long timeout) Attendez qu'un premier appareil physique soit connecté. |
Des champs
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Chaîne d'affichage 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 de 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 écouteur est intéressé par les changements d'état de démarrage rapide.
Actuellement, unIDeviceManager
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 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 : 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 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 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 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é viadisconnectFromTcpDevice(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 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 périphériques connus, leur état et les valeurs des options IDeviceSelection
couramment utilisées.
Paramètres | |
---|---|
stream | 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 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 . |
executeGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
Exécutez une commande adb non ciblée sur un appareil particulier, par exemple. 'adb connecter'
Retour | |
---|---|
String | sortie std si la commande réussit null sinon. |
forcerallouerappareil
public 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 void freeDevice (ITestDevice device, FreeDeviceState deviceState)
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 |
deviceState | FreeDeviceState : le FreeDeviceState . Utilisé pour contrôler si l'appareil est renvoyé au pool d'appareils disponibles. |
getAdbPath
public String getAdbPath ()
Renvoie le chemin vers le 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 |
getDeviceDescriptorgetDeviceDescriptor
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 vers le binaire fastboot à utiliser.
Retour | |
---|---|
String |
initialiser
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
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.
Paramètres | |
---|---|
globalDeviceFilter | IDeviceSelection |
globalDeviceMonitors | |
deviceFactory | IManagedTestDeviceFactory |
initialiser
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
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.
Paramètres | |
---|---|
globalDeviceFilter | IDeviceSelection : le filtre des appareils |
globalDeviceMonitors |
initialiser
public 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 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 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 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 |
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'appelantParamè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 |
Lance | |
---|---|
DeviceNotAvailableException |
listAllDevices
publiclistAllDevices (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
publiclistAllDevices ()
Renvoie une liste de DeviceDescriptors pour tous les périphériques 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 | l' ITestDevice nouvellement alloué en mode tcp ou null si une connexion tcp n'a pas pu être établie |
Lance | |
---|---|
DeviceNotAvailableException |
removeDeviceMonitor
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 écouteur n'est plus intéressé par les changements d'état de démarrage rapide.
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 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 void terminateDeviceMonitor ()
Arrêtez les moniteurs de périphérique.
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 : 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 é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 |
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/03/30 (UTC).