DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
   ↳ com.android.tradefed.device.DeviceManager

Podsumowanie

Zagnieżdżone klasy

class DeviceManager.FastbootDevice

Urządzenie w trybie Fastboot Mode. 

Fieldsem

public static final String UNKNOWN_DISPLAY_STRING

Wyświetlany ciąg tekstowy w przypadku nieznanych właściwości

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Konstruktory publiczne

DeviceManager()

Klasę DeviceManager należy pobrać z poziomu GlobalConfiguration

Metody publiczne

void addAvailableDevice(IDevice stubDevice)
void addAvailableNativeDevice(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 szybkiego uruchamiania.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice(IDeviceSelection options)

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

ITestDevice allocateDevice()

Prośba o fizyczne urządzenie do testowania

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.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

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

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

Metoda pomocnicza do wykonywania poleceń powłoki na dostępnym urządzeniu.

String executeGlobalAdbCommand(String... cmdArgs)

Wykonywanie polecenia adb niekierowanego do konkretnego urządzenia, np.

ITestDevice forceAllocateDevice(String serial)

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

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Zwracanie urządzenia do puli

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

String getAdbPath()

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

String getAdbVersion()

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

DeviceDescriptor getDeviceDescriptor(String serial)

Zwraca DeviceDescriptor o podanym numerze seryjnym.

String getFastbootPath()

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

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inicjalizacja menedżera urządzenia.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inicjalizacja menedżera urządzenia.

void init()

Inicjalizacja menedżera urządzenia.

boolean isEmulator(String serial)

Określanie, czy podany numer seryjny reprezentuje emulator

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

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

void killEmulator(ITestDevice device)

Wyłącz dany emulator.

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

Pomocnicza metoda uruchamiania 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 za pomocą connectToTcpDevice(String).

void removeDeviceMonitor(IDeviceMonitor mon)

Usuwa wcześniej dodany komponent typu IDeviceMonitor.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge()

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

void stopAdbBridge()

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

void terminate()

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

void terminateDeviceMonitor()

Zatrzymaj monitorowanie urządzenia.

void terminateDeviceRecovery()

Zatrzymuje wątek odzyskiwania urządzenia.

void terminateHard(String reason)

terminateHard().

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

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

Fieldsem

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Wyświetlany ciąg tekstowy w przypadku nieznanych właściwości

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Konstruktory publiczne

DeviceManager

public DeviceManager ()

Klasę DeviceManager należy pobrać z poziomu GlobalConfiguration

Metody publiczne

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Parametry
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

Parametry
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Dodaje IDeviceMonitor

Parametry
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parametry
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

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 szybkiego uruchamiania tylko wtedy, gdy będzie na nich co najmniej 1 aktywny odbiornik.

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

addMonitoringTcpFastbootDevice

public 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 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 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 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 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 urządzeniem i wywoła błąd 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 udało się utworzyć połączenia TCP.

disconnectFromTcpDevice

public 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 void displayDevicesInfo (PrintWriter stream, 
                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
stream PrintWriter: ERROR(/PrintWriter), do którego ma zostać wyprowadzony opis.
includeStub boolean: określa, czy wyświetlać również stuby urządzeń.

executeCmdOnAvailableDevice

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

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Wykonywanie polecenia adb niekierowanego do konkretnego urządzenia, np. „adb connect”

Zwroty
String Dane wyjściowe standardowe, jeśli polecenie zakończyło się pomyślnie, w przeciwnym razie null.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Przydzielenie 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 było go przydzielić

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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
deviceState FreeDeviceState: FreeDeviceState. Służy do określenia, czy urządzenie ma zostać zwrócone do puli dostępnych urządzeń.

getAdbPath

public String getAdbPath ()

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

Zwroty
String

getAdbVersion

public String getAdbVersion ()

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

Zwroty
String

getDeviceDescriptor

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

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

Zwroty
String

init

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

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

Parametry
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

Parametry
globalDeviceFilter IDeviceSelection: filtr urządzeń
globalDeviceMonitors

init

public void init ()

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

isEmulator

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

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

Parametry
serial String

Zwroty
boolean

killEmulator

public 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

launchEmulator

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

Pomocnicza metoda 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

listAllDevices

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

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

Zwroty
lista DeviceDescriptor dla wszystkich znanych urządzeń;

reconnectDeviceToTcp

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

Parametry
usbDevice ITestDevice: urządzenie jest obecnie 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

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametry
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

zakończyć

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

Zatrzymaj monitorowanie urządzeń.

terminateDeviceRecovery

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

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

waitForFirstDeviceAdded

public 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