IDDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Interfejs do zarządzania zestawem dostępnych urządzeń do testów.
Streszczenie
Zagnieżdżone klasy | |
---|---|
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 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 urządzenie fizyczne do przetestowania |
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 poprzezdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) Zwrócone ITestDevice będzie dostępne w trybie online, ale może nie odpowiadać. |
abstract boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Odłącz się od urządzenia podłączonego za pomocą protokołu 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 często używanych opcji |
abstract CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Metoda pomocnicza umożliwiająca wykonanie polecenia powłoki na dostępnym urządzeniu. |
abstract ITestDevice | forceAllocateDevice (String serial) Niegrzecznie przydzielaj urządzenie, nawet jeśli nie jest ono aktualnie dostępne. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Zwróć urządzenie do basenu Próby zwrotu 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 do użycia. |
abstract void | init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Zainicjuj menedżera urządzeń za pomocą filtra 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 informację, 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) Zamknij podany 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ę 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 poprzez |
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 zamyka bibliotekę 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
dodajMonitor urządzenia
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Dodaje IDeviceMonitor
Parametry | |
---|---|
mon | IDeviceMonitor |
dodajFastbootListener
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 jeden lub więcej aktywnych słuchaczy. 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 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 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 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 abstract 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 abstract 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 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 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 abstract 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 abstract void displayDevicesInfo (PrintWriter printWriter, 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 | |
---|---|
printWriter | 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 abstract 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 . |
wymuś przydzielenie urządzenia
public abstract 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 abstract void freeDevice (ITestDevice device, FreeDeviceState state)
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 |
state | FreeDeviceState : FreeDeviceState . Służy do kontrolowania, czy urządzenie wraca do dostępnej puli urządzeń. |
pobierzAdbPath
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 |
pobierzDeviceDescriptor
public abstract 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 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ń za pomocą filtra urządzeń. Tego filtra można użyć do poinstruowania menedżera urządzeń, aby ignorował określone podłączone urządzenia.
Parametry | |
---|---|
globalDeviceFilter | IDeviceSelection : filtr urządzenia |
deviceMonitors |
w tym
public abstract 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 abstract 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 abstract boolean isNullDevice (String serial)
Określ, czy podany numer seryjny reprezentuje urządzenie zerowe
Parametry | |
---|---|
serial | String |
Zwroty | |
---|---|
boolean |
zabij emulator
public abstract 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 | jeśli emulator nie zostanie zamknięty |
uruchomEmulator
public abstract 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 | 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 minimalnej ilości 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 podłącz urządzenie doTcp
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 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 | jeśli połączenie z usbDevice zostało utracone i nie można go było odzyskać |
usuńMonitor urządzenia
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 ponownieAdbBridge
public abstract void restartAdbBridge ()
Uruchom ponownie (jeśli wywołano stopAdbBridge()
) most adb i usługi zależą od połączeń adb.
zatrzymajAdbBridge
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 zamyka bibliotekę ddm.
Należy to wywołać po zakończeniu aplikacji.Zobacz też:
zakończyćDeviceMonitor
public abstract void terminateDeviceMonitor ()
Zatrzymaj monitory urządzeń.
zakończyć 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 zakończenia umowy. |
zakończyćHard
public abstract void terminateHard ()
Podobnie jak terminate()
, ale próbuje również wymusić zamknięcie adb.
WaitForFirstDeviceAdded
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 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.