IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

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

Podsumowanie

Zagnieżdżone klasy

interface IDeviceManager.IFastbootListener

Detektor zmian stanu fastboot. 

Metody publiczne

abstract void addDeviceMonitor(IDeviceMonitor mon)

Dodaje IDeviceMonitor

abstract void addFastbootListener(IDeviceManager.IFastbootListener listener)

Informuje menedżera, że odbiorca 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()

Prośba o urządzenie fizyczne do testowania

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Nawiązywanie połączenia z urządzeniem za pomocą adb-over-tcp

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

Zwrócony ITestDevice będzie online, ale może nie odpowiadać.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Odłącz urządzenie połączone za pomocą adb-over-tcp.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Wyświetla przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości w przypadku często używanych opcji IDeviceSelection.

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

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

abstract ITestDevice forceAllocateDevice(String serial)

przydzielać urządzenie w sposób nieuprzejmy, nawet jeśli nie jest ono obecnie dostę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, będą ignorowane.

abstract String getAdbPath()

Zwraca ścieżkę do pliku binarnego adb, który ma być używany.

abstract String getAdbVersion()

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

abstract DeviceDescriptor getDeviceDescriptor(String serial)

Zwraca obiekt DeviceDescriptor o podanym numerze seryjnym.

abstract String getFastbootPath()

Zwraca ścieżkę do pliku binarnego fastboot, którego należy użyć.

abstract void 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ślanie, czy dany numer seryjny reprezentuje emulator

default boolean isFileSystemMountCheckEnabled()

Zwraca informację, czy należy sprawdzić, czy system plików NativeDeviceStateMonitor jest prawidłowo zamontowany.

abstract boolean isNullDevice(String serial)

Określ, czy dany numer seryjny reprezentuje urządzenie puste

abstract void killEmulator(ITestDevice device)

Wyłącz podany emulator.

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

Metoda pomocnicza do uruchamiania emulatora.

abstract listAllDevices(boolean shortDescriptor)

Zwraca listę obiektów DeviceDescriptor wszystkich znanych urządzeń.

abstract listAllDevices()

Zwraca listę obiektów DeviceDescriptor wszystkich znanych urządzeń.

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Metoda pomocnicza, która przełącza podane 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 element IDeviceMonitor.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Informuje menedżera, że odbiorca nie jest już zainteresowany zmianami stanu szybkiego uruchamiania.

default void removeMonitoringTcpFastbootDevice(String serial)
abstract void restartAdbBridge()

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

abstract void stopAdbBridge()

Zatrzymaj mostek 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 monitory urządzeń.

abstract void terminateDeviceRecovery()

Zatrzymuje wątek odzyskiwania urządzenia.

default void terminateHard(String reason)

Podobne do: terminateHard()

abstract void terminateHard()

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

abstract boolean waitForFirstDeviceAdded(long timeout)

Poczekaj, aż pierwsze urządzenie fizyczne zostanie podłą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 odbiorca jest zainteresowany zmianami stanu fastboot.

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

TODO: to trochę obejście problemu – 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ć zmiennej „fastboot_serial” do komunikacji z urządzeniem.

Parametry
serial String: numer seryjny urządzenia.
fastboot_serial String: numer seryjny urządzenia w trybie fastboot.

allocateDevice

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 powinno spełniać urządzenie.
isTemporary boolean: czy należy utworzyć tymczasowe urządzenie NullDevice.
Zwroty
ITestDevice ITestDevice do testowania lub null, jeśli nie jest dostępny.

allocateDevice

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 powinno spełniać urządzenie.
Zwroty
ITestDevice ITestDevice do testowania lub null, jeśli nie jest dostępny.

allocateDevice

public abstract ITestDevice allocateDevice ()

Prośba o urządzenie fizyczne do testowania

Zwroty
ITestDevice ITestDevice do testowania lub null, jeśli nie jest dostępny.

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Nawiązywanie połączenia z urządzeniem za pomocą adb-over-tcp

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

Zwrócony ITestDevice będzie online, ale może nie odpowiadać.

Pamiętaj, że wykonanie działania, takiego jak ponowne uruchomienie urządzenia połączonego przez TCP, spowoduje zerwanie połączenia TCP z urządzeniem i wyświetlenie komunikatu 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ę nawiązać połączenia TCP.

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Odłącz urządzenie połączone za pomocą adb-over-tcp.

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

Parametry
tcpDevice ITestDevice: urządzenie w trybie TCP, wcześniej przydzielone za pomocą connectToTcpDevice(String)
Zwroty
boolean true, jeśli przełączenie na tryb USB się powiodło

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Wyświetla przyjazny dla użytkownika opis zawierający listę znanych urządzeń, ich stan i wartości w przypadku często używanych opcji IDeviceSelection.

Parametry
printWriter PrintWriter: ERROR(/PrintWriter), do którego ma być zapisany opis.
includeStub boolean: określa, czy wyświetlać też urządzenia zastępcze.

executeCmdOnAvailableDevice

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

Metoda pomocnicza do wykonywania 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 czasu oczekiwania.
Zwroty
CommandResult A CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

przydzielać urządzenie w sposób nieuprzejmy, nawet jeśli nie jest ono obecnie dostępne;

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

Parametry
serial String: numer seryjny urządzenia do przypisania.
Zwroty
ITestDevice ITestDevice lub null, jeśli nie udało się go przydzielić.

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, będą ignorowane.

Parametry
device ITestDevice: ITestDevice bezpłatnie
state FreeDeviceState: FreeDeviceState. Używany do określania, czy urządzenie ma zostać zwrócone do puli dostępnych urządzeń.

getAdbPath

public abstract String getAdbPath ()

Zwraca ścieżkę do pliku binarnego adb, który ma być używany.

Zwroty
String

getAdbVersion

public abstract String getAdbVersion ()

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

Zwroty
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Zwraca obiekt DeviceDescriptor o podanym numerze seryjnym.

Parametry
serial String: numer seryjny urządzenia, które chcesz uzyskać
Zwroty
DeviceDescriptor DeviceDescriptor dla wybranego urządzenia lub wartość null, jeśli numer seryjny nie pasuje do znanego urządzenia.

getFastbootPath

public abstract String getFastbootPath ()

Zwraca ścieżkę do pliku binarnego fastboot, którego należy użyć.

Zwroty
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Zainicjuj menedżera urządzeń za pomocą filtra urządzeń. Ten filtr może służyć do instruowania narzędzia DeviceManager, aby ignorowało niektóre podłączone urządzenia.

Parametry
globalDeviceFilter IDeviceSelection: filtr urządzeń
deviceMonitors

init

public abstract void init ()

Zainicjuj menedżera urządzeń. Tę metodę należy wywołać tylko raz przed wywołaniem innych metod.

isEmulator

public abstract boolean isEmulator (String serial)

Określanie, czy dany numer seryjny reprezentuje emulator

Parametry
serial String

Zwroty
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Zwraca informację, czy należy sprawdzić, czy system plików NativeDeviceStateMonitor jest prawidłowo zamontowany.

Zwroty
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Określ, czy dany numer seryjny reprezentuje urządzenie puste

Parametry
serial String

Zwroty
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Wyłącz podany emulator.

Blokuje do momentu, aż emulator zniknie z adb. Nie będzie to miało wpływu, jeśli emulator jest już niedostępny.

Parametry
device ITestDevice: ITestDevice reprezentujący emulator do wyłączenia
Zgłasza
DeviceNotAvailableException jeśli emulator nie zostanie wyłączony.

launchEmulator

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

Metoda pomocnicza do uruchamiania emulatora.

Uruchomi emulator zgodnie z ustawieniami określonymi przez kod wywołujący.

Parametry
device ITestDevice: symbol zastępczy ITestDevice reprezentujący przydzielone urządzenie emulatora.
bootTimeout long: czas w milisekundach, przez jaki należy czekać na uruchomienie emulatora.
emulatorArgs : argumenty wiersza poleceń do uruchomienia emulatora
Zgłasza
DeviceNotAvailableException jeśli emulator nie uruchomi się lub nie przejdzie w tryb online.

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Zwraca listę obiektów DeviceDescriptor wszystkich znanych urządzeń.

Parametry
shortDescriptor boolean: czy ograniczyć deskryptory do minimum informacji;
Zwroty
listę DeviceDescriptor wszystkich znanych urządzeń,

listAllDevices

public abstract  listAllDevices ()

Zwraca listę obiektów DeviceDescriptor wszystkich znanych urządzeń.

Zwroty
listę DeviceDescriptor wszystkich znanych urządzeń,

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Metoda pomocnicza, która przełącza podane urządzenie USB w tryb adb-over-tcp, a następnie łączy się z nim za pomocą connectToTcpDevice(String).

Parametry
usbDevice ITestDevice: urządzenie, które jest obecnie w trybie USB
Zwroty
ITestDevice nowo przydzielony ITestDevice w trybie TCP lub null, jeśli nie udało się nawiązać połączenia TCP.
Zgłasza
DeviceNotAvailableException jeśli połączenie z usbDevice zostało utracone i nie można go przywrócić;

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Usuwa wcześniej dodany element IDeviceMonitor. Nie ma wpływu, jeśli nie dodano mon.

Parametry
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informuje menedżera, że odbiorca nie jest już zainteresowany zmianami stanu szybkiego uruchamiania.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Parametry
serial String

restartAdbBridge

public abstract void restartAdbBridge ()

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

stopAdbBridge

public abstract void stopAdbBridge ()

Zatrzymaj mostek 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.

Należy ją wywołać po zakończeniu działania aplikacji.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Zatrzymaj monitory urządzeń.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Zatrzymuje wątek odzyskiwania urządzenia.

terminateHard

public void terminateHard (String reason)

Podobne do: terminateHard()

Parametry
reason String: opcjonalny powód zamknięcia konta.

terminateHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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