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

Đại diện của một thiết bị trong chế độ Fastboot.

Lĩnh vực

public static final String UNKNOWN_DISPLAY_STRING

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

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

nhà thầu công cộng

DeviceManager ()

DeviceManager nên được lấy từ GlobalConfiguration

Phương thức công khai

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

Thêm một 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 các 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 disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

ITestDevice được trả lại 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 có chứa danh sách các thiết bị đã biết, trạng thái của chúng và 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ị khả dụng.

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ô bạo một thiết bị, ngay cả khi thiết bị đó hiện không khả dụng.

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

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

Các nỗ lực trả lại thiết bị chưa được cấp phát trước đó sẽ bị bỏ qua.

String getAdbPath ()

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

String getAdbVersion ()

Nhận phiên bản adb hiện đang được trình quản lý thiết bị sử dụng.

DeviceDescriptor getDeviceDescriptor (String serial)

Trả về DeviceDescriptor với 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) 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 sê-ri đã cho có đại diện cho trình giả lập không

boolean isFileSystemMountCheckEnabled ()

Trả 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 thiết bị rỗng 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 giả lập.

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 nó 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 các thay đổi trạng thái fastboot.

void restartAdbBridge ()

Khởi động lại (nếu stopAdbBridge() được gọi) adb bridge và các dịch vụ phụ thuộc vào 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 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

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

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

Đã bật mFastboot

protected boolean mFastbootEnabled

nhà thầu công cộng

Quản lý thiết bị

public DeviceManager ()

DeviceManager nên được lấy từ GlobalConfiguration

Phương thức công khai

thêm thiết bị có sẵn

public void addAvailableDevice (IDevice stubDevice)

Thông số
stubDevice IDevice

thêmDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Thêm một IDeviceMonitor

Thông số
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Thông số
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

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

TODO: đâ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' để giao tiếp với thiết bị.

Thông số
serial String : số sê-ri của thiết bị.

fastboot_serial String : số sê-ri 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ị phải đáp ứng.

isTemporary boolean : có nên tạo NullDevice tạm thời hay không.

trả lại
ITestDevice một 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ị phải đáp ứng.

trả lại
ITestDevice một 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 một 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 disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

ITestDevice được trả lại 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 chẳng hạn như khởi động lại trên 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

Thông số
ipAndPort String : địa chỉ ip ban đầu và cổng của thiết bị để kết nối vớ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ốiTừTcpDevice

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

Thông số
tcpDevice ITestDevice : thiết bị hiện ở chế độ tcp, được phân bổ trước đó 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 có chứa danh sách các thiết bị đã biết, trạng thái của chúng và 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ả sang

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ị khả dụng.

Thông số
serial String : Sê-ri của thiết bị.

command String : Lệnh trình bao.

timeout long : Lượng thời gian để lệnh hoàn thành.

timeUnit TimeUnit : Đơn vị 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 null nếu không.

buộc phân bổ thiết bị

public ITestDevice forceAllocateDevice (String serial)

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

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ể cấp phát

thiết bị miễn phí

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

Các nỗ lực trả lại thiết bị chưa được cấp phát 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 nếu thiết bị được đưa trở lại nhóm thiết bị có sẵn.

getAdbPath

public String getAdbPath ()

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

trả lại
String

getAdbVersion

public String getAdbVersion ()

Nhận phiên bản adb hiện đang được trình quản lý thiết bị sử dụng.

trả lại
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Trả về DeviceDescriptor với sê-ri đã cho.

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

trả lại
DeviceDescriptor DeviceDescriptor cho thiết bị đã chọn hoặc null nếu 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.

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ị. Điều 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ị. Điều 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ị. Điều 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 sê-ri đã cho có đại diện cho trình giả lập không

Thông số
serial String

trả lại
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

trả lại
boolean

isNullDevice

public boolean isNullDevice (String serial)

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

Thông số
serial String

trả lại
boolean

giết giả lập

public void killEmulator (ITestDevice device)

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

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

Thông số
device ITestDevice : trình giả lập đại diện cho ITestDevice tắt

ném
DeviceNotAvailableException

khởi độngTrì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 giả lập.

Sẽ khởi chạy trình giả lập 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ị giả lập được phân bổ

bootTimeout long : thời gian tính bằng ms để đợi trình giả lập khởi động

emulatorArgs : đối số dòng lệnh để khởi chạy trình giả lập

ném
DeviceNotAvailableException

listAllDevices

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ó nên giới hạn bộ mô tả ở mức thông tin tối thiểu hay không

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

listAllDevices

public  listAllDevices ()

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

trả lại
một 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 nó 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

gỡ 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 các 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) adb bridge và các dịch vụ phụ thuộc vào kết nối adb.

dừngAdbBridge

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.

Điều này phải được gọi 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ứtDeviceRecovery

public void terminateDeviceRecovery ()

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

chấm dứtHard

public void terminateHard (String reason)

Giống như terminateHard() .

Thông số
reason String : lý do tùy chọn được đưa ra để chấm dứt.

chấm dứtHard

public void terminateHard ()

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

waitForFirstDeviceAdded

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 đó, nó sẽ trả về trực tiếp True. Nếu không có thiết bị nào được thêm vào, nó sẽ trả về false sau khi hết thời gian chờ.

Thông số
timeout long : thời gian đợi tính bằng mili giây trước khi trả về false.

trả lại
boolean