IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Các lớp con gián tiếp đã biết Quản lý thiết bị Quản lý thiết bị

---

Giao diện quản lý tập hợp các thiết bị có sẵn để thử nghiệm.

Bản tóm tắt

Các lớp lồng nhau
interface	IDeviceManager.IFastbootListener Một trình lắng nghe để thay đổi trạng thái fastboot.

Phương pháp công khai
abstract void	addDeviceMonitor ( IDeviceMonitor mon) Thêm IDeviceMonitor
abstract void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Thông báo cho người quản lý rằng người nghe quan tâm đến các thay đổi trạng thái fastboot.
abstract void	addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Thêm thiết bị vào màn hình khởi động nhanh.
abstract ITestDevice	allocateDevice ( IDeviceSelection options, boolean isTemporary) Yêu cầu một thiết bị để kiểm tra đáp ứng các tiêu chí nhất định.
abstract ITestDevice	allocateDevice ( IDeviceSelection options) Yêu cầu một thiết bị để kiểm tra đáp ứng các tiêu chí nhất định.
abstract ITestDevice	allocateDevice () Yêu cầu một thiết bị vật lý để thử nghiệm
abstract ITestDevice	connectToTcpDevice (String ipAndPort) Kết nối với thiết bị có adb-over-tcp Phương thức này phân bổ một thiết bị mới, thiết bị này cuối cùng sẽ được giải phóng thông qua disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) ITestDevice được trả lại sẽ trực tuyến, nhưng có thể không phản hồi.
abstract boolean	disconnectFromTcpDevice ( ITestDevice tcpDevice) Ngắt kết nối khỏi thiết bị được kết nối adb-over-tcp.
abstract void	displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Đưa ra một mô tả thân thiện với người dùng chứa danh sách các thiết bị đã biết, trạng thái của chúng và các giá trị cho các tùy chọn IDeviceSelection thường được sử dụng.
abstract CommandResult	executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Một phương thức trợ giúp để thực thi lệnh shell trên thiết bị có sẵn.
abstract ITestDevice	forceAllocateDevice (String serial) Phân bổ thiết bị một cách sơ sài, ngay cả khi thiết bị đó hiện không khả dụng.
abstract void	freeDevice ( ITestDevice device, FreeDeviceState state) Trả lại thiết bị cho hồ bơi Các nỗ lực trả lại thiết bị chưa được cấp phát trước đó sẽ bị bỏ qua.
abstract String	getAdbPath () Trả về đường dẫn đến tệp nhị phân adb để sử dụng.
abstract String	getAdbVersion () Nhận phiên bản adb hiện đang được người quản lý thiết bị sử dụng.
abstract DeviceDescriptor	getDeviceDescriptor (String serial) Trả về DeviceDescriptor với chuỗi đã cho.
abstract String	getFastbootPath () Trả về đường dẫn đến tệp nhị phân fastboot để sử dụng.
abstract void	init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Khởi tạo trình quản lý thiết bị bằng bộ lọc thiết bị.
abstract void	init () Khởi tạo trình quản lý thiết bị.
abstract boolean	isEmulator (String serial) Xác định xem nối tiếp đã cho có đại diện cho trình giả lập hay không
default boolean	isFileSystemMountCheckEnabled () Trả về việc chúng ta có nên kiểm tra trong NativeDeviceStateMonitor trong NativeDeviceStateMonitor xem hệ thống tệp có được gắn kết đúng cách hay không.
abstract boolean	isNullDevice (String serial) Xác định xem nối tiếp đã cho đại diện cho một thiết bị rỗng
abstract void	killEmulator ( ITestDevice device) Tắt trình giả lập đã cho.
abstract void	launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Phương thức trợ giúp để khởi chạy trình giả lập.
abstract	listAllDevices (boolean shortDescriptor) Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
abstract	listAllDevices () Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
abstract ITestDevice	reconnectDeviceToTcp ( ITestDevice usbDevice) Một phương pháp trợ giúp chuyển thiết bị usb đã cho sang chế độ adb-over-tcp, sau đó kết nối với nó qua connectToTcpDevice(String) .
abstract void	removeDeviceMonitor ( IDeviceMonitor mon) Xóa IDeviceMonitor đã thêm trước đó.
abstract void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Thông báo cho người quản lý rằng người nghe không còn quan tâm đến các thay đổi trạng thái fastboot.
abstract void	restartAdbBridge () Khởi động lại (nếu stopAdbBridge() được gọi) cầu nối adb và các dịch vụ phụ thuộc vào kết nối adb.
abstract void	stopAdbBridge () Dừng cầu nối adb và các dịch vụ phụ thuộc vào kết nối adb.
abstract void	terminate () Dừng các dịch vụ giám sát thiết bị và chấm dứt thư viện ddm.
abstract void	terminateDeviceMonitor () Dừng Màn hình Thiết bị.
abstract void	terminateDeviceRecovery () Dừng chuỗi khôi phục thiết bị.
default void	terminateHard (String reason) Giống như terminateHard() .
abstract void	terminateHard () Giống như terminate() , nhưng cũng cố gắng tắt mạnh mẽ adb.
abstract boolean	waitForFirstDeviceAdded (long timeout) Chờ cho đến khi thiết bị vật lý đầu tiên được kết nối.

