Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

Известные косвенные подклассы

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

DeviceImpl	Устройство.
DeviceManager.FastbootDevice	Представление устройства в режиме Fastboot.
IDevice	Устройство.
NullDevice	Заполнитель `IDevice` используемый `DeviceManager` для выделения, когда `IDeviceSelection.nullDeviceRequested()` имеет `true`
RemoteAvdIDevice	Заполнитель `IDevice` используемый `DeviceManager` для выделения, когда `DeviceSelectionOptions.gceDeviceRequested()` имеет `true`
StubDevice	Реализация заглушки-заполнителя `IDevice` .
StubLocalAndroidVirtualDevice	Заполнитель `IDevice` используемый `DeviceManager` для выделения, когда `DeviceSelectionOptions.localVirtualDeviceRequested()` имеет `true`
VmRemoteDevice	Удаленное виртуальное устройство, которым мы будем управлять изнутри виртуальной машины.

Абстрактное устройство, которое может принимать команды оболочки.

Краткое содержание

Публичные методы
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Выполняет команду оболочки на устройстве и отправляет результат `receiver` .
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Выполняет команду оболочки на устройстве и отправляет результат `receiver` .
`abstract String`	`getName ()` Возвращает (человеческое) имя для этого устройства.
`abstract ListenableFuture<String>`	`getSystemProperty (String name)` Выполните потенциальный асинхронный запрос к системному свойству.

Публичные методы

executeShellCommand

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

Выполняет команду оболочки на устройстве и отправляет результат receiver .

maxTimeToOutputResponse используется как максимальное время ожидания при ожидании вывода команды от устройства.
В любой момент, если команда оболочки не выводит ничего в течение периода, превышающего maxTimeToOutputResponse , метод выдаст исключение ShellCommandUnresponsiveException .

Для таких команд, как вывод журнала, следует использовать значение maxTimeToOutputResponse , равное 0, что означает, что метод никогда не выдаст исключение и будет блокироваться до тех пор, пока IShellOutputReceiver.isCancelled() получателя не вернет true .

Параметры
`command`	`String` : команда оболочки для выполнения
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` , который будет получать вывод команды оболочки.
`maxTimeToOutputResponse`	`long` : максимальное время, в течение которого команда может не выводить никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока `receiver` не отменит выполнение) и никогда не выдаст исключение.
`maxTimeUnits`	`TimeUnit` : Единицы измерения для ненулевых значений `maxTimeToOutputResponse` .

Броски
`TimeoutException`	в случае тайм-аута соединения при отправке команды.
`AdbCommandRejectedException`	если adb отклоняет команду.
`ShellCommandUnresponsiveException`	в случае, если команда оболочки не отправляет никаких выходных данных в течение периода, превышающего `maxTimeToOutputResponse` .
	в случае ошибки ввода-вывода при соединении.

Смотрите также:

DdmPreferences.getTimeOut()

executeShellCommand

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

Выполняет команду оболочки на устройстве и отправляет результат receiver .

Параметры
`command`	`String` : команда оболочки для выполнения
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` , который будет получать вывод команды оболочки.
`maxTimeout`	`long` : максимальное время ожидания для возврата команды. Значение 0 означает, что максимальное время ожидания не применяется.
`maxTimeToOutputResponse`	`long` : максимальное время, в течение которого команда может не выводить никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока `receiver` не отменит выполнение) и никогда не выдаст исключение.
`maxTimeUnits`	`TimeUnit` : Единицы измерения для ненулевых значений `maxTimeout` и `maxTimeToOutputResponse` .

Броски
`TimeoutException`	в случае тайм-аута соединения при отправке команды.
`AdbCommandRejectedException`	если adb отклоняет команду.
`ShellCommandUnresponsiveException`	в случае, если команда оболочки не отправляет никаких выходных данных в течение периода, превышающего `maxTimeToOutputResponse` .
	в случае ошибки ввода-вывода при соединении.

Смотрите также:

DdmPreferences.getTimeOut()

получитьИмя

public abstract String getName ()

Возвращает (человеческое) имя для этого устройства. Обычно это имя AVD для AVD или комбинация названия производителя, названия модели и серийного номера для устройств.

Возврат
`String`

получитьSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

Выполните потенциальный асинхронный запрос к системному свойству.

Параметры
`name`	`String` : имя возвращаемого значения.

Возврат
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)` может вернуть null.