Menadżer urządzeń
public class DeviceManager
extends Object
implements IDeviceManager
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.device.DeviceManager |
Streszczenie
Zagnieżdżone klasy | |
---|---|
class | DeviceManager.FastbootDevice Reprezentacja urządzenia w trybie Fastboot. |
Pola | |
---|---|
public static final String | UNKNOWN_DISPLAY_STRING Wyświetl ciąg znaków dla nieznanych właściwości |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
Konstruktorzy publiczni | |
---|---|
DeviceManager () Menedżer urządzeń powinien zostać pobrany z pliku |
Metody publiczne | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Dodaje |
void | addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice) |
void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Informuje menedżera, że słuchacz jest zainteresowany zmianami stanu fastboot. |
void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Dodaj urządzenie do monitora fastboot. |
ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) Poproś o urządzenie do testów, które spełnia określone kryteria. |
ITestDevice | allocateDevice ( IDeviceSelection options) Poproś o urządzenie do testów, które spełnia określone kryteria. |
ITestDevice | allocateDevice () Poproś o urządzenie fizyczne do przetestowania |
ITestDevice | connectToTcpDevice (String ipAndPort) Połącz się z urządzeniem za pomocą adb-over-tcp Ta metoda przydziela nowe urządzenie, które ostatecznie powinno zostać zwolnione poprzezdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) Zwrócone ITestDevice będzie dostępne w trybie online, ale może nie odpowiadać. |
boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Odłącz się od urządzenia podłączonego za pomocą protokołu adb-over-tcp. |
void | displayDevicesInfo (PrintWriter stream, boolean includeStub) Wygeneruj przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości często używanych opcji |
CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Metoda pomocnicza umożliwiająca wykonanie polecenia powłoki na dostępnym urządzeniu. |
String | executeGlobalAdbCommand (String... cmdArgs) Wykonaj polecenie adb, które nie jest skierowane do konkretnego urządzenia, np. |
ITestDevice | forceAllocateDevice (String serial) Niegrzecznie przydzielaj urządzenie, nawet jeśli nie jest ono aktualnie dostępne. |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) Zwróć urządzenie do basenu Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, będą ignorowane. |
String | getAdbPath () Zwraca ścieżkę do pliku binarnego adb do użycia. |
String | getAdbVersion () Pobierz wersję adb aktualnie używaną przez menedżera urządzeń. |
DeviceDescriptor | getDeviceDescriptor (String serial) Zwraca DeviceDescriptor z podanym numerem seryjnym. |
String | getFastbootPath () Zwraca ścieżkę do pliku binarnego fastboot do użycia. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Zainicjuj menedżera urządzeń. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Zainicjuj menedżera urządzeń. |
void | init () Zainicjuj menedżera urządzeń. |
boolean | isEmulator (String serial) Określ, czy podany numer seryjny reprezentuje emulator |
boolean | isFileSystemMountCheckEnabled () Zwraca informację, czy powinniśmy sprawdzić w |
boolean | isNullDevice (String serial) Określ, czy podany numer seryjny reprezentuje urządzenie zerowe |
void | killEmulator ( ITestDevice device) Zamknij podany emulator. |
void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metoda pomocnicza do uruchomienia emulatora. |
listAllDevices (boolean shortDescriptor) Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń | |
listAllDevices () Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń | |
ITestDevice | reconnectDeviceToTcp ( ITestDevice usbDevice) Metoda pomocnicza, która przełącza dane urządzenie USB w tryb adb-over-tcp, a następnie łączy się z nim poprzez |
void | removeDeviceMonitor ( IDeviceMonitor mon) Usuwa wcześniej dodany |
void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informuje menedżera, że słuchacz nie jest już zainteresowany zmianami stanu fastboot. |
void | restartAdbBridge () Uruchom ponownie (jeśli wywołano |
void | stopAdbBridge () Zatrzymaj most adb, a usługi zależą od połączeń adb. |
void | terminate () Zatrzymuje usługi monitorowania urządzeń i zamyka bibliotekę ddm. |
void | terminateDeviceMonitor () Zatrzymaj monitory urządzeń. |
void | terminateDeviceRecovery () Zatrzymuje wątek odzyskiwania urządzenia. |
void | terminateHard (String reason) Podobnie jak |
void | terminateHard () Podobnie jak |
boolean | waitForFirstDeviceAdded (long timeout) Poczekaj, aż zostanie podłączone pierwsze urządzenie fizyczne. |
Pola
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Wyświetl ciąg znaków dla nieznanych właściwości
mFastbootWłączony
protected boolean mFastbootEnabled
Konstruktorzy publiczni
Menadżer urządzeń
public DeviceManager ()
Menedżer urządzeń powinien zostać pobrany z pliku GlobalConfiguration
Metody publiczne
dodajDostępne Urządzenie
public void addAvailableDevice (IDevice stubDevice)
Parametry | |
---|---|
stubDevice | IDevice |
dodajMonitor urządzenia
public void addDeviceMonitor (IDeviceMonitor mon)
Dodaje IDeviceMonitor
Parametry | |
---|---|
mon | IDeviceMonitor |
dodaj urządzenie Fastboot
public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)
Parametry | |
---|---|
fastbootDevice | DeviceManager.FastbootDevice |
dodajFastbootListener
public void addFastbootListener (IDeviceManager.IFastbootListener listener)
Informuje menedżera, że słuchacz jest zainteresowany zmianami stanu fastboot.
ObecnieIDeviceManager
będzie monitorować urządzenia w trybie fastboot tylko wtedy, gdy istnieje jeden lub więcej aktywnych słuchaczy. DO ZROBIENIA: to trochę hack - znajdź lepsze rozwiązanie addMonitoringTcpFastbootDevice
public void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Dodaj urządzenie do monitora fastboot. Monitor fastboot będzie używać „fastboot_serial” do komunikacji z urządzeniem.
Parametry | |
---|---|
serial | String : numer seryjny urządzenia. |
fastboot_serial | String : numer seryjny urządzenia w trybie szybkiego uruchamiania. |
przydziel urządzenie
public ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Poproś o urządzenie do testów, które spełnia określone kryteria.
Parametry | |
---|---|
options | IDeviceSelection : IDeviceSelection urządzenie powinno spełniać. |
isTemporary | boolean : czy należy utworzyć tymczasowe urządzenie NullDevice. |
Zwroty | |
---|---|
ITestDevice | a ITestDevice do testowania lub null , jeśli nie jest dostępne |
przydziel urządzenie
public ITestDevice allocateDevice (IDeviceSelection options)
Poproś o urządzenie do testów, które spełnia określone kryteria.
Parametry | |
---|---|
options | IDeviceSelection : IDeviceSelection urządzenie powinno spełniać. |
Zwroty | |
---|---|
ITestDevice | a ITestDevice do testowania lub null , jeśli nie jest dostępne |
przydziel urządzenie
public ITestDevice allocateDevice ()
Poproś o urządzenie fizyczne do przetestowania
Zwroty | |
---|---|
ITestDevice | a ITestDevice do testowania lub null , jeśli nie jest dostępne |
połącz się z urządzeniem Tcp
public ITestDevice connectToTcpDevice (String ipAndPort)
Połącz się z urządzeniem za pomocą adb-over-tcp
Ta metoda przydziela nowe urządzenie, które ostatecznie powinno zostać zwolnione poprzezdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
Zwrócone ITestDevice
będzie dostępne w trybie online, ale może nie odpowiadać. Należy pamiętać, że wykonanie takiej czynności, jak ponowne uruchomienie urządzenia podłączonego za pomocą protokołu TCP, spowoduje zerwanie połączenia TCP z urządzeniem i spowoduje wyjątek DeviceNotAvailableException
Parametry | |
---|---|
ipAndPort | String : oryginalny adres IP i port urządzenia, z którym chcesz się połączyć |
Zwroty | |
---|---|
ITestDevice | ITestDevice lub null , jeśli nie można utworzyć połączenia TCP |
odłączOdTcpDevice
public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Odłącz się od urządzenia podłączonego za pomocą protokołu adb-over-tcp.
Przełącza urządzenie z powrotem w tryb USB i zwalnia je.Parametry | |
---|---|
tcpDevice | ITestDevice : urządzenie aktualnie w trybie TCP, wcześniej przydzielone przez connectToTcpDevice(String) |
Zwroty | |
---|---|
boolean | true , jeśli przełączenie na tryb USB powiodło się |
wyświetl informacje o urządzeniach
public void displayDevicesInfo (PrintWriter stream, boolean includeStub)
Wygeneruj przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości często używanych opcji IDeviceSelection
.
Parametry | |
---|---|
stream | PrintWriter : ERROR(/PrintWriter) do którego ma zostać wypisany opis |
includeStub | boolean : Określa, czy wyświetlać także urządzenia pośredniczące. |
wykonajCmdOnAvailableDevice
public CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Metoda pomocnicza umożliwiająca wykonanie polecenia powłoki na dostępnym urządzeniu.
Parametry | |
---|---|
serial | String : Numer seryjny urządzenia. |
command | String : Polecenie powłoki. |
timeout | long : Ilość czasu potrzebna do wykonania polecenia. |
timeUnit | TimeUnit : Jednostka limitu czasu. |
Zwroty | |
---|---|
CommandResult | CommandResult . |
wykonajGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
Wykonaj polecenie adb, które nie jest skierowane do konkretnego urządzenia, np. „połączenie adb”
Zwroty | |
---|---|
String | standardowe wyjście, jeśli polecenie zakończy się sukcesem, w przeciwnym razie null. |
wymuś przydzielenie urządzenia
public ITestDevice forceAllocateDevice (String serial)
Niegrzecznie przydzielaj urządzenie, nawet jeśli nie jest ono aktualnie dostępne.
Nie będzie miało żadnego efektu, jeśli urządzenie jest już przydzielone.Parametry | |
---|---|
serial | String : numer seryjny urządzenia do przydzielenia |
Zwroty | |
---|---|
ITestDevice | ITestDevice lub null , jeśli nie można go przydzielić |
bezpłatne urządzenie
public void freeDevice (ITestDevice device, FreeDeviceState deviceState)
Zwróć urządzenie do basenu
Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, będą ignorowane.Parametry | |
---|---|
device | ITestDevice : ITestDevice za darmo |
deviceState | FreeDeviceState : FreeDeviceState . Służy do kontrolowania, czy urządzenie wraca do dostępnej puli urządzeń. |
pobierzAdbPath
public String getAdbPath ()
Zwraca ścieżkę do pliku binarnego adb do użycia.
Zwroty | |
---|---|
String |
pobierz wersję Adb
public String getAdbVersion ()
Pobierz wersję adb aktualnie używaną przez menedżera urządzeń.
Zwroty | |
---|---|
String |
pobierzDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (String serial)
Zwraca DeviceDescriptor z podanym numerem seryjnym.
Parametry | |
---|---|
serial | String : numer seryjny urządzenia, które należy pobrać |
Zwroty | |
---|---|
DeviceDescriptor | DeviceDescriptor dla wybranego urządzenia lub null, jeśli numer seryjny nie pasuje do znanego urządzenia. |
pobierzFastbootPath
public String getFastbootPath ()
Zwraca ścieżkę do pliku binarnego fastboot do użycia.
Zwroty | |
---|---|
String |
w tym
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
Zainicjuj menedżera urządzeń. Należy to wywołać raz i tylko raz, zanim zostaną wywołane jakiekolwiek inne metody.
Parametry | |
---|---|
globalDeviceFilter | IDeviceSelection |
globalDeviceMonitors | |
deviceFactory | IManagedTestDeviceFactory |
w tym
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
Zainicjuj menedżera urządzeń. Należy to wywołać raz i tylko raz, zanim zostaną wywołane jakiekolwiek inne metody.
Parametry | |
---|---|
globalDeviceFilter | IDeviceSelection : filtr urządzenia |
globalDeviceMonitors |
w tym
public void init ()
Zainicjuj menedżera urządzeń. Należy to wywołać raz i tylko raz, zanim zostaną wywołane jakiekolwiek inne metody.
jestEmulator
public boolean isEmulator (String serial)
Określ, czy podany numer seryjny reprezentuje emulator
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Zwraca informację, czy powinniśmy sprawdzić w NativeDeviceStateMonitor
, czy system plików jest poprawnie zamontowany.
Zwroty | |
---|---|
boolean |
jestNullDevice
public boolean isNullDevice (String serial)
Określ, czy podany numer seryjny reprezentuje urządzenie zerowe
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
boolean |
zabij emulator
public void killEmulator (ITestDevice device)
Zamknij podany emulator.
Blokuje, dopóki emulator nie zniknie z adb. Nie będzie miało żadnego efektu, jeśli emulator nie jest już dostępny.Parametry | |
---|---|
device | ITestDevice : ITestDevice reprezentujący emulator do zamknięcia |
Rzuca | |
---|---|
DeviceNotAvailableException |
uruchomEmulator
public void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metoda pomocnicza do uruchomienia emulatora.
Uruchomi emulator określony przez osobę wywołującąParametry | |
---|---|
device | ITestDevice : symbol zastępczy ITestDevice reprezentujący przydzielone urządzenie emulujące |
bootTimeout | long : czas w ms oczekiwania na uruchomienie emulatora |
emulatorArgs |
Rzuca | |
---|---|
DeviceNotAvailableException |
listaWszystkieUrządzenia
publiclistAllDevices (boolean shortDescriptor)
Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń
Parametry | |
---|---|
shortDescriptor | boolean : czy ograniczyć deskryptory do minimalnej ilości informacji |
Zwroty | |
---|---|
lista DeviceDescriptor dla wszystkich znanych urządzeń |
listaWszystkieUrządzenia
publiclistAllDevices ()
Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń
Zwroty | |
---|---|
lista DeviceDescriptor dla wszystkich znanych urządzeń |
ponownie podłącz urządzenie doTcp
public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Metoda pomocnicza, która przełącza dane urządzenie USB w tryb adb-over-tcp, a następnie łączy się z nim poprzez connectToTcpDevice(String)
.
Parametry | |
---|---|
usbDevice | ITestDevice : urządzenie aktualnie w trybie USB |
Zwroty | |
---|---|
ITestDevice | nowo przydzielone ITestDevice w trybie TCP lub null , jeśli nie można utworzyć połączenia TCP |
Rzuca | |
---|---|
DeviceNotAvailableException |
usuńMonitor urządzenia
public void removeDeviceMonitor (IDeviceMonitor mon)
Usuwa wcześniej dodany IDeviceMonitor
. Nie ma żadnego efektu, jeśli mon nie został dodany.
Parametry | |
---|---|
mon | IDeviceMonitor |
usuńFastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informuje menedżera, że słuchacz nie jest już zainteresowany zmianami stanu fastboot.
uruchom ponownie AdbBridge
public void restartAdbBridge ()
Uruchom ponownie (jeśli wywołano stopAdbBridge()
) most adb i usługi zależą od połączeń adb.
zatrzymajAdbBridge
public void stopAdbBridge ()
Zatrzymaj most adb, a usługi zależą od połączeń adb.
zakończyć
public void terminate ()
Zatrzymuje usługi monitorowania urządzeń i zamyka bibliotekę ddm.
Należy to wywołać po zakończeniu aplikacji.zakończyćDeviceMonitor
public void terminateDeviceMonitor ()
Zatrzymaj monitory urządzeń.
zakończyć odzyskiwanie urządzenia
public void terminateDeviceRecovery ()
Zatrzymuje wątek odzyskiwania urządzenia.
zakończyćHard
public void terminateHard (String reason)
Podobnie jak terminateHard()
.
Parametry | |
---|---|
reason | String : opcjonalny powód zakończenia umowy. |
zakończyćHard
public void terminateHard ()
Podobnie jak terminate()
, ale próbuje również wymusić zamknięcie adb.
WaitForFirstDeviceAdded
public boolean waitForFirstDeviceAdded (long timeout)
Poczekaj, aż zostanie podłączone pierwsze urządzenie fizyczne. Jeśli urządzenie było wcześniej podłączone, zwraca bezpośrednio wartość True. Jeśli nie dodano żadnego urządzenia, po przekroczeniu limitu czasu zwraca wartość false.
Parametry | |
---|---|
timeout | long : czas oczekiwania w milisekundach przed zwróceniem wartości false. |
Zwroty | |
---|---|
boolean |
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-12-01 UTC.