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 đại diện cho một thiết bị ở Chế độ khởi động nhanh. 

Trường

public static final String UNKNOWN_DISPLAY_STRING

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

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

void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

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

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

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

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

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.

String executeGlobalAdbCommand(String... cmdArgs)

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

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.

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

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

String getAdbPath()

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

String getAdbVersion()

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

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Khởi chạy trình quản lý thiết bị.

void init()

Khởi chạy 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ề 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.

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

listAllDevices()

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

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

void removeDeviceMonitor(IDeviceMonitor mon)

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

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.

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 các dịch vụ theo dõi 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()

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

boolean waitForFirstDeviceAdded(long timeout)

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

Trường

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

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

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 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 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 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 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 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 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 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ổ 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)

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ố
stream 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 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 CommandResult.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Thực thi 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, rỗng nếu không.

forceAllocateDevice

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

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
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 ()

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 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 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 void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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.

Tham số
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

khởi tạo

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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.

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

khởi tạo

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

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

listAllDevices

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

removeDeviceMonitor

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

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public 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