Menadżer urządzeń

public class DeviceManager
extends Object implements IDeviceManager

Obiekt Java.lang.Object
com.android.tradefed.device.DeviceManager


Streszczenie

Zagnieżdżone klasy

class DeviceManager.FastbootDevice

Reprezentacja urządzenia w trybie Fastboot.

Pola

public static final String UNKNOWN_DISPLAY_STRING

Wyświetl ciąg znaków dla nieznanych właściwości

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Konstruktorzy publiczni

DeviceManager ()

Menedżer urządzeń powinien zostać pobrany z pliku GlobalConfiguration

Metody publiczne

void addAvailableDevice (IDevice stubDevice)
void addDeviceMonitor ( IDeviceMonitor mon)

Dodaje IDeviceMonitor

void addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener ( IDeviceManager.IFastbootListener listener)

Informuje menedżera, że ​​słuchacz jest zainteresowany zmianami stanu fastboot.

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Dodaj urządzenie do monitora fastboot.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Poproś o urządzenie do testów, które spełnia określone kryteria.

ITestDevice allocateDevice ( IDeviceSelection options)

Poproś o urządzenie do testów, które spełnia określone kryteria.

ITestDevice allocateDevice ()

Poproś o urządzenie fizyczne do przetestowania

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 poprzez disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Zwrócone ITestDevice będzie dostępne w trybie online, ale może nie odpowiadać.

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Odłącz się od urządzenia podłączonego za pomocą protokołu adb-over-tcp.

void displayDevicesInfo (PrintWriter stream, 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 .

CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)

Metoda pomocnicza umożliwiająca wykonanie polecenia powłoki na dostępnym urządzeniu.

String executeGlobalAdbCommand (String... cmdArgs)

Wykonaj polecenie adb, które nie jest skierowane do konkretnego urządzenia, np.

ITestDevice forceAllocateDevice (String serial)

Niegrzecznie przydzielaj urządzenie, nawet jeśli nie jest ono aktualnie dostępne.

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Zwróć urządzenie do basenu

Próby zwrotu urządzenia, które nie zostało wcześniej przydzielone, będą ignorowane.

String getAdbPath ()

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

String getAdbVersion ()

Pobierz wersję adb aktualnie używaną przez menedżera urządzeń.

DeviceDescriptor getDeviceDescriptor (String serial)

Zwraca DeviceDescriptor z podanym numerem seryjnym.

String getFastbootPath ()

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Zainicjuj menedżera urządzeń.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Zainicjuj menedżera urządzeń.

void init ()

Zainicjuj menedżera urządzeń.

boolean isEmulator (String serial)

Określ, czy podany numer seryjny reprezentuje emulator

boolean isFileSystemMountCheckEnabled ()

Zwraca informację, czy powinniśmy sprawdzić w NativeDeviceStateMonitor , czy system plików jest poprawnie zamontowany.

boolean isNullDevice (String serial)

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

void killEmulator ( ITestDevice device)

Zamknij podany emulator.

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

Metoda pomocnicza do uruchomienia emulatora.

listAllDevices (boolean shortDescriptor)

Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń

listAllDevices ()

Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń

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

void removeDeviceMonitor ( IDeviceMonitor mon)

Usuwa wcześniej dodany IDeviceMonitor .

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge ()

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

void stopAdbBridge ()

Zatrzymaj most adb, a usługi zależą od połączeń adb.

void terminate ()

Zatrzymuje usługi monitorowania urządzeń i zamyka bibliotekę ddm.

void terminateDeviceMonitor ()

Zatrzymaj monitory urządzeń.

void terminateDeviceRecovery ()

Zatrzymuje wątek odzyskiwania urządzenia.

void terminateHard (String reason)

Podobnie jak terminateHard() .

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

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

Pola

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Wyświetl ciąg znaków dla nieznanych właściwości

mDvc pon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootWłączony

protected boolean mFastbootEnabled

Konstruktorzy publiczni

Menadżer urządzeń

public DeviceManager ()

Menedżer urządzeń powinien zostać pobrany z pliku GlobalConfiguration

Metody publiczne

dodajDostępne Urządzenie

public void addAvailableDevice (IDevice stubDevice)

Parametry
stubDevice IDevice

dodajMonitor urządzenia

public void addDeviceMonitor (IDeviceMonitor mon)

Dodaje IDeviceMonitor

Parametry
mon IDeviceMonitor

dodaj urządzenie Fastboot

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parametry
fastbootDevice DeviceManager.FastbootDevice

dodajFastbootListener

public 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 istnieje jeden lub więcej aktywnych słuchaczy.

DO ZROBIENIA: to trochę hack - znajdź lepsze rozwiązanie

addMonitoringTcpFastbootDevice

public 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 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 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 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 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 poprzez disconnectFromTcpDevice(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 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 void displayDevicesInfo (PrintWriter stream, 
                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
stream 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 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 .

wykonajGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Wykonaj polecenie adb, które nie jest skierowane do konkretnego urządzenia, np. „połączenie adb”

Zwroty
String standardowe wyjście, jeśli polecenie zakończy się sukcesem, w przeciwnym razie null.

wymuś przydzielenie urządzenia

public 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 void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

deviceState FreeDeviceState : FreeDeviceState . Służy do kontrolowania, czy urządzenie wraca do dostępnej puli urządzeń.

pobierzAdbPath

public String getAdbPath ()

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

Zwroty
String

pobierz wersję Adb

public String getAdbVersion ()

Pobierz wersję adb aktualnie używaną przez menedżera urządzeń.

Zwroty
String

pobierzDeviceDescriptor

public 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 String getFastbootPath ()

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

Zwroty
String

w tym

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

Zainicjuj menedżera urządzeń. Należy to wywołać raz i tylko raz, zanim zostaną wywołane jakiekolwiek inne metody.

Parametry
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

w tym

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Zainicjuj menedżera urządzeń. Należy to wywołać raz i tylko raz, zanim zostaną wywołane jakiekolwiek inne metody.

Parametry
globalDeviceFilter IDeviceSelection : filtr urządzenia

globalDeviceMonitors

w tym

public 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 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 boolean isNullDevice (String serial)

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

Parametry
serial String

Zwroty
boolean

zabij emulator

public 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

uruchomEmulator

public 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 : argumenty wiersza poleceń umożliwiające uruchomienie emulatora

Rzuca
DeviceNotAvailableException

listaWszystkieUrządzenia

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

Zwraca listę DeviceDescriptors dla wszystkich znanych urządzeń

Zwroty
lista DeviceDescriptor dla wszystkich znanych urządzeń

ponownie podłącz urządzenie doTcp

public 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

usuńMonitor urządzenia

public 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 void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

uruchom ponownie AdbBridge

public void restartAdbBridge ()

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

zatrzymajAdbBridge

public void stopAdbBridge ()

Zatrzymaj most adb, a usługi zależą od połączeń adb.

zakończyć

public void terminate ()

Zatrzymuje usługi monitorowania urządzeń i zamyka bibliotekę ddm.

Należy to wywołać po zakończeniu aplikacji.

zakończyćDeviceMonitor

public void terminateDeviceMonitor ()

Zatrzymaj monitory urządzeń.

zakończyć odzyskiwanie urządzenia

public 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 void terminateHard ()

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

WaitForFirstDeviceAdded

public 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