IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

Известные косвенные подклассы AdbShimDevice , DeviceImpl , DeviceManager.FastbootDevice , IDevice , NullDevice , RemoteAvdIDevice , StubDevice , StubLocalAndroidVirtualDevice , VmRemoteDevice AdbShimDevice AdbShimDevice — это реализация-заполнитель для IDevice . 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 maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Выполняет команду оболочки на устройстве и отправляет результат receiver .
abstract void	executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Выполняет команду оболочки на устройстве и отправляет результат receiver .
abstract String	getName () Возвращает (очеловеченное) название для этого устройства.
abstract ListenableFuture<String>	getSystemProperty (String name) Выполните потенциально асинхронный запрос к системному свойству.

Общедоступные методы

executeShellCommand

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

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

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

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

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

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

См. также:

• DdmPreferences.getTimeOut()

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 .

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

См. также:

• DdmPreferences.getTimeOut()

getName

public abstract String getName ()

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

Возвраты
String

получитьСистемноеСвойство

public abstract ListenableFuture<String> getSystemProperty (String name)

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

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

Возвраты
ListenableFuture<String>	ListenableFuture. get может вернуть null.