IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Giao diện để quản lý tập hợp các 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 cho các thay đổi về trạng thái khởi động nhanh. 

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 trình nghe quan tâm đến các thay đổi về trạng thái khởi động nhanh.

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Thêm thiết bị vào trình theo dõi khởi động nhanh.

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ẽ có mạng nhưng có thể không phản hồi.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Tạo một nội dung mô tả dễ hiểu cho người dùng, trong đó có danh sách các thiết bị đã biết, trạng thái và giá trị của các tuỳ chọn IDeviceSelection thường dùng.

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

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ổ một thiết bị một cách thô bạo, ngay cả khi thiết bị đó hiện không có sẵn.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Trả lại thiết bị vào nhóm

Hệ thống sẽ bỏ qua các nỗ lực 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()

Tải 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 chạy trình quản lý thiết bị bằng bộ lọc thiết bị.

abstract void init()

Khởi chạy 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ề kết quả về việc chúng ta có nên kiểm tra trong NativeDeviceStateMonitor hay không để hệ thống tệp được gắn đúng cách.

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 DeviceDescriptors cho tất cả thiết bị đã biết

abstract listAllDevices()

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

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Một phương thức trợ giúp chuyển đổi 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á IDeviceMonitor đã thêm trước đó.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

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 kết nối adb.

abstract void stopAdbBridge()

Dừng cầu 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ụ theo dõi 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()

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

abstract boolean waitForFirstDeviceAdded(long timeout)

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

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 trình nghe quan tâm đến các thay đổi về trạng thái khởi động nhanh.

Hiện tại, IDeviceManager sẽ chỉ theo dõi các thiết bị ở chế độ khởi động nhanh 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 cách hack – 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 thiết bị vào trình theo dõi khởi động nhanh. Trình giám sát khởi động nhanh 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 chế độ khởi động nhanh của thiết bị.

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ó ITestDevice

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ẽ có mạng 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 thiết bị đã kết nối tcp sẽ cắt đứ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 vớ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 đang ở chế độ tcp, trước đây đượ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)

Tạo một nội dung mô tả dễ hiểu cho người dùng, trong đó có danh sách các thiết bị đã biết, trạng thái và giá trị của các tuỳ chọn IDeviceSelection thường dùng.

Tham số
printWriter PrintWriter: ERROR(/PrintWriter) để xuất nội dung mô tả
includeStub boolean: Liệu có hiển thị cả thiết bị giả lập hay không.

executeCmdOnAvailableDevice

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

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

Tham số
serial String: Mã 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 Một CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Phân bổ một thiết bị một cách thô bạo, 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ả lại thiết bị vào nhóm

Hệ thống sẽ bỏ qua các nỗ lực trả lại thiết bị chưa được phân bổ trước đó.

Tham số
device ITestDevice: ITestDevice cần 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 ()

Tải 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 để thiết bị nhận được
Giá trị trả về
DeviceDescriptor DeviceDescriptor cho thiết bị đã chọn hoặc rỗng nếu số sê-ri 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.

Giá trị trả về
String

khởi tạo

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Khởi chạy trình quản lý thiết bị bằng 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ị đã kết nối.

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

khởi tạo

public abstract void init ()

Khởi chạy trình quản lý thiết bị. Bạn chỉ được gọi phương thức này 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ề kết quả về việc chúng ta có nên kiểm tra trong NativeDeviceStateMonitor hay không để hệ thống tệp được gắn đúng cách.

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 không có sẵn.

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 phương thức gọi

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

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

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

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

listAllDevices

public abstract  listAllDevices ()

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

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

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Một phương thức trợ giúp chuyển đổi 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 đang ở 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 kết nối với usbDevice bị mất và không thể khôi phục

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Xoá 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 trình nghe không còn quan tâm đến các thay đổi về trạng thái khởi động nhanh.

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 kết nối adb.

stopAdbBridge

public abstract 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 abstract void terminate ()

Dừng các dịch vụ theo dõi 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 chấm dứt ứng dụng.

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 không bắt buộc cho việc chấm dứt.

terminateHard

public abstract void terminateHard ()

Giống 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 kết nối thiết bị thực tế đầu tiên. Nếu trước đây đã kết nối thiết bị, thì hàm này sẽ trực tiếp trả về True. Nếu không có thiết bị nào được thêm, hàm 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