IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Interfejs do zarządzania zestawem dostępnych urządzeń do testowania.

Podsumowanie

Zagnieżdżone klasy

interface IDeviceManager.IFastbootListener

Listener dla zmian stanu fastboot. 

Metody publiczne

abstract void addDeviceMonitor(IDeviceMonitor mon)

Dodaje IDeviceMonitor

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 szybkiego uruchamiania.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Zażądaj urządzenia do testowania, które spełnia określone kryteria.

abstract ITestDevice allocateDevice(IDeviceSelection options)

Zażądaj urządzenia do testowania, które spełnia określone kryteria.

abstract ITestDevice allocateDevice()

Prośba o fizyczne urządzenie do testowania

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Łączenie z urządzeniem za pomocą adb-over-tcp

Ta metoda przydziela nowe urządzenie, które powinno zostać ostatecznie zwolnione za pomocą funkcji disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Zwrócone urządzenie ITestDevice będzie online, ale może nie reagować na polecenia.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Rozłącz się z urządzeniem połączonym przez adb-over-tcp.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Wyświetl przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości dla najczęściej używanych opcji IDeviceSelection.

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)

Przypisywanie urządzenia w niegrzeczny sposób, nawet jeśli jest ono obecnie niedostępne.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Zwracanie urządzenia do puli

Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, zostaną zignorowane.

abstract String getAdbPath()

Zwraca ścieżkę do używanego binarnego pliku adb.

abstract String getAdbVersion()

Pobierz wersję adb obecnie używaną przez menedżera urządzenia.

abstract DeviceDescriptor getDeviceDescriptor(String serial)

Zwraca DeviceDescriptor o podanym numerze seryjnym.

abstract String getFastbootPath()

Zwraca ścieżkę do używanego pliku binarnego fastboot.

abstract void init(IDeviceSelection globalDeviceFilter, deviceMonitors)

Inicjalizacja menedżera urządzeń za pomocą filtra urządzeń.

abstract void init()

Inicjalizacja menedżera urządzenia.

abstract boolean isEmulator(String serial)

Określanie, czy podany numer seryjny reprezentuje emulator

default boolean isFileSystemMountCheckEnabled()

Zwraca informację, czy w pliku NativeDeviceStateMonitor system plików jest prawidłowo zamontowany.

abstract boolean isNullDevice(String serial)

Określ, czy podany numer seryjny reprezentuje urządzenie null

abstract void killEmulator(ITestDevice device)

Wyłącz dany emulator.

abstract void 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 za pomocą connectToTcpDevice(String).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Usuwa wcześniej dodany komponent IDeviceMonitor.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Informuje menedżera, że słuchacz już nie jest zainteresowany zmianami stanu szybkiego uruchamiania.

abstract void restartAdbBridge()

Uruchom ponownie (jeśli wywołano stopAdbBridge()) most adb, ponieważ usługi zależą od połączeń adb.

abstract void stopAdbBridge()

Zatrzymaj most adb i usługi zależne od połączeń adb.

abstract void terminate()

Zatrzymuje usługi monitorowania urządzenia i kończy działanie biblioteki ddm.

abstract void terminateDeviceMonitor()

Zatrzymaj monitorowanie urządzenia.

abstract void terminateDeviceRecovery()

Zatrzymuje wątek odzyskiwania urządzenia.

default void terminateHard(String reason)

terminateHard().

abstract void terminateHard()

Podobnie jak terminate(), ale dodatkowo próbuje wymusić zamknięcie adb.

abstract boolean waitForFirstDeviceAdded(long timeout)

Poczekaj, aż pierwsze urządzenie fizyczne zostanie połączone.

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 fastboot.

Obecnie IDeviceManager będzie monitorować urządzenia w trybie fastboot tylko wtedy, gdy będzie na nich co najmniej 1 aktywny odbiornik.

TODO: to jest trochę hack – znajdź lepsze rozwiązanie

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Dodaj urządzenie do monitora szybkiego uruchamiania. Monitor fastboot będzie używać parametru „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.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Zażądaj urządzenia do testowania, 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 ma takiej strony.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Zażądaj urządzenia do testowania, które spełnia określone kryteria.

Parametry
options IDeviceSelection: IDeviceSelection, które urządzenie powinno spełniać.
Zwroty
ITestDevice ITestDevice na potrzeby testowania lub null, jeśli nie jest dostępny

allocateDevice

public abstract ITestDevice allocateDevice ()

Prośba o fizyczne urządzenie do testowania

Zwroty
ITestDevice ITestDevice do testowania lub null, jeśli nie ma takiej strony.

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Łączenie z urządzeniem za pomocą adb-over-tcp

Ta metoda przydziela nowe urządzenie, które powinno zostać ostatecznie zwolnione za pomocą funkcji disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Zwrócone urządzenie ITestDevice będzie online, ale może nie reagować na polecenia.

Pamiętaj, że wykonanie czynności takiej jak ponowne uruchomienie urządzenia połączonego przez TCP spowoduje zerwanie połączenia TCP z tym urządzeniem i wywoła błąd DeviceNotAvailableException

Parametry
ipAndPort String: oryginalny adres IP i port urządzenia, z którym ma być nawiązane połączenie
Zwroty
ITestDevice ITestDevice lub null, jeśli nie udało się utworzyć połączenia TCP.

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Rozłącz się z urządzeniem połączonym przez adb-over-tcp.

Przełącza urządzenie z powrotem w tryb USB i odblokowuje je.

Parametry
tcpDevice ITestDevice: urządzenie w trybie TCP, które zostało wcześniej przydzielone za pomocą funkcji connectToTcpDevice(String)
Zwroty
boolean true jeśli przełączenie na tryb USB zakończyło się powodzeniem

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Wyświetl przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości dla najczęściej używanych opcji IDeviceSelection.

Parametry
printWriter PrintWriter: ERROR(/PrintWriter), do którego ma zostać wyprowadzony opis.
includeStub boolean: określa, czy wyświetlać również stuby urządzeń.

executeCmdOnAvailableDevice

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: polecenie powłoki.
timeout long: czas wykonania polecenia.
timeUnit TimeUnit: jednostka czasu oczekiwania.
Zwroty
CommandResult CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Przypisywanie urządzenia w niegrzeczny sposób, nawet jeśli jest ono obecnie niedostępne.

Nie będzie mieć zastosowania, jeśli urządzenie jest już przypisane.

Parametry
serial String: numer seryjny urządzenia do przydzielenia
Zwroty
ITestDevice ITestDevice lub null, jeśli nie można go przypisać

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Zwracanie urządzenia do puli

Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, zostaną zignorowane.

Parametry
device ITestDevice: ITestDevice do wolnego
state FreeDeviceState: FreeDeviceState. Służy do określenia, czy urządzenie ma zostać zwrócone do puli dostępnych urządzeń.

getAdbPath

public abstract String getAdbPath ()

Zwraca ścieżkę do używanego binarnego pliku adb.

Zwroty
String

getAdbVersion

public abstract String getAdbVersion ()

Pobierz wersję adb obecnie używaną przez menedżera urządzenia.

Zwroty
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Zwraca DeviceDescriptor o podanym numerze seryjnym.

Parametry
serial String: numer seryjny urządzenia, którego dotyczy prośba
Zwroty
DeviceDescriptor DeviceDescriptor wybranego urządzenia lub null, jeśli numer seryjny nie pasuje do znanego urządzenia.

getFastbootPath

public abstract String getFastbootPath ()

Zwraca ścieżkę do używanego pliku binarnego fastboot.

Zwroty
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inicjalizacja menedżera urządzeń za pomocą filtra urządzeń. Ten filtr może służyć do wydawania DeviceManagerowi instrukcji ignorowania określonych połączonych urządzeń.

Parametry
globalDeviceFilter IDeviceSelection: filtr urządzeń
deviceMonitors

init

public abstract void init ()

Inicjalizacja menedżera urządzenia. Musisz wywołać tę metodę tylko raz, zanim zaczniesz wywoływać inne metody.

isEmulator

public abstract boolean isEmulator (String serial)

Określanie, czy podany numer seryjny reprezentuje emulator

Parametry
serial String

Zwroty
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Zwraca informację, czy w pliku NativeDeviceStateMonitor 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 null

Parametry
serial String

Zwroty
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Wyłącz dany emulator.

Blokuje, dopóki emulator zniknie z adb. Nie będzie mieć zastosowania, jeśli emulator jest już niedostępny.

Parametry
device ITestDevice: ITestDevice reprezentujący emulator do wyłączenia
Rzuty
DeviceNotAvailableException jeśli nie uda się wyłączyć emulatora

launchEmulator

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Metoda pomocnicza do uruchamiania emulatora.

uruchomi emulację zgodnie z wytycznymi wywołującego,

Parametry
device ITestDevice: symbol zastępczy ITestDevice reprezentujący przypisane urządzenie emulatora
bootTimeout long: czas w ms oczekiwania na uruchomienie emulatora
emulatorArgs : argumenty wiersza poleceń do uruchamiania emulatora
Rzuty
DeviceNotAvailableException jeśli emulator nie uruchamia się lub nie łączy się z internetem.

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń.

Parametry
shortDescriptor boolean: czy ograniczyć opisy do minimalnych informacji
Zwroty
lista DeviceDescriptor dla wszystkich znanych urządzeń;

listAllDevices

public abstract  listAllDevices ()

Zwraca listę DeviceDescriptors 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 za pomocą connectToTcpDevice(String).

Parametry
usbDevice ITestDevice: urządzenie w trybie USB
Zwroty
ITestDevice nowo przydzielony adres ITestDevice w trybie TCP lub null, jeśli nie udało się utworzyć połączenia TCP
Rzuty
DeviceNotAvailableException jeśli połączenie z usbDevice zostało utracone i nie udało się go przywrócić

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Usuwa wcześniej dodany komponent IDeviceMonitor. Nie ma efektu, jeśli nie dodano mon.

Parametry
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informuje menedżera, że słuchacz już nie jest zainteresowany zmianami stanu szybkiego uruchamiania.

restartAdbBridge

public abstract void restartAdbBridge ()

Uruchom ponownie (jeśli wywołano stopAdbBridge()) most adb, ponieważ usługi zależą od połączeń adb.

stopAdbBridge

public abstract void stopAdbBridge ()

Zatrzymaj most adb i usługi zależne od połączeń adb.

zakończyć

public abstract void terminate ()

Zatrzymuje usługi monitorowania urządzenia i kończy działanie biblioteki ddm.

Musi być wywoływany po zakończeniu działania aplikacji.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Zatrzymaj monitorowanie urządzenia.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Zatrzymuje wątek odzyskiwania urządzenia.

terminateHard

public void terminateHard (String reason)

terminateHard().

Parametry
reason String: opcjonalny powód zakończenia.

terminateHard

public abstract void terminateHard ()

Podobnie jak terminate(), ale dodatkowo próbuje wymusić zamknięcie adb.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Poczekaj, aż pierwsze urządzenie fizyczne zostanie połączone. Jeśli urządzenie było wcześniej połączone, zwraca bezpośrednio wartość Prawda. Jeśli nie dodano żadnego urządzenia, po przekroczeniu limitu czasu zwraca wartość fałsz.

Parametry
timeout long: czas oczekiwania w milisekundach przed zwróceniem wartości false.
Zwroty
boolean