Phương pháp công khai

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Thêm IDeviceMonitor

Thông số
mon	IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Thông báo cho người quản lý rằng người nghe quan tâm đến các thay đổi trạng thái fastboot.

Hiện tại một IDeviceManager sẽ chỉ giám sát các thiết bị trong fastboot nếu có một hoặc nhiều người nghe đang hoạt động.

VIỆC CẦN LÀM: đây là một chút hack - hãy tìm một giải pháp tốt hơn

addMoprisTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Thêm thiết bị vào màn hình khởi động nhanh. Màn hình fastboot sẽ sử dụng 'fastboot_serial' để giao tiếp với thiết bị.

Thông số
serial	String : số sê-ri của thiết bị.
fastboot_serial	String : số sê-ri chế độ khởi động nhanh của thiết bị.

phân bổ

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Yêu cầu một thiết bị để kiểm tra đáp ứng các tiêu chí nhất định.

Thông số
options	IDeviceSelection : IDeviceSelection mà thiết bị phải đáp ứng.
isTemporary	boolean : có nên tạo NullDevice tạm thời hay không.

Lợi nhuận
ITestDevice	một ITestDevice để thử nghiệm hoặc null nếu không có sẵn

phân bổ

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Yêu cầu một thiết bị để kiểm tra đáp ứng các tiêu chí nhất định.

Thông số
options	IDeviceSelection : IDeviceSelection mà thiết bị phải đáp ứng.

Lợi nhuận
ITestDevice	một ITestDevice để thử nghiệm hoặc null nếu không có sẵn

phân bổ

public abstract ITestDevice allocateDevice ()

Yêu cầu một thiết bị vật lý để thử nghiệm

Lợi nhuận
ITestDevice	một ITestDevice để thử nghiệm hoặc null nếu không có sẵn

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Kết nối với thiết bị có adb-over-tcp

Phương thức này phân bổ một thiết bị mới, thiết bị này cuối cùng sẽ được giải phóng thông qua disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

ITestDevice được trả lại sẽ trực tuyến, nhưng có thể không phản hồi.

Lưu ý rằng thực hiện hành động chẳng hạn như khởi động lại trên thiết bị được kết nối tcp, sẽ cắt đứt kết nối tcp với thiết bị và dẫn đến DeviceNotAvailableException

Thông số
ipAndPort	String : địa chỉ ip ban đầu và cổng của thiết bị để kết nối

Lợi nhuận
ITestDevice	ITestDevice hoặc null nếu không thể hình thành kết nối tcp

ngắt kết nốiFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Ngắt kết nối khỏi thiết bị được kết nối adb-over-tcp.

Chuyển thiết bị về chế độ usb và giải phóng thiết bị.

Thông số
tcpDevice	ITestDevice : thiết bị hiện ở chế độ tcp, được cấp phát trước đây qua connectToTcpDevice(String)

Lợi nhuận
boolean	true nếu chuyển sang chế độ usb thành công

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Đưa ra một mô tả thân thiện với người dùng chứa danh sách các thiết bị đã biết, trạng thái của chúng và các giá trị cho các tùy chọn IDeviceSelection thường được sử dụng.

Thông số
printWriter	PrintWriter : ERROR(/PrintWriter) để xuất mô tả sang
includeStub	boolean : Có hay không hiển thị các thiết bị sơ khai.

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Một phương thức trợ giúp để thực thi lệnh shell trên thiết bị có sẵn.

Thông số
serial	String : Sê-ri thiết bị.
command	String : Lệnh shell.
timeout	long : Khoảng thời gian để hoàn thành lệnh.
timeUnit	TimeUnit : Đơn vị thời gian chờ.

Lợi nhuận
CommandResult	Một CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Phân bổ thiết bị một cách sơ sài, ngay cả khi thiết bị đó hiện không khả dụng.

Sẽ không có hiệu lực nếu thiết bị đã được cấp phát.

Thông số
serial	String : chuỗi thiết bị để cấp phát

Lợi nhuận
ITestDevice	ITestDevice hoặc null nếu nó không thể được cấp phát

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Trả lại thiết bị cho hồ bơi

Các nỗ lực trả lại thiết bị chưa được cấp phát trước đó sẽ bị bỏ qua.

Thông số
device	ITestDevice : ITestDevice miễn phí
state	FreeDeviceState : FreeDeviceState . Được sử dụng để kiểm soát xem thiết bị có được trả về nhóm thiết bị khả dụng hay không.

getAdbPath

public abstract String getAdbPath ()

Trả về đường dẫn đến tệp nhị phân adb để sử dụng.

Lợi nhuận
String

getAdbVersion

public abstract String getAdbVersion ()

Nhận phiên bản adb hiện đang được người quản lý thiết bị sử dụng.

Lợi nhuận
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Trả về DeviceDescriptor với chuỗi đã cho.

Thông số
serial	String : số sê-ri để thiết bị nhận được

Lợi nhuận
DeviceDescriptor	DeviceDescriptor cho thiết bị đã chọn hoặc null nếu nối tiếp không khớp với một thiết bị đã biết.

getFastbootPath

public abstract String getFastbootPath ()

Trả về đường dẫn đến tệp nhị phân fastboot để sử dụng.

Lợi nhuận
String

trong đó

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Khởi tạo trình quản lý thiết bị bằng bộ lọc thiết bị. Bộ lọc này có thể được sử dụng để hướng dẫn DeviceManager bỏ qua các thiết bị được kết nối nhất định.

Thông số
globalDeviceFilter	IDeviceSelection : bộ lọc thiết bị
deviceMonitors

trong đó

public abstract void init ()

Khởi tạo trình quản lý thiết bị. Điều này phải được gọi một lần và chỉ một lần trước khi bất kỳ phương thức nào khác được gọi.

isEmulator

public abstract boolean isEmulator (String serial)

Xác định xem nối tiếp đã cho có đại diện cho trình giả lập hay không

Thông số
serial	String

Lợi nhuận
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Trả về việc chúng ta có nên kiểm tra trong NativeDeviceStateMonitor trong NativeDeviceStateMonitor xem hệ thống tệp có được gắn kết đúng cách hay không.

Lợi nhuận
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Xác định xem nối tiếp đã cho đại diện cho một thiết bị rỗng

Thông số
serial	String

Lợi nhuận
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Tắt trình giả lập đã cho.

Chặn cho đến khi trình giả lập biến mất khỏi adb. Sẽ không có hiệu lực nếu giả lập đã không có sẵn.

Thông số
device	ITestDevice : ITestDevice đại diện cho trình giả lập để tắt

Ném
DeviceNotAvailableException	nếu giả lập không tắt

launcher

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Phương thức trợ giúp để khởi chạy trình giả lập.

Sẽ khởi chạy trình mô phỏng theo chỉ định của người gọi

Thông số
device	ITestDevice : trình giữ chỗ ITestDevice đại diện cho thiết bị giả lập được phân bổ
bootTimeout	long : thời gian tính bằng mili giây để đợi trình giả lập khởi động
emulatorArgs	: đối số dòng lệnh để khởi chạy trình giả lập

Ném
DeviceNotAvailableException	nếu giả lập không khởi động được hoặc trực tuyến

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết

Thông số
shortDescriptor	boolean : có giới hạn bộ mô tả ở mức thông tin tối thiểu hay không

Lợi nhuận
	danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

listAllDevices

public abstract  listAllDevices ()

Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết

Lợi nhuận
	danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

renectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Một phương pháp trợ giúp chuyển thiết bị usb đã cho sang chế độ adb-over-tcp, sau đó kết nối với nó qua connectToTcpDevice(String) .

Thông số
usbDevice	ITestDevice : thiết bị hiện ở chế độ usb

Lợi nhuận
ITestDevice	ITestDevice mới được cấp phát ở chế độ tcp hoặc null nếu không thể hình thành kết nối tcp

Ném
DeviceNotAvailableException	nếu kết nối với usbDevice bị mất và không thể khôi phục được

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Xóa IDeviceMonitor đã thêm trước đó. Không có tác dụng nếu mon chưa được thêm vào.

Thông số
mon	IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Thông báo cho người quản lý rằng người nghe không còn quan tâm đến các thay đổi trạng thái fastboot.

khởi động lạiAdbBridge

public abstract void restartAdbBridge ()

Khởi động lại (nếu stopAdbBridge() được gọi) cầu nối adb và các dịch vụ phụ thuộc vào kết nối adb.

stopAdbBridge

public abstract void stopAdbBridge ()

Dừng cầu nối adb và các dịch vụ phụ thuộc vào kết nối adb.

chấm dứt

public abstract void terminate ()

Dừng các dịch vụ giám sát thiết bị và chấm dứt thư viện ddm.

Điều này phải được gọi khi chấm dứt ứng dụng.

Xem thêm:

• AndroidDebugBridge.terminate()

endDeviceMonitor

public abstract void terminateDeviceMonitor ()

Dừng Màn hình Thiết bị.

terDeviceRecovery

public abstract void terminateDeviceRecovery ()

Dừng chuỗi khôi phục thiết bị.

chấm dứt

public void terminateHard (String reason)

Giống như terminateHard() .

Thông số
reason	String : lý do tùy chọn được đưa ra cho việc chấm dứt.

chấm dứt

public abstract void terminateHard ()

Giống như terminate() , nhưng cũng cố gắng tắt mạnh mẽ adb.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Chờ cho đến khi thiết bị vật lý đầu tiên được kết nối. Nếu một thiết bị đã được kết nối trước đó, nó sẽ trả về trực tiếp True. Nếu không có thiết bị nào được thêm vào, nó sẽ trả về false sau khi hết thời gian chờ.

Thông số
timeout	long : thời gian chờ tính bằng mili giây trước khi trả về false.

Lợi nhuận
boolean