Quản lý thiết bị

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
↳	com.android.tradefed.device.DeviceManager

---

Bản tóm tắt

Các lớp lồng nhau
class	DeviceManager.FastbootDevice Hình đại diện của một thiết bị ở chế độ Fastboot.

Lĩnh vực
public static final String	UNKNOWN_DISPLAY_STRING Hiển thị chuỗi cho thuộc tính không xác định
protected DeviceMonitorMultiplexer	mDvcMon
protected boolean	mFastbootEnabled

Nhà thầu xây dựng công cộng
DeviceManager () Trình quản lý thiết bị phải được truy xuất từ GlobalConfiguration

Phương pháp công cộng
void	addAvailableDevice (IDevice stubDevice)
void	addDeviceMonitor ( IDeviceMonitor mon) Thêm IDeviceMonitor
void	addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Thông báo cho người quản lý rằng người nghe quan tâm đến những thay đổi trạng thái fastboot.
void	addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Thêm thiết bị vào màn hình fastboot.
ITestDevice	allocateDevice ( IDeviceSelection options, boolean isTemporary) Yêu cầu một thiết bị để thử nghiệm đáp ứng các tiêu chí nhất định.
ITestDevice	allocateDevice ( IDeviceSelection options) Yêu cầu một thiết bị để thử nghiệm đáp ứng các tiêu chí nhất định.
ITestDevice	allocateDevice () Yêu cầu một thiết bị vật lý để thử nghiệm
ITestDevice	connectToTcpDevice (String ipAndPort) Kết nối với thiết bị bằng 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ả về sẽ trực tuyến nhưng có thể không phản hồi.
boolean	disconnectFromTcpDevice ( ITestDevice tcpDevice) Ngắt kết nối khỏi thiết bị được kết nối adb-over-tcp.
void	displayDevicesInfo (PrintWriter stream, boolean includeStub) Xuấ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.
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.
String	executeGlobalAdbCommand (String... cmdArgs) Thực thi lệnh adb không được nhắm mục tiêu đến một thiết bị cụ thể, vd.
ITestDevice	forceAllocateDevice (String serial) Phân bổ một cách thô lỗ một thiết bị, ngay cả khi nó hiện không có sẵn.
void	freeDevice ( ITestDevice device, FreeDeviceState deviceState) Trả lại thiết bị cho hồ bơi Mọi nỗ lực trả lại thiết bị chưa được phân bổ trước đó sẽ bị bỏ qua.
String	getAdbPath () Trả về đường dẫn tới tệp nhị phân adb để sử dụng.
String	getAdbVersion () Tải phiên bản adb hiện đang được người quản lý thiết bị sử dụng.
DeviceDescriptor	getDeviceDescriptor (String serial) Trả về DeviceDescriptor với chuỗi đã cho.
String	getFastbootPath () Trả về đường dẫn đến tệp nhị phân fastboot để sử dụng.
void	init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Khởi tạo trình quản lý thiết bị.
void	init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Khởi tạo trình quản lý thiết bị.
void	init () Khởi tạo trình quản lý thiết bị.
boolean	isEmulator (String serial) Xác định xem chuỗi đã cho có đại diện cho trình mô phỏng hay không
boolean	isFileSystemMountCheckEnabled () Trả về xem chúng ta có nên kiểm tra trong NativeDeviceStateMonitor xem hệ thống tệp đã được gắn đúng cách hay chưa.
boolean	isNullDevice (String serial) Xác định xem chuỗi đã cho có đại diện cho thiết bị null không
void	killEmulator ( ITestDevice device) Tắt trình giả lập đã cho.
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 mô phỏng.
	listAllDevices (boolean shortDescriptor) Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
	listAllDevices () Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
ITestDevice	reconnectDeviceToTcp ( ITestDevice usbDevice) Một phương thức trợ giúp chuyển thiết bị usb đã cho sang chế độ adb-over-tcp, sau đó kết nối với thiết bị đó thông qua connectToTcpDevice(String) .
void	removeDeviceMonitor ( IDeviceMonitor mon) Xóa IDeviceMonitor đã thêm trước đó.
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 những thay đổi trạng thái fastboot.
void	restartAdbBridge () Khởi động lại (nếu stopAdbBridge() được gọi) cầu adb và các dịch vụ phụ thuộc vào kết nối adb.
void	stopAdbBridge () Dừng cầu adb và các dịch vụ phụ thuộc vào kết nối adb.
void	terminate () Dừng dịch vụ giám sát thiết bị và chấm dứt thư viện ddm.
void	terminateDeviceMonitor () Dừng màn hình thiết bị.
void	terminateDeviceRecovery () Dừng chuỗi khôi phục thiết bị.
void	terminateHard (String reason) Giống như terminateHard() .
void	terminateHard () Giống như terminate() , nhưng cũng cố gắng tắt adb một cách mạnh mẽ.
boolean	waitForFirstDeviceAdded (long timeout) Đợi cho đến khi thiết bị vật lý đầu tiên được kết nối.

Lĩnh vực

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Hiển thị chuỗi cho thuộc tính không xác định

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootĐã bật

protected boolean mFastbootEnabled

Nhà thầu xây dựng công cộng

Quản lý thiết bị

public DeviceManager ()

Trình quản lý thiết bị phải được truy xuất từ GlobalConfiguration

Phương pháp công cộng

thêmThiết bị có sẵn

public void addAvailableDevice (IDevice stubDevice)

Thông số
stubDevice	IDevice

thêmDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Thêm IDeviceMonitor

Thông số
mon	IDeviceMonitor

thêmFastbootThiết bị

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Thông số
fastbootDevice	DeviceManager.FastbootDevice

thêmFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Thêm thiết bị vào màn hình fastboot. Màn hình fastboot sẽ sử dụng 'fastboot_serial' để liên lạc với thiết bị.

Thông số
serial	String : số serial của thiết bị.
fastboot_serial	String : số serial chế độ fastboot của thiết bị.

phân bổ thiết bị

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

Trả lại
ITestDevice	ITestDevice để thử nghiệm hoặc null nếu không có sẵn

phân bổ thiết bị

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

Trả lại
ITestDevice	ITestDevice để thử nghiệm hoặc null nếu không có sẵn

phân bổ thiết bị

public ITestDevice allocateDevice ()

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

Trả lại
ITestDevice	ITestDevice để thử nghiệm hoặc null nếu không có sẵn

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Kết nối với thiết bị bằng 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ả về sẽ trực tuyến nhưng có thể không phản hồi.

Lưu ý rằng việc thực hiện hành động 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 gốc và cổng của thiết bị cần kết nối

Trả lại
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 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ị trở lại chế độ usb và giải phóng thiết bị.

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

Trả lại
boolean	true nếu chuyển sang chế độ usb thành công

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Xuấ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ố
stream	PrintWriter : ERROR(/PrintWriter) để xuất mô tả thành
includeStub	boolean : Có hay không hiển thị các thiết bị còn sơ khai.

thực thiCmdOnAvailableDevice

public 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 : Serial của thiết bị.
command	String : Lệnh shell.
timeout	long : Khoảng thời gian để lệnh hoàn thành.
timeUnit	TimeUnit : Đơn vị tính thời gian chờ.

Trả lại
CommandResult	Một CommandResult .

thực thiGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Thực thi lệnh adb không được nhắm mục tiêu đến một thiết bị cụ thể, vd. 'kết nối adb'

Trả lại
String	đầu ra std nếu lệnh thành công là null.

lực lượngphân bổthiết bị

public ITestDevice forceAllocateDevice (String serial)

Phân bổ một cách thô lỗ một thiết bị, ngay cả khi nó hiện không có sẵn.

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

Thông số
serial	String : nối tiếp thiết bị để phân bổ

Trả lại
ITestDevice	ITestDevice hoặc null nếu không thể phân bổ

thiết bị miễn phí

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

Mọi nỗ lực trả lại thiết bị chưa được phân bổ trước đó sẽ bị bỏ qua.

Thông số
device	ITestDevice : ITestDevice miễn phí
deviceState	FreeDeviceState : FreeDeviceState . Được sử dụng để kiểm soát xem thiết bị có được đưa trở lại nhóm thiết bị có sẵn hay không.

getAdbPath

public String getAdbPath ()

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

Trả lại
String

getAdbPhiên bản

public String getAdbVersion ()

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

Trả lại
String

getDeviceDevicer

public DeviceDescriptor getDeviceDescriptor (String serial)

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

Thông số
serial	String : số serial để thiết bị lấy

Trả lại
DeviceDescriptor	DeviceDescriptor cho thiết bị đã chọn hoặc null nếu nối tiếp không khớp với thiết bị đã biết.

getFastbootPath

public String getFastbootPath ()

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

Trả lại
String

trong đó

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

Khởi tạo trình quản lý thiết bị. Phương thức 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.

Thông số
globalDeviceFilter	IDeviceSelection
globalDeviceMonitors
deviceFactory	IManagedTestDeviceFactory

trong đó

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Khởi tạo trình quản lý thiết bị. Phương thức 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.

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

trong đó

public void init ()

Khởi tạo trình quản lý thiết bị. Phương thức 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 boolean isEmulator (String serial)

Xác định xem chuỗi đã cho có đại diện cho trình mô phỏng hay không

Thông số
serial	String

Trả lại
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Trả lại
boolean

isNullDevice

public boolean isNullDevice (String serial)

Xác định xem chuỗi đã cho có đại diện cho thiết bị null không

Thông số
serial	String

Trả lại
boolean

giết Trình mô phỏng

public void killEmulator (ITestDevice device)

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

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

Thông số
device	ITestDevice : ITestDevice đại diện cho trình mô phỏng tắt

Ném
DeviceNotAvailableException

khởi chạy Trình mô phỏng

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

Phương thức trợ giúp để khởi chạy trình mô phỏng.

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ị mô phỏng được phân bổ
bootTimeout	long : thời gian tính bằng ms để chờ trình giả lập khởi động
emulatorArgs	: đối số dòng lệnh để khởi chạy trình mô phỏng

Ném
DeviceNotAvailableException

danh sáchTất cả các thiết bị

public  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 mô tả ở mức thông tin tối thiểu không

Trả lại
	danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

danh sáchTất cả các thiết bị

public  listAllDevices ()

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

Trả lại
	danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

kết nối lạiDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

Trả lại
ITestDevice	ITestDevice mới được phân bổ ở chế độ tcp hoặc null nếu không thể hình thành kết nối tcp

Ném
DeviceNotAvailableException

loại bỏDeviceMonitor

public 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

loại bỏFastbootListener

public 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 những thay đổi trạng thái fastboot.

khởi động lạiAdbBridge

public void restartAdbBridge ()

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

dừng lạiAdbBridge

public void stopAdbBridge ()

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

chấm dứt

public void terminate ()

Dừng 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 yêu cầu khi chấm dứt ứng dụng.

chấm dứtDeviceMonitor

public void terminateDeviceMonitor ()

Dừng màn hình thiết bị.

chấm dứtPhục hồi thiết bị

public void terminateDeviceRecovery ()

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

chấm dứtCứng

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ứtCứng

public void terminateHard ()

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

waitForFirstDeviceĐã thêm

public boolean waitForFirstDeviceAdded (long timeout)

Đợi 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 đó, thiết bị đó sẽ trả về trực tiếp Đúng. Nếu không có thiết bị nào được thêm vào, nó sẽ trả về sai 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ề sai.

Trả lại
boolean