Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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 IDeviceMonitor

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 przez disconnectFromTcpDevice(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 IDeviceSelection .

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 NativeDeviceStateMonitor czy system plików jest prawidłowo zamontowany.

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 connectToTcpDevice(String) .

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

Usuwa poprzednio dodany IDeviceMonitor .

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 stopAdbBridge() ) most adb i usługi zależą od połączeń adb.

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 terminateHard() .

abstract void terminateHard ()

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

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.

Obecnie IDeviceManager 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 przez disconnectFromTcpDevice(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 : argumenty wiersza poleceń do uruchomienia emulatora

Rzuty
DeviceNotAvailableException jeśli emulator nie uruchamia się lub nie przechodzi w tryb online

listaWszystkichUrządzeń

public abstract  listAllDevices (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 abstract  listAllDevices ()

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.

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