IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Znane podklasy pośrednie DeviceManager DeviceManager

---

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.

Zobacz też:

• AndroidDebugBridge.terminate()

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