Menedżer urządzeń ID
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Interfejs do zarządzania zbiorem dostępnych urządzeń do testów.
Streszczenie
Klasy zagnieżdżone | |
---|---|
interface | IDeviceManager.IFastbootListener Odbiornik zmian stanu fastboot. |
Metody publiczne | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) Dodaje |
abstract void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Informuje menedżera, że słuchacz jest zainteresowany zmianami stanu szybkiego uruchamiania. |
abstract void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Dodaj urządzenie do monitora fastboot. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) Poproś o urządzenie do testów, które spełnia określone kryteria. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options) Poproś o urządzenie do testów, które spełnia określone kryteria. |
abstract ITestDevice | allocateDevice () Poproś o fizyczne urządzenie do testowania |
abstract 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 przezdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) Zwrócone ITestDevice będzie w trybie online, ale może nie odpowiadać. |
abstract boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Rozłącz się z podłączonym urządzeniem adb-over-tcp. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Wygeneruj przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości dla często używanych opcji |
abstract CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Metoda pomocnicza do wykonania polecenia powłoki na dostępnym urządzeniu. |
abstract ITestDevice | forceAllocateDevice (String serial) Niegrzecznie przydziel urządzenie, nawet jeśli nie jest obecnie dostępne. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Zwróć urządzenie do basenu Próby zwrócenia urządzenia, które nie zostało wcześniej przydzielone, będą ignorowane. |
abstract String | getAdbPath () Zwraca ścieżkę do pliku binarnego adb do użycia. |
abstract String | getAdbVersion () Pobierz wersję adb aktualnie używaną przez menedżera urządzeń. |
abstract DeviceDescriptor | getDeviceDescriptor (String serial) Zwraca DeviceDescriptor z podanym numerem seryjnym. |
abstract String | getFastbootPath () Zwraca ścieżkę do pliku binarnego fastboot, który ma zostać użyty. |
abstract void | init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Zainicjuj menedżera urządzeń z filtrem urządzeń. |
abstract void | init () Zainicjuj menedżera urządzeń. |
abstract boolean | isEmulator (String serial) Sprawdź, czy podany numer seryjny reprezentuje emulator |
default boolean | isFileSystemMountCheckEnabled () Zwraca czy powinniśmy sprawdzić w |
abstract boolean | isNullDevice (String serial) Sprawdź, czy podany numer seryjny reprezentuje urządzenie zerowe |
abstract void | killEmulator ( ITestDevice device) Wyłącz dany emulator. |
abstract void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metoda pomocnicza do uruchomienia emulatora. |
abstract | listAllDevices (boolean shortDescriptor) Zwraca listę deskryptorów urządzeń dla wszystkich znanych urządzeń |
abstract | listAllDevices () Zwraca listę deskryptorów urządzeń dla wszystkich znanych urządzeń |
abstract 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 przez |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Usuwa poprzednio dodany |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informuje menedżera, że słuchacz nie jest już zainteresowany zmianami stanu szybkiego uruchamiania. |
abstract void | restartAdbBridge () Uruchom ponownie (jeśli |
abstract void | stopAdbBridge () Zatrzymaj most adb i usługi zależą od połączeń adb. |
abstract void | terminate () Zatrzymuje usługi monitorowania urządzeń i kończy działanie biblioteki ddm. |
abstract void | terminateDeviceMonitor () Zatrzymaj monitory urządzeń. |
abstract void | terminateDeviceRecovery () Zatrzymuje wątek odzyskiwania urządzenia. |
default void | terminateHard (String reason) Podobnie jak |
abstract void | terminateHard () Podobnie jak |
abstract boolean | waitForFirstDeviceAdded (long timeout) Poczekaj, aż zostanie podłączone pierwsze urządzenie fizyczne. |
Metody publiczne
addDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Dodaje IDeviceMonitor
Parametry | |
---|---|
mon | IDeviceMonitor |
addFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
Informuje menedżera, że słuchacz jest zainteresowany zmianami stanu szybkiego uruchamiania.
ObecnieIDeviceManager
będzie monitorować urządzenia w fastboot tylko wtedy, gdy istnieje jeden lub więcej aktywnych detektorów. TODO: to trochę hack - znajdź lepsze rozwiązanie addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Dodaj urządzenie do monitora fastboot. Monitor fastboot użyje „fastboot_serial” do komunikacji z urządzeniem.
Parametry | |
---|---|
serial | String : numer seryjny urządzenia. |
fastboot_serial | String : numer seryjny urządzenia w trybie fastboot. |
przydzielićUrządzenie
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Poproś o urządzenie do testów, które spełnia określone kryteria.
Parametry | |
---|---|
options | IDeviceSelection : IDeviceSelection , które urządzenie powinno spełniać. |
isTemporary | boolean : czy należy utworzyć tymczasowe urządzenie NullDevice. |
Zwroty | |
---|---|
ITestDevice | ITestDevice do testowania lub null , jeśli nie jest dostępne |
przydzielićUrządzenie
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Poproś o urządzenie do testów, które spełnia określone kryteria.
Parametry | |
---|---|
options | IDeviceSelection : IDeviceSelection , które urządzenie powinno spełniać. |
Zwroty | |
---|---|
ITestDevice | ITestDevice do testowania lub null , jeśli nie jest dostępne |
przydzielićUrządzenie
public abstract ITestDevice allocateDevice ()
Poproś o fizyczne urządzenie do testowania
Zwroty | |
---|---|
ITestDevice | ITestDevice do testowania lub null , jeśli nie jest dostępne |
ConnectToTcpDevice
public abstract 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 przezdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
Zwrócone ITestDevice
będzie w trybie online, ale może nie odpowiadać. Zwróć uwagę, że wykonanie akcji, takiej jak ponowne uruchomienie na urządzeniu podłączonym przez tcp, spowoduje przerwanie połączenia tcp z urządzeniem i spowoduje 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 |
rozłącz od urządzenia Tcp
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Rozłącz się z podłączonym urządzeniem adb-over-tcp.
Przełącza urządzenie z powrotem do trybu 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ę |
displayDevicesInfo
public abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)
Wygeneruj przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości dla często używanych opcji IDeviceSelection
.
Parametry | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) do wyprowadzenia opisu do |
includeStub | boolean : Określa, czy wyświetlać również urządzenia pośredniczące. |
executeCmdOnAvailableDevice
public abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Metoda pomocnicza do wykonania polecenia powłoki na dostępnym urządzeniu.
Parametry | |
---|---|
serial | String : numer seryjny urządzenia. |
command | String : Polecenie powłoki. |
timeout | long : Czas potrzebny na wykonanie polecenia. |
timeUnit | TimeUnit : Jednostka limitu czasu. |
Zwroty | |
---|---|
CommandResult | CommandResult . |
forceAlocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Niegrzecznie przydziel urządzenie, nawet jeśli nie jest obecnie dostępne.
Nie będzie działać, 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ć |
freeDevice
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Zwróć urządzenie do basenu
Próby zwrócenia urządzenia, które nie zostało wcześniej przydzielone, będą ignorowane.Parametry | |
---|---|
device | ITestDevice : ITestDevice do darmowego |
state | FreeDeviceState : FreeDeviceState . Służy do kontrolowania, czy urządzenie jest zwracane do dostępnej puli urządzeń. |
pobierzŚcieżkęAdb
public abstract String getAdbPath ()
Zwraca ścieżkę do pliku binarnego adb do użycia.
Zwroty | |
---|---|
String |
pobierzWersjęAdb
public abstract String getAdbVersion ()
Pobierz wersję adb aktualnie używaną przez menedżera urządzeń.
Zwroty | |
---|---|
String |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Zwraca DeviceDescriptor z podanym numerem seryjnym.
Parametry | |
---|---|
serial | String : numer seryjny urządzenia do pobrania |
Zwroty | |
---|---|
DeviceDescriptor | DeviceDescriptor dla wybranego urządzenia lub null, jeśli numer seryjny nie pasuje do znanego urządzenia. |
Pobierz ścieżkę Fastboot
public abstract String getFastbootPath ()
Zwraca ścieżkę do pliku binarnego fastboot, który ma zostać użyty.
Zwroty | |
---|---|
String |
w tym
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
Zainicjuj menedżera urządzeń z filtrem urządzeń. Filtr ten może być użyty do poinstruowania menedżera urządzeń, aby ignorował niektóre podłączone urządzenia.
Parametry | |
---|---|
globalDeviceFilter | IDeviceSelection : filtr urządzenia |
deviceMonitors |
w tym
public abstract void init ()
Zainicjuj menedżera urządzeń. To musi być wywołane raz i tylko raz przed wywołaniem innych metod.
isEmulator
public abstract boolean isEmulator (String serial)
Sprawdź, czy podany numer seryjny reprezentuje emulator
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Zwraca czy powinniśmy sprawdzić w NativeDeviceStateMonitor
czy system plików jest prawidłowo zamontowany.
Zwroty | |
---|---|
boolean |
isNullDevice
public abstract boolean isNullDevice (String serial)
Sprawdź, czy podany numer seryjny reprezentuje urządzenie zerowe
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
boolean |
killEmulator
public abstract void killEmulator (ITestDevice device)
Wyłącz dany emulator.
Blokuje się do momentu zniknięcia emulatora z adb. Nie przyniesie efektu, jeśli emulator nie jest już dostępny.Parametry | |
---|---|
device | ITestDevice : ITestDevice reprezentujący emulator do zamknięcia |
Rzuty | |
---|---|
DeviceNotAvailableException | jeśli emulator się nie wyłączy |
uruchomEmulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metoda pomocnicza do uruchomienia emulatora.
Uruchomi emulator określony przez rozmówcęParametry | |
---|---|
device | ITestDevice : symbol zastępczy ITestDevice reprezentujący przydzielone urządzenie emulatora |
bootTimeout | long : czas oczekiwania w ms na uruchomienie emulatora |
emulatorArgs |
Rzuty | |
---|---|
DeviceNotAvailableException | jeśli emulator nie uruchamia się lub nie przechodzi w tryb online |
listaWszystkichUrządzeń
public abstractlistAllDevices (boolean shortDescriptor)
Zwraca listę deskryptorów urządzeń dla wszystkich znanych urządzeń
Parametry | |
---|---|
shortDescriptor | boolean : czy ograniczyć deskryptory do minimum informacji |
Zwroty | |
---|---|
lista DeviceDescriptor dla wszystkich znanych urządzeń |
listaWszystkichUrządzeń
public abstractlistAllDevices ()
Zwraca listę deskryptorów urządzeń dla wszystkich znanych urządzeń
Zwroty | |
---|---|
lista DeviceDescriptor dla wszystkich znanych urządzeń |
reconnectDeviceToTcp
public abstract 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 przez 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 |
Rzuty | |
---|---|
DeviceNotAvailableException | jeśli połączenie z usbDevice zostało utracone i nie można go odzyskać |
usuńDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
Usuwa poprzednio dodany IDeviceMonitor
. Nie działa, jeśli mon nie został dodany.
Parametry | |
---|---|
mon | IDeviceMonitor |
usuńFastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informuje menedżera, że słuchacz nie jest już zainteresowany zmianami stanu szybkiego uruchamiania.
uruchom ponownieAdbBridge
public abstract void restartAdbBridge ()
Uruchom ponownie (jeśli stopAdbBridge()
) most adb i usługi zależą od połączeń adb.
stopAdbBridge
public abstract void stopAdbBridge ()
Zatrzymaj most adb i usługi zależą od połączeń adb.
zakończyć
public abstract void terminate ()
Zatrzymuje usługi monitorowania urządzeń i kończy działanie biblioteki ddm.
Musi to zostać wywołane po zakończeniu aplikacji.Zobacz też:
zakończyćDeviceMonitor
public abstract void terminateDeviceMonitor ()
Zatrzymaj monitory urządzeń.
Zakończ odzyskiwanie urządzenia
public abstract 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 podany do wypowiedzenia. |
zakończyćHard
public abstract void terminateHard ()
Podobnie jak terminate()
, ale próbuje również wymusić zamknięcie adb.
waitForFirstDeviceDodano
public abstract 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 True. Jeśli żadne urządzenie nie zostało dodane, 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: 2022-11-07 UTC.