IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Giao diện để quản lý bộ thiết bị có sẵn để kiểm thử.

Tóm tắt

Lớp lồng ghép

interface IDeviceManager.IFastbootListener

Trình nghe các thay đổi về trạng thái fastboot. 

Phương thức công khai

abstract void addDeviceMonitor(IDeviceMonitor mon)

Thêm IDeviceMonitor

abstract void addFastbootListener(IDeviceManager.IFastbootListener listener)

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

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Thêm một thiết bị vào trình giám sát fastboot.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

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

abstract ITestDevice allocateDevice(IDeviceSelection options)

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

abstract ITestDevice allocateDevice()

Yêu cầu thiết bị thực để kiểm thử

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Kết nối với một thiết bị bằng adb-over-tcp

Phương thức này phân bổ một thiết bị mới, 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ạng thái 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 nội dung mô tả thân thiện với người dùng, bao gồm danh sách các thiết bị đã biết, trạng thái và giá trị của các thiết bị đó cho các lựa chọn IDeviceSelection thường 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ị hiện có.

abstract ITestDevice forceAllocateDevice(String serial)

Phân bổ thô bạo một thiết bị, ngay cả khi thiết bị đó hiện không có sẵn.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Trả thiết bị về nhóm

Hệ thống sẽ bỏ qua những yêu cầu trả lại thiết bị chưa được phân bổ trước đó.

abstract String getAdbPath()

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

abstract String getAdbVersion()

Lấy phiên bản adb mà trình quản lý thiết bị hiện đang sử dụng.

abstract DeviceDescriptor getDeviceDescriptor(String serial)

Trả về DeviceDescriptor có số sê-ri đã 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)

Khởi động trình quản lý thiết bị bằng một bộ lọc thiết bị.

abstract void init()

Khởi động trình quản lý thiết bị.

abstract boolean isEmulator(String serial)

Xác định xem số sê-ri đã cho có đại diện cho một trình mô phỏng hay không

default boolean isFileSystemMountCheckEnabled()

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

abstract boolean isNullDevice(String serial)

Xác định xem số sê-ri đã cho có đại diện cho một thiết bị rỗng hay không

abstract void killEmulator(ITestDevice device)

Tắt trình mô phỏng đã cho.

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

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

abstract listAllDevices(boolean shortDescriptor)

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

abstract listAllDevices()

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

abstract 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).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Xoá một IDeviceMonitor đã thêm trước đó.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Thông báo cho trình quản lý rằng một trình nghe không còn quan tâm đến các thay đổi về trạng thái fastboot nữa.

default void removeMonitoringTcpFastbootDevice(String serial)
abstract 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 các 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 Trình theo dõi thiết bị.

abstract void terminateDeviceRecovery()

Dừng luồng khôi phục thiết bị.

default void terminateHard(String reason)

Tương tự như terminateHard().

abstract void terminateHard()

Tương tự như terminate(), nhưng cũng cố gắng buộc tắt adb.

abstract boolean waitForFirstDeviceAdded(long timeout)

Chờ cho đến khi thiết bị thực tế đầu tiên được kết nối.

Phương thức công khai

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Thêm IDeviceMonitor

Tham số
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

Hiện tại, IDeviceManager sẽ chỉ theo dõi các thiết bị ở chế độ 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 giải pháp tạm thời – hãy tìm một giải pháp tốt hơn

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Thêm một thiết bị vào trình giám sát fastboot. Trình giám sát fastboot sẽ sử dụng "fastboot_serial" để giao tiếp với thiết bị.

Tham số
serial String: số sê-ri của thiết bị.
fastboot_serial String: số sê-ri của thiết bị ở chế độ fastboot.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

Tham số
options IDeviceSelection: IDeviceSelection mà thiết bị phải đáp ứng.
isTemporary boolean: có tạo NullDevice tạm thời hay không.
Giá trị trả về
ITestDevice ITestDevice để kiểm thử hoặc null nếu không có

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

Tham số
options IDeviceSelection: IDeviceSelection mà thiết bị phải đáp ứng.
Giá trị trả về
ITestDevice ITestDevice để kiểm thử hoặc null nếu không có

allocateDevice

public abstract ITestDevice allocateDevice ()

Yêu cầu thiết bị thực để kiểm thử

Giá trị trả về
ITestDevice ITestDevice để kiểm thử hoặc null nếu không có

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Kết nối với một thiết bị bằng adb-over-tcp

Phương thức này phân bổ một thiết bị mới, 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ạng thái trực tuyến nhưng có thể không phản hồi.

Xin lưu ý rằng việc thực hiện thao tác như khởi động lại trên một thiết bị được kết nối tcp sẽ cắt kết nối tcp với thiết bị và dẫn đến DeviceNotAvailableException

Tham số
ipAndPort String: địa chỉ IP và cổng ban đầu của thiết bị cần kết nối
Giá trị trả về
ITestDevice ITestDevice hoặc null nếu không thể tạo kết nối tcp

disconnectFromTcpDevice

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ị.

Tham số
tcpDevice ITestDevice: thiết bị hiện ở chế độ tcp, trước đó được phân bổ thông qua connectToTcpDevice(String)
Giá trị trả về
boolean true nếu chuyển sang chế độ USB thành công

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Đưa ra nội dung mô tả thân thiện với người dùng, bao gồm danh sách các thiết bị đã biết, trạng thái và giá trị của các thiết bị đó cho các lựa chọn IDeviceSelection thường dùng.

Tham số
printWriter PrintWriter: ERROR(/PrintWriter) để xuất nội dung mô tả
includeStub boolean: Có hiển thị các thiết bị stub hay không.

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ị hiện có.

Tham số
serial String: Số sê-ri của thiết bị.
command String: Lệnh shell.
timeout long: Khoảng thời gian để hoàn tất lệnh.
timeUnit TimeUnit: Đơn vị của thời gian chờ.
Giá trị trả về
CommandResult CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Phân bổ thô bạo một thiết bị, ngay cả khi thiết bị đó hiện không có sẵn.

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

Tham số
serial String: số sê-ri của thiết bị cần phân bổ
Giá trị trả về
ITestDevice ITestDevice hoặc null nếu không thể phân bổ

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Trả thiết bị về nhóm

Hệ thống sẽ bỏ qua những yêu cầu trả lại thiết bị chưa được phân bổ trước đó.

Tham số
device ITestDevice: ITestDevice để giải phóng
state FreeDeviceState: FreeDeviceState. Dùng để kiểm soát việc thiết bị có được trả về nhóm thiết bị có sẵn hay không.

getAdbPath

public abstract String getAdbPath ()

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

Giá trị trả về
String

getAdbVersion

public abstract String getAdbVersion ()

Lấy phiên bản adb mà trình quản lý thiết bị hiện đang sử dụng.

Giá trị trả về
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Trả về DeviceDescriptor có số sê-ri đã cho.

Tham số
serial String: số sê-ri của thiết bị cần nhận
Giá trị trả về
DeviceDescriptor DeviceDescriptor cho thiết bị đã chọn hoặc giá trị rỗng nếu số sê-ri không khớp với 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.

Giá trị trả về
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

Tham số
globalDeviceFilter IDeviceSelection: bộ lọc thiết bị
deviceMonitors

init

public abstract void init ()

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

isEmulator

public abstract boolean isEmulator (String serial)

Xác định xem số sê-ri đã cho có đại diện cho một trình mô phỏng hay không

Tham số
serial String

Giá trị trả về
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Giá trị trả về
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Xác định xem số sê-ri đã cho có đại diện cho một thiết bị rỗng hay không

Tham số
serial String

Giá trị trả về
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Tắt trình mô phỏng đã 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 mô phỏng hiện không dùng được.

Tham số
device ITestDevice: ITestDevice đại diện cho trình mô phỏng sẽ tắt
Gửi
DeviceNotAvailableException nếu trình mô phỏng không tắt được

launchEmulator

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

Phương thức trợ giúp để 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

Tham số
device ITestDevice: phần giữ chỗ ITestDevice đại diện cho thiết bị mô phỏng được phân bổ
bootTimeout long: thời gian chờ (tính bằng mili giây) để trình mô phỏng khởi động
emulatorArgs : đối số dòng lệnh để chạy trình mô phỏng
Gửi
DeviceNotAvailableException nếu trình mô phỏng không khởi động hoặc chuyển sang trạng thái trực tuyến

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

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

Tham số
shortDescriptor boolean: có giới hạn nội dung mô tả ở mức tối thiểu hay không
Giá trị trả về
danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

listAllDevices

public abstract  listAllDevices ()

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

Giá trị trả về
danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

reconnectDeviceToTcp

public abstract 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).

Tham số
usbDevice ITestDevice: thiết bị hiện ở chế độ USB
Giá trị trả về
ITestDevice ITestDevice mới được phân bổ ở chế độ tcp hoặc null nếu không thể tạo kết nối tcp
Gửi
DeviceNotAvailableException nếu mất kết nối với usbDevice và không thể khôi phục

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Xoá một IDeviceMonitor đã thêm trước đó. Không có hiệu lực nếu bạn chưa thêm mon.

Tham số
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Thông báo cho trình quản lý rằng một trình nghe không còn quan tâm đến các thay đổi về trạng thái fastboot nữa.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Tham số
serial String

restartAdbBridge

public abstract 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 các 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.

Bạn phải gọi phương thức này khi ứng dụng kết thúc.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Dừng Trình theo dõi thiết bị.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Dừng luồng khôi phục thiết bị.

terminateHard

public void terminateHard (String reason)

Tương tự như terminateHard().

Tham số
reason String: lý do chấm dứt (không bắt buộc).

terminateHard

public abstract void terminateHard ()

Tương tự như terminate(), nhưng cũng cố gắng buộc tắt adb.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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