DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

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

Tóm tắt

Lớp lồng ghép

class DeviceManager.FastbootDevice

Hình ảnh minh hoạ một thiết bị ở Chế độ khởi động nhanh. 

Hằng số

String UNKNOWN_DISPLAY_STRING

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

Trường

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Hàm khởi tạo công khai

DeviceManager()

Bạn nên truy xuất DeviceManager từ GlobalConfiguration

Phương thức công khai

void addAvailableDevice(IDevice stubDevice)
void addAvailableNativeDevice(IDevice stubDevice)
void addDeviceMonitor(IDeviceMonitor mon)

Thêm IDeviceMonitor

void addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
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.

void addMonitoringTcpFastbootDevice(String serial, String fastbootSerial)

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

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

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

ITestDevice allocateDevice()

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

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.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

void displayDevicesInfo(PrintWriter stream, 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.

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

String executeGlobalAdbCommand(String... cmdArgs)

Thực thi một lệnh adb không nhắm đến một thiết bị cụ thể, ví dụ:

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.

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

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 đó.

String getAdbPath()

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

String getAdbVersion()

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

DeviceDescriptor getDeviceDescriptor(String serial)

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

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

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

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

void init()

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

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

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.

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

void killEmulator(ITestDevice device)

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

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

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

listAllDevices(boolean shortDescriptor)

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

listAllDevices()

Trả về danh sách DeviceDescriptor 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)

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

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.

void removeMonitoringTcpFastbootDevice(String serial)

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.

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.

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.

void terminateDeviceMonitor()

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

void terminateDeviceRecovery()

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

void terminateHard(String reason)

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

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

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

Hằng số

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

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

Giá trị không đổi: "unknown"

Trường

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Hàm khởi tạo công khai

DeviceManager

public DeviceManager ()

Bạn nên truy xuất DeviceManager từ GlobalConfiguration

Phương thức công khai

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Tham số
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

Tham số
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Thêm IDeviceMonitor

Tham số
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Tham số
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

public 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 void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

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ị.
fastbootSerial String: số sê-ri của thiết bị ở chế độ fastboot.

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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 ITestDevice allocateDevice (IDeviceSelection options)

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

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 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 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 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 void displayDevicesInfo (PrintWriter stream, 
                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ố
stream 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 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.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Thực thi một lệnh adb không nhắm đến một thiết bị cụ thể, ví dụ: "adb connect"

Giá trị trả về
String đầu ra std nếu lệnh thành công, nếu không thì sẽ là giá trị rỗng.

forceAllocateDevice

public 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 void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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
deviceState 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 String getAdbPath ()

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

Giá trị trả về
String

getAdbVersion

public 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 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 String getFastbootPath ()

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

Giá trị trả về
String

init

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

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.

Tham số
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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.

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

init

public 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 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 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 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

launchEmulator

public 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

listAllDevices

public  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  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 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

removeDeviceMonitor

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

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

terminateDeviceRecovery

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

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

waitForFirstDeviceAdded

public 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