IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Interfejs do zarządzania zestawem dostępnych urządzeń do testowania.
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 fastboot. |
abstract void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Dodaj urządzenie do monitora fastboot. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) Poproś o testowanie urządzenia spełniającego określone kryteria. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options) Poproś o testowanie urządzenia spełniającego określone kryteria. |
abstract ITestDevice | allocateDevice () Poproś o fizyczne urządzenie do testów |
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) Odłącz się od podłączonego urządzenia 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 wykonywania poleceń powłoki na dostępnym urządzeniu. |
abstract ITestDevice | forceAllocateDevice (String serial) Niegrzecznie przydzielaj urządzenie, nawet jeśli nie jest ono obecnie dostępne. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Zwróć urządzenie do puli Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, zostaną zignorowane. |
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 do użycia. |
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) Określ, czy podany numer seryjny reprezentuje emulator |
default boolean | isFileSystemMountCheckEnabled () Zwraca, czy powinniśmy sprawdzić w |
abstract boolean | isNullDevice (String serial) Określ, 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 uruchamiania emulatora. |
abstract | listAllDevices (boolean shortDescriptor) Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń |
abstract | listAllDevices () Zwraca listę DeviceDescriptors 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 wcześniej dodany |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informuje menedżera, że słuchacz nie jest już zainteresowany zmianami stanu fastboot. |
abstract void | restartAdbBridge () Uruchom ponownie (jeśli wywołano |
abstract void | stopAdbBridge () Zatrzymaj most adb, a 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
dodaj Monitor urządzeń
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Dodaje IDeviceMonitor
Parametry | |
---|---|
mon | IDeviceMonitor |
dodaj FastbootListener
public abstract 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 co najmniej jeden aktywny odbiornik. DO ZROBIENIA: 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 trybu szybkiego rozruchu urządzenia. |
przydziel urządzenie
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Poproś o testowanie urządzenia spełniającego określone kryteria.
Parametry | |
---|---|
options | IDeviceSelection : IDeviceSelection 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ępny |
przydziel urządzenie
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Poproś o testowanie urządzenia spełniającego określone kryteria.
Parametry | |
---|---|
options | IDeviceSelection : IDeviceSelection urządzenie powinno spełniać. |
Zwroty | |
---|---|
ITestDevice | ITestDevice do testowania lub null , jeśli nie jest dostępny |
przydziel urządzenie
public abstract ITestDevice allocateDevice ()
Poproś o fizyczne urządzenie do testów
Zwroty | |
---|---|
ITestDevice | ITestDevice do testowania lub null , jeśli nie jest dostępny |
połącz z urządzeniem Tcp
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ć. Pamiętaj, że wykonanie akcji, takiej jak ponowne uruchomienie na urządzeniu podłączonym do 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 ma zostać nawiązane połączenie |
Zwroty | |
---|---|
ITestDevice | ITestDevice lub null , jeśli nie można utworzyć połączenia TCP |
rozłącz z TcpDevice
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Odłącz się od podłączonego urządzenia 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 do trybu USB powiodło się |
wyświetl informacje o urządzeniach
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 którego ma zostać wysłany opis |
includeStub | boolean : Czy wyświetlać również urządzenia pośredniczące. |
wykonaćCmdOnAvailableDevice
public abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Metoda pomocnicza do wykonywania poleceń powłoki na dostępnym urządzeniu.
Parametry | |
---|---|
serial | String : Numer seryjny urządzenia. |
command | String : Komenda powłoki. |
timeout | long : ilość czasu na wykonanie polecenia. |
timeUnit | TimeUnit : Jednostka limitu czasu. |
Zwroty | |
---|---|
CommandResult | CommandResult . |
wymuśPrzydzielUrządzenie
public abstract ITestDevice forceAllocateDevice (String serial)
Niegrzecznie przydzielaj urządzenie, nawet jeśli nie jest ono obecnie dostępne.
Nie przyniesie ż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ć |
darmowe urządzenie
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Zwróć urządzenie do puli
Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, zostaną zignorowane.Parametry | |
---|---|
device | ITestDevice : ITestDevice za darmo |
state | FreeDeviceState : FreeDeviceState . Służy do kontrolowania, czy urządzenie jest zwracane do dostępnej puli urządzeń. |
getAdbPath
public abstract String getAdbPath ()
Zwraca ścieżkę do pliku binarnego adb do użycia.
Zwroty | |
---|---|
String |
pobierz wersję 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, który ma uzyskać urządzenie |
Zwroty | |
---|---|
DeviceDescriptor | DeviceDescriptor dla wybranego urządzenia lub null, jeśli numer seryjny nie pasuje do znanego urządzenia. |
getFastbootPath
public abstract String getFastbootPath ()
Zwraca ścieżkę do pliku binarnego fastboot do użycia.
Zwroty | |
---|---|
String |
w tym
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
Zainicjuj menedżera urządzeń z filtrem urządzeń. Tego filtru można użyć 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, zanim zostaną wywołane jakiekolwiek inne metody.
jestEmulatorem
public abstract boolean isEmulator (String serial)
Określ, 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)
Określ, czy podany numer seryjny reprezentuje urządzenie zerowe
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
boolean |
zabićEmulator
public abstract void killEmulator (ITestDevice device)
Wyłącz dany emulator.
Blokuje, dopóki emulator nie zniknie z adb. Nie przyniesie żadnego efektu, jeśli emulator nie jest już dostępny.Parametry | |
---|---|
device | ITestDevice : ITestDevice reprezentujący emulator do zamknięcia |
Rzuty | |
---|---|
DeviceNotAvailableException | jeśli emulator nie zamknie się |
uruchom emulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metoda pomocnicza do uruchamiania emulatora.
Uruchomi emulator zgodnie z poleceniem dzwoniącegoParametry | |
---|---|
device | ITestDevice : symbol zastępczy ITestDevice reprezentujący przydzielone urządzenie emulatora |
bootTimeout | long : czas w ms oczekiwania na uruchomienie emulatora |
emulatorArgs |
Rzuty | |
---|---|
DeviceNotAvailableException | jeśli emulator nie uruchomi się lub nie przejdzie do trybu online |
listaWszystkieUrządzenia
public abstractlistAllDevices (boolean shortDescriptor)
Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń
Parametry | |
---|---|
shortDescriptor | boolean : czy ograniczyć deskryptory do minimum informacji |
Zwroty | |
---|---|
lista DeviceDescriptor dla wszystkich znanych urządzeń |
listaWszystkieUrządzenia
public abstractlistAllDevices ()
Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń
Zwroty | |
---|---|
lista DeviceDescriptor dla wszystkich znanych urządzeń |
ponownie połącz urządzenie z Tcp
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 wcześniej dodany IDeviceMonitor
. Nie ma żadnego efektu, 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 fastboot.
uruchom ponownie AdbBridge
public abstract void restartAdbBridge ()
Uruchom ponownie (jeśli wywołano stopAdbBridge()
) adb bridge i usługi zależą od połączeń adb.
stopAdbBridge
public abstract void stopAdbBridge ()
Zatrzymaj most adb, a 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 zamknięciu aplikacji.Zobacz też:
zakończ Monitorowanie urządzeń
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ćTwarde
public void terminateHard (String reason)
Podobnie jak terminateHard()
.
Parametry | |
---|---|
reason | String : opcjonalny powód zakończenia. |
zakończyćTwarde
public abstract void terminateHard ()
Podobnie jak terminate()
, ale próbuje również wymusić zamknięcie adb.
Dodano funkcję oczekiwania na pierwsze urządzenie
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, zwraca wartość false po przekroczeniu limitu czasu.
Parametry | |
---|---|
timeout | long : czas oczekiwania w milisekundach przed zwróceniem 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-03-30 UTC.