DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

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

Podsumowanie

Zagnieżdżone klasy

class DeviceManager.FastbootDevice

Ilustracja urządzenia w trybie Fastboot Mode. 

Stałe

String UNKNOWN_DISPLAY_STRING

Ciąg tekstowy do wyświetlania nieznanych właściwości

Pola

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Konstruktory publiczne

DeviceManager()

Obiekt DeviceManager należy pobrać z obiektu 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 odbiorca jest zainteresowany zmianami stanu fastboot.

void addMonitoringTcpFastbootDevice(String serial, String fastbootSerial)

Dodaj urządzenie do monitora fastboot.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice(IDeviceSelection options)

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

ITestDevice allocateDevice()

Prośba o urządzenie fizyczne do testowania

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

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

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Odłącz urządzenie połączone za pomocą 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 w przypadku często 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, które nie jest kierowane na konkretne urządzenie, np.

ITestDevice forceAllocateDevice(String serial)

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

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Wkładanie urządzenia z powrotem 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, który ma być używany.

String getAdbVersion()

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

DeviceDescriptor getDeviceDescriptor(String serial)

Zwraca obiekt DeviceDescriptor o podanym numerze seryjnym.

String getFastbootPath()

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

long getShellCheckCmdTime()

Pobiera limit czasu w milisekundach polecenia sprawdzającego dostępność powłoki.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Zainicjuj menedżera urządzeń.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors)

Zainicjuj menedżera urządzeń.

void init()

Zainicjuj menedżera urządzeń.

boolean isEmulator(String serial)

Określanie, czy dany numer seryjny reprezentuje emulator

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

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

void killEmulator(ITestDevice device)

Wyłącz podany emulator.

void launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, List<String> emulatorArgs)

Metoda pomocnicza do uruchamiania emulatora.

List<DeviceDescriptor> listAllDevices(boolean shortDescriptor)

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

List<DeviceDescriptor> listAllDevices()

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

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

void removeDeviceMonitor(IDeviceMonitor mon)

Usuwa wcześniej dodany komponent IDeviceMonitor.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void removeMonitoringTcpFastbootDevice(String serial)

void restartAdbBridge()

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

void stopAdbBridge()

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

void terminateDeviceRecovery()

Zatrzymuje wątek odzyskiwania urządzenia.

void terminateHard(String reason)

Podobne do: terminateHard()

void terminateHard()

Podobnie jak terminate(), ale próbuje też wymusić wyłączenie adb.

boolean waitForFirstDeviceAdded(long timeout)

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

Stałe

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Ciąg tekstowy do wyświetlania nieznanych właściwości

Wartość stała: "unknown"

Pola

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Konstruktory publiczne

DeviceManager

public DeviceManager ()

Obiekt DeviceManager należy pobrać z obiektu 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 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 void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

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.
fastbootSerial String: numer seryjny urządzenia w trybie fastboot.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Poproś o urządzenie 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.
Zwraca
ITestDevice ITestDevice do testowania lub null, jeśli nie jest dostępny.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

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

Parametry
options IDeviceSelection: IDeviceSelection, które urządzenie powinno spełniać.
Zwraca
ITestDevice ITestDevice do testowania lub null, jeśli nie jest dostępny.

allocateDevice

public ITestDevice allocateDevice ()

Prośba o urządzenie fizyczne do testowania

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

connectToTcpDevice

public 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(ITestDevice).

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

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 wygenerowanie DeviceNotAvailableException

Parametry
ipAndPort String: oryginalny adres IP i port urządzenia, z którym ma być nawiązane połączenie
Zwraca
ITestDevice ITestDevice lub null, jeśli nie udało się utworzyć połączenia TCP.

disconnectFromTcpDevice

public 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 jest obecnie w trybie TCP, wcześniej przydzielone za pomocą connectToTcpDevice(String)
Zwraca
boolean true, jeśli przełączenie na tryb USB się powiodło

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Wygeneruj 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
stream PrintWriter: PrintWriter, do którego ma być zapisany opis.
includeStub boolean: określa, czy wyświetlać też urządzenia zastępcze.

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 potrzebny na wykonanie polecenia.
timeUnit TimeUnit: Jednostka czasu oczekiwania.
Zwraca
CommandResult A CommandResult

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Wykonywanie polecenia adb, które nie jest kierowane na konkretne urządzenie, np. „adb connect”

Zwraca
String Standardowe dane wyjściowe, jeśli polecenie zakończy się powodzeniem, w przeciwnym razie wartość null.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

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

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

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Wkładanie urządzenia z powrotem do basenu

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

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

getAdbPath

public String getAdbPath ()

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

Zwraca
String

getAdbVersion

public String getAdbVersion ()

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

Zwraca
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Zwraca obiekt DeviceDescriptor o podanym numerze seryjnym.

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

getFastbootPath

public String getFastbootPath ()

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

Zwraca
String

getShellCheckCmdTime

public long getShellCheckCmdTime ()

Pobiera limit czasu w milisekundach polecenia sprawdzającego dostępność powłoki.

Zwraca
long

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

Parametry
globalDeviceFilter IDeviceSelection

globalDeviceMonitors List

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors)

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

Parametry
globalDeviceFilter IDeviceSelection: filtr urządzeń
globalDeviceMonitors List

init

public void init ()

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

isEmulator

public boolean isEmulator (String serial)

Określanie, czy dany numer seryjny reprezentuje emulator

Parametry
serial String

Zwraca
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Zwraca
boolean

isNullDevice

public boolean isNullDevice (String serial)

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

Parametry
serial String

Zwraca
boolean

killEmulator

public void killEmulator (ITestDevice device)

Wyłącz podany emulator.

Blokuje, dopóki emulator nie 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

launchEmulator

public void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                List<String> 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 List: argumenty wiersza poleceń do uruchomienia emulatora
Zgłasza
DeviceNotAvailableException

listAllDevices

public List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

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

Parametry
shortDescriptor boolean: czy ograniczyć deskryptory do minimum informacji
Zwraca
List<DeviceDescriptor> listę DeviceDescriptor wszystkich znanych urządzeń,

listAllDevices

public List<DeviceDescriptor> listAllDevices ()

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

Zwraca
List<DeviceDescriptor> listę DeviceDescriptor wszystkich znanych urządzeń,

reconnectDeviceToTcp

public 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
Zwraca
ITestDevice nowo przydzielony ITestDevice w trybie TCP lub null, jeśli nie udało się nawiązać połączenia TCP.
Zgłasza
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parametry
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Parametry
serial String

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

zamknąć | usunąć

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

Zatrzymaj monitory urządzeń.

terminateDeviceRecovery

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

Podobnie jak terminate(), ale próbuje też wymusić wyłączenie adb.

waitForFirstDeviceAdded

public 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 funkcja zwraca wartość false.

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