Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

Biểu diễn của một thiết bị ở chế độ Fastboot.

Lĩnh vực

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

Các nhà xây dựng công cộng

DeviceManager ()

DeviceManager phải được truy xuất từ GlobalConfiguration

Phương pháp công khai

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

Thêm IDeviceMonitor

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 khởi động nhanh.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice ( IDeviceSelection options)

Yêu cầu một thiết bị để kiểm tra đá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ị có 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 qua 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)

Đưa ra một mô tả thân thiện với người dùng chứa danh sách các thiết bị đã biết, trạng thái của chúng và các 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ị có sẵn.

String executeGlobalAdbCommand (String... cmdArgs)

Thực thi một lệnh adb không được nhắm mục tiêu đến một thiết bị cụ thể, ví dụ.

ITestDevice forceAllocateDevice (String serial)

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

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Trả lại thiết bị cho hồ bơi

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 người quản lý thiết bị sử dụng.

DeviceDescriptor getDeviceDescriptor (String serial)

Trả về DeviceDescriptor với chuỗi đã 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 nối tiếp đã cho có đại diện cho trình giả lập hay không

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

Xác định xem nối tiếp đã cho đại diện cho một thiết bị rỗ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 pháp 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) cầu nối adb 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 mạnh mẽ adb.

boolean waitForFirstDeviceAdded (long timeout)

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

mFastbootEnabled

protected boolean mFastbootEnabled

Các nhà xây dựng công cộng

Quản lý thiết bị

public DeviceManager ()

DeviceManager phải được truy xuất từ GlobalConfiguration

Phương pháp công khai

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Thông số
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Thêm IDeviceMonitor

Thông số
mon IDeviceMonitor

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 một IDeviceManager sẽ chỉ giám sát các thiết bị trong fastboot nếu có một hoặc nhiều người nghe đang hoạt động.

VIỆC CẦN LÀM: đây là một chút hack - hãy tìm một giải pháp tốt hơn

addMoprisTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Thêm thiết bị vào màn hình khởi động nhanh. 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ế độ khởi động nhanh của thiết bị.

phân bổ

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Yêu cầu một thiết bị để kiểm tra đá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.

Lợi nhuận
ITestDevice một ITestDevice để thử nghiệm hoặc null nếu không có sẵn

phân bổ

public ITestDevice allocateDevice (IDeviceSelection options)

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

Thông số
options IDeviceSelection : IDeviceSelection mà thiết bị phải đáp ứng.

Lợi nhuận
ITestDevice một ITestDevice để thử nghiệm hoặc null nếu không có sẵn

phân bổ

public ITestDevice allocateDevice ()

Yêu cầu một thiết bị vật lý để thử nghiệm

Lợi nhuận
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ị có 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 qua 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 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 đứ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

Lợi nhuận
ITestDevice ITestDevice hoặc null nếu không thể hình thành kết nối tcp

ngắt kết nốiFromTcpDevice

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 cấp phát trước đây qua connectToTcpDevice(String)

Lợi nhuận
boolean true nếu chuyển sang chế độ usb thành công

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Đưa ra một mô tả thân thiện với người dùng chứa danh sách các thiết bị đã biết, trạng thái của chúng và các 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ị sơ khai.

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ị có sẵn.

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

command String : Lệnh shell.

timeout long : Khoảng thời gian để hoàn thành lệnh.

timeUnit TimeUnit : Đơn vị thời gian chờ.

Lợi nhuận
CommandResult Một CommandResult .

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Thực thi một lệnh adb không được nhắm mục tiêu đến một thiết bị cụ thể, ví dụ. 'kết nối adb'

Lợi nhuận
String đầu ra std nếu lệnh thành công rỗng, ngược lại.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Phân bổ thiết bị một cách sơ sài, 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 cấp phát.

Thông số
serial String : chuỗi thiết bị để cấp phát

Lợi nhuận
ITestDevice ITestDevice hoặc null nếu nó không thể được cấp phát

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Trả lại thiết bị cho hồ bơi

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 xem thiết bị có được trả về nhóm thiết bị khả dụng hay không.

getAdbPath

public String getAdbPath ()

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

Lợi nhuận
String

getAdbVersion

public String getAdbVersion ()

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

Lợi nhuận
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Trả về DeviceDescriptor với chuỗi đã cho.

Thông số
serial String : số sê-ri để thiết bị nhận được

Lợi nhuận
DeviceDescriptor DeviceDescriptor cho thiết bị đã chọn hoặc null nếu nối tiếp 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.

Lợi nhuận
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 nối tiếp đã cho có đại diện cho trình giả lập hay không

Thông số
serial String

Lợi nhuận
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Lợi nhuận
boolean

isNullDevice

public boolean isNullDevice (String serial)

Xác định xem nối tiếp đã cho đại diện cho một thiết bị rỗng

Thông số
serial String

Lợi nhuận
boolean

killEmulator

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ó hiệu lực nếu giả lập đã không có sẵn.

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

Ném
DeviceNotAvailableException

launcher

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

Lợi nhuận
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

Lợi nhuận
danh sách DeviceDescriptor cho tất cả các thiết bị đã biết

renectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Một phương pháp 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 ở chế độ usb

Lợi nhuận
ITestDevice ITestDevice mới được cấp phát ở chế độ tcp hoặc null nếu không thể hình thành kết nối tcp

Ném
DeviceNotAvailableException

removeDeviceMonitor

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

removeFastbootListener

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) cầu nối 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 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.

endDeviceMonitor

public void terminateDeviceMonitor ()

Dừng Màn hình Thiết bị.

terDeviceRecovery

public void terminateDeviceRecovery ()

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

chấm dứt

public void terminateHard (String reason)

Giống như terminateHard() .

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

chấm dứt

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Chờ 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 chờ tính bằng mili giây trước khi trả về false.

Lợi nhuận
boolean