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 Hình đại 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 thuộc tính không xác định |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
Nhà thầu xây dựng công cộng | |
---|---|
DeviceManager () Trình quản lý thiết bị phải được truy xuất từ |
Phương pháp công cộng | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Thêm |
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 những 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 quadisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) ITestDevice được trả về 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 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 |
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 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ô lỗ một thiết bị, ngay cả khi nó hiện không có sẵn. |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) Trả lại thiết bị cho hồ bơi Mọi nỗ lực trả lại thiết bị chưa được phân bổ trước đó sẽ bị bỏ qua. |
String | getAdbPath () Trả về đường dẫn tới tệp nhị phân adb để sử dụng. |
String | getAdbVersion () Tải 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 chuỗi đã cho có đại diện cho trình mô phỏng hay không |
boolean | isFileSystemMountCheckEnabled () Trả về xem chúng ta có nên kiểm tra trong |
boolean | isNullDevice (String serial) Xác định xem chuỗi đã cho có đại diện cho thiết bị null 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 mô phỏng. |
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 thiết bị đó thông qua |
void | removeDeviceMonitor ( IDeviceMonitor mon) Xóa |
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 những thay đổi trạng thái fastboot. |
void | restartAdbBridge () Khởi động lại (nếu |
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 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ư |
void | terminateHard () Giống như |
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
Hiển thị chuỗi cho thuộc tính không xác định
mFastbootĐã bật
protected boolean mFastbootEnabled
Nhà thầu xây dựng công cộng
Quản lý thiết bị
public DeviceManager ()
Trình quản lý thiết bị phải được truy xuất từ GlobalConfiguration
Phương pháp công cộng
thêmThiết bị có sẵn
public void addAvailableDevice (IDevice stubDevice)
Thông số | |
---|---|
stubDevice | IDevice |
thêmDeviceMonitor
public void addDeviceMonitor (IDeviceMonitor mon)
Thêm IDeviceMonitor
Thông số | |
---|---|
mon | IDeviceMonitor |
thêmFastbootThiết bị
public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)
Thông số | |
---|---|
fastbootDevice | DeviceManager.FastbootDevice |
thêmFastbootListener
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 những 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. VIỆC CẦN LÀM: đâ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' để liên lạc với thiết bị.
Thông số | |
---|---|
serial | String : số serial của thiết bị. |
fastboot_serial | String : số serial 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ị sẽ đáp ứng. |
isTemporary | boolean : có nên tạo NullDevice tạm thời hay không. |
Trả lại | |
---|---|
ITestDevice | 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ị sẽ đáp ứng. |
Trả lại | |
---|---|
ITestDevice | 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 | 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 quadisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
ITestDevice
được trả về 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 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 gốc và cổng của thiết bị cần kết nố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ố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ị trở lại 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 đó thông 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 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ả thành |
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ị có sẵn.
Thông số | |
---|---|
serial | String : Serial của thiết bị. |
command | String : Lệnh shell. |
timeout | long : Khoảng thời gian để lệnh hoàn thành. |
timeUnit | TimeUnit : Đơn vị tính 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 là null. |
lực lượngphân bổthiết bị
public ITestDevice forceAllocateDevice (String serial)
Phân bổ một cách thô lỗ một thiết bị, ngay cả khi nó hiện không có sẵn.
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ể phân bổ |
thiết bị miễn phí
public void freeDevice (ITestDevice device, FreeDeviceState deviceState)
Trả lại thiết bị cho hồ bơi
Mọi nỗ lực trả lại thiết bị chưa được phân bổ 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 đưa trở lại nhóm thiết bị có sẵn hay không. |
getAdbPath
public String getAdbPath ()
Trả về đường dẫn tới tệp nhị phân adb để sử dụng.
Trả lại | |
---|---|
String |
getAdbPhiên bản
public String getAdbVersion ()
Tải phiên bản adb hiện đang được người quản lý thiết bị sử dụng.
Trả lại | |
---|---|
String |
getDeviceDevicer
public DeviceDescriptor getDeviceDescriptor (String serial)
Trả về DeviceDescriptor với chuỗi đã cho.
Thông số | |
---|---|
serial | String : số serial để thiết bị lấy |
Trả lại | |
---|---|
DeviceDescriptor | DeviceDescriptor cho thiết bị đã chọn hoặc null nếu nối tiếp 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ị. Phương thức 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ị. Phương thức 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ị. Phương thức 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 chuỗi đã cho có đại diện cho trình mô phỏng hay không
Thông số | |
---|---|
serial | String |
Trả lại | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Trả về xem chúng ta có nên kiểm tra trong NativeDeviceStateMonitor
xem hệ thống tệp đã được gắn đúng cách hay chưa.
Trả lại | |
---|---|
boolean |
isNullDevice
public boolean isNullDevice (String serial)
Xác định xem chuỗi đã cho có đại diện cho thiết bị null không
Thông số | |
---|---|
serial | String |
Trả lại | |
---|---|
boolean |
giết Trình mô phỏng
public void killEmulator (ITestDevice device)
Tắt trình giả lập đã 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 giả lập chưa có sẵn.Thông số | |
---|---|
device | ITestDevice : ITestDevice đại diện cho trình mô phỏng tắt |
Ném | |
---|---|
DeviceNotAvailableException |
khởi chạy Trì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 mô phỏng.
Sẽ khởi chạy trình mô phỏng theo chỉ định của người gọiThông số | |
---|---|
device | ITestDevice : trình giữ chỗ ITestDevice đại diện cho thiết bị mô phỏng được phân bổ |
bootTimeout | long : thời gian tính bằng ms để chờ trình giả lập khởi động |
emulatorArgs |
Ném | |
---|---|
DeviceNotAvailableException |
danh sáchTất cả các thiết bị
publiclistAllDevices (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 mô tả ở mức thông tin tối thiểu không |
Trả lại | |
---|---|
danh sách DeviceDescriptor cho tất cả các thiết bị đã biết |
danh sáchTất cả các thiết bị
publiclistAllDevices ()
Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
Trả lại | |
---|---|
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 thiết bị đó thông 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 |
loại 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 những 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 adb và các dịch vụ phụ thuộc vào kết nối adb.
dừng lạiAdbBridge
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 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 yêu cầu 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ứtPhục hồi thiết bị
public void terminateDeviceRecovery ()
Dừng chuỗi khôi phục thiết bị.
chấm dứtCứng
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ứtCứng
public void terminateHard ()
Giống như terminate()
, nhưng cũng cố gắng tắt adb một cách mạnh mẽ.
waitForFirstDeviceĐã thêm
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 đó, thiết bị đó sẽ trả về trực tiếp Đúng. Nếu không có thiết bị nào được thêm vào, nó sẽ trả về sai 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ề sai. |
Trả lại | |
---|---|
boolean |
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2023-12-01 UTC.