Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

Znane podklasy pośrednie

DeviceImpl, DeviceManager.FastbootDevice, IDevice, NullDevice, RemoteAvdIDevice, StubDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

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 maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Wykonuje polecenie powłoki na urządzeniu i wysyła wynik do `receiver`.
`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 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 maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

maxTimeToOutputResponse jest używany jako maksymalny czas oczekiwania na dane wyjściowe 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 log output należy używać wartości maxTimeToOutputResponse 0, co oznacza, że metoda nigdy nie zgłosi wyjątku i będzie blokować się 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ść (dopóki `receiver` nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
`maxTimeUnits`	`TimeUnit`: jednostki dla wartości `maxTimeToOutputResponse` innych niż zero.

Zgłasza
`TimeoutException`	w przypadku przekroczenia limitu czasu połączenia podczas wysyłania polecenia.
`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`.
	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 maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

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ść (dopóki `receiver` nie anuluje wykonania) na dane wyjściowe polecenia i nigdy nie zgłosi wyjątku.
`maxTimeUnits`	`TimeUnit`: jednostki dla wartości innych niż zero w polach `maxTimeout` i `maxTimeToOutputResponse`.

Zgłasza
`TimeoutException`	w przypadku przekroczenia limitu czasu połączenia podczas wysyłania polecenia.
`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`.
	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.

Zwroty
`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.

Zwroty
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)` może zwracać wartość null.