IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

Znane podklasy pośrednie AdbShimDevice, DeviceImpl, DeviceManager.FastbootDevice, IDevice, NullDevice, RemoteAvdIDevice, StubDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice AdbShimDevice Implementacja zastępcza IDevice w AdbShimDevice.  DeviceImpl urządzenie,  DeviceManager.FastbootDevice Ilustracja urządzenia w trybie Fastboot Mode.  IDevice urządzenie,  NullDevice Symbol zastępczy IDevice używany przez DeviceManager do określania, kiedy IDeviceSelection.nullDeviceRequested() jest true. RemoteAvdIDevice Symbol zastępczy IDevice używany przez DeviceManager do określania, kiedy DeviceSelectionOptions.gceDeviceRequested() jest true. StubDevice Implementacja zastępcza interfejsu IDevice.  StubLocalAndroidVirtualDevice Symbol zastępczy IDevice używany przez DeviceManager do określania, kiedy DeviceSelectionOptions.localVirtualDeviceRequested() jest true. VmRemoteDevice Zdalne urządzenie wirtualne, którym będziemy zarządzać z poziomu maszyny wirtualnej.

---

Abstrakcyjne urządzenie, które może odbierać polecenia powłoki.

Podsumowanie

Metody publiczne
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do receiver.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do receiver.
abstract String	getName() Zwraca (zrozumiałą dla człowieka) nazwę tego urządzenia.
abstract ListenableFuture<String>	getSystemProperty(String name) Wykonywanie potencjalnego zapytania asynchronicznego dotyczącego właściwości systemu.

Metody publiczne

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do receiver.

maxTimeToOutputResponse jest używany jako maksymalny czas oczekiwania, gdy oczekiwane jest wyjście polecenia z urządzenia.
Jeśli w dowolnym momencie polecenie powłoki nie wygeneruje żadnych danych wyjściowych przez okres dłuższy niż maxTimeToOutputResponse, metoda zgłosi wyjątek ShellCommandUnresponsiveException.

W przypadku poleceń takich jak dane wyjściowe dziennika należy używać wartości maxTimeToOutputResponse 0, co oznacza, że metoda nigdy nie zgłosi wyjątku i będzie blokować działanie do momentu, aż funkcja IShellOutputReceiver.isCancelled() odbiorcy zwróci wartość true.

Parametry
command	String: polecenie powłoki do wykonania
receiver	IShellOutputReceiver: IShellOutputReceiver, który otrzyma wynik polecenia powłoki
maxTimeout	long: maksymalny czas oczekiwania na zwrócenie polecenia. Wartość 0 oznacza, że nie zostanie zastosowany maksymalny czas oczekiwania.
maxTimeToOutputResponse	long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (do momentu, gdy receiver anuluje wykonanie) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits	TimeUnit: jednostki dla wartości maxTimeout i maxTimeToOutputResponse innych niż zero.

Zgłasza
AdbCommandRejectedException	jeśli adb odrzuci polecenie.
ShellCommandUnresponsiveException	w przypadku, gdy polecenie powłoki nie wysyła żadnych danych wyjściowych przez okres dłuższy niż maxTimeToOutputResponse.
TimeoutException	w przypadku przekroczenia limitu czasu połączenia podczas wysyłania polecenia.
IOException	w przypadku błędu wejścia/wyjścia w połączeniu.

Zobacz też:

• DdmPreferences.getTimeOut()

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do receiver.

maxTimeToOutputResponse jest używany jako maksymalny czas oczekiwania, gdy oczekiwane jest wyjście polecenia z urządzenia.
Jeśli w dowolnym momencie polecenie powłoki nie wygeneruje żadnych danych wyjściowych przez okres dłuższy niż maxTimeToOutputResponse, metoda zgłosi wyjątek ShellCommandUnresponsiveException.

W przypadku poleceń takich jak dane wyjściowe dziennika należy używać wartości maxTimeToOutputResponse 0, co oznacza, że metoda nigdy nie zgłosi wyjątku i będzie blokować działanie do momentu, aż funkcja IShellOutputReceiver.isCancelled() odbiorcy zwróci wartość true.

Parametry
command	String: polecenie powłoki do wykonania
receiver	IShellOutputReceiver: IShellOutputReceiver, który otrzyma wynik polecenia powłoki
maxTimeToOutputResponse	long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi. Wartość 0 oznacza, że metoda będzie czekać w nieskończoność (do momentu, gdy receiver anuluje wykonanie) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
maxTimeUnits	TimeUnit: jednostki dla wartości maxTimeToOutputResponse innych niż zero.

Zgłasza
AdbCommandRejectedException	jeśli adb odrzuci polecenie.
ShellCommandUnresponsiveException	w przypadku, gdy polecenie powłoki nie wysyła żadnych danych wyjściowych przez okres dłuższy niż maxTimeToOutputResponse.
TimeoutException	w przypadku przekroczenia limitu czasu połączenia podczas wysyłania polecenia.
IOException	w przypadku błędu wejścia/wyjścia w połączeniu.

Zobacz też:

• DdmPreferences.getTimeOut()

getName

public abstract String getName ()

Zwraca (zrozumiałą dla człowieka) nazwę tego urządzenia. W przypadku AVD jest to zwykle nazwa AVD, a w przypadku urządzeń – połączenie nazwy producenta, nazwy modelu i numeru seryjnego.

Zwraca
String

getSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

Wykonywanie potencjalnego zapytania asynchronicznego dotyczącego właściwości systemu.

Parametry
name	String: nazwa wartości do zwrócenia.

Zwraca
ListenableFuture<String>	ListenableFuture. get może zwracać wartość null.