IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

Các lớp con gián tiếp đã biết AdbShimDevice, DeviceImpl, DeviceManager.FastbootDevice, IDevice, NullDevice, RemoteAvdIDevice, StubDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice AdbShimDevice Phương thức triển khai phần giữ chỗ AdbShimDevice của IDevice.  DeviceImpl Một thiết bị.  DeviceManager.FastbootDevice Biểu thị một thiết bị ở Chế độ khởi động nhanh.  IDevice Một thiết bị.  NullDevice Một phần giữ chỗ IDevice do DeviceManager dùng để phân bổ khi IDeviceSelection.nullDeviceRequested() là true RemoteAvdIDevice IDevice phần giữ chỗ do DeviceManager dùng để phân bổ khi DeviceSelectionOptions.gceDeviceRequested() là true StubDevice Phương thức triển khai phần giữ chỗ Stub của IDevice.  StubLocalAndroidVirtualDevice IDevice phần giữ chỗ do DeviceManager dùng để phân bổ khi DeviceSelectionOptions.localVirtualDeviceRequested() là true VmRemoteDevice Một thiết bị ảo từ xa mà chúng ta sẽ quản lý từ bên trong Máy ảo.

---

Một thiết bị trừu tượng có thể nhận lệnh shell.

Tóm tắt

Phương thức công khai
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver.
abstract String	getName() Trả về tên (đã được nhân hoá) cho thiết bị này.
abstract ListenableFuture<String>	getSystemProperty(String name) Thực hiện một truy vấn không đồng bộ tiềm năng cho một thuộc tính hệ thống.

Phương thức công khai

executeShellCommand

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

Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver.

maxTimeToOutputResponse được dùng làm thời gian chờ tối đa khi dự kiến đầu ra lệnh từ thiết bị.
Bất cứ lúc nào, nếu lệnh shell không xuất ra bất cứ thứ gì trong khoảng thời gian dài hơn maxTimeToOutputResponse, thì phương thức sẽ gửi ShellCommandUnresponsiveException.

Đối với các lệnh như đầu ra nhật ký, bạn nên dùng maxTimeToOutputResponse giá trị là 0, tức là phương thức sẽ không bao giờ gửi và sẽ chặn cho đến khi IShellOutputReceiver.isCancelled() của trình nhận trả về true.

Tham số
command	String: lệnh shell cần thực thi
receiver	IShellOutputReceiver: IShellOutputReceiver sẽ nhận đầu ra của lệnh shell lệnh
maxTimeout	long: thời gian chờ tối đa để lệnh trả về. Giá trị 0 có nghĩa là sẽ không áp dụng thời gian chờ tối đa.
maxTimeToOutputResponse	long: khoảng thời gian tối đa mà lệnh được phép không xuất ra bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ chờ đầu ra của lệnh mãi mãi (cho đến khi receiver huỷ quá trình thực thi) và không bao giờ gửi.
maxTimeUnits	TimeUnit: Đơn vị cho các giá trị maxTimeout và maxTimeToOutputResponse khác 0.

Gửi
AdbCommandRejectedException	nếu adb từ chối lệnh.
ShellCommandUnresponsiveException	trong trường hợp lệnh shell không gửi bất kỳ đầu ra nào trong khoảng thời gian dài hơn maxTimeToOutputResponse.
TimeoutException	trong trường hợp xảy ra thời gian chờ trên kết nối khi gửi lệnh.
IOException	trong trường hợp xảy ra lỗi I/O trên kết nối.

Xem thêm:

• DdmPreferences.getTimeOut()

executeShellCommand

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

Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver.

maxTimeToOutputResponse được dùng làm thời gian chờ tối đa khi dự kiến đầu ra lệnh từ thiết bị.
Bất cứ lúc nào, nếu lệnh shell không xuất ra bất cứ thứ gì trong khoảng thời gian dài hơn maxTimeToOutputResponse, thì phương thức sẽ gửi ShellCommandUnresponsiveException.

Đối với các lệnh như đầu ra nhật ký, bạn nên dùng maxTimeToOutputResponse giá trị là 0, tức là phương thức sẽ không bao giờ gửi và sẽ chặn cho đến khi IShellOutputReceiver.isCancelled() của trình nhận trả về true.

Tham số
command	String: lệnh shell cần thực thi
receiver	IShellOutputReceiver: IShellOutputReceiver sẽ nhận đầu ra của lệnh shell lệnh
maxTimeToOutputResponse	long: khoảng thời gian tối đa mà lệnh được phép không xuất ra bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ chờ đầu ra của lệnh mãi mãi (cho đến khi receiver huỷ quá trình thực thi) và không bao giờ gửi.
maxTimeUnits	TimeUnit: Đơn vị cho các giá trị maxTimeToOutputResponse khác 0.

Gửi
AdbCommandRejectedException	nếu adb từ chối lệnh.
ShellCommandUnresponsiveException	trong trường hợp lệnh shell không gửi bất kỳ đầu ra nào trong khoảng thời gian dài hơn maxTimeToOutputResponse.
TimeoutException	trong trường hợp xảy ra thời gian chờ trên kết nối khi gửi lệnh.
IOException	trong trường hợp xảy ra lỗi I/O trên kết nối.

Xem thêm:

• DdmPreferences.getTimeOut()

getName

public abstract String getName ()

Trả về tên (đã được nhân hoá) cho thiết bị này. Thông thường, đây là tên AVD cho AVD và là tổ hợp gồm tên nhà sản xuất, tên mẫu và số sê-ri cho các thiết bị.

Giá trị trả về
String

getSystemProperty

public abstract ListenableFuture<String> getSystemProperty (String name)

Thực hiện một truy vấn không đồng bộ tiềm năng cho một thuộc tính hệ thống.

Tham số
name	String: tên của giá trị cần trả về.

Giá trị trả về
ListenableFuture<String>	a ListenableFuture. get có thể trả về giá trị rỗng